SEC EDGAR MCP MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Ticker/nome → resolução CIK; endpoint de fatos da empresa
Arquivamentos: recuperação 10-K, 10-Q, 8-K e extração de seção
Finanças XBRL analisadas em balanço patrimonial/demonstração de resultados/fluxo de caixa
Negociação com informações privilegiadas – Formulário de transações 3/4/5
Cada resposta cita o URL de arquivamento da SEC para verificação

Demo ao vivo

Como fica na prática

sec-edgar-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sec-edgar-mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: SEC EDGAR MCP

Faça uma leitura rápida de 10K com números e citações exatos

👤 Analistas, investidores, jornalistas que cobrem empresas públicas ⏱ ~30 min intermediate

Quando usar: Você precisa ler um 10-K esta tarde, não esta semana.

Pré-requisitos

SEC_EDGAR_USER_AGENT definido com seu nome e e-mail — SEC exige um User-Agent contatável para acesso programático

Fluxo

Resolva a empresa

Procure o CIK da Microsoft.✓ Copiado

→ CIK 0000789019 retornado
Puxe o último 10-K

Obtenha o 10-K mais recente e extraia a seção Fatores de risco.✓ Copiado

→ Seção Fatores de Risco retornada com URL de arquivamento
Puxe os números

Extraia o balanço patrimonial e a demonstração de resultados do ano fiscal de 2025.✓ Copiado

→ Linhas limpas com valores + unidades + URL de arquivamento

Resultado: Uma leitura digestível de 10K com links verificáveis para EDGAR.

Armadilhas

Anos fiscais e civis confusos — Sempre imprima o período fiscal na resposta para que os usuários possam verificar a integridade

Combine com: yahoo-finance

Rastreie transações internas para uma lista de observação

👤 Investidores seguindo o sentimento interno ⏱ ~20 min intermediate

Quando usar: Você deseja um resumo diário das atividades do Formulário 4 para sua lista de observação.

Fluxo

Liste os insiders para cada ticker

Para AAPL, MSFT, NVDA – extraia transações do Formulário 4 nos últimos 30 dias.✓ Copiado

→ Linhas com nome do insider, função, compra/venda, ações, preço, data
Agregar

Resuma a compra líquida de informações privilegiadas versus a venda por ticker.✓ Copiado

→ Uma linha por ticker com direção líquida

Resultado: Um briefing interno nítido sem raspar EDGAR à mão.

Armadilhas

Contando transações relacionadas a opções como 'compras' — Filtrar códigos de transação; P/S vs A/M/D é importante

Combine com: alpaca

Resuma os registros 8-K de hoje em uma lista de observação

👤 Redações, equipes de desenvolvimento corporativo, relações com investidores ⏱ ~10 min beginner

Quando usar: Algo material aconteceu; você deseja um resumo em inglês simples e rápido.

Fluxo

Extraia 8-Ks recentes

Obtenha os registros 8-K de hoje para ver os tickers em minha lista de observação.✓ Copiado

→ Por arquivamento: códigos de item + link
Resumir

Para cada um, um resumo de uma frase em inglês simples com o código do item.✓ Copiado

→ Resumo claro com o URL SEC

Resultado: Um resumo da lista de observação em que você pode confiar e vincular.

Combine com: fetch

Compare as finanças de duas empresas lado a lado

👤 Analistas de ações, estudantes construindo modelos ⏱ ~20 min intermediate

Quando usar: Você precisa de uma comparação rápida entre maçãs.

Fluxo

Extraia o XBRL de ambas as empresas

Obtenha receita, lucro bruto, lucro operacional, lucro líquido para AAPL e MSFT para o ano fiscal de 2024.✓ Copiado

→ Tabela alinhada com unidades e URLs de arquivamento
Diferenciar as margens

Calcule e compare as margens brutas e operacionais.✓ Copiado

→ Margens lado a lado; link para cada arquivo

Resultado: Uma comparação defensável com URLs de origem exatos.

Combine com: antv-chart

Combinações

Combine com outros MCPs para 10× de alavancagem

sec-edgar-mcp + yahoo-finance

Combine os fundamentos da SEC com as cotações atuais do mercado

Obtenha o lucro líquido de 10 mil mais recente da MSFT e o valor de mercado atual; calcular múltiplos implícitos.✓ Copiado

sec-edgar-mcp + alpaca

Use sinais internos como uma tela

Para tickers com compras internas líquidas nos últimos 30 dias, liste os preços atuais da Alpaca.✓ Copiado

sec-edgar-mcp + antv-chart

Faça um gráfico dos números XBRL extraídos

Extraia 5 anos de receita e faça um gráfico com o gráfico antv.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
lookup_cik	ticker_or_name: str	Primeiro passo para qualquer consulta empresarial	1 SEC request
get_company_facts	cik: str	Descubra quais itens de linha são relatados	1 SEC request
get_filings	cik: str, form_type: str, limit?: int	Extrair limalhas 10-K / 10-Q / 8-K	1 SEC request
extract_section	accession_number: str, section: str	Leia uma seção específica (por exemplo, Fatores de Risco, MD&A)	1 SEC request
get_financials	cik: str, period: str	Demonstrações financeiras estruturadas com unidades	1 SEC request
get_insider_transactions	cik: str, days?: int	Atividade do formulário 3/4/5	1 SEC request

Custo e limites

O que custa rodar

Cota de API: Limite de taxa SEC: ~10 solicitações/seg por IP – respeite-o
Tokens por chamada: Pequenos para metadados, os arquivamentos podem ser muito grandes (dezenas de milhares de tokens)
Monetário: Gratuito - EDGAR é público
Dica: Use extract_section em vez de descartar todo o arquivo; as seções MD&A ou Fatores de Risco por si só geralmente são suficientes.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: SEC_EDGAR_USER_AGENT identifica você para a SEC; use um nome real e um e-mail contatável. Não envie seu e-mail pessoal para uma configuração compartilhada.

Saída de dados: Todas as chamadas vão para sec.gov. Nenhum serviço de terceiros na configuração padrão.

Nada devolvido por este MCP constitui aconselhamento de investimento. Sempre verifique por meio do arquivo da SEC vinculado antes de agir.

Solução de problemas

Erros comuns e correções

403 de sec.gov

Seu User-Agent está ausente ou malformado. SEC requer o formato 'Nome ([email protected])'.

Verificar: echo $SEC_EDGAR_USER_AGENT

Taxa limitada (429)

Recue para menos de 10 req/s. Lote por CIK em vez de emitir muitas chamadas paralelas.

Verificar: Inspect headers on the failing response

Conceito XBRL não encontrado

A empresa não pode relatar esse conceito. Use get_company_facts para ver quais conceitos existem.

Verificar: get_company_facts(cik) and grep for the concept

Alternativas

SEC EDGAR MCP vs. outros

Alternativa	Quando usar	Troca
yahoo-finance	Você quer cotações + fundamentos básicos sem precisão no nível SEC	Menos autoritário; sem registros diretos
alpaca	Você precisa de dados de mercado de corretagem e negociação	Sem arquivamentos; formato de dados diferente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills