filingrail-mcp
About
SEC EDGAR filings as MCP tools — XBRL financials, Form 4 insider trades, 8-K events and 13F holdings, with the source sec.gov filing URL on every record.
Details
- Author
- adamhudson777
- Categories
- Finance
Jump to
Setup
Install filingrail-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/adamhudson777/filingrail-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
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 itssec.govsource filing.
Onepip 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.
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-mcphands your agent the finished JSON instead.
- Source-traceable.Every financial response carries the originatingsource_filing_url. Click it, see the exact 10-K / 10-Q on sec.gov. No "trust us."
- Normalized.revenueisrevenue, whether the filer tagged itus-gaap:Revenues,SalesRevenueNet, orRevenueFromContractWithCustomerExcludingAssessedTax. 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.
Filingrail is a REST API on RapidAPI. The free tier is50 calls/day, no credit card:
The end user brings their own key — set it asRAPIDAPI_KEYin 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.
Cursor / Continue / any other MCP client
Point the client atfilingrail-mcpas the stdio command and passRAPIDAPI_KEYas 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" } }
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."
- 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.
Keys and billing are handled by RapidAPI.Get yours →
- Get an API key (RapidAPI listing)
- Filingrail homepage
- Python SDK (sync + async)—pip install filingrail
- API status page
- Questions / issues:support@hudsonenterprisesllc.com
Bridge Town is an MCP-native, git-versioned financial modeling platform for FP&A teams and finance leaders. AI agents use Bridge Town tools to create projects, write Python model files, run models in isolated cloud sandboxes, query data, write outputs to Google Sheets, create dashboards, branch scenarios, and collaborate with teammates.
The Capital.com MCP Server lets your AI assistant talk to your trading account directly. Market data, position checks, trade previews – all in plain language, without leaving your AI tool.
Coinrule Agentic Trading MCP enables investors to create, backtest, execute, and manage trading agents through natural language across stocks, crypto and ETFs
Invest with Claude and other AI assistants
Australian Consumer Data Right Product Data
Remote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage) and tick-data purchase. Keyless for catalog & stats; optional OAuth for account tools. Endpoint: https://cryptostruct.com/mcp
Cross-border debt collection from your AI assistant: check cases, get pricing, submit new cases.
Read-only MCP server for your Evibe investment portfolio + live market data (holdings, performance, dividends, benchmarks, screeners). Works with Claude & ChatGPT.
Financial and quantitative modeling engine for AI agents. Typed, named, deterministic.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
