Skip to main content

MCP server for the Filingrail SEC EDGAR API. Drop into Claude Desktop, Cursor, Continue, or any MCP-compatible agent.

Project description

filingrail-mcp — MCP server for SEC EDGAR data

Drop SEC filings, financials, insider trades, 8-K events, and 13F holdings into Claude Desktop, Cursor, Continue, or any MCP-compatible agent.

Install

Note: PyPI publication is pending. Watch the Filingrail RapidAPI listing — the live-on-PyPI announcement will land in the listing's About tab.

pip install filingrail-mcp  # PyPI publication pending

Get a key

Free tier: 50 calls/day, no card. Subscribe on RapidAPI: https://rapidapi.com/hudson-enterprises-llc-hudson-enterprises-llc-default/api/filingrail

Configure your agent

Claude Desktop

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

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

Restart Claude Desktop. Filingrail tools (search_companies, get_financials, get_insider_trades, etc.) will appear in the tool list.

Cursor / Continue / any other MCP client

Point the client at filingrail-mcp as the stdio command, pass RAPIDAPI_KEY as an env var.

Tools exposed

Tool What it does
search_companies(q, limit) Resolve ticker / CIK / name fragment to a company
get_recent_filings(form_type, cik, limit) Recent filings firehose, filterable
get_financials(ticker_or_cik, limit) Latest 10-K / 10-Q normalized line items
get_financials_history(...) Historical Q or A series
get_insider_trades(ticker_or_cik, since, limit) Form 4 transactions
get_8k_events(ticker_or_cik, since, limit) 8-K events with item codes
get_13f_holdings(institution_cik, quarter, limit) Institutional holdings
health() API liveness check

Try it

After installing, ask Claude: "What was Apple's cash position last quarter?" or "List Berkshire Hathaway's top 10 holdings as of 2026-Q1."

Source-traceable

Every get_financials response carries the originating source_filing_url. Click it to see the exact 10-K / 10-Q on sec.gov that the numbers came from. No abstraction, no "trust us."

Links

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

filingrail_mcp-0.1.0.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

filingrail_mcp-0.1.0-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file filingrail_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: filingrail_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for filingrail_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 3ee63eaf95833d38285d8076ae5f84d8f1ad13fa9196149711136818d3b65fc6
MD5 8e16b3a56a05a15b17ef86ae7c032e66
BLAKE2b-256 e293f45a1ba637ac3f5342f1be27f2fcd6d8a44be5fa299ade6f43f56e4a8fea

See more details on using hashes here.

File details

Details for the file filingrail_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: filingrail_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for filingrail_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e1b0311545c42c474c1abccc6e535d5b90f20b2e0fa64d68fa1e29203650c3b7
MD5 ca84be763ccb4c687f1395b2ed490cf7
BLAKE2b-256 f154075d03c4f082ff71425e267d207e0932ec4089cff94df1be478fa91b128d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page