mcp-mercado-financeiro-brasil

🚧 Em construção (Fase 1). Projeto em desenvolvimento ativo — a API das tools e o catálogo de fontes ainda podem mudar. Use com cautela e acompanhe o roadmap abaixo.

Servidor MCP (Model Context Protocol) que conecta assistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf) a dados do mercado financeiro brasileiro via fontes públicas. Núcleo zero-cadastro, async, com cache e degradação graciosa.

AVISO: conteúdo informativo/educativo. Não constitui recomendação de investimento. Rentabilidade passada não garante resultados futuros.

Ferramentas (Fase 1)

Fontes: BACEN SGS, BACEN PTAX (Olinda), Tesouro Transparente — todas sem chave. Ações/FIIs (brapi.dev) e cripto (CoinGecko) chegam nas fases 2/3 como opcionais via token.

Related MCP server: mcp-meelion

Instalação

# execução efêmera (recomendado)
uvx mcp-mercado-financeiro-brasil

# ou permanente
pip install mcp-mercado-financeiro-brasil

Claude Desktop / Cursor

{
  "mcpServers": {
    "mercado-financeiro-brasil": {
      "command": "uvx",
      "args": ["mcp-mercado-financeiro-brasil"]
    }
  }
}

Desenvolvimento

uv sync --extra dev
uv run pytest          # testes unitários (mockados)
uv run pytest -m integration  # testes que batem nas APIs reais
uv run ruff check .
uv run mypy src

Variáveis de ambiente (opcionais)

Licença

MIT