mcp-mercado-financeiro-brasil

🚧 En construcción (Fase 1). Proyecto en desarrollo activo — la API de las herramientas y el catálogo de fuentes aún pueden cambiar. Úsalo con cautela y sigue el roadmap a continuación.

Servidor MCP (Model Context Protocol) que conecta asistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf) a datos del mercado financiero brasileño mediante fuentes públicas. Núcleo sin registro, async, con caché y degradación elegante.

Aviso: contenido informativo/educativo. No constituye una recomendación de inversión. La rentabilidad pasada no garantiza resultados futuros.

Herramientas (Fase 1)

Fuentes: BACEN SGS, BACEN PTAX (Olinda), Tesouro Transparente — todas sin clave. Acciones/FIIs (brapi.dev) y cripto (CoinGecko) llegan en las fases 2/3 como opcionales vía token.

Related MCP server: mcp-meelion

Instalación

# 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"]
    }
  }
}

Desarrollo

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

Variables de entorno (opcionales)

Licencia

MIT