Metadata-Version: 2.4
Name: filingrail-mcp
Version: 0.1.0
Summary: MCP server for the Filingrail SEC EDGAR API. Drop into Claude Desktop, Cursor, Continue, or any MCP-compatible agent.
Author-email: Hudson Enterprises LLC <support@hudsonenterprisesllc.com>
License: MIT
Project-URL: Homepage, https://filingrail.hudsonenterprisesllc.com
Project-URL: Repository, https://github.com/hudson-enterprises/filingrail-mcp
Project-URL: Filingrail API, https://rapidapi.com/hudson-enterprises-llc-hudson-enterprises-llc-default/api/filingrail
Keywords: mcp,model-context-protocol,sec,edgar,filings,financial-data,claude,cursor,rapidapi
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: filingrail>=0.1.0
Requires-Dist: mcp>=1.0.0

# 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](https://rapidapi.com/hudson-enterprises-llc-hudson-enterprises-llc-default/api/filingrail) — the live-on-PyPI announcement will land in the listing's About tab.

```bash
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):

```json
{
  "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

- [Filingrail homepage](https://filingrail.hudsonenterprisesllc.com)
- [RapidAPI listing (Docs tab)](https://rapidapi.com/hudson-enterprises-llc-hudson-enterprises-llc-default/api/filingrail)
- [Python SDK (synchronous + async)](https://pypi.org/project/filingrail/) — PyPI publication pending
- [Status page](https://status.hudsonenterprisesllc.com)
- Source repo: TBD (public release pending — for now, email `support@hudsonenterprisesllc.com`)

## License

MIT
