FinData MCP

FinData MCP

Dados do mercado de ações, fundamentos de empresas, indicadores macroeconômicos do FRED, arquivos da SEC EDGAR e preços de criptomoedas para agentes de IA — tudo em um único servidor MCP. Teste grátis: 50 chamadas/dia. Pagamento por uso: $0,01/chamada via micropagamentos x402 na Base. Sem cadastro, sem chave de API.

Dados financeiros para agentes de IA. Cinco ferramentas que cobrem preços de ações em tempo real (NYSE, NASDAQ, mais de 50.000 tickers), fundamentos de ações (índice P/L, lucros, capitalização de mercado), mais de 800.000 séries econômicas do FRED (PIB, IPC, inflação, taxas de juros, rendimentos de títulos do Tesouro), arquivos da SEC EDGAR (relatórios anuais 10-K, 10-Q, 8-K) e preços de criptomoedas (Bitcoin, Ethereum, mais de 8.000 moedas). Funciona com Claude Desktop, Cursor, Windsurf e qualquer cliente MCP.

Início Rápido

Instalação:

pip install findata-mcp

Defina sua chave de carteira (qualquer carteira EVM com USDC na Base):

export EVM_PRIVATE_KEY=your_private_key_here

Adicione ao Claude Desktop — edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "findata-mcp": {
      "command": "findata-mcp",
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Adicione ao Cursor — edite .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "findata-mcp": {
      "command": "findata-mcp",
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Reinicie seu cliente. Agora você tem cinco ferramentas de dados financeiros disponíveis.

---

Ferramentas

Ferramenta	O que retorna	Cache
stock_quote(ticker)	Preço, volume, variação %, capitalização de mercado	1 min
company_fundamentals(ticker)	Receita, P/L, setor, beta, rendimento de dividendos, descrição	1 hr
economic_indicator(series_id)	Mais de 800.000 séries do FRED (PIB, IPC, taxas, curvas de rendimento)	6 hr
sec_filing(ticker, form_type)	Texto completo de 10-K, 10-Q, 8-K da SEC EDGAR	24 hr
crypto_price(coin_id)	Preço, capitalização de mercado, volume em 24h, gráfico de 7 dias	1 min

---

Exemplos

Obter uma cotação de ação

stock_quote(ticker="NVDA")

{
  "ticker": "NVDA",
  "price": 878.35,
  "change": 12.40,
  "change_pct": 1.43,
  "volume": 41200000,
  "market_cap": 2150000000000,
  "currency": "USD"
}

Consultar fundamentos de uma empresa

company_fundamentals(ticker="AAPL")

{
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "sector": "Technology",
  "market_cap": 3280000000000,
  "pe_ratio": 33.2,
  "revenue": 383285000000,
  "beta": 1.24,
  "dividend_yield": 0.0044
}

Verificar um indicador econômico

economic_indicator(series_id="FEDFUNDS")

{
  "series_id": "FEDFUNDS",
  "title": "Federal Funds Effective Rate",
  "units": "Percent",
  "frequency": "Monthly",
  "latest_value": 4.33,
  "latest_date": "2026-02-01"
}

Séries FRED comuns: GDP, CPIAUCSL (inflação), UNRATE (desemprego), DGS10 (título do Tesouro de 10 anos), FEDFUNDS.

Ler um arquivo da SEC

sec_filing(ticker="AAPL", form_type="10-K")

{
  "ticker_or_cik": "AAPL",
  "form_type": "10-K",
  "filing_date": "2025-11-01",
  "document_url": "https://www.sec.gov/Archives/...",
  "content": "UNITED STATES SECURITIES AND EXCHANGE COMMISSION..."
}

Também aceita ticker_or_cik (legado) ou symbol como aliases para ticker.

---

Preços

$0,01 por chamada. Sem cadastro, sem chaves de API, sem taxas mensais.

O pagamento acontece automaticamente via x402 — um protocolo aberto de micropagamentos. Seu cliente MCP assina uma transferência de USDC na mainnet da Base para cada chamada. Você precisa de:

1. Uma chave privada de carteira EVM (definida como EVM_PRIVATE_KEY)
2. Um pequeno saldo de USDC na mainnet da Base (~$1 cobre 100 chamadas)

É isso. Sem contas, sem limites de taxa, sem páginas de cobrança.

---

Como Funciona

O pacote pip install é um servidor MCP stdio leve. Ele encaminha suas chamadas de ferramentas para um backend hospedado, lidando automaticamente com a assinatura de pagamento x402. Os dados vêm de Yahoo Finance, FRED, SEC EDGAR e CoinGecko.

Your AI agent  →  findata-mcp (local stdio)  →  Backend (Railway)  →  Data providers
                  signs x402 payment              verifies payment

---

Configuração

Variável	Obrigatória	Padrão	Descrição
EVM_PRIVATE_KEY	Sim	—	Chave privada da carteira com USDC na Base
FINDATA_BACKEND_URL	Não	URL de produção	Substituição para backend auto-hospedado

---

Métodos Alternativos de Instalação

uvx (sem necessidade de instalação):

uvx findata-mcp

---

Status de Distribuição

• PyPI: findata-mcp
• Smithery: ao vivo
• Glama: ao vivo
• mcp.so: ao vivo

Licença

MIT