SECfinAPI

Os registros da SEC contêm os dados financeiros de todas as empresas públicas dos EUA — mas estão em XBRL, que é difícil de interpretar. Criei o **SECfinAPI** para padronizá-los em JSON limpo, e um **servidor MCP** para que assistentes de IA possam usá-los diretamente.

GitHub

Experimente este MCPPatrocinado

Documentação

secfinapi-mcp

Servidor MCP para SECfinAPI — dados financeiros padronizados do SEC EDGAR (demonstrações de resultados, balanços patrimoniais, fluxo de caixa, mais de 40 índices) como ferramentas para Claude, Cursor e outros assistentes de IA.

Pergunte ao seu assistente de IA coisas como "Qual é a tendência de receita da Apple?" ou "Compare as margens operacionais da MSFT e da GOOGL" — ele busca os dados ao vivo por meio do SECfinAPI.

Ele roda localmente na sua máquina e é um wrapper leve sobre a API REST do SECfinAPI. Sem servidor para hospedar, sem custo extra.

Configuração

Obtenha uma chave de API (gratuita) em https://www.secfinapi.com.
Adicione o servidor à configuração MCP do seu assistente de IA.

Claude Desktop

Abra Configurações → Desenvolvedor → Editar Config e adicione:

Quando publicado no npm:

{
  "mcpServers": {
    "secfinapi": {
      "command": "npx",
      "args": ["-y", "secfinapi-mcp"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Executando a partir do código-fonte (antes da publicação):

{
  "mcpServers": {
    "secfinapi": {
      "command": "node",
      "args": ["C:/path/to/sec-financial-mcp/dist/index.js"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Reinicie o Claude Desktop. As 6 ferramentas abaixo aparecem no menu de ferramentas (🔌).

Cursor / VS Code

Mesma estrutura de configuração nas configurações MCP do editor — command, args e a variável de ambiente SECFINAPI_KEY.

Ferramentas

Ferramenta	Retorna
`get_company_info`	Metadados da empresa + um link para seus arquivamentos no SEC EDGAR
`get_income_statement`	Demonstração de resultados padronizada (com datas de arquivamento)
`get_balance_sheet`	Balanço patrimonial padronizado
`get_cash_flow`	Demonstração de fluxo de caixa padronizada
`get_metrics`	Mais de 40 índices financeiros (ROE, ROIC, margens, crescimento…)
`list_companies`	Listar / pesquisar as empresas públicas dos EUA disponíveis

Variáveis de ambiente

Variável	Obrigatória	Padrão
`SECFINAPI_KEY`	sim	—
`SECFINAPI_BASE_URL`	não	a API de produção do SECfinAPI

Executar a partir do código-fonte

npm install
npm run build
SECFINAPI_KEY=your-key node dist/index.js

Publicação (mantenedor)

npm run build
npm publish

Licença

MIT