Dados B3 — MCP-сервер (бразильский фондовый рынок, проверяемые фундаментальные показатели)

Português abaixo

Коннектор MCP, который даёт вашему ИИ-агенту (Claude, ChatGPT, Cursor и другим) доступ к фундаментальным показателям бразильских публичных компаний (B3) — включая банки и страховщиков — с 2010 года по сегодняшний день, с полностью опубликованной методологией: ROE, ROIC, маржи, рост, чистый долг/EBITDA, множители на момент времени (P/E, P/B, EV/EBITDA по цене первой торговой сессии после фактической публикации отчётности — без look-ahead, пригодно для бэктестов), дивиденды и дивидендная доходность, готовые скоринги (Piotroski F-Score и Graham) и история пересмотренной отчётности.

Источники: открытые данные CVM (ODbL) и B3 (COTAHIST). Каждый показатель несёт счёт CVM, из которого он получен, и ничего не публикуется, пока не пройдёт набор инвариантных тестов — баланс сходится, отчёт о прибылях и убытках сходится, и цена никогда не предшествует отчёту, который её обосновывает.

Продукт и тарифы: https://dadosb3.com

Способ 1 — удалённый (ничего устанавливать не нужно, рекомендуется)

Добавьте этот удалённый коннектор в свой ИИ-клиент:

https://dadosb3.com/mcp/

В Claude: Настройки → Коннекторы → добавить пользовательский коннектор → вставьте URL.

Related MCP server: brdata-mcp

Способ 2 — локальный (stdio)

pip install -r requirements.txt
python server.py

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

Способ 3 — образ Docker (одна команда, без локального Python)

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

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

Образ публикуется при каждом push в main (.github/workflows/publicar-imagem.yml). Он существует по двум причинам: путь установки одной командой и возможность для каталогов MCP реально запустить сервер, чтобы оценить его.

Инструменты

WEGE3 и вся методология открыты, ключ не нужен. Для остальных компаний создайте бесплатный ключ (200 запросов в день, без карты) или оформите подписку Pro на https://dadosb3.com и передавайте его в аргументе chave_api или в переменной окружения DADOS_B3_API_KEY.

Количество компаний здесь намеренно не указано: вселенная растёт каждый раз, когда публикует CVM, а число, замороженное в README, устаревает незаметно для всех. Чтобы узнать сегодняшнее число, вызовите saude.

Банки и страховщики

Финансовые учреждения отчитываются по другому плану счетов — у них нет EBIT и нет выручки от продаж. Коннектор классифицирует их по фактическому плану счетов и возвращает показатели, которые для них имеют смысл, — ROE, маржа, рост, P/E, P/B, дивиденды — и намеренно не публикует для них ROIC, EBITDA или EV/EBITDA, поскольку они неприменимы. Примеры: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Почему именно этот

Методология опубликована, а не описана, инвариантные тесты контролируют каждый релиз, в множители не просачивается будущая информация, а пересмотры остаются в истории — когда компания переиздаёт отчёт, обе версии остаются рядом. Честное сравнение, в том числе там, где конкуренты лучше: https://dadosb3.com/comparativo

Лицензия

MIT (этот коннектор). Базовые данные являются публичными (CVM/B3); сервис добавляет стандартизацию, методологию и тесты.

Dados B3 — servidor MCP (bolsa brasileira, fundamentos auditáveis)

Conector MCP que dá ao seu agente de IA (Claude, ChatGPT, Cursor e outros) acesso a dados fundamentalistas das companhias abertas brasileiras (B3) — inclusive bancos e seguradoras —, de 2010 até hoje, com metodologia 100% pública: ROE, ROIC, margens, crescimento, dívida líquida/EBITDA, múltiplos ponto-no-tempo (P/L, P/VP, EV/EBITDA com o preço do 1º pregão após a publicação real do balanço — sem look-ahead, próprio para backtest), dividendos e dividend yield, scores prontos (Piotroski F-Score e Graham) e histórico de reapresentações de balanço.

Fonte: CVM (dados abertos, ODbL) e B3 (COTAHIST). Cada número carrega a conta CVM de origem; nada é publicado sem uma bateria de testes de invariantes passando (o balanço fecha, a DRE fecha, o preço nunca antecede a publicação).

Produto e planos: https://dadosb3.com

Uso 1 — remoto (nada para instalar, recomendado)

Adicione este conector remoto ao seu cliente de IA:

https://dadosb3.com/mcp/

No Claude: Configurações → Conectores → adicionar conector personalizado → cole a URL.

Uso 2 — local (stdio)

pip install -r requirements.txt
python server.py

Uso 3 — imagem Docker (um comando, sem Python local)

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

A imagem é publicada a cada push na main. Ela existe por dois motivos: dar um caminho de instalação de um comando só, e permitir que diretórios de MCP rodem o servidor para avaliá-lo.

Ferramentas

A empresa WEGE3 e a metodologia são abertas para degustação, sem chave. Para as demais, crie uma chave grátis (200 consultas/dia, sem cartão) ou assine o Pro em https://dadosb3.com e passe a chave no argumento chave_api (ou na variável DADOS_B3_API_KEY).

A contagem de empresas não fica escrita aqui de propósito: o universo cresce quando a CVM publica, e um número congelado num README envelheceria sem ninguém ver. Para o número de hoje, chame saude.

Bancos e seguradoras

Instituições financeiras têm plano de contas próprio (não há EBIT nem receita de venda). O conector as classifica pelo plano de contas real e entrega os indicadores que fazem sentido — ROE, margem, crescimento, P/L, P/VP, dividendos — e não publica ROIC/EBITDA/EV-EBITDA para elas (não se aplicam). Ex.: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Por que este e não outro

Metodologia 100% pública, testes de invariantes antes de cada publicação, múltiplos sem vazamento de informação futura, e histórico de reapresentações registrado. Comparativo honesto, inclusive onde os concorrentes são melhores: https://dadosb3.com/comparativo

Licença

MIT (este conector). Os dados são públicos (CVM/B3); o serviço adiciona padronização, metodologia e testes.