Filingrail MCP server

<!-- mcp-name: io.github.adamhudson777/filingrail-mcp -->

filingrail-mcp — SEC EDGAR filings inside Claude, Cursor, and any MCP agent

Give your AI agent live SEC EDGAR data: company financials, insider trades, 8-K events, 13F holdings, and the raw filings stream — all normalized to clean JSON, every number traceable back to its sec.gov source filing.

One pip install, one API key, and your agent can answer "What was Apple's cash position last quarter?" or "List Berkshire Hathaway's top 10 holdings as of 2026-Q1" — against real filings, not its training data.

pip install filingrail-mcp

Live on PyPI: pypi.org/project/filingrail-mcp · MIT licensed · Python 3.10+

Why this exists

Every number a public company reports to the SEC is free and open on EDGAR. The bottleneck isn't access — it's the XBRL parser, the tag-drift normalizer, the rate-limit governor, and the dedup layer you'd have to write before you get the one figure you actually wanted. filingrail-mcp hands your agent the finished JSON instead.

• Source-traceable. Every financial response carries the originating sourcefilingurl. Click it, see the exact 10-K / 10-Q on sec.gov. No "trust us."
• Normalized. revenue is revenue, whether the filer tagged it us-gaap:Revenues, SalesRevenueNet, or RevenueFromContractWithCustomerExcludingAssessedTax. 1.8M+ XBRL rows back to 2006.
• Zero plumbing. No EDGAR User-Agent config, no local parser, no rate-limit governor. The API handles all of it.

Get a key (free tier, no card)

Filingrail is a REST API on RapidAPI. The free tier is 50 calls/day, no credit card:

→ Subscribe to Filingrail on RapidAPI and copy your X-RapidAPI-Key.

The end user brings their own key — set it as RAPIDAPI_KEY in your MCP client config (below).

Configure your agent

Claude Desktop

Edit %APPDATA%/Claude/claudedesktopconfig.json (Windows) or ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS):

{
  "mcpServers": {
    "filingrail": {
      "command": "filingrail-mcp",
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" }
    }
  }
}

Restart Claude Desktop. The Filingrail tools (searchcompanies, getfinancials, getinsidertrades, …) appear in the tool list. Then just ask a question in plain English.

Cursor / Continue / any other MCP client

Point the client at filingrail-mcp as the stdio command and pass RAPIDAPI_KEY as an environment variable. Same shape as above.

If your client only accepts a raw command, use:

{ "command": "filingrail-mcp", "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" } }

Tools exposed

Try it

After installing and configuring, ask your agent:

Shortened. The full README is on GitHub.