{
  "name": "stocks-llm",
  "version": "0.1.0",
  "description": "US public companies: S&P 500 + NASDAQ-100 + Dow Jones + Russell 1000 + Russell 2000 (deduped — effectively the Russell 3000 plus the Dow), spanning large-, mid-, AND small-cap companies (~2,900+). Data: SEC EDGAR filings + Finnhub fundamentals, each figure dated. Informational only, NOT financial advice.",
  "endpoint": "https://stocks-llm.com/mcp",
  "transport": "streamable-http",
  "stateless": true,
  "protocolVersions": [
    "2025-06-18",
    "2025-03-26",
    "2024-11-05"
  ],
  "latestProtocolVersion": "2025-06-18",
  "maxBatch": 10,
  "authentication": {
    "type": "none",
    "note": "Read-only public financial data; no API key or OAuth. Rate limited per client (see rateLimits)."
  },
  "rateLimits": {
    "toolsCallPerMinute": 8,
    "toolsCallPerDay": 500,
    "globalDailyCallCap": 5000,
    "note": "Per-client (IP-keyed) fixed windows. Only tools/call consumes a slot; the handshake (initialize/tools/list/ping) does not. A batch of N tools/call consumes N slots."
  },
  "tools": [
    {
      "name": "search_companies",
      "summary": "Natural-language / thematic search over the stocks-llm knowledge base of US public companies: S&P 500 + NASDAQ-100 + Dow Jones + Russell 1000 + Russell 2000 (deduped — effectively the Russell 3000 plus the Dow), spanning large-, mid-, AND small-cap companies (~2,900+).",
      "required": [
        "query"
      ]
    },
    {
      "name": "get_company_profile",
      "summary": "Full enriched profile for ONE company (mirrors the /company/{ticker} page): name, ticker, sector, the LLM business summary + one-line pitch, key fundamentals (price + as-of date, market cap, margins, ROE/ROA, valuation), dividend facts, competitors, plus its latest SEC filings and recent news — the DATED evidence you cite.",
      "required": []
    },
    {
      "name": "compare_companies",
      "summary": "Head-to-head comparison of TWO companies (mirrors the /compare/{a}-vs-{b} page): the same real, dated side-by-side metrics — price, market cap, P/E, PEG, margins, ROE/ROA, debt/equity, revenue growth, dividend yield + streak, beta, 1-year return — plus each company's one-line pitch.",
      "required": [
        "ticker_a",
        "ticker_b"
      ]
    }
  ],
  "dataSources": [
    "SEC EDGAR filings",
    "Finnhub fundamentals",
    "U.S. House Clerk STOCK-Act (PTR) disclosures"
  ],
  "privacy": "No accounts, no user data stored, no cookies set by /mcp. Read-only DB queries; per-client IP-keyed rate limiting only.",
  "disclaimer": "Informational only — NOT financial advice.",
  "documentation": {
    "about": "https://stocks-llm.com/about",
    "llmsTxt": "https://stocks-llm.com/llms.txt",
    "llmsFullTxt": "https://stocks-llm.com/llms-full.txt"
  },
  "contact": "https://stocks-llm.com/about"
}