SEC EDGAR MCP Server
guptaprakhariitr/sec-edgar-mcp
Acesso em tempo real a dados financeiros e regulatórios da SEC para agentes IA
Ver no GitHubServidor MCP que integra dados da SEC EDGAR diretamente em agentes de IA, permitindo buscas em documentos de empresas, leitura de 10-K/8-K, extração de fatos XBRL e monitoramento de transações de insiders. Hostado em Cloudflare Workers com dados públicos sem API key obrigatória.
Instalação
npx convez-ai guptaprakhariitr/sec-edgar-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise de demonstrações financeiras estruturadas (XBRL) de qualquer empresa pública
- Monitoramento de eventos materiais (8-K) e alertas de transações de insiders
- Busca contextualizada de arquivos SEC (10-K, 10-Q, etc.) por ticker e período
Veredito

Ferramenta sólida para democratizar acesso a dados financeiros regulatórios em fluxos de IA. Implementação clara, preço acessível (desde grátis até $79/mês) e cobertura completa de casos de uso (filings, fatos XBRL, insider trades). Recomendado para aplicações que precisam de dados financeiros verificados e estruturados.
README
A tradução para o português deste README ainda está na fila.
sec-edgar-mcp
Hosted MCP server that gives AI agents real-time access to SEC EDGAR — filings search, 10-K/8-K reading, XBRL financial facts, and insider-trade (Form 4) alerts. Free underlying data, no API key required by SEC, indie-priced from $9/mo.

