convez.ai
MCP ServerFinanceiroIntermediário
michalperni11-gif

secfinapi-mcp

michalperni11-gif/secfinapi-mcp

Acesso a dados financeiros da SEC EDGAR para assistentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que conecta Claude e Cursor aos dados financeiros padronizados da SEC EDGAR via SECfinAPI. Fornece demonstrações financeiras (income statements, balance sheets, cash flow) e 40+ índices financeiros para análise de empresas públicas americanas em tempo real.

Instalação

$npx convez-ai michalperni11-gif/secfinapi-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
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise de tendências de receita e lucratividade de empresas públicas
  • Comparação de métricas financeiras entre concorrentes (margens, ROE, ROIC)
  • Pesquisa de balanços patrimoniais e fluxos de caixa standardizados
  • Suporte a decisões de investimento com dados de filing da SEC

Veredito

MCP server bem estruturado que democratiza acesso a dados financeiros SEC EDGAR para IA. Setup simples e cobertura abrangente de demonstrações e métricas, ideal para análise financeira automatizada em Claude/Cursor.

README

A tradução para o português deste README ainda está na fila.

secfinapi-mcp

MCP server for SECfinAPI — standardized SEC EDGAR financial data (income statements, balance sheets, cash flow, 40+ ratios) as tools for Claude, Cursor, and other AI assistants.

Ask your AI assistant things like "What's Apple's revenue trend?" or "Compare MSFT and GOOGL operating margins" — it fetches the data live through SECfinAPI.

It runs locally on your machine and is a thin wrapper over the SECfinAPI REST API. No server to host, no extra cost.

Setup

  1. Get an API key (free) at https://www.secfinapi.com.
  2. Add the server to your AI assistant's MCP config.

Claude Desktop

Open Settings → Developer → Edit Config and add:

Once published to npm:

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

Running from source (before publishing):

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

Restart Claude Desktop. The 6 tools below appear under the tools (🔌) menu.

Cursor / VS Code

Same config shape in the editor's MCP settings — command, args, and the SECFINAPI_KEY env var.

Tools

ToolReturns
get_company_infoCompany metadata + a link to its filings on SEC EDGAR
get_income_statementStandardized income statement (with filing dates)
get_balance_sheetStandardized balance sheet
get_cash_flowStandardized cash flow statement
get_metrics40+ financial ratios (ROE, ROIC, margins, growth…)
list_companiesList / search the available US public companies

Environment variables

VariableRequiredDefault
SECFINAPI_KEYyes—
SECFINAPI_BASE_URLnothe SECfinAPI production API

Run from source

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

Publishing (maintainer)

npm run build
npm publish

License

MIT

Ver o original no GitHub

Bom para

Relacionados