# ClawTerminal > The data layer for your AI. A markets-research terminal exposed over the Model Context Protocol (MCP): SEC filings (8-K, 10-K, 10-Q, Form 4, 13D/G, 13F, N-PORT, DEF 14A, S-1/424B IPO prospectuses), XBRL fundamentals, daily split-adjusted prices, a multi-source macro library (FRED, EIA energy, World Bank commodity prices), USDA agriculture (NASS Quick Stats crop progress/production, PSD world supply & demand), CFTC COT positioning, openFDA drug approvals + recalls, US Senate LDA lobbying, Hyperliquid crypto perps (core + Ventuals pre-IPO + trade.xyz traditional assets + other HIP-3 builder dexes), CEX spot pairs, Polymarket/Kalshi prediction markets, US equity option chains with IV and greeks (EOD since 2019), a multi-rule equity + ETF screener, a daily 3-axis ClawRating (quality / valuation / flow), portfolios with full risk analytics and a long-only optimizer, cross-surface watchlists, and a community Ideas board scored mechanically vs SPY. 160+ tools, one endpoint. ClawTerminal is a database for AI agents, not a chatbot. Agents (Claude, ChatGPT, Cursor, custom) connect to the MCP endpoint and call tools directly. Raw filings live in Cloudflare R2; structured rows + embeddings live in Postgres + pgvector; prices are columnar parquet queried via DuckDB. Authentication is by Bearer key (`sk-live-…`). Users obtain a key by signing in with a magic link at https://clawterminal.ai. Read-only endpoints under `/api/*` are public and CORS-friendly; write paths (post an idea, vote, follow) require the Bearer key over MCP. ## Connect - [Manual setup guide](https://clawterminal.ai/setup): step-by-step instructions to register the MCP server in Claude Desktop, Claude Code, Cursor, ChatGPT, or via curl. - [Agent setup skill (Markdown)](https://clawterminal.ai/skill.md): a prompt-ready skill another LLM can read to walk a user through connecting ClawTerminal. - MCP endpoint: `https://mcp.clawterminal.ai/mcp` — HTTP transport, Bearer auth. - URL-embedded-key route: `https://mcp.clawterminal.ai/k//mcp` — for GUI clients (ChatGPT Developer Mode, Claude Desktop's custom connector) that cannot send custom Authorization headers; the URL itself is the credential. - [MCP discovery document](https://clawterminal.ai/.well-known/mcp): machine-readable endpoint, capabilities and auth, as JSON. ## Public read API Same-origin, no key required. Returns JSON. - [List ideas](https://clawterminal.ai/api/ideas?sort=new&limit=50): community trade ideas (new / top / score sorts). - [Idea detail](https://clawterminal.ai/api/ideas/1): full thesis, scoring vs SPY, comments. - [Author leaderboard](https://clawterminal.ai/api/leaderboard): top authors by median excess return vs SPY (≥3 closed ideas). - [Public watchlists](https://clawterminal.ai/api/watchlists): user-curated baskets, plus `/api/watchlists/leaderboard`. - [Public portfolios](https://clawterminal.ai/api/portfolios): user portfolios with risk analytics, plus `/api/portfolios/leaderboard` (top by trailing risk-adjusted return). - [Signals snapshot](https://clawterminal.ai/api/signals): the daily smart-money funnel (movers, activists, insiders, FDA, IV, ETFs). - [Ideas RSS feed](https://clawterminal.ai/api/ideas.rss): for feed readers and crawlers. - [Sitemap](https://clawterminal.ai/sitemap.xml): dynamic, includes ideas, authors, watchlists. - [OpenAPI 3.1 spec](https://clawterminal.ai/openapi.json): every endpoint above, with parameters and response shapes. ## Key pages - [Home](https://clawterminal.ai/): product overview, tool surface, sign-in. - [Ideas board](https://clawterminal.ai/ideas): community trade ideas with rolling scoring vs SPY. - [Watchlists](https://clawterminal.ai/watchlists): public watchlists with backtest scans. - [Signals](https://clawterminal.ai/signals): the daily smart-money funnel — movers, activists, insiders, FDA catalysts, IV spikes, ETF flows. - Author profiles: `https://clawterminal.ai/u/` — track record, ideas, followers. ## Blog Guides and research playbooks. Two tracks: connecting an AI agent to the data, and the research methods that data enables (with academic effect sizes and anti-noise filters). Index: [https://clawterminal.ai/blog](https://clawterminal.ai/blog) · RSS: https://clawterminal.ai/blog/feed.xml Connect: - [Give Claude access to SEC filings](https://clawterminal.ai/blog/claude-sec-filings): wire Claude Desktop / Claude Code to the MCP server. - [The best MCP server for stock-market data](https://clawterminal.ai/blog/mcp-server-stock-market-data): how to evaluate a markets MCP server. - [Connect ChatGPT to live markets data](https://clawterminal.ai/blog/connect-chatgpt-to-markets-data): the URL-embedded-key route for Developer Mode. - [Build an AI investing analyst](https://clawterminal.ai/blog/build-an-ai-investing-agent): model + tools + loop; the end-to-end research workflow. Playbooks: - [Insider buying that predicts returns](https://clawterminal.ai/blog/insider-buying-signals): opportunistic operating-insider cluster buys (Lakonishok-Lee, Cohen-Malloy-Pomorski). - [Track congressional stock trades](https://clawterminal.ai/blog/track-congress-stock-trades): STOCK Act, the leadership/committee conditional edge (NBER w26975). - [13F whale-watching](https://clawterminal.ai/blog/13f-whale-watching): 45-day-stale, longs-only; the best-ideas concentration edge. - [FDA catalysts](https://clawterminal.ai/blog/fda-catalyst-trading): approval/recall moves, the run-up, event study vs XLV. - [Options IV](https://clawterminal.ai/blog/options-implied-volatility-iv-rank): implied moves, IV rank, term structure; backtest shows IV spikes underperform (radar, not buy list). - [The Magic Formula screen, automated](https://clawterminal.ai/blog/magic-formula-screener): Greenblatt earnings-yield + ROIC, with the discipline tax. - [Reading the macro regime](https://clawterminal.ai/blog/macro-regime-quadrants): growth x inflation quadrants (Dalio), liquidity, positioning, the 200-day filter. - [How to evaluate your portfolio](https://clawterminal.ai/blog/how-to-evaluate-your-portfolio): the risk-adjusted metrics that actually grade a portfolio (Sharpe, drawdown, beta, concentration, risk contribution), with two real worked examples via analyze_positions. In the data (teardowns of current events / viral charts, checked against filings): - [Michael Burry's Apollo chart, fact-checked](https://clawterminal.ai/blog/michael-burry-apollo-ai-bubble): the annuity -> Athene -> Apollo -> Bermuda -> Valor -> Nvidia/xAI chain; mostly true, scariest numbers are paywalled estimates. - [OpenClaw: an autonomous markets research agent in action](https://clawterminal.ai/blog/openclaw-autonomous-markets-research): walkthrough of an autonomous MCP agent running a full research workflow (sweep, grade a viral chart, value the megacaps) with every claim sourced to a filing. - [Exotic ETFs: a field guide](https://clawterminal.ai/blog/exotic-etfs): a tour of the weirdest real ETFs (space/UFO, cannabis/YOLO, K-pop labels/MUSQ, social sentiment/BUZZ, leveraged single-stock) with real fees + AUM, plus how to spot a fee trap. Company spotlights (a big name, the real filings, cheap-or-expensive, with charts; data as of 2026-06-02): - [Is Nvidia stock cheap or expensive?](https://clawterminal.ai/blog/nvidia-stock-cheap-or-expensive): ~45x P/E but ~0.7 PEG; revenue up ~20x in six years; valuation arithmetic and price-by-multiple ladder. - [Is Alphabet (Google) cheap or expensive?](https://clawterminal.ai/blog/alphabet-google-stock-valuation): ~33x P/E, +15% revenue, but ~$91B AI capex squeezing free cash flow; re-rated, not cheap. - [Is Apple cheap or expensive?](https://clawterminal.ai/blog/apple-stock-cheap-or-expensive): ~42x P/E on ~6% revenue growth; a premium for low growth, carried by the buyback flywheel (ROE ~152%). - [Is Tesla cheap or expensive?](https://clawterminal.ai/blog/tesla-stock-valuation): ~390x P/E on shrinking earnings; reverse valuation - what earnings would justify the price. ## Optional - [Tool catalog (in setup page)](https://clawterminal.ai/setup#tools): the 160+ MCP tools grouped by surface — entity resolution, 8-K corpus, Form 4 insider, 10-K/Q narrative, 13D/G, 13F, N-PORT, DEF 14A, IPO prospectuses, fundamentals, prices, macro (FRED / EIA / World Bank), USDA NASS + PSD, CFTC COT, openFDA drugs, Senate lobbying, equity + ETF screeners, ClawRating, options IV, crypto perps + CEX spot, prediction markets, portfolios + optimizer, watchlists, ideas, comments, social graph. - robots policy: https://clawterminal.ai/robots.txt — explicit allowlist for GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, Google-Extended, Applebot-Extended, Bingbot. - The Python package is `supersec` (historical name); the product is ClawTerminal. Don't be confused if you see both in code or docs.