sec-api-dev-mcp
README.md
# sec-api-dev-mcp
A stdio [MCP](https://modelcontextprotocol.io) server for SEC EDGAR data through [sec-api.dev](https://sec-api.dev):
company lookup, filing history, full-text search since 2001, filing text and sections, XBRL facts, parsed Form 3/4/5
and 13F tables, quarterly Form D and insider tables, and an FDA catalyst calendar built from SEC filings.
Zero dependencies, Node 18+, every tool read-only.
Two tools work with no key at all: `demo_company` (AAPL, MSFT, NVDA, AMZN, GOOGL, META, TSLA, AMD) and
`fda_calendar_next_30_days`. The rest need `SEC_API_KEY`, free at https://sec-api.dev/sign-up (100 requests a month,
no card). Prefer no local process? The same data is hosted at `https://sec-api.dev/api/mcp`
(setup: https://sec-api.dev/edgar-mcp-server).
sec-api.dev is independent: not sec-api.io, not affiliated with the SEC or FDA. Not investment advice.
## Claude Desktop
`claude_desktop_config.json`:
```json
{
"mcpServers": {
"sec-api": {
"command": "npx",
"args": ["-y", "sec-api-dev-mcp"],
"env": { "SEC_API_KEY": "your-sec-api-key" }
}
}
}
```
## Claude Code
```bash
claude mcp add sec-api -e SEC_API_KEY="$SEC_API_KEY" -- npx -y sec-api-dev-mcp
```
## Cursor (`.cursor/mcp.json`)
```json
{ "mcpServers": { "sec-api": { "command": "npx", "args": ["-y", "sec-api-dev-mcp"], "env": { "SEC_API_KEY": "your-sec-api-key" } } } }
```
## Tools
| Tool | Key | What it returns |
| --- | --- | --- |
| `demo_company` | no | Profile, last three 10-Ks or Assets facts for 8 demo tickers |
| `fda_calendar_next_30_days` | no | PDUFA dates, AdComs and readouts in the next 30 days, with sources |
| `search_companies` | yes | Ticker or name to CIK |
| `get_filings` | yes | A company's filings with accession and sec.gov URL |
| `search_filing_text` | yes | Full-text search of filings since 2001 |
| `get_company_facts` | yes | XBRL facts as filed |
| `get_documents` | yes | Document manifest or paged text |
| `extract_section` | yes | One 10-K/10-Q/8-K item (1A, 7, 2.02...) |
| `get_insider_trades` | yes | One Form 3/4/5 parsed |
| `query_insider_transactions` | yes | Quarterly insider tables, 2025 Q4 to 2026 Q3 |
| `get_13f_holdings` | yes | One 13F-HR information table |
| `get_form_d_offerings` | yes | Quarterly Form D notices, 2026 Q2 to Q3 |
| `get_daily_filing_index` | yes | SEC daily index for a date |
| `biotech_calendar` | yes | Biotech catalysts (free key: 30 days ahead) |
Real output of `fda_calendar_next_30_days` with `{"type":"pdufa"}` on November 15, 2026 (no key):
```json
{"count":9,"events":[{"type":"pdufa","date":"2026-11-22","dateConfidence":"exact","ticker":"SVRA","status":"scheduled","source":"https://www.sec.gov/Archives/edgar/data/1160308/000119312526453535/svra-20260930.htm"}]}
```
Every request with a key counts against your sec-api.dev plan (https://sec-api.dev/pricing).
## Tests
```bash
npm test # offline: protocol, schemas, key handling, stdio round trip
SEC_API_LIVE=1 npm test # also calls the real keyless endpoints
```
Operated by Stunning Couches LLC. MIT licence.
## Links
- Product: https://sec-api.dev
- Docs: https://sec-api.dev/docs
- MCP setup guide: https://sec-api.dev/edgar-mcp-server
- Hosted MCP endpoint (Streamable HTTP): `https://sec-api.dev/api/mcp`
- npm: https://www.npmjs.com/package/sec-api-dev-mcp
- MCP Registry name: `io.github.sec-api-dev/sec-api-dev-mcp`
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues