프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Dados B3

제작자: Val7h버전 1.9.2i★ –i컴퓨터 또는 클라우드
레지스트리 이름io.github.Val7h/dados-b3

설치

개요

제작자가 쓴 설명(영어 원문)

Brazilian stocks (B3): 36 read-only tools for fundamentals, dividends, FIIs, ETFs, BDRs. Free.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 컴퓨터 또는 클라우드
  • 전송 방식: stdio, Streamable HTTP
  • 카테고리: 기타
  • 입력해야 할 값: DADOS_B3_API_KEY

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

웹, 데스크톱, 모바일의 Claude에서 쓸 수 있어요:

  1. Settings → Connectors 열기
  2. Add custom connector 누르기
  3. 아래 주소를 붙여 넣고 Add 누르기
  4. 로그인하라고 하면 제작자의 서비스에 로그인하기
SettingsConnectors1+ Add2https://…3
https://dadosb3.com/mcp/

또는 내 컴퓨터에서 실행하기

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DADOS_B3_API_KEY",
        "ghcr.io/val7h/dados-b3-mcp:1.9.2"
      ],
      "env": {
        "DADOS_B3_API_KEY": "your-value"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add --transport http dados-b3 https://dadosb3.com/mcp/

또는 내 컴퓨터에서 실행하기

claude mcp add dados-b3 --env DADOS_B3_API_KEY=your-value -- docker run -i --rm -e DADOS_B3_API_KEY ghcr.io/val7h/dados-b3-mcp:1.9.2

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "dados-b3": {
      "url": "https://dadosb3.com/mcp/"
    }
  }
}

또는 내 컴퓨터에서 실행하기

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DADOS_B3_API_KEY",
        "ghcr.io/val7h/dados-b3-mcp:1.9.2"
      ],
      "env": {
        "DADOS_B3_API_KEY": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "dados-b3": {
      "type": "http",
      "url": "https://dadosb3.com/mcp/"
    }
  }
}

