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_urlde 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 comous-gaap:Revenues,SalesRevenueNetouRevenueFromContractWithCustomerExcludingAssessedTax. 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
| Ferramenta | O 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ível | Preço | Chamadas/mês |
|---|---|---|
| Gratuito | $0 | 1.500 (50/dia) |
| Pro | $9/mês | 5.000 |
| Ultra | $49/mês | 50.000 |
| Mega | $199/mês | 500.000 |
Chaves e cobrança são gerenciadas pela RapidAPI. Obtenha a sua →
Links
- Obtenha uma chave de API (listagem no RapidAPI)
- Página inicial do Filingrail
- SDK Python (síncrono + assíncrono) —
pip install filingrail - Página de status da API
- Perguntas / problemas:
support@hudsonenterprisesllc.com
Licença
MIT © Hudson Enterprises LLC