← stocks-llm · About · Methodology

Connect stocks-llm to your AI agent

stocks-llm exposes the same natural-language US-public-company discovery the website serves as read-only MCP tools — any MCP-compatible client (Claude Desktop, Claude Code, or any other agent) can call them directly, grounded in the same real, dated, cited SEC EDGAR + Finnhub data.

Endpoint at a glance

Endpointhttps://stocks-llm.com/mcp
Transportstreamable-http (MCP's remote transport) · stateless (no session id)
Protocol2025-06-18, 2025-03-26, 2024-11-05
Authnone — read-only public data, no API key or OAuth
Max batch10 JSON-RPC requests / POST

Discover it programmatically: /.well-known/mcp.json is the machine-readable manifest (the authoritative source these facts are rendered from).

Tools

Tool	Required args	What it returns
`search_companies`	query	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+).
`get_company_profile`	(see tools/list)	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.
`compare_companies`	ticker_a, ticker_b	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.

A tools/list call on the live endpoint is the authoritative source for the full, current input schemas — don't hand-copy them. Every tool response carries the "informational only — not financial advice" disclaimer.

Add it to a client

Claude Desktop / Claude Code (remote MCP server) — no env/headers/token block, because the server takes no auth:

{
  "mcpServers": {
    "stocks-llm": {
      "type": "streamable-http",
      "url": "https://stocks-llm.com/mcp"
    }
  }
}

Verify it before you rely on it

curl -s https://stocks-llm.com/.well-known/mcp.json

curl -s https://stocks-llm.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Or point the official inspector at it:

npx @modelcontextprotocol/inspector https://stocks-llm.com/mcp

Rate limits

The /mcp path has its own, tighter limiter than the human chat endpoint (an agent can fire requests machine-paced). Only tools/call consumes a slot; the initialize / tools/list / ping handshake is free. A batch of N tools/call consumes N slots.

Per minute8 tools/call
Per day500 tools/call / client
Global cap5000 tools/call / day

Data sources & privacy

Sources: SEC EDGAR filings, Finnhub fundamentals, U.S. House Clerk STOCK-Act (PTR) disclosures. Each figure is dated.
Privacy: No accounts, no user data stored, no cookies set by /mcp. Read-only DB queries; per-client IP-keyed rate limiting only.

Directory listings

Strategy: publish once to the official MCP Registry; the major community directories ingest it downstream. The status below is the honest state — the site operator has not yet submitted, and "listed" is never claimed without a verifiable public listing.

Directory	Status
Official MCP Registry	not submitted
mcp.so	not submitted
Glama MCP directory	not submitted
Smithery	not submitted

About stocks-llm · Methodology · Discovery manifest · llms.txt (for AI agents)

Informational only — NOT financial advice. Informational only — NOT financial advice. Data is delayed daily-close, may be missing or stale, and coverage varies. Verify independently and consult a qualified professional before any investment decision.