Datos B3 — servidor MCP (bolsa brasileña, fundamentos auditables)

Conector MCP que da a su agente de IA (Claude, ChatGPT, Cursor y otros) acceso a datos fundamentalistas de 400+ compañías abiertas brasileñas (B3) — incluyendo bancos y aseguradoras —, de 2010 hasta hoy, con metodología 100% pública: ROE, ROIC, márgenes, crecimiento, deuda neta/EBITDA, múltiplos punto-en-el-tiempo (P/L, P/VP, EV/EBITDA con el precio del 1er pregón después de la publicación real del balance — sin look-ahead, apto para backtest), dividendos y dividend yield, scores listos (Piotroski F-Score y Graham) e historial de reexpresiones de balance.

Fuente: CVM (datos abiertos, ODbL) y B3 (COTAHIST). Cada número lleva la cuenta CVM de origen; nada se publica sin que pase una batería de pruebas de invariantes (el balance cuadra, el DRE cuadra, el precio nunca antecede a la publicación). Producto y planes: https://dadosb3.com

Uso 1 — remoto (nada que instalar, recomendado)

Añada este conector remoto a su cliente de IA:

https://dadosb3.com/mcp/

En Claude: Configuración → Conectores → añadir conector personalizado → pegue la URL.

Related MCP server: brdata-mcp

Uso 2 — local (stdio)

pip install -r requirements.txt
python server.py

Config de ejemplo para un cliente MCP local:

{
  "mcpServers": {
    "dados-b3": {
      "command": "python",
      "args": ["server.py"],
      "env": { "DADOS_B3_API_KEY": "sua_chave_opcional" }
    }
  }
}

Uso 3 — imagen Docker (un comando, sin Python local)

docker run -i --rm -e DADOS_B3_API_KEY=sua_chave_opcional ghcr.io/val7h/dados-b3-mcp:latest

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/val7h/dados-b3-mcp:latest"]
    }
  }
}

La imagen se publica automáticamente en cada push a main (.github/workflows/publicar-imagem.yml). Existe por dos motivos: dar un camino de instalación de un solo comando, y permitir que los directorios de MCP ejecuten el servidor para evaluarlo — sin un paquete instalable declarado, no pueden siquiera iniciarlo.

Herramientas

La empresa WEGE3 y la metodología están abiertas para degustación, sin clave. Para las demás, cree una clave gratis (200 consultas/día, sin tarjeta) o suscríbase al Pro (R$ 49,90/mes) en https://dadosb3.com y pase la clave en el argumento chave_api (o en la variable DADOS_B3_API_KEY).

Bancos y aseguradoras

Las instituciones financieras tienen su propio plan de cuentas (no hay EBIT ni ingreso de venta). El conector las clasifica por el plan de cuentas real y entrega los indicadores que tienen sentido — ROE, margen, crecimiento, P/L, P/VP, dividendos — y no publica ROIC/EBITDA/EV-EBITDA para ellas (no aplican). Ej.: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Por qué este y no otro

Metodología 100% pública, pruebas de invariantes antes de cada publicación, múltiplos sin fuga de información futura, e historial de reexpresiones registrado (cuando la empresa republica un balance, las dos versiones quedan lado a lado) — cosas que ninguna otra API de datos de la B3 hace. Comparativo honesto, incluso donde los competidores son mejores: https://dadosb3.com/comparativo

Licencia

MIT (este conector). Los datos son públicos (CVM/B3); el servicio añade estandarización, metodología y pruebas.