Feito para agentes.
A mesma API que serve o site alimenta CLI e MCP — toda resposta carrega linhagem, todo número é auditável. Nenhuma caixa-preta entre o seu agente e a fonte oficial.
Cotações, screeners e indicadores no terminal — saída legível para humanos, JSON para pipelines. Tudo com a mesma linhagem da API.
$ npm install -g @databolsa/cli
added 23 packages in 1.4s databolsa v0.1.0-preview (bin: databolsa)
$ databolsa quote PETR4 --range 1m
PETR4 · PETRÓLEO BRASILEIRO S.A. · PN data fech. var volume 2026-06-09 32,18 +0,8% R$ 1,02B 2026-06-10 32,46 +0,9% R$ 1,18B 2026-06-11 32,41 −0,2% R$ 0,96B 21 pregões · fonte: b3_cotahist (ajustado)
$ databolsa screener acoes --pl-max 10 --dy-min 6 --format json | jq '.[0]'
{
"ticker": "PETR4",
"pl": 4.6,
"dy_12m": 13.6,
"lineage": { "source": "cvm_dfp_itr", "reference": "ITR 1T2026" }
}Uma Agent Skill empacota o servidor MCP com o conhecimento de como usar a DataBolsa — quais indicadores existem, quando um número não se aplica, e como citar a linhagem. O agente passa a operar a base como um analista, não só a chamar tools.
/plugin marketplace add databolsa/skill
> use databolsa para rodar um screener de FIIs com DY > 8% e auditar a linhagem
claude mcp add databolsa -- npx @databolsa/mcp --api-key $DATABOLSA_API_KEY
MCP (Model Context Protocol) é o padrão aberto que conecta agentes a fontes de dados. O servidor da DataBolsa expõe cada endpoint da API como uma tool tipada.
O agente recebe o mesmo JSON que o site consome — incluindo o objeto lineage de cada número, e null com justificativa quando o indicador não se aplica.
O catálogo abaixo é gerado do contrato OpenAPI — quando a API ganha um endpoint, o agente ganha uma tool.
getHealthStatus da API e frescor dos dadossearchBusca unificada (typeahead) por ações/FIIs/índices/títulos/macrogetIngestHealthSaúde da ingestão (última run, fontes, histórico)listCompaniesLista companhias abertas (cadastro CVM)getCompanyCompanhia por código CVMlistCompanyDocumentsDocumentos e comunicados (IPE/CVM)getStockPerfil e última cotação do papellistQuotesSérie de cotações OHLCVgetStockIndicatorsIndicadores fundamentalistas (snapshot TTM)getStockIndicatorHistoryHistórico de um indicador (trimestral)listDividendsProventos (dividendos e JCP)listCorporateEventsEventos societários (desdobramentos, grupamentos, bonificações)listInsiderMovesMovimentações de insiders (CVM VLMO, por mês)screenStocksFiltra ações por múltiplos critérios fundamentalistasscreenFiisUniverso de FIIs filtrável por segmento e tijolo/papelgetMacroGearsEngrenagens macro (sinais por seção)getMacroRegimeRegime econômico (quadrante crescimento × inflação)getMarketExpectationsExpectativas Focus (consenso por indicador)listSeriesCatálogo de séries (BCB/IBGE/FRED/...)getSeriesObservações de uma série (com acumulados opcionais)getYieldCurveCurva de juros (Tesouro), um ponto por vencimentolistTesouroBondsTítulos do Tesouro Direto (taxas e preços)listIndicesÍndices disponíveis (IBOV, IFIX, ...)listIndexQuotesSérie de níveis diários de um índicegetIndexCompositionComposição teórica do índice (carteira teórica vigente)getFiiPerfil do fundo imobiliáriogetFiiIndicatorsIndicadores do FII (snapshot)getFiiIndicatorHistoryHistórico de um indicador do FII (informe mensal)listFiiDistributionsDistribuições (rendimentos) do FIIlistFiiReportsInformes mensais do FIIlistBdrsCatálogo de BDRs (recibos de ações estrangeiras)getBdrPerfil de um BDRlistBdrQuotesCotações EOD de um BDRgetOptionsChainCadeia de opções vigente de um subjacentelistOptionExpiriesVencimentos disponíveis de um subjacentelistOptionQuotesHistórico EOD de uma série de opçãolistCryptoQuotesCandles de um criptoativo (diário; 1h vazio no v1)37 tools · contrato 1.0.0
┤ agente conectado a api.databolsa.com ├
Cada pergunta vira chamadas de tools MCP — abra os cartões para ver o JSON real que o agente recebe, linhagem incluída.
A linhagem é o contrato.
Cada resposta de tool inclui um objeto lineage com fonte, referência e URL — o agente pode citar a origem de cada número, e você pode auditar a citação.