_ registry / mcp streamable-http · checked 41m ago

dados-b3

https://dadosb3.com

Registry code: e11e86fec62b1455

api record

Brazilian stock (B3) fundamentals: ratios, dividends, scores, REITs (FIIs), ETFs. Open methodology.

from a public catalogue that lists it, not from the operator

endpoint
https://dadosb3.com/mcp/
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is dados-b3 live?
Yes — it answered the hub's last check (checked 41m ago). It answered 98% of checks over the last 30 days.
Is dados-b3 free to use?
Yes — the hub reached it with no key and no payment.
What tools does dados-b3 have?
36 tools: indicadores_anuais, multiplos, dividendos, desempenho, fundos_da_acao, scores, auditar_amostra, fii, ….
Is dados-b3 safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
98%

90 days 98.1%· all time 98.1%

latency
683ms

last good check

priced tools
0

of 36 tools

_ answered our checks, 90 days 371 checks · signed record
  • degraded → live
  • live → degraded· HTTP 502
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
_ what it is for
topic
finance & markets stock & market data
used for
  • get brazilian stock fundamentals
  • screen b3 stocks and fiis
  • get dividend history
  • get daily price series
takes → gives
text, data → data
tools
23 reads
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 36 tools
18 open 18 never probed 18 of 36 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • indice open 16h ago

    Í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` devolve o fechamento DIÁRIO em pontos como colunas (`data`, `fechamento`): sem chave vem uma AMOSTRA dos últimos 30 pregões com `aviso`; com chave_api, a série inteira. `codigo=""` lista os índices disponíveis e a cobertura de cada um. Índice de RETORNO TOTAL (a B3 reinveste os proventos nos pontos); não é recomendação.

    mcp-tool

    {
  "type": "object",
  "title": "indiceArguments",
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = últimos 5 anos."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Fim do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = até o último pregão."
    },
    "serie": {
      "type": "boolean",
      "title": "Serie",
      "default": false,
      "description": "False (padrão) = resumo; True = série diária em colunas. Sem chave_api a série vem como amostra dos últimos 30 pregões."
    },
    "codigo": {
      "type": "string",
      "title": "Codigo",
      "default": "IBOV",
      "description": "Código do índice B3: IBOV (padrão), IFIX, SMLL, IDIV, IBXX... Vazio = lista os índices disponíveis e a cobertura de cada um."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    },
    "media_curta": {
      "type": "integer",
      "title": "Media Curta",
      "default": 21,
      "description": "Média móvel curta, em pregões: inteiro de 1 a 1000, menor que media_longa (padrão 21)."
    },
    "media_longa": {
      "type": "integer",
      "title": "Media Longa",
      "default": 100,
      "description": "Média móvel longa, em pregões: inteiro de 1 a 1000, maior que media_curta (padrão 100)."
    }
  }
}
    arguments 48 lines
  • acessos_telecom open 6h ago

    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 consolidado, com a participação no total e a variação em 12 meses (contas nossas). `servico` (movel ou banda_larga) + `cnpj` (14 dígitos, ou TOTAL para a soma de todas as operadoras) devolve a SÉRIE MENSAL daquela operadora, recortada por `de`/`ate` (AAAA-MM). Telefonia móvel não conta M2M nem ponto de serviço (como o total oficial da Anatel). O mês mais novo é preliminar. O campo `ticker` só vem preenchido quando o CNPJ completo da operadora é o de uma empresa com papel negociado (Vivo/VIVT3, TIM/TIMS3); do contrário é nulo (a Claro não é listada). Número da Anatel somado por operadora por nós; a resposta traz a fonte, a licença, a atribuição e a citação. Não é recomendação de investimento.

    mcp-tool

    {
  "type": "object",
  "title": "acessos_telecomArguments",
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Primeiro mês da série, AAAA-MM (ex.: 2024-01)."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Último mês da série, AAAA-MM (ex.: 2025-06)."
    },
    "cnpj": {
      "type": "string",
      "title": "Cnpj",
      "default": "",
      "description": "CNPJ da operadora com 14 dígitos, ou TOTAL para a soma de todas. Use com `servico`."
    },
    "servico": {
      "type": "string",
      "title": "Servico",
      "default": "",
      "description": "Serviço: \"movel\" ou \"banda_larga\". Vazio = ranking dos dois; com `cnpj`, a série mensal."
    }
  }
}
    arguments 30 lines
  • tarifas_energia open 3h ago

    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, com a variação do total contra o reajuste anterior (conta nossa) e o resumo (mais barata, mediana, mais cara entre as que têm tarifa em vigor). `cnpj` (14 dígitos) devolve todas as vigências de UMA distribuidora, recortadas por `de`/`ate` (AAAA-MM-DD, início da vigência). O campo `ticker` só vem preenchido quando o CNPJ completo da distribuidora é o de uma empresa com papel negociado; do contrário é nulo, porque a distribuidora costuma ser subsidiária da companhia listada e o grupo não é deduzido pelo nome. Número da ANEEL; a resposta traz a fonte, a licença e a citação. Não é recomendação de investimento.

    mcp-tool

    {
  "type": "object",
  "title": "tarifas_energiaArguments",
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início de vigência mais antigo: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Início de vigência mais recente: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "cnpj": {
      "type": "string",
      "title": "Cnpj",
      "default": "",
      "description": "CNPJ da distribuidora com 14 dígitos; devolve todas as vigências dela."
    }
  }
}
    arguments 24 lines
  • fundos_investimento open 6h ago

    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 novo já fechado), os `limite` maiores fundos por PL, os que mais captaram e os que mais perderam (captação líquida = captação menos resgate, conta nossa). `cnpj` (14 dígitos, da classe ou do fundo): o nome, a classificação, o gestor e a série de 13 meses (foto do último dia informado de cada mês, soma do mês dos fluxos e a variação da cota no mês, conta nossa que NÃO é a rentabilidade oficial). `busca`: procura pelo nome (sem acento e sem caixa) ou pelo começo do CNPJ. O PL de todos os fundos não é somado (fundo de cotas contaria duas vezes). Número que o administrador informou à CVM; a resposta traz a fonte, a licença e a citação. Não é recomendação de investimento.

    mcp-tool

    {
  "type": "object",
  "title": "fundos_investimentoArguments",
  "properties": {
    "cnpj": {
      "type": "string",
      "title": "Cnpj",
      "default": "",
      "description": "CNPJ do fundo ou da classe com 14 dígitos; devolve a série de 13 meses."
    },
    "busca": {
      "type": "string",
      "title": "Busca",
      "default": "",
      "description": "Nome do fundo (sem acento e sem distinção de caixa) ou começo do CNPJ."
    },
    "limite": {
      "type": "integer",
      "title": "Limite",
      "default": 20,
      "description": "Quantidade de fundos em cada ranking (padrão 20)."
    }
  }
}
    arguments 24 lines
  • bancos open 6h ago

    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 da carteira de crédito (a mesma tabela de https://dadosb3.com/bancos). Com `ticker` (ITUB4, BBDC4, BBAS3, SANB11...): a série trimestral daquele banco. ABERTO, sem chave. Número publicado pelo Banco Central, sem recálculo (a inadimplência é a divisão de duas linhas dele). Não é recomendação de investimento.

    mcp-tool

    {
  "type": "object",
  "title": "bancosArguments",
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "default": "",
      "description": "Ticker de banco opcional, como ITUB4, BBDC4, BBAS3 ou SANB11. Vazio = todos os bancos, último trimestre."
    }
  }
}
    arguments 12 lines
  • bdr open 26h ago

    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édia — aberto; `tipo=` filtra. Com `ticker`: cadastro da B3, último pregão, rentabilidade com e sem proventos (1 mês a 10 anos, em reais, já com o câmbio), proventos por BDR em R$ e desdobramentos com a conferência pelo preço. `serie=True` devolve o fechamento DIÁRIO em colunas (sem chave, amostra dos últimos 30 pregões). AAPL34 é aberto; os demais exigem chave_api. NÃO tem o código da ação lá fora nem a proporção BDR:ação. Não é recomendação.

    mcp-tool

    {
  "type": "object",
  "title": "bdrArguments",
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Fim da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "tipo": {
      "type": "string",
      "title": "Tipo",
      "default": "",
      "description": "Filtro de tipo de BDR: DRN, DR1, DR2, DR3 ou DRE. Vazio = todos."
    },
    "serie": {
      "type": "boolean",
      "title": "Serie",
      "default": false,
      "description": "False (padrão) = resumo; True = série diária em colunas. Sem chave_api a série vem como amostra dos últimos 30 pregões."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "default": "",
      "description": "Ticker do BDR, como AAPL34, NVDC34 ou IVVB39. Vazio = lista os BDRs negociados no último ano."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 42 lines
  • fiis_ranking reads open 19h ago

    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 por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Traz `citacao`. O filtro em massa por faixas é `screener_fiis`, que exige chave.

    mcp-tool

    {
  "type": "object",
  "title": "fiis_rankingArguments",
  "properties": {
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 12 lines
  • fatos_relevantes open 10h ago

    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 companhia (ex.: PETR4); `categoria` é "Fato Relevante" ou "Comunicado ao Mercado". Cada item traz `frase`, uma sentença só descritiva. Sem resumo, sem leitura de impacto e sem recomendação. ATENÇÃO: a fonte são os dados abertos da CVM (ODbL), que a CVM atualiza SEMANALMENTE e que trazem a data, não a hora; o campo `fonte` diz quando o arquivo foi atualizado. Gratuito, sem chave. Traz `citacao`.

    mcp-tool

    {
  "type": "object",
  "title": "fatos_relevantesArguments",
  "properties": {
    "limite": {
      "type": "integer",
      "title": "Limite",
      "default": 20,
      "description": "Quantidade de documentos, inteiro de 1 a 100 (padrão 20), do mais recente ao mais antigo."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "default": "",
      "description": "Ticker de companhia opcional, como PETR4. Vazio = todas."
    },
    "categoria": {
      "type": "string",
      "title": "Categoria",
      "default": "Fato Relevante",
      "description": "Categoria: \"Fato Relevante\" (padrão) ou \"Comunicado ao Mercado\"."
    }
  }
}
    arguments 24 lines
  • listas open 10h ago

    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 citar. É a MESMA conta das páginas dadosb3.com/listas/...: use esta ferramenta em vez de ler uma página por ação para montar um ranking. `lista`: "dividendos" (as ações líquidas de maior dividend yield de 12 meses, uma classe por empresa), "pl" (ações líquidas com P/L abaixo de 10) ou "fiis" (FIIs de maior rendimento em 12 meses). Vazio devolve o catálogo das três. `limite`: de 1 a 20 linhas (padrão 20). ABERTA: sem chave (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Informação histórica, não é recomendação: a nota vem na resposta.

    mcp-tool

    {
  "type": "object",
  "title": "listasArguments",
  "properties": {
    "lista": {
      "type": "string",
      "title": "Lista",
      "default": "",
      "description": "Qual lista: \"dividendos\", \"pl\" ou \"fiis\". Vazio = o catálogo das três."
    },
    "limite": {
      "type": "integer",
      "title": "Limite",
      "default": 20,
      "description": "Quantidade de linhas, inteiro de 1 a 20 (padrão 20)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 24 lines
  • metodologia reads open 41m ago

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

    mcp-tool

    {
  "type": "object",
  "title": "metodologiaArguments",
  "properties": {
    "nome": {
      "type": "string",
      "title": "Nome",
      "default": "",
      "description": "Nome da página de metodologia (ex.: roic, dividendos). Vazio = lista as páginas disponíveis."
    }
  }
}
    arguments 12 lines
  • saude reads open 41m ago

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

    mcp-tool

    {
  "type": "object",
  "title": "saudeArguments",
  "properties": {}
}
    arguments 5 lines
  • listar_empresas reads open 41m ago

    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` (a lista) ou `fii` (um fundo). Gratuito, sem chave.

    mcp-tool

    {
  "type": "object",
  "title": "listar_empresasArguments",
  "properties": {}
}
    arguments 5 lines
  • producao_petroleo_gas open 3h ago

    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, com a soma dos poços, a participação no total nacional e a variação contra o mesmo mês do ano anterior (contas nossas). `nivel=campo` traz os campos; `periodo` (AAAA-MM) pede outro mês. `cnpj` (14 dígitos), `operador` (nome na ANP) ou `campo` devolvem a SÉRIE MENSAL dele, recortada por `de`/`ate` (AAAA-MM). Até dez/2023 é o arquivo por poço da ANP (mar e terra); de 2024 em diante os operadores vêm do Boletim Mensal da ANP e o dado por poço de exportação manual da consulta pública, com cobertura PARCIAL: cada linha traz `fonte` e `escopo` (`completo`, `somente_mar`), a resposta traz `cobertura_manual` com os meses que faltam, e a variação em 12 meses só existe entre meses de mesmo escopo. O `cnpj` vem da relação de concessionários da ANP pelo contrato e só quando o nome do operador confere; o `ticker` só vem quando esse CNPJ completo é o de uma empresa com papel negociado (operador SPE ou consórcio não liga). Número da ANP; a resposta traz a fonte, a licença, o acordo de uso e a citação. Não é recomendação de investimento.

    mcp-tool

    {
  "type": "object",
  "title": "producao_petroleo_gasArguments",
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Primeiro mês da série, AAAA-MM (ex.: 2024-01)."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Último mês da série, AAAA-MM (ex.: 2025-06)."
    },
    "cnpj": {
      "type": "string",
      "title": "Cnpj",
      "default": "",
      "description": "CNPJ do operador com 14 dígitos; devolve a série mensal dele."
    },
    "campo": {
      "type": "string",
      "title": "Campo",
      "default": "",
      "description": "Nome do campo de petróleo ou gás na ANP; devolve a série mensal dele."
    },
    "nivel": {
      "type": "string",
      "title": "Nivel",
      "default": "operador",
      "description": "Nível: \"operador\" (padrão) ou \"campo\"."
    },
    "periodo": {
      "type": "string",
      "title": "Periodo",
      "default": "",
      "description": "Mês a devolver, AAAA-MM (ex.: 2025-06). Vazio = o último mês da base."
    },
    "operador": {
      "type": "string",
      "title": "Operador",
      "default": "",
      "description": "Nome do operador como consta na ANP; devolve a série mensal dele."
    }
  }
}
    arguments 48 lines
  • saiu_da_bolsa open 3h ago

    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, Santos Brasil...). Sem `ano`: os 3 anos mais recentes. Com `ano`: só aquele ano (dentro desses 3). ABERTO, sem chave. É a página https://dadosb3.com/saiu-da-bolsa. Não é recomendação.

    mcp-tool

    {
  "type": "object",
  "title": "saiu_da_bolsaArguments",
  "properties": {
    "ano": {
      "type": "integer",
      "title": "Ano",
      "default": 0,
      "description": "Ano do último pregão, dentro dos 3 mais recentes (ex.: 2025). 0 = os 3 anos mais recentes."
    }
  }
}
    arguments 12 lines
  • dicionario reads open 26h ago

    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.

    mcp-tool

    {
  "type": "object",
  "title": "dicionarioArguments",
  "properties": {}
}
    arguments 5 lines
  • etfs_ranking reads open 26h ago

    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 fonte pública). Só ETF líquido (> R$ 1 mi/dia) entra em ágio, retorno e taxa. Gratuito.

    mcp-tool

    {
  "type": "object",
  "title": "etfs_rankingArguments",
  "properties": {}
}
    arguments 5 lines
  • hoje reads open 19h ago

    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 republicou o que já tinha entregue), os proventos de ações aprovados, rendimentos e informes de FII, eventos societários (grupamento, desdobramento, bonificação) e trocas de ticker. Cada seção declara `dados_ate`, a data máxima daquela FONTE: as defasagens são diferentes e a janela é fixa a partir de hoje, então fonte parada aparece parada em vez de parecer recente. Gratuito, sem chave.

    mcp-tool

    {
  "type": "object",
  "title": "hojeArguments",
  "properties": {}
}
    arguments 5 lines
  • tesouro_direto open 19h ago

    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-juros, ipca, ipca-juros, renda-mais, educa-mais, igpm-juros) filtra a família; `data` (AAAA-MM-DD) pede o último dia-base até essa data; `titulo` + `vencimento` (AAAA-MM-DD) devolve a SÉRIE DIÁRIA daquele título, recortada por `de`/`ate`. Compra e venda são os rótulos da fonte (do ponto de vista do investidor), taxas indicativas da manhã. Prefixado = taxa NOMINAL a.a.; IPCA+, Renda+ e Educa+ = taxa REAL a.a. (acima da inflação); Selic = taxa sobre a Selic: nominal e real NÃO se comparam diretamente. Número do Tesouro, sem recálculo; a resposta traz a fonte, a licença e a citação. Não é recomendação de investimento.

    mcp-tool

    {
  "type": "object",
  "title": "tesouro_diretoArguments",
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Primeiro dia da série: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Use com `titulo` + `vencimento`."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Último dia da série: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Use com `titulo` + `vencimento`."
    },
    "data": {
      "type": "string",
      "title": "Data",
      "default": "",
      "description": "Dia-base, AAAA-MM-DD (também aceita 01/06/2024): devolve o último dia-base até essa data. Vazio = o mais recente."
    },
    "titulo": {
      "type": "string",
      "title": "Titulo",
      "default": "",
      "description": "Família do título: selic, prefixado, prefixado-juros, ipca, ipca-juros, renda-mais, educa-mais ou igpm-juros. Vazio = todos."
    },
    "vencimento": {
      "type": "string",
      "title": "Vencimento",
      "default": "",
      "description": "Vencimento de um título, AAAA-MM-DD (ex.: 2035-05-15). Exige `titulo`; devolve a série diária dele."
    }
  }
}
    arguments 36 lines
  • indicadores_anuais reads unknown 38h ago

    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`. Banco e seguradora entram, mas sem ROIC/EBITDA, que não se aplicam ao plano de contas deles. ABERTA: qualquer ticker, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave). Traz `citacao` pronta para citar.

    mcp-tool

    {
  "type": "object",
  "title": "indicadores_anuaisArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
  • multiplos reads unknown 36h ago

    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, não sobre balanço trimestral. ABERTA: qualquer ticker, sem chave, um por vez, pelo método atual (sem `as_of`; o ponto-no-tempo por data passada exige chave na REST). Sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave. Traz `citacao`.

    mcp-tool

    {
  "type": "object",
  "title": "multiplosArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
  • dividendos reads unknown 16h ago

    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). ABERTA para todos os tickers, sem chave, um por vez (a mesma regra da REST /empresas/TICKER/dividendos; o mesmo dado é público em dadosb3.com/acoes/TICKER/dividendos). Sem chave: 2000 consultas por hora e 20000 por dia, por endereço; chave_api é opcional. Traz `citacao`: cite-a ao usar o número. Ticker de companhia que SAIU da bolsa (ENBR3, BIDI4...) devolve o bloco `saiu_da_bolsa` (último pregão e link) e os proventos que ela declarou à CVM (Formulário de Referência: montante em R$ por classe e exercício, até ~2021; Relatório Proventos do IPE: valor por ação e data-com, desde 2024), com `cobertura.fontes` dizendo a fonte e o período; se não declarou nenhum, devolve `erro` com `saiu_da_bolsa` (ausência DESCONHECIDA, não "não pagou").

    mcp-tool

    {
  "type": "object",
  "title": "dividendosArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
  • desempenho reads unknown 21h ago

    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; em PREÇO e, quando há proventos registrados, também o retorno TOTAL (`retorno_total_pct`: dividendos, JCP e rendimentos reinvestidos no data-ex); SEM custos (as `premissas` vêm na resposta). Use esta ferramenta para "essa estratégia valeu a pena?" em vez de baixar a série diária. Medida do passado, não recomendação. ABERTA para todos os tickers, sem chave (degustação); chave_api é aceita mas desnecessária.

    mcp-tool

    {
  "type": "object",
  "title": "desempenhoArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = últimos 5 anos."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Fim do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = até o último pregão."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    },
    "media_curta": {
      "type": "integer",
      "title": "Media Curta",
      "default": 21,
      "description": "Média móvel curta, em pregões: inteiro de 1 a 1000, menor que media_longa (padrão 21)."
    },
    "media_longa": {
      "type": "integer",
      "title": "Media Longa",
      "default": 100,
      "description": "Média móvel longa, em pregões: inteiro de 1 a 1000, maior que media_curta (padrão 100)."
    }
  }
}
    arguments 44 lines
  • fundos_da_acao unknown 13h ago

    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ão 20) corta a lista dos maiores por valor; contadores e maiores movimentos cobrem todos os fundos. A carteira sai depois do fim do mês: a data de referência vem na resposta. Licença da fonte: ODbL 1.0. WEGE3 é aberto; as demais ações seguem a regra de chave da página. Não é recomendação.

    mcp-tool

    {
  "type": "object",
  "title": "fundos_da_acaoArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "limite": {
      "type": "integer",
      "title": "Limite",
      "default": 20,
      "description": "Quantidade de fundos listados, inteiro de 1 a 500 (padrão 20), os maiores por valor."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 26 lines
  • scores reads unknown 23h ago

    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 parte da vitrine aberta.

    mcp-tool

    {
  "type": "object",
  "title": "scoresArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
  • auditar_amostra reads unknown 38h ago

    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ístico: a mesma semente devolve sempre os mesmos casos, então seu resultado é reproduzível por terceiros. Cada caso traz empresa, CD_CVM, exercício, indicador, valor publicado, a fórmula, e a conta CVM que AQUELA empresa usou NAQUELE exercício. Confira baixando dfp_cia_aberta_<EXERCICIO>.zip em dados.cvm.gov.br, filtrando CD_CVM e ORDEM_EXERC='ÚLTIMO', atento a ESCALA_MOEDA (MIL = milhares). Regras: publique o DENOMINADOR (7 divergências em 100 é resultado, "7 divergências" não é); NÃO transforme "não consegui conferir" em "passou"; e se afirmar que um número está errado, mostre a conta. Achou erro? É isso que interessa — github.com/Val7h/dados-b3-mcp/issues. Gratuito, sem chave. Auditoria que exige cadastro não é auditoria.

    mcp-tool

    {
  "type": "object",
  "title": "auditar_amostraArguments",
  "required": [
    "semente"
  ],
  "properties": {
    "n": {
      "type": "integer",
      "title": "N",
      "default": 25,
      "description": "Quantidade de casos sorteados, inteiro de 1 a 25 (padrão 25)."
    },
    "semente": {
      "type": "integer",
      "title": "Semente",
      "description": "Inteiro à sua escolha; a mesma semente devolve sempre os mesmos casos."
    }
  }
}
    arguments 20 lines
  • fii reads unknown 38h ago

    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, por endereço; com `chave_api` vale o limite da chave). Traz `citacao`. `serie=True` devolve a série DIÁRIA em colunas (abertura, máxima, mínima, fechamento, volume, negócios, quantidade; sem ajuste, com os saltos sinalizados); sem chave, amostra dos últimos 30 pregões (MXRF11 vem inteiro).

    mcp-tool

    {
  "type": "object",
  "title": "fiiArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Fim da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "serie": {
      "type": "boolean",
      "title": "Serie",
      "default": false,
      "description": "False (padrão) = detalhe do fundo; True = série diária em colunas. Sem chave_api, amostra dos últimos 30 pregões (MXRF11 vem inteiro)."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker de FII, como MXRF11, HGLG11 ou KNRI11 (sem distinção de caixa; aceita .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 38 lines
  • screener_fiis reads unknown 21h ago

    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 valores limpos (P/VP e DY sem flag). Ordena por P/VP crescente, teto de 100. Requer chave_api (grátis ou Pro).

    mcp-tool

    {
  "type": "object",
  "title": "screener_fiisArguments",
  "required": [
    "filtros"
  ],
  "properties": {
    "filtros": {
      "type": "object",
      "title": "Filtros",
      "description": "Dicionário de filtros, ex.: {\"pvp_max\": 0.9, \"dy_min\": 0.10, \"segmento\": \"Logística\", \"cotistas_min\": 5000}. Chaves válidas: pvp_min, pvp_max, dy_min, dy_max, segmento, cotistas_min.",
      "additionalProperties": true
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 21 lines
  • etf reads unknown 13h ago

    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 aberto para degustação; os demais exigem chave_api (grátis ou Pro). `serie=True` devolve a série DIÁRIA em colunas (abertura, máxima, mínima, fechamento, volume, negócios, quantidade e `fechamento_ajustado` por desdobramento conferido), com os eventos, os saltos sem explicação e o retorno com rendimentos reinvestidos; `de`/`ate` recortam; sem chave, amostra dos últimos 30 pregões (BOVA11 vem inteiro).

    mcp-tool

    {
  "type": "object",
  "title": "etfArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Fim da série (com serie=True): AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024)."
    },
    "serie": {
      "type": "boolean",
      "title": "Serie",
      "default": false,
      "description": "False (padrão) = detalhe do ETF; True = série diária em colunas. Sem chave_api, amostra dos últimos 30 pregões (BOVA11 vem inteiro)."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker de ETF, como BOVA11 ou IVVB11 (sem distinção de caixa; aceita .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 38 lines
  • veredito reads unknown never probed

    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 setor, com a história da própria empresa e com o universo; mais a BANDEIRA DE CONFIANÇA do retrato (verde/amarelo/vermelho: houve reapresentação? o dado é o mais recente? passou nas conferências?). Uma frase de topo de até 25 palavras. Sem adjetivo de julgamento e sem recomendação: quem conclui é quem lê. Gratuito, sem chave. Traz `citacao` pronta para citar.

    mcp-tool

    {
  "type": "object",
  "title": "vereditoArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    }
  }
}
    arguments 14 lines
  • precos reads unknown 23h ago

    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 e avisa. O preço NÃO é ajustado: os eventos societários do período vêm junto (`eventos`) para quem monta o retorno total. WEGE3 gratuita; demais tickers SEM chave devolvem uma AMOSTRA (últimos 30 pregões) com um `aviso` que diz como ter a série inteira (chave grátis em `chave_api`) e que `desempenho` responde sem chave; com chave, a série completa. ★ FORMATO COMPACTO (04/10/2026). Cinco anos de série completa pesam ~250 KB, mais do que cabe no contexto de um cliente de IA (o ChatGPT recebeu os 1.248 pregões e não conseguiu processá-los). Por padrão a resposta traz só `data,fechamento` em forma de colunas (`colunas` + `linhas`, ~28 KB). Peça mais com `campos` (lista separada por vírgula entre data, ticker, abertura, maxima, minima, fechamento, medio, volume, quantidade, negocios) ou `campos="todos"` para a lista completa de objetos em `serie`.

    mcp-tool

    {
  "type": "object",
  "title": "precosArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "de": {
      "type": "string",
      "title": "De",
      "default": "",
      "description": "Início do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = desde o começo da série."
    },
    "ate": {
      "type": "string",
      "title": "Ate",
      "default": "",
      "description": "Fim do período: AAAA-MM-DD (também aceita 2024, 2024-06, 06/2024 e 01/06/2024). Vazio = até o último pregão."
    },
    "campos": {
      "type": "string",
      "title": "Campos",
      "default": "data,fechamento",
      "description": "Colunas da série, separadas por vírgula, entre data, ticker, abertura, maxima, minima, fechamento, medio, volume, quantidade, negocios (padrão \"data,fechamento\"). \"todos\" devolve objetos completos (resposta grande)."
    },
    "limite": {
      "type": "integer",
      "title": "Limite",
      "default": 1500,
      "description": "Máximo de pregões devolvidos (padrão 1500, máximo 20000); corta a partir do mais antigo e avisa."
    },
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 44 lines
  • quanto_rendeu unknown 13h ago

    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 começa no mesmo dia do último fechamento, N anos antes); para outro período, use `desempenho` com `de`/`ate`. ABERTO, sem chave. Medida do passado, sem custos nem impostos; não é recomendação. Devolve o texto em markdown e a URL para citar.

    mcp-tool

    {
  "type": "object",
  "title": "quanto_rendeuArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker de ação, FII ou ETF da B3, como PETR4, HGLG11 ou BOVA11 (sem distinção de caixa; aceita .SA)."
    }
  }
}
    arguments 14 lines
  • reapresentacoes reads unknown 23h ago

    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. WEGE3 gratuita; demais tickers exigem chave_api (grátis ou Pro): as reapresentações por versão ficam atrás de chave.

    mcp-tool

    {
  "type": "object",
  "title": "reapresentacoesArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
  • fatos_contabeis reads unknown 41h ago

    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ções. FII não publica DFP/ITR nesse formato — o que existe é o informe mensal, exposto por `fii`. ABERTA: qualquer ticker, sem chave, um por vez, com o histórico de hoje (a versão vigente de cada período). O balanço como estava numa data passada (`as_of`) e as versões antigas não existem aqui: na REST exigem chave. Sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com `chave_api` vale o limite da chave. Traz `citacao`.

    mcp-tool

    {
  "type": "object",
  "title": "fatos_contabeisArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    },
    "trimestral": {
      "type": "boolean",
      "title": "Trimestral",
      "default": false,
      "description": "False (padrão) = DFP anual; True = ITR trimestral (1T a 3T isolados)."
    }
  }
}
    arguments 26 lines
  • screener reads unknown 21h ago

    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_ebit, margem_liquida, dl_ebitda, cresc_receita_1a, cresc_receita_5a_cagr (sufixos _min/_max) e os múltiplos pl (P/L anual, da DFP) e pl_ttm (P/L de 12 meses, do ITR ou DFP mais recente), ex. {"pl_max": 10}; P/L negativo, acima de 200 ou ausente nunca passa e a linha traz `multiplos` com `dt_receb`, `data_preco` e `ressalvas` do valor (`rigor="estrito"` só aceita P/L sem nenhuma ressalva; `fora_do_filtro` explica quem ficou de fora). Sem `ano` usa o último de cada empresa. `as_of` ("AAAA-MM-DD") responde outra pergunta: o que estava PÚBLICO naquela data (balanço já recebido pela CVM, ~100 dias depois do exercício) — use para pesquisa sem olhar o futuro; cada linha traz `disponivel_em`. `ano` e `as_of` não se combinam. O universo continua o das companhias ativas hoje (viés de sobrevivência, declarado na resposta). `recibo=True` congela a resposta num endereço permanente com o sha256 do resultado — use quando for CITAR a lista, porque ela muda quando a base for atualizada e o recibo não. Só valores SEM flag entram. Requer chave_api (grátis ou Pro).

    mcp-tool

    {
  "type": "object",
  "title": "screenerArguments",
  "required": [
    "filtros"
  ],
  "properties": {
    "ano": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ano",
      "default": null,
      "description": "Exercício a filtrar (ex.: 2024). Vazio = o último de cada empresa. Não se combina com `as_of`."
    },
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "As Of",
      "default": null,
      "description": "Data AAAA-MM-DD: usa só o que já era público naquele dia (balanço recebido pela CVM). Não se combina com `ano`."
    },
    "rigor": {
      "type": "string",
      "title": "Rigor",
      "default": "padrao",
      "description": "Rigor do P/L: \"padrao\" (padrão) ou \"estrito\" (só P/L sem nenhuma ressalva)."
    },
    "recibo": {
      "type": "boolean",
      "title": "Recibo",
      "default": false,
      "description": "True congela a resposta num endereço permanente com sha256; False (padrão) = sem recibo."
    },
    "filtros": {
      "type": "object",
      "title": "Filtros",
      "description": "Dicionário de filtros, ex.: {\"roic_min\": 0.15, \"dl_ebitda_max\": 2}. Chaves = indicador + sufixo _min ou _max.",
      "additionalProperties": true
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 59 lines
  • trimestres reads unknown 16h ago

    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ó responde depois que o exercício fecha, e fica até um ano defasada. O 4º TRIMESTRE NÃO VEM, e é escolha: a ITR publica 1T/2T/3T e o exercício fechado é da DFP. Dá para derivar `4T = anual − 9M`, e não derivamos — número calculado por nós não entra na mesma lista dos que a companhia reportou. Para o ano fechado use `indicadores_anuais`. Banco e seguradora recebem só margem líquida e ROE: não há resultado bruto nem EBIT nesse plano de contas. WEGE3 gratuita; demais exigem chave_api.

    mcp-tool

    {
  "type": "object",
  "title": "trimestresArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
  • eventos reads unknown 10h ago

    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,01 × 100 = 1,0). WEGE3 gratuita; demais tickers exigem chave_api. Ticker de companhia que SAIU da bolsa responde com `saiu_da_bolsa` (último pregão e link), mesmo sem chave.

    mcp-tool

    {
  "type": "object",
  "title": "eventosArguments",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker",
      "description": "Ticker da B3, como PETR4, VALE3 ou WEGE3 (sem distinção de caixa; aceita o sufixo .SA)."
    },
    "chave_api": {
      "type": "string",
      "title": "Chave Api",
      "default": "",
      "description": "Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão)."
    }
  }
}
    arguments 20 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id e11e86fec62b1455.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/e11e86fec62b1455/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/e11e86fec62b1455/badge.svg)](https://brick.blue/agent/e11e86fec62b1455?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.