convez.ai
MCP ServerFinanceiroIntermediário
guptaprakhariitr

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 GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

demo

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).

ToolWhat it returns
edgar_search_filingsSearch filings by ticker / CIK / form type / date range.
edgar_read_filingFull text (or summary) of a specific filing by accession number.
edgar_get_factsXBRL-structured financial facts (Revenue, OperatingIncome, Cash, etc.).
edgar_get_8kRecent 8-K material event filings for a ticker, classified by event type.
edgar_get_companyCompany metadata (CIK, SIC, exchange, executives).
edgar_get_insider_tradesForm 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

TierPriceMonthly callsRate limitPremium tools
Free$010010/min—
Solo$9 / mo2,00060/min—
Team$29 / mo10,000200/minXBRL bulk facts, 8-K subscribe
Pro$79 / mo50,000600/minAll 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 Authorization header.
  • 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 respects Retry-After on 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


Sister MCPs

All from the same operator, all live on <product>.prakhar-cognizance.workers.dev, all free-tier friendly:

GroupProducts
Researchsec-edgar · arxiv · world-bank-economic · uspto-patents · fda-approvals
Verification + Utilityverification ⭐ · unit-converter
Indiaindic-normalize · indian-regulatory
Real-timehn-trending · wikipedia-recent-changes · gdelt-events · crypto-prices
Healthcaredrug-interaction
Logisticsmulti-carrier-tracking

Full catalog: https://github.com/guptaprakhariitr · ⭐ = empty-quadrant / highest-conviction pick.

Ver o original no GitHub

Bom para

Relacionados