Dados B3 — MCP-Server (brasilianischer Aktienmarkt, prüfbare Fundamentaldaten)

Portugiesisch unten

Ein MCP-Konnektor, der Ihrem KI-Agenten (Claude, ChatGPT, Cursor und anderen) Zugriff auf Fundamentaldaten brasilianischer börsennotierter Unternehmen (B3) — einschließlich Banken und Versicherern — von 2010 bis heute bietet, mit einer vollständig veröffentlichten Methodik: ROE, ROIC, Margen, Wachstum, Nettoverschuldung/EBITDA, Point-in-Time-Kennzahlen (KGV, KBV, EV/EBITDA mit dem Kurs der ersten Handelssitzung nach der tatsächlichen Veröffentlichung des Berichts — ohne Look-ahead, für Backtests geeignet), Dividenden und Dividendenrendite, fertige Scores (Piotroski F-Score und Graham) sowie ein Verzeichnis neu eingereichter Berichte.

Quellen: Offene Daten der CVM (ODbL) und B3 (COTAHIST). Jede Zahl trägt das CVM-Konto, aus dem sie stammt, und nichts wird veröffentlicht, ohne dass eine Reihe von Invariantentests bestanden wird — die Bilanz geht auf, die Gewinn- und Verlustrechnung stimmt überein, und ein Kurs geht niemals der Veröffentlichung voraus, die ihn rechtfertigt.

Produkt und Pläne: https://dadosb3.com

Verwendung 1 — Remote (nichts zu installieren, empfohlen)

Fügen Sie diesen Remote-Konnektor zu Ihrem KI-Client hinzu:

https://dadosb3.com/mcp/

In Claude: Einstellungen → Konnektoren → benutzerdefinierten Konnektor hinzufügen → URL einfügen.

Related MCP server: brdata-mcp

Verwendung 2 — Lokal (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" }
    }
  }
}

Verwendung 3 — Docker-Image (ein Befehl, kein lokales 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"]
    }
  }
}

Das Image wird bei jedem Push auf main veröffentlicht (.github/workflows/publicar-imagem.yml). Es existiert aus zwei Gründen: ein Installationspfad mit einem einzigen Befehl und die Möglichkeit für MCP-Verzeichnisse, den Server tatsächlich auszuführen, um ihn zu bewerten.

Werkzeuge

WEGE3 und die gesamte Methodik sind offen, kein Schlüssel erforderlich. Für andere Unternehmen erstellen Sie einen kostenlosen Schlüssel (200 Abfragen/Tag, keine Karte) oder abonnieren Sie Pro unter https://dadosb3.com und übergeben Sie ihn im Argument chave_api oder in der Umgebungsvariable DADOS_B3_API_KEY.

Die Anzahl der Unternehmen wird hier bewusst nicht angegeben: Das Universum wächst, wann immer die CVM veröffentlicht, und eine in einem README eingefrorene Zahl altert, ohne dass es jemand bemerkt. Rufen Sie saude für die heutige Zahl auf.

Banken und Versicherer

Finanzinstitute melden nach einem anderen Kontenplan — es gibt kein EBIT und keine Umsatzerlöse. Der Konnektor klassifiziert sie nach ihrem tatsächlichen Kontenplan und liefert die Indikatoren, die für sie von Bedeutung sind — ROE, Marge, Wachstum, KGV, KBV, Dividenden — und veröffentlicht für sie bewusst kein ROIC, EBITDA oder EV/EBITDA, da diese nicht anwendbar sind. Beispiele: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Warum dieser

Eine Methodik, die veröffentlicht statt beschrieben wird, Invariantentests, die jede Veröffentlichung absichern, Kennzahlen ohne Einblick in zukünftige Informationen, und Neu einreichungen bleiben dokumentiert — wenn ein Unternehmen einen Bericht neu veröffentlicht, bleiben beide Versionen nebeneinander bestehen. Ein ehrlicher Vergleich, auch dort, wo Wettbewerber besser sind: https://dadosb3.com/comparativo

Lizenz

MIT (dieser Konnektor). Die zugrunde liegenden Daten sind öffentlich (CVM/B3); der Dienst ergänzt Standardisierung, Methodik und Tests.

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.