Claude: "What were Microsoft's revenue and operating income for FY2024?"
Tool: edgar_get_facts(ticker="MSFT", concept="Revenues")
edgar_get_facts(ticker="MSFT", concept="OperatingIncomeLoss")
Claude: "Microsoft's FY2024 revenue was $245.1B (+15.7% YoY) and operating income was $109.4B…"
What it does
Six tools, all backed by the SEC's free EDGAR APIs (no key required, only a polite User-Agent per SEC fair-use policy).
| Tool | What it returns |
|---|---|
edgar_search_filings | Search filings by ticker / CIK / form type / date range. |
edgar_read_filing | Full text (or summary) of a specific filing by accession number. |
edgar_get_facts | XBRL-structured financial facts (Revenue, OperatingIncome, Cash, etc.). |
edgar_get_8k | Recent 8-K material event filings for a ticker, classified by event type. |
edgar_get_company | Company metadata (CIK, SIC, exchange, executives). |
edgar_get_insider_trades | Form 4 filings (insider buys/sells) with directionality. |
Full per-tool reference: docs/TOOLS.md.
Install
In Cursor
# in your Cursor settings, MCP servers tab, add:
{
"sec-edgar": {
"url": "https://sec-edgar-mcp.workers.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
Or one-click via Smithery: https://smithery.ai/server/sec-edgar-mcp/install/cursor.
In Claude Desktop
{
"mcpServers": {
"sec-edgar": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-fetch", "https://sec-edgar-mcp.workers.dev/mcp"],
"env": { "MCP_AUTH_TOKEN": "YOUR_API_KEY" }
}
}
}
In Cline / Continue
Same URL pattern as Cursor. See docs/TOOLS.md.
Free tier (no API key)
Send requests without an Authorization header. You get 100 calls / month with a 10-req/min ceiling. Hot enough to try, not enough for production.
Pricing
| Tier | Price | Monthly calls | Rate limit | Premium tools |
|---|---|---|---|---|
| Free | $0 | 100 | 10/min | — |
| Solo | $9 / mo | 2,000 | 60/min | — |
| Team | $29 / mo | 10,000 | 200/min | XBRL bulk facts, 8-K subscribe |
| Pro | $79 / mo | 50,000 | 600/min | All of the above + email/webhook alerts |
Subscribe at sec-edgar-mcp.workers.dev/upgrade (or once Smithery's bundled billing is wired, via Smithery checkout — see DISTRIBUTION.md).
How it works
┌────────────┐ ┌────────────────────────┐ ┌──────────────────┐
│ Cursor / │ │ Cloudflare Worker │ │ data.sec.gov │
│ Claude / │ ───► │ sec-edgar-mcp │ ───► │ www.sec.gov │
│ Cline │ │ │ │ (EDGAR) │
└────────────┘ │ - MCP JSON-RPC handler │ └──────────────────┘
POST /mcp │ - API-key + quota │ ▲
Bearer <key> │ - KV cache (TTL 1h–24h)│ │
│ - tool handlers │ ┌─────┴─────┐
└────────────┬───────────┘ │ KV CACHE │
│ │ KV USAGE │
▼ └───────────┘
JSON-RPC response
- Stateless Worker — every request loads identity from
Authorizationheader. - KV cache — 1-hour TTL for current filings, 24-hour for older ones, 365-day for things that never change (company name, CIK).
- Polite to SEC — sends
User-Agent: <your-name> <your-email>(mandated by SEC fair-use), and respectsRetry-Afteron 429s. - Free-tier-only infra — 100k req/day on Workers + 100k reads/day on KV is the binding constraint at ~$3k+ MRR.
Repo layout
sec-edgar-mcp/
├── README.md ← this file
├── CHANGELOG.md ← versioned releases
├── LICENSE ← MIT
├── package.json
├── wrangler.toml
├── tsconfig.json
├── smithery.json ← Smithery listing manifest
├── src/
│ ├── index.ts ← Worker entrypoint
│ ├── edgar.ts ← EDGAR API client
│ ├── tools.ts ← MCP tool definitions
│ ├── auth.ts ← (vendored from _template)
│ ├── cache.ts ← (vendored from _template)
│ ├── billing.ts ← (vendored from _template) — move to private repo
│ └── mcp-server.ts ← (vendored from _template)
├── test/
│ ├── tools.test.ts ← Vitest tests against fabricated fixtures
│ └── fixtures/ ← saved JSON responses
├── docs/
│ ├── TOOLS.md ← per-tool API reference (this is what agents read!)
│ └── DISTRIBUTION.md ← Smithery / Glama / Cursor listing notes
└── .github/workflows/
├── ci.yml
└── deploy.yml
Open-source split
- This repo (public) — MCP shim, tool schemas, basic EDGAR client, free-tier handlers, fixtures.
sec-edgar-mcp-internal(private) — premium-tool implementations (8-K subscription, XBRL bulk, alerts), Stripe webhook handler, advanced cache heuristics, eval datasets.
The deployed Worker pulls from both — but only the public part is on GitHub. See ../../README.md#source-control-split-open-vs-closed for rationale.
Local dev
npm install
wrangler kv namespace create CACHE # one-time
wrangler kv namespace create USAGE # one-time
# paste IDs into wrangler.toml
echo "your-name your-email@example.com" | wrangler secret put SEC_USER_AGENT
npm run dev # http://localhost:8787/mcp
npm test # run vitest
npm run typecheck # strict TS check
Deploy
wrangler deploy
Live at https://sec-edgar-mcp.<account>.workers.dev. Custom-domain instructions in ../../_template/DEPLOY.md.
License
MIT — see LICENSE. The data is from SEC EDGAR and is public domain; please respect the SEC's fair access policy.
See also
docs/TOOLS.md— per-tool reference for agents.docs/DISTRIBUTION.md— listing checklist (overrides template defaults).CHANGELOG.md— release history.../README.md— Category 1 pipeline.../../README.md— overall products plan.
Sister MCPs
All from the same operator, all live on <product>.prakhar-cognizance.workers.dev, all free-tier friendly:
| Group | Products |
|---|---|
| Research | sec-edgar · arxiv · world-bank-economic · uspto-patents · fda-approvals |
| Verification + Utility | verification ⭐ · unit-converter |
| India | indic-normalize · indian-regulatory |
| Real-time | hn-trending · wikipedia-recent-changes · gdelt-events · crypto-prices |
| Healthcare | drug-interaction |
| Logistics | multi-carrier-tracking |
Full catalog: https://github.com/guptaprakhariitr · ⭐ = empty-quadrant / highest-conviction pick.