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 `source_filing_url`. 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/claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

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

Restart Claude Desktop. The Filingrail tools (`search_companies`, `get_financials`, `get_insider_trades`, …) 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:

• *"What was Apple's revenue and operating income last quarter, and link me the filing."*
• *"Show me insider sells at NVIDIA in the last 30 days."*
• *"What 8-K events did Tesla file this month?"*
• *"List Berkshire Hathaway's 10 largest 13F positions for 2026-Q1."*

What it is not

Honest caveats:

• Not real-time. New filings appear within ~24h of EDGAR acceptance (fair-access policy).
• Not Bloomberg. No intraday prices, options chains, non-US issuers, or analyst estimates.
• Structured SEC data, traced to source — that's the whole product.

Pricing

Keys and billing are handled by RapidAPI. **Get yours →**

Links

• Get an API key (RapidAPI listing)
• Filingrail homepage
• Python SDK (sync + async) — `pip install filingrail`
• API status page
• Questions / issues: `support@hudsonenterprisesllc.com`

License

MIT © Hudson Enterprises LLC