SEC EDGAR financials, insider trades, 8-K events, and 13F holdings as MCP tools.
Runs on your machine from its package; the steps are below.
At most: only reads or looks up information.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
uvx filingrail-mcp
MCP client config
{
"mcpServers": {
"filingrail": {
"command": "uvx",
"args": [
"filingrail-mcp"
]
}
}
}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+
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_filing_url. Click it, see the exact 10-K / 10-Q on sec.gov. No "trust us."revenue is revenue, whether the filer tagged it us-gaap:Revenues, SalesRevenueNet, or RevenueFromContractWithCustomerExcludingAssessedTax. 1.8M+ XBRL rows back to 2006.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).
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.
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" } }
| Tool | What it does |
|---|---|
search_companies(q, limit) | Resolve ticker / CIK / name fragment to a company (8,000+ SEC issuers, fuzzy match) |
get_recent_filings(form_type, cik, limit) | Recent filings firehose — filter by form (10-K, 8-K, 4, 13F-HR) or CIK |
get_financials(ticker_or_cik, limit) | Latest 10-K / 10-Q normalized line items + source_filing_url |
get_financials_history(ticker_or_cik, period, limit, …) | Historical quarterly or annual series |
get_insider_trades(ticker_or_cik, since, limit) | Form 4 transactions — who bought/sold, when, how much |
get_8k_events(ticker_or_cik, since, limit) | 8-K material events with SEC item codes (5.02, 2.01, …) |
get_13f_holdings(institution_cik, quarter, limit) | Institutional holdings (e.g. Berkshire = CIK 1067983) |
health() | API liveness check |
After installing and configuring, ask your agent:
Honest caveats:
| Tier | Price | Calls/month |
|---|---|---|
| Free | $0 | 1,500 (50/day) |
| Pro | $9/mo | 5,000 |
| Ultra | $49/mo | 50,000 |
| Mega | $199/mo | 500,000 |
Keys and billing are handled by RapidAPI. Get yours →
pip install filingrailsupport@hudsonenterprisesllc.comMIT © Hudson Enterprises LLC