filingrail-mcp

Arquivos SEC EDGAR como ferramentas MCP — dados financeiros XBRL, negociações de insiders no Form 4, eventos 8-K e participações 13F, com o URL do arquivo em sec.gov em cada registro.

Documentação

filingrail-mcp — arquivos SEC EDGAR dentro do Claude, Cursor e qualquer agente MCP

Dê ao seu agente de IA dados SEC EDGAR ao vivo: finanças de empresas, negociações de insiders, eventos 8-K, participações 13F e o fluxo bruto de arquivos — tudo normalizado em JSON limpo, cada número rastreável até o arquivo de origem sec.gov.

Um pip install, uma chave de API, e seu agente pode responder "Qual era a posição de caixa da Apple no último trimestre?" ou "Liste as 10 principais participações da Berkshire Hathaway em 2026-Q1" — com base em arquivos reais, não em seus dados de treinamento.

pip install filingrail-mcp

Ao vivo no PyPI: pypi.org/project/filingrail-mcp · licença MIT · Python 3.10+

Por que isso existe

Todo número que uma empresa pública reporta à SEC é gratuito e aberto no EDGAR. O gargalo não é o acesso — é o parser XBRL, o normalizador de derivação de tags, o controlador de limite de taxa e a camada de deduplicação que você teria que escrever antes de obter o único número que realmente queria. filingrail-mcp entrega ao seu agente o JSON pronto.

  • Rastreável até a fonte. Cada resposta financeira carrega o source_filing_url de origem. Clique nele, veja o 10-K / 10-Q exato em sec.gov. Sem "confie em nós".
  • Normalizado. revenue é revenue, independentemente de o arquivador ter marcado como us-gaap:Revenues, SalesRevenueNet ou RevenueFromContractWithCustomerExcludingAssessedTax. Mais de 1,8 milhão de linhas XBRL desde 2006.
  • Zero infraestrutura. Sem configuração de User-Agent do EDGAR, sem parser local, sem controlador de limite de taxa. A API cuida de tudo.

Obtenha uma chave (plano gratuito, sem cartão)

Filingrail é uma API REST no RapidAPI. O plano gratuito é 50 chamadas/dia, sem cartão de crédito:

Assine o Filingrail no RapidAPI e copie seu X-RapidAPI-Key.

O usuário final traz sua própria chave — defina-a como RAPIDAPI_KEY na configuração do seu cliente MCP (abaixo).

Configure seu agente

Claude Desktop

Edite %APPDATA%/Claude/claude_desktop_config.json (Windows) ou ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "filingrail": {
      "command": "filingrail-mcp",
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" }
    }
  }
}

Reinicie o Claude Desktop. As ferramentas do Filingrail (search_companies, get_financials, get_insider_trades, …) aparecem na lista de ferramentas. Depois é só fazer uma pergunta em inglês simples.

Cursor / Continue / qualquer outro cliente MCP

Aponte o cliente para filingrail-mcp como comando stdio e passe RAPIDAPI_KEY como variável de ambiente. Mesma estrutura acima.

Se o seu cliente aceitar apenas um comando bruto, use:

{ "command": "filingrail-mcp", "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" } }

Ferramentas expostas

FerramentaO que faz
search_companies(q, limit)Resolve ticker / CIK / fragmento de nome para uma empresa (mais de 8.000 emissores SEC, correspondência difusa)
get_recent_filings(form_type, cik, limit)Fluxo de arquivos recentes — filtre por formulário (10-K, 8-K, 4, 13F-HR) ou CIK
get_financials(ticker_or_cik, limit)Itens de linha normalizados do 10-K / 10-Q mais recentes + source_filing_url
get_financials_history(ticker_or_cik, period, limit, …)Séries históricas trimestrais ou anuais
get_insider_trades(ticker_or_cik, since, limit)Transações do Formulário 4 — quem comprou/vendeu, quando, quanto
get_8k_events(ticker_or_cik, since, limit)Eventos materiais 8-K com códigos de item da SEC (5.02, 2.01, …)
get_13f_holdings(institution_cik, quarter, limit)Participações institucionais (ex.: Berkshire = CIK 1067983)
health()Verificação de disponibilidade da API

Experimente

Após instalar e configurar, pergunte ao seu agente:

  • "Qual foi a receita e o lucro operacional da Apple no último trimestre, e me envie o link do arquivo."
  • "Mostre-me vendas de insiders na NVIDIA nos últimos 30 dias."
  • "Quais eventos 8-K a Tesla arquivou este mês?"
  • "Liste as 10 maiores posições 13F da Berkshire Hathaway para 2026-Q1."

O que não é

Ressalvas honestas:

  • Não é em tempo real. Novos arquivos aparecem em até ~24h após a aceitação do EDGAR (política de acesso justo).
  • Não é Bloomberg. Sem preços intradiários, cadeias de opções, emissores não americanos ou estimativas de analistas.
  • Dados estruturados da SEC, rastreados até a fonte — esse é o produto.

Preços

NívelPreçoChamadas/mês
Gratuito$01.500 (50/dia)
Pro$9/mês5.000
Ultra$49/mês50.000
Mega$199/mês500.000

Chaves e cobrança são gerenciadas pela RapidAPI. Obtenha a sua →

Links

Licença

MIT © Hudson Enterprises LLC