또는 내 컴퓨터에서 실행하기

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "dados-b3": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DADOS_B3_API_KEY",
        "ghcr.io/val7h/dados-b3-mcp:1.9.2"
      ],
      "env": {
        "DADOS_B3_API_KEY": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요:

  1. 웹에서 ChatGPT 열기 → Settings → Connectors (Apps)
  2. Create 또는 Add 누르기(일부 요금제는 먼저 Advanced에서 Developer mode를 켜야 해요)
  3. 아래 주소를 붙여 넣고 이름을 정한 뒤 저장하기
  4. 로그인하라고 하면 제작자의 서비스에 로그인하기
SettingsConnectors1+ Create2https://…3
https://dadosb3.com/mcp/

메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

  • DADOS_B3_API_KEY 비밀 env
    Dados B3 API key. Optional: WEGE3 and the whole methodology are free without one. Create a free key (200 queries/day, no card) or subscribe at https://dadosb3.com.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 6일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • listar_empresas

    Lista as companhias abertas brasileiras (AÇÕES), com nome, CNPJ e ticker quando resolvido. A contagem vem na resposta — nunca escrita aqui, que é lida por clientes de IA e envelheceria sem ninguém ver. Só ações. Fundo imobiliário NÃO entra nesta lista: para FII use `fiis_ranking`

  • indicadores_anuais

    Série anual (2010–hoje) de ROIC, ROE, margens, crescimento e dívida líquida/EBITDA de uma AÇÃO da B3, com flags de qualidade. Só ações. Ticker de fundo imobiliário (terminado em 11, como MXRF11) NÃO se consulta aqui — FII não tem ROIC nem EBITDA, tem P/VP, DY e vacância: use `fii

  • multiplos

    Múltiplos ponto-no-tempo de uma AÇÃO (P/L, P/VP, EV/EBITDA anuais; P/L TTM trimestral) — preço do 1º pregão APÓS a publicação real do balanço, sem vazamento de informação futura. Só ações. Para o P/VP de um fundo imobiliário use `fii`, que o calcula sobre o informe mensal da CVM,

  • dividendos

    Histórico de proventos em dinheiro (dividendos e JCP) de uma empresa da B3: valor por ação, data de aprovação, data-com, preço na data-com, parcela e data de pagamento, mais resumo anual e dividend yield 12 meses (com o total do ano corrente até hoje e do ano anterior fechado). A

  • precos

    Série DIÁRIA de preços de uma AÇÃO numa chamada só (abertura, máxima, mínima, fechamento, médio, volume, quantidade, negócios), do COTAHIST da B3, do mais antigo ao mais recente. `de`/`ate` em AAAA-MM-DD recortam; `limite` (padrão 1500, máximo 20000) corta a partir do mais antigo

  • desempenho

    Desempenho de uma AÇÃO num período em POUCOS números, calculado no servidor: retorno, drawdown máximo (com as datas) e volatilidade do comprar-e-manter, e o mesmo para um cruzamento de médias móveis (padrão 21 × 100). Padrão: últimos 5 anos. Preço AJUSTADO por eventos societários

  • indice

    Índices da B3 (IBOV, IFIX, SMLL, IDIV, IBXX...): o benchmark para comparar um papel ou uma estratégia. Padrão: o DESEMPENHO do índice num período (retorno, queda máxima, volatilidade; comprar e manter e cruzamento de médias 21 × 100), últimos 5 anos, ABERTO sem chave. `serie=True

  • acessos_telecom

    Acessos de telefonia móvel e de banda larga fixa por operadora, mês a mês (Anatel, dados abertos; licença CC BY-ND 3.0 declarada pela Anatel, uso acertado com o órgão e informado pelo dono em 01/11/2026). ABERTO, sem chave. Sem argumentos: o ranking de cada serviço no mês consoli

  • tesouro_direto

    Taxas e preços diários dos títulos do Tesouro Direto (Tesouro Nacional, Tesouro Transparente, ODbL 1.0), desde 31/12/2004: a curva de juros pública por vencimento. ABERTO, sem chave. Sem argumentos: todos os títulos no dia-base mais recente. `titulo` (selic, prefixado, prefixado-

  • producao_petroleo_gas

    Produção de petróleo e gás natural por operador e por campo (ANP, dados abertos, licença declarada CC BY-ND 3.0, uso acertado com a ANP). ABERTO, sem chave. Taxa MÉDIA DIÁRIA do mês: petróleo em bbl/dia, gás em Mm³/dia (mil m³). Sem argumentos: os operadores do último mês da base

  • tarifas_energia

    Tarifa residencial de energia elétrica por distribuidora (ANEEL, dados abertos, ODbL 1.0), desde 2010: TUSD e TE em R$/MWh, SEM tributos (ICMS, PIS e COFINS ficam de fora), subgrupo B1 convencional. ABERTO, sem chave. Sem argumentos: a tarifa mais recente de cada distribuidora, c

  • fundos_investimento

    Fundos de investimento registrados na CVM (renda fixa, multimercado, ações, cambial; ~25 mil), do Informe Diário da CVM (dados abertos, ODbL 1.0): cota, patrimônio líquido (PL), cotistas e captação e resgate do mês. ABERTO, sem chave. Sem argumentos: no mês de referência (o mais

  • quanto_rendeu

    Quanto viraram R$ 1.000 numa AÇÃO, FII ou ETF há 1, 3, 5 e 10 anos: só com o preço e com os proventos reinvestidos, contra o Ibovespa (IFIX no FII) e a meta Selic, até o último fechamento. São EXATAMENTE os números da página https://dadosb3.com/quanto-rendeu/{ticker} (cada janela

  • fundos_da_acao

    Quais FUNDOS DE INVESTIMENTO têm uma AÇÃO na carteira e quanto (valor e quantidade), e quem aumentou ou reduziu a posição no último mês disponível: a Composição e Diversificação das Aplicações (CDA) que os fundos entregam à CVM (bloco de ações; 13 meses). `limite` (1 a 500, padrã

  • bancos

    Indicadores dos BANCOS listados, do IF.data do Banco Central (conglomerado prudencial, ODbL 1.0): índice de Basileia, inadimplência acima de 90 dias, ativos problemáticos, carteira de crédito, lucro e patrimônio. Sem `ticker`: o ÚLTIMO trimestre de cada banco, na ordem do tamanho

  • saiu_da_bolsa

    Companhias que SAÍRAM DA BOLSA (deixaram de ser negociadas na B3), por ano do ÚLTIMO PREGÃO: as que tiveram o registro de companhia aberta cancelado na CVM (com data e motivo da CVM) e as que pararam de negociar com o registro ainda ativo (mudança para fora, fusão, OPA: JBS, BRF,

  • bdr

    BDRs negociados na B3 (recibos em reais de ações ou ETFs listados lá fora: AAPL34, NVDC34, IVVB39...). `ticker=""` LISTA os BDRs que negociaram no último ano, com tipo (DRN não patrocinado; DR1/DR2/DR3 patrocinado nível I/II/III; DRE BDR de ETF), último fechamento e liquidez médi

  • eventos

    Desdobramentos, grupamentos, bonificações e CISÕES de uma empresa, com a FONTE de cada um (declarado pela B3 ou achado por nós) e o que o preço disse (confirmou, não distingue, discorda). Eventos do mesmo dia são uma operação: `efeito_liquido_do_dia` é o multiplicador do grupo (0

  • scores

    Scores fundamentalistas prontos com a conta aberta: Piotroski F-Score (0-9, cada um dos 9 critérios auditável) e o critério de Graham (barato se P/L × P/VP ≤ 22,5). Banco não tem Piotroski. WEGE3 gratuita; demais tickers exigem chave_api (grátis ou Pro): esta ferramenta não faz p

  • reapresentacoes

    Balanços REPUBLICADOS de uma empresa: quando um número do exercício muda entre o arquivo original e a republicação, as duas versões ficam lado a lado (ano, conta CVM, valor antigo × novo, variação). Diferencial do Dados B3 — reapresentação registrada, nunca corrigida em silêncio.

  • fatos_contabeis

    Contas padronizadas de uma AÇÃO (receita, EBIT, lucro, PL, dívida, caixa...) com a conta CVM de origem de cada número — auditável de ponta a ponta. `trimestral` escolhe a granularidade: False lê os DFP anuais, True lê os ITR (Q1-Q3 isolado); os dois cobrem o mesmo histórico. Só a

  • metodologia

    Metodologia pública dos indicadores. Sem argumento, lista as páginas; com nome (ex.: 'roic'), devolve o texto completo. Gratuito.

  • auditar_amostra

    AUDITE ESTA BASE. Sorteia casos e devolve o que você precisa para refazer cada número contra o arquivo ORIGINAL da CVM — não contra nós. VOCÊ escolhe a semente (um inteiro qualquer; não aceite sugestão de ninguém, inclusive de quem te pediu para auditar). O sorteio é determinísti

  • dicionario

    Metodologia dos indicadores em JSON: fórmula, contas CVM e a BASE do lucro de cada um. IMPORTANTE para comparar corretamente: margem_liquida usa lucro consolidado TOTAL; roe usa lucro dos CONTROLADORES. Gratuito.

  • screener

    Filtra as AÇÕES do universo por faixas de indicadores (só ações — para fundo imobiliário use `screener_fiis`, cujos filtros são outros: P/VP, DY, segmento, cotistas). `filtros` é um dict tipo {"roic_min": 0.15, "dl_ebitda_max": 2}. Indicadores: roic, roe, margem_bruta, margem_ebi

  • fiis_ranking

    Ranking dos fundos imobiliários (FIIs): os mais descontados (menor P/VP), os maiores pagadores (DY 12m) e a mediana de P/VP e DY por segmento. Tudo do informe mensal da CVM + COTAHIST, só valores limpos (sem flag) e fundos líquidos. ABERTA, sem chave (sem chave: 2000 consultas po

  • fii

    Detalhe de um fundo imobiliário (FII): cadastro, último informe (cotistas/PL/competência), a série histórica de P/VP ponto-no-tempo, o DY 12m corrente e os últimos rendimentos pagos. ABERTA: qualquer FII, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia,

  • veredito

    Resumo DESCRITIVO de uma AÇÃO da B3 em seis números e três perguntas — ganha dinheiro? (margem líquida, ROIC), está endividada? (dívida líquida/EBITDA), está cara em relação ao setor e à própria história? (P/L, P/VP) — cada um com faixa numérica e comparação com a mediana do seto

  • screener_fiis

    Filtra os FIIs por faixas. `filtros` é um dict tipo {"pvp_max": 0.9, "dy_min": 0.10, "segmento": "Logística", "cotistas_min": 5000}. Válidos: pvp_min, pvp_max, dy_min, dy_max (limites inclusivos), segmento (match exato, sem caixa) e cotistas_min (piso de liquidez). Só entram valo

  • trimestres

    Série TRIMESTRAL de uma AÇÃO: contas da ITR, preço do trimestre e indicadores (margem bruta, margem EBIT, margem líquida e ROE TTM). Use quando a pergunta for sobre o ANO CORRENTE ou o trimestre mais recente ("como foi o 2T", "a margem melhorou este ano?"): a série anual só respo

  • hoje

    O que mudou no mercado brasileiro nos últimos 30 dias. Responde "o que aconteceu com a empresa X esta semana" — a pergunta que nenhuma série anual responde. Traz, na janela: os balanços que ficaram públicos (com a data de entrega à CVM), os documentos REENVIADOS (a companhia repu

  • fatos_relevantes

    Os últimos Fatos Relevantes (ou Comunicados ao Mercado) que as companhias entregaram à CVM, do mais recente para o mais antigo, cada um com a companhia, o assunto (texto livre da companhia), a data de entrega, o protocolo e o LINK DO DOCUMENTO ORIGINAL na CVM. `ticker` filtra por

  • saude

    Cobertura atual do banco (contagens e última ingestão). Gratuito.

  • etfs_ranking

    ETFs listados na B3: mais negociados, maior patrimônio, maior deságio e maior ágio sobre a cota (preço ÷ cota do MESMO dia), retorno de 12 meses pela cota (retorno total por construção) e menor taxa EFETIVA (despesa do balancete ÷ PL médio, anualizada — a nominal não existe em fo

  • etf

    Detalhe de um ETF: cadastro (CVM + B3), último informe diário (cota, patrimônio, cotistas), ágio/deságio dos últimos 30 pregões, taxa efetiva mês a mês, carteira mais recente (10 maiores) e sobreposição com ETFs do mesmo índice, retornos pela cota e pelo preço. BOVA11 é o ETF abe

  • listas

    A LISTA COM DATA PRONTA, sem montar nada: devolve o ranking já calculado, com o nome, a DATA-BASE, o critério (liquidez de R$ 5 milhões por dia em 63 pregões, teto de 30% de DY, 5.000 cotistas...), as linhas (ticker, valores), a fonte e a `source_url` da página canônica para cita

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 Val7h 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • ✓ 통과

    엔드포인트 응답

    191ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 36개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

기타 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 32684개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 32684개 중 93%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 32684개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Dados B3, 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: DADOS_B3_API_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.9.2)은 그저께 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Master CSS

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트
설치

Remote Desktop Commander

제작자: desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

클라우드에서 실행★ 211그저께 업데이트
설치

Master CSS

제작자: master-co

Inspect Master CSS classes, generated CSS, and project stylesheets from your AI client.

내 컴퓨터에서 실행오늘 업데이트
설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

Dados B3 — MCP server for the Brazilian stock market (B3)

Official site: https://dadosb3.com/?de=github · Remote MCP endpoint: `https://dadosb3.com/mcp/` · Methodology · Connection guide · llms.txt

*Português abaixo*

dadosb3.com is the only official address of the project. The old address on onrender.com is

retired; anything that still points there is out of date.

Keywords: B3, Bovespa, Brazilian stock market, Brazilian stocks (ações brasileiras), dividends (dividendos, proventos), FII (Brazilian REITs, fundos imobiliários), ETFs, BDRs, CVM filings, delisted companies (deslistagem), fundamentals, point-in-time multiples, MCP, Model Context Protocol.

At a glance (checked against the live server on 2026-11-06)

Remote serverhttps://dadosb3.com/mcp/ (Streamable HTTP), 36 read-only tools
Coverageevery company with CVM filings (DFP/ITR), 2010 to today, banks and insurers included; FIIs, ETFs, BDRs, B3 indices, Tesouro Direto, macro series; companies that left the exchange, with their last trading day, CVM status and dividends paid before leaving (list)
Updatesend-of-day prices (B3 COTAHIST) and dividends every trading night; CVM filings as the CVM publishes them. Live proof: saude / dadosb3.com/saude
Without a keyany ticker, one at a time: annual indicators, multiples, CVM accounts, dividends, FIIs, FII ranking, total return (desempenho), veredito, ETF ranking, methodology. Limit: 60 queries/hour and 150/day per IP; AI assistants (ChatGPT, Claude, Perplexity, this MCP connector) get their own allowance of 2,000/hour and 20,000/day
With a free key200 queries/day, no card: adds scores, restatements, quarterly series, full daily prices, corporate events, ETF detail and the screeners (get a key)
ProR$ 49.90/month, 10,000 queries/day and the whole base as CSV (plans)
Not coveredintraday or real-time quotes, prices before 2010, investment advice

Methodology and lineage

Every number carries the CVM account it came from. Each indicator page links down to the line of the CVM file, e.g. ITUB4 ROE 2025. Formulas: methodology and the JSON dictionary. Audit it yourself with your own seed: dadosb3.com/auditoria (or the auditar_amostra tool). Invariant tests run before every release: transparency page.

Example questions

  • "How much did PETR4 pay in dividends over the last 12 months, with ex-dates?" → dividendos
  • "Which companies left B3 in 2026, and what did they pay before leaving?" → saiu_da_bolsa, dividendos
  • "Itaú's 2025 ROE, with the CVM accounts behind it" → indicadores_anuais
  • "FIIs with the highest 12-month yield and P/B below 1" → fiis_ranking, fii
  • "Was WEGE3 worth it over 5 years, against the Ibovespa and Selic?" → desempenho
  • "What did R$ 1,000 in ITUB4 return?" → quanto_rendeu

What it is

An MCP connector that gives your AI agent (Claude, ChatGPT, Cursor and others) access to fundamentals for Brazilian listed companies (B3) — banks and insurers included — from 2010 to today, with a fully published methodology: ROE, ROIC, margins, growth, net debt/EBITDA, point-in-time multiples (P/E, P/B, EV/EBITDA priced at the first trading session *on or after* the day the filing actually became public — no look-ahead, usable for backtests), dividends and dividend yield, ready-made scores (Piotroski F-Score and Graham) and a record of restated filings.

Sources: CVM open data (ODbL) and B3 (COTAHIST). Every figure carries the CVM account it came from, and nothing is published unless a suite of invariant tests passes — the balance sheet balances, the income statement reconciles, and a price never precedes the filing that justifies it.

Product and plans: https://dadosb3.com/?de=github

Use 1 — remote (nothing to install, recommended)

Add this remote connector to your AI client:

https://dadosb3.com/mcp/

In Claude: Settings → Connectors → add custom connector → paste the URL.

The remote server exposes 36 read-only tools (most of them work without a key). Beyond the table below it also serves bancos, fatos_relevantes, fundos_da_acao, fundos_investimento, listas, producao_petroleo_gas, quanto_rendeu, saiu_da_bolsa, screener_fiis, tarifas_energia, acessos_telecom and tesouro_direto. The local builds in Use 2 and Use 3 run the subset in the table. Open pages without a key: https://dadosb3.com/claude-code?de=github (Claude Code guide) and the list under "Open pages, no key".

Use in Claude Code (plugin)

This repository is a Claude Code plugin marketplace with one plugin, dados-b3. The plugin registers the remote server https://dadosb3.com/mcp and adds a skill that tells Claude when to use it and to cite the dadosb3.com page each answer comes from.

In a Claude Code session (v2.1.275 or later), one command:

/plugin install dados-b3 --marketplace Val7h/dados-b3-mcp

Or in two steps:

/plugin marketplace add Val7h/dados-b3-mcp

/plugin install dados-b3@dados-b3

From your shell, without a session:

claude plugin marketplace add Val7h/dados-b3-mcp

claude plugin install dados-b3@dados-b3

Without the plugin (only the MCP server, no skill):

claude mcp add --transport http dados-b3 https://dadosb3.com/mcp

The free tools need no key. Prices are end-of-day, not real-time quotes, and the answers are past data, not investment advice. Guide: https://dadosb3.com/claude-code?de=github

Use 2 — local (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" } } } }

Use 3 — Docker image (one command, no local 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"] } } }

The image is published on every push to main (.github/workflows/publicar-imagem.yml). It exists for two reasons: a one-command install path, and letting MCP directories actually run the server in order to evaluate it.

Tools

ToolWhat it doesFree?
listar_empresasEvery covered company (name, tax ID, ticker), banks and insurers includedyes
indicadores_anuaisROE, ROIC, margins, growth, net debt/EBITDA — annual series from 2010yes, any ticker (no-key limit above)
multiplosP/E, P/B, EV/EBITDA point-in-time; trailing P/Eyes, any ticker (no-key limit above)
fatos_contabeisStandardised accounts carrying the CVM code each figure came fromyes, any ticker (no-key limit above)
dividendosCash distributions, annual summary and 12-month dividend yieldyes, any ticker (no-key limit above)
scoresPiotroski F-Score with all nine criteria shown, plus the Graham testWEGE3 yes; others need a key
reapresentacoesRestated filings — the original and the revised figure side by sideWEGE3 yes; others need a key
trimestresQuarterly series: Q1/Q2/Q3 accounts as filed, the quarter's price, margins and trailing ROEWEGE3 yes; others need a key
etfs_rankingB3 ETFs: most traded, largest net assets, largest premium/discount to same-day NAV, 12m NAV return, lowest EFFECTIVE feeyes
etfOne ETF: daily NAV (FNET filing), premium/discount, monthly effective fee, portfolio (CDA) and overlap with peersBOVA11 yes; others need a key
auditar_amostraDraws cases with YOUR seed so you can recompute each figure against the CVM file (formula, account, where to look)yes
fiis_rankingMost discounted FIIs (point-in-time P/B), highest 12m yield and medians by segmentyes
hojeWhat changed in the last 30 days: filings published, filings re-sent, dividends, fund distributions, corporate actions, ticker changesyes
fiiOne real-estate fund: point-in-time P/B, 12-month yield, vacancy, recent distributionsyes, any fund
fiisFilters funds by P/B and dividend-yield rangeskey required
screenerFilters the whole market by indicator ranges; as_of answers what was PUBLIC on a date (no look-ahead); recibo=True freezes the answer at a permanent, citable addresskey required
reciboReads a frozen screener query: question, cut-off date, data version, result and its sha256yes
vereditoDescriptive summary of one stock: six numbers in three questions, each with its numeric band and comparison (sector median, the company's own history, the whole market), plus the data confidence flag — facts, never adviceyes, any stock
desempenho"Was it worth it?" in a few numbers, computed server-side: return, max drawdown, volatility and a 21 x 100 moving-average crossover vs buy-and-hold, on the split-adjusted price and, when dividends are recorded, the TOTAL return (dividends and JCP reinvested on the ex-date). Open for every tickeryes
desempenho_fiiThe same for a real-estate fund (price only; distributions only in the total return; a daily jump above 35% is flagged confiavel: false)yes
desempenho_etfThe same for an ETF (price only; a daily jump above 35% is flagged)yes
indiceThe benchmark: performance of a B3 index (IBOV, IFIX, SMLL...); empty code lists themyes
indice_precosDaily close of an index in points (30-session sample without a key)sample
bdrBDRs on B3: the list (open) or one BDR with returns, distributions in reais and splitslist yes; AAPL34
bdr_precosDaily prices of a BDR (30-session sample without a key)sample
precosThe DAILY price series of one stock (open, high, low, close, volume), oldest first, plus the corporate events of the period; not adjusted. Without a key, a 30-session SAMPLE with a notice of how to get it allWEGE3 yes; others sample, full needs a key
eventosSplits, reverse splits, bonus issues and spin-offs with the source of each (B3-declared or found by us) and the net effect of the dayWEGE3 yes; others need a key
dicionarioFormula, CVM accounts and earnings base of each indicator, as JSONyes
metodologiaThe published methodology pages, as textyes
saudeCurrent coverage and last ingestionyes

trimestres stops at Q3 on purpose. The interim filing (ITR) never carries a standalone fourth quarter — it can be derived as full year − nine months, and some do derive it. We do not: a figure we computed would sit in the same list as the figures the company reported, carrying the error of two filings and erasing the line between what was filed and what we calculated. For the closed year, ask for the annual series.

No key needed for the tools marked "yes": any ticker, one at a time, up to 60 queries/hour and 150/day per IP (AI assistants and this connector: 2,000/hour and 20,000/day). WEGE3 is open in every tool. For the tools that need a key, create a free key at https://dadosb3.com/chave-gratis?de=github (200 queries/day, no card) or subscribe to Pro at https://dadosb3.com/assinar?de=github (10,000/day), and pass it in the chave_api argume

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

PopNx에게 묻기