DataBR — API de Dados Públicos Brasileiros

io.github.igorpdevPublished by GitHub account igorpdevv1.0.0Updated Oct 24, 2026

Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server exposing Brazilian public data — central bank, IBGE, companies, markets, government transparency and more — paid per query in USDC.

What you can do
Query economic indicators from BCB, IBGE and IPEA, such as Selic, PTAX exchange rates, IPCA, GDP and Focus expectations, plus consolidated economic panoramas and IPEA series. Look up companies by CNPJ: registration data, compliance checks, sector analysis, credit score, due diligence and network or portfolio risk analyses. Retrieve financial market data: B3 stock quotes, Ibovespa, CVM fund details and quotas, relevant facts, Tesouro Direto and BNDES credit operations. Search government transparency and legislative records: bids, contracts, public servants, PEP lists, TCU rulings, budget execution, official gazette, deputies, senators, bills, votes and TSE candidates. Access judicial, tax, ag
When to use it
Useful when an assistant needs Brazilian public-sector or corporate data — macro indicators, CNPJ due diligence, market quotes, transparency or legislative records — and the user is willing to pay small per-query fees in USDC instead of registering for an API key.
Requirements
Remote endpoint at databr.api.br/mcp; no signup or API key. Each query requires on-chain payment in USDC on the Base network via the x402 protocol, sent with an X-PAYMENT header, so a funded wallet is needed. Rate limits apply per IP and per wallet.
Before you install
Every data call costs money (roughly $0.003 to $0.150 USDC per query, plus $0.002 for context format), so an assistant can spend funds automatically. Payment requires a wallet with USDC on Base; the Python SDK takes a private key, which is a sensitive secret. Queries send CNPJ, CPF or names of companies and people to a third-party API.

Installation

In SourceWeft

  1. Open DataBR — API de Dados Públicos Brasileiros in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.igorpdev%2Fdatabr/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "databr-api-de-dados-p-blicos-brasileiros": {
      "type": "http",
      "url": "https://databr.api.br/mcp"
    }
  }
}

README

DataBR

API de dados públicos brasileiros para agentes de IA, com pagamento on-chain via protocolo x402 (USDC na rede Base).

Sem cadastro. Sem API key. Pague por consulta.

Documentação | Python SDK | MCP Server | MCP Marketplace | Smithery


Como funciona

Agente IA → GET /v1/bcb/selic → 402 Payment Required         → Paga $0.003 USDC on-chain (Base)         → Retry com header X-PAYMENT         → 200 OK + dados

O protocolo x402 permite que agentes de IA paguem por dados automaticamente, sem cadastro ou chave de API. Basta ter USDC na rede Base.


Início rápido

curl (explorar sem pagar)

bash
# Health checkcurl https://databr.api.br/health
# Ver requisitos de pagamento de qualquer endpointcurl -I https://databr.api.br/v1/bcb/selic# → 402 Payment Required + JSON com instruções x402

Python SDK

bash
pip install databr
python
from databr import DataBR
client = DataBR(private_key="0x...")  # wallet com USDC na Base
# Taxa Selicselic = client.bcb.selic()print(selic.data)  # {"valor": "14.25", ...}
# Empresa por CNPJempresa = client.empresas.consultar("33000167000101")print(empresa.data["razao_social"])
# Due diligence completadd = client.empresas.due_diligence("33000167000101")
# Formato LLM-readyipca = client.economia.ipca(format="context")print(ipca.context)  # texto pronto para prompt

MCP (Claude, Cursor, etc.)

Listado no MCP Marketplace — instale direto pelo marketplace ou adicione manualmente ao seu MCP client:

json
{  "mcpServers": {    "databr": {      "url": "https://databr.api.br/mcp"    }  }}

170+ ferramentas disponíveis cobrindo todos os endpoints da API.


Endpoints

122 endpoints organizados por domínio. Documentação completa em databr.api.br/docs.

Economia

EndpointPreçoDescrição
GET /v1/bcb/selic$0.003Taxa Selic vigente
GET /v1/bcb/cambio/{moeda}$0.003Câmbio PTAX (USD, EUR, etc.)
GET /v1/bcb/credito$0.003Oferta de crédito
GET /v1/bcb/reservas$0.003Reservas internacionais
GET /v1/bcb/taxas-credito$0.003Taxas de juros por modalidade
GET /v1/bcb/pix/estatisticas$0.003Estatísticas PIX
GET /v1/bcb/focus$0.003Expectativas Focus (mercado)
GET /v1/economia/ipca$0.003Inflação IPCA
GET /v1/economia/pib$0.003PIB trimestral
GET /v1/economia/panorama$0.015Panorama econômico consolidado
GET /v1/ipea/serie/{codigo}$0.003Séries IPEA (macro, social, regional)

Empresas

EndpointPreçoDescrição
GET /v1/empresas/{cnpj}$0.003Dados cadastrais (Receita Federal)
GET /v1/empresas/{cnpj}/compliance$0.007Check rápido CEIS/CNEP/CEPIM
GET /v1/empresas/{cnpj}/setor$0.007Análise setorial
GET /v1/empresas/{cnpj}/perfil-completo$0.020Perfil completo com cruzamentos
GET /v1/empresas/{cnpj}/duediligence$0.075Due diligence automatizada
GET /v1/compliance/{cnpj}$0.010Compliance completo (CGU + CNJ)
GET /v1/credito/score/{cnpj}$0.010Score de crédito estimado

Mercado financeiro

EndpointPreçoDescrição
GET /v1/mercado/acoes/{ticker}$0.005Cotação de ações (B3)
GET /v1/mercado/indices/ibovespa$0.005Índice Ibovespa
GET /v1/mercado/fundos/{cnpj}$0.010Detalhes de fundo (CVM)
GET /v1/mercado/fundos/{cnpj}/cotas$0.005Cotas de fundo
GET /v1/mercado/fundos/{cnpj}/analise$0.010Análise de fundo
GET /v1/mercado/fatos-relevantes$0.005Fatos relevantes CVM
GET /v1/mercado/{cnae}/competicao$0.030Análise de competição
GET /v1/tesouro/titulos$0.003Tesouro Direto
GET /v1/bndes/{cnpj}/operacoes$0.005Operações de crédito BNDES

Transparência e governo

EndpointPreçoDescrição
GET /v1/transparencia/licitacoes$0.003Licitações PNCP
GET /v1/transparencia/contratos$0.003Contratos federais
GET /v1/transparencia/servidores$0.003Servidores públicos
GET /v1/transparencia/pgfn$0.003Dívida ativa PGFN por CNPJ
GET /v1/transparencia/pep$0.003Pessoas Expostas Politicamente (por nome)
GET /v1/transparencia/leniencias$0.003Acordos de leniência por CNPJ
GET /v1/transparencia/renuncias$0.003Renúncias fiscais por exercício
GET /v1/tcu/acordaos$0.003Acórdãos do TCU
GET /v1/tcu/certidao/{cnpj}$0.003Certidão TCU
GET /v1/orcamento/despesas$0.003Execução orçamentária
GET /v1/dou/busca$0.007Busca em diários oficiais

Legislativo

EndpointPreçoDescrição
GET /v1/legislativo/deputados$0.003Deputados federais
GET /v1/legislativo/senado/senadores$0.003Senadores
GET /v1/legislativo/proposicoes$0.003Projetos de lei
GET /v1/legislativo/votacoes$0.003Votações
GET /v1/eleicoes/candidatos$0.003Candidatos TSE
GET /v1/eleicoes/filiados$0.003Filiados partidários por UF
GET /v1/eleicoes/compliance/{cpf_cnpj}$0.007Compliance eleitoral

Jurídico

EndpointPreçoDescrição
GET /v1/judicial/stf$0.010Decisões do STF
GET /v1/judicial/stj$0.010Decisões do STJ
GET /v1/judicial/processos/{doc}$0.015Processos por CPF/CNPJ
GET /v1/litigio/{cnpj}/risco$0.030Risco litigioso

Ambiental

EndpointPreçoDescrição
GET /v1/ambiental/desmatamento$0.005Alertas DETER (INPE)
GET /v1/ambiental/prodes$0.005Monitoramento PRODES
GET /v1/ambiental/embargos$0.005Embargos IBAMA
GET /v1/ambiental/uso-solo$0.005Cobertura MapBiomas
GET /v1/ambiental/risco/{municipio}$0.007Risco ambiental
GET /v1/ambiental/empresa/{cnpj}/esg$0.030Análise ESG

Saúde, energia, transporte e mais

EndpointPreçoDescrição
GET /v1/saude/medicamentos/{registro}$0.003Medicamentos ANVISA
GET /v1/saude/planos$0.003Planos ANS
GET /v1/energia/geracao$0.005Geração de energia (ONS)
GET /v1/energia/tarifas$0.003Tarifas ANEEL
GET /v1/energia/combustiveis$0.003Preços ANP
GET /v1/transporte/aeronaves$0.005Aeronaves ANAC
GET /v1/transporte/acidentes$0.005Acidentes PRF
GET /v1/comercio/exportacoes$0.005Exportações (ComexStat)
GET /v1/educacao/censo-escolar$0.005Censo escolar INEP
GET /v1/emprego/rais$0.005RAIS (emprego formal)
GET /v1/emprego/caged$0.005CAGED (admissões/demissões)

Tributário

EndpointPreçoDescrição
GET /v1/tributario/ncm/{codigo}$0.003Carga tributária por NCM/NBS (IBPT)
GET /v1/tributario/icms/{uf}$0.003Alíquota ICMS interna de um estado
GET /v1/tributario/icms$0.003Tabela ICMS completa (27 UFs) ou interestadual

Análises compostas

EndpointPreçoDescrição
GET /v1/rede/{cnpj}/influencia$0.050Análise de rede e influência
POST /v1/carteira/risco$0.150Risco de carteira (múltiplos CNPJs)

Query parameters

Todos os endpoints aceitam:

ParâmetroExemploDescrição
format?format=contextTexto LLM-ready em vez de JSON (+$0.002)
fields?fields=valor,dataProjeção de campos
since?since=2026-01-01Filtrar a partir de data
until?until=2026-02-01Filtrar até data
limit?limit=10Limite de registros
offset?offset=20Offset para paginação

Formato de resposta

json
{  "source": "bcb_sgs",  "updated_at": "2026-02-21T10:00:00Z",  "cached": true,  "cache_age_seconds": 3600,  "cost_usdc": "0.003",  "data": {    "valor": "14.25",    "data": "2026-02-21"  }}

Preços

FaixaPreço (USDC)Exemplos
Consultas básicas$0.003BCB, IBGE, empresas, legislativo, tributário
Consultas padrão$0.005Ações B3, CVM, comércio exterior
Consultas avançadas$0.007Compliance empresa, DOU, risco ambiental
Premium$0.010Compliance completo, fundos, decisões STF/STJ
Análises cruzadas$0.015–$0.030Panorama, ESG, litígio, competição
Análises profundas$0.050–$0.150Rede de influência, due diligence, carteira
Formato contexto+$0.002Adicional sobre qualquer endpoint

Rate limits: 100 req/min por IP | 500 req/min por wallet x402.


Python SDK

bash
pip install databr

Namespaces disponíveis

NamespaceExemploMétodos
bcbclient.bcb.selic()selic, cambio, focus, credito, reservas, taxas_credito, pix
empresasclient.empresas.consultar(cnpj)consultar, compliance, perfil_completo, due_diligence
economiaclient.economia.ipca()ipca, pib, panorama
mercadoclient.mercado.acoes("PETR4")acoes, fundos, cotas, fatos, indices, competicao
complianceclient.compliance.verificar(cnpj)verificar, ceis, cnep, cepim
judicialclient.judicial.processos(doc)processos, stf, stj, litigio
legislativoclient.legislativo.deputados()deputados, senadores, proposicoes, votacoes
ambientalclient.ambiental.desmatamento()desmatamento, prodes, embargos, uso_solo, esg
transparenciaclient.transparencia.licitacoes()licitacoes, contratos, servidores, orcamento
saudeclient.saude.medicamentos(reg)medicamentos, operadoras, estabelecimentos
energiaclient.energia.tarifas()tarifas, geracao, carga, combustiveis
transporteclient.transporte.aeronaves()aeronaves, transportadores, acidentes
comercioclient.comercio.exportacoes()exportacoes, importacoes
empregoclient.emprego.rais()rais, caged
tributarioclient.tributario.ncm("22030000", uf="SP")ncm, icms

Tratamento de erros

python
from databr import DataBR, NotFoundError, PaymentError, RateLimitError
try:    empresa = client.empresas.consultar("00000000000000")except NotFoundError:    print("CNPJ não encontrado")except PaymentError:    print("Pagamento falhou — verificar saldo USDC")except RateLimitError as e:    print(f"Rate limit — retry em {e.retry_after}s")

Testnet

python
client = DataBR(private_key="0x...", network="testnet")  # Base Sepolia, USDC de teste

Fontes de dados

42 coletores automáticos + 8 on-demand, cobrindo:

FonteÓrgãoAtualização
Selic, PTAX, crédito, reservas, PIX, FocusBCBDiária/semanal
IPCA, PIB, população, pesquisasIBGEDiária/mensal
Cotações, IbovespaB3Diária (dias úteis)
Fundos, fatos relevantes, cotasCVMDiária
Candidatos, bens, doações, filiadosTSEAnual / On-demand
Licitações PNCPPortal da TransparênciaDiária
Acórdãos, certidões, inabilitadosTCUSemanal
Deputados, senadores, proposiçõesCâmara/SenadoDiária
RREO, RGF, Tesouro DiretoTesouro NacionalDiária/mensal
Exportações, importaçõesComexStatMensal
Tarifas, geração, cargaANEEL/ONSSemanal/diária
MedicamentosANVISAMensal
Operadoras, planosANSSemanal
DETER, PRODES, MapBiomasINPEDiária/mensal
EmbargosIBAMASemanal
Aeronaves, transportadores, acidentesANAC/ANTT/PRFSemanal/mensal
Censo escolarINEPSemestral
RAIS, CAGEDMTE (FTP)Mensal/anual
Decisões STF, STJTribunais superioresDiária
CombustíveisANPSemanal
Séries macroIPEADiária
Diários oficiaisQuerido DiárioOn-demand
CNPJminhareceita.orgOn-demand
Compliance CEIS/CNEPCGUOn-demand
Processos judiciaisDataJud CNJOn-demand
Carga tributária NCM/NBSIBPTOn-demand
Acordos leniência, PEP, renúncias, PGFNCGU/Portal da TransparênciaOn-demand
Operações de créditoBNDES (CKAN)On-demand
Alíquotas ICMS (27 UFs)CONFAZ/SEFAZEstático (2026)

Desenvolvimento local

Pré-requisitos

  • Go 1.24+
  • Docker (PostgreSQL + Redis)

Setup

bash
git clone https://github.com/igorpdev/databr.gitcd databr
# Subir PostgreSQL e Redisdocker-compose up -d
# Configurar variáveiscp .env.example .env# Editar .env com suas configurações
# Rodar APIgo run cmd/api/main.go
# Rodar coletores (em outro terminal)go run cmd/collector/main.go
# Testesgo test ./...

A API sobe em http://localhost:8080. Sem WALLET_ADDRESS configurado, os endpoints /v1/* funcionam sem pagamento (modo dev).

Estrutura

databr/├── cmd/│   ├── api/              # Entrypoint REST API + MCP│   └── collector/        # Scheduler de coletores├── internal/│   ├── handlers/         # 30+ handlers HTTP (122 endpoints)│   ├── collectors/       # 23 pacotes de coletores (50 fontes)│   ├── repositories/     # PostgreSQL (pgx/v5)│   ├── cache/            # Redis + cache em memória│   ├── x402/             # Middleware de pagamento + pricing│   ├── mcp/              # MCP Server (170+ tools)│   ├── domain/           # Entidades e interfaces│   ├── metrics/          # Prometheus│   └── logging/          # Structured logging (slog)├── sdk/python/           # Python SDK (PyPI: databr)├── docs/│   ├── openapi.yaml      # Especificação OpenAPI 3.0│   └── landing.html      # Landing page├── migrations/           # Schema PostgreSQL├── Dockerfile            # API (multi-stage, ~23MB)├── Dockerfile.collector  # Coletores└── docker-compose.yml    # Dev: PostgreSQL 16 + Redis 7

Stack

CamadaTecnologia
BackendGo 1.24, Chi Router
BancoPostgreSQL 16 (pgx/v5)
CacheRedis (Upstash em produção)
Pagamentosx402 protocol, USDC, Base network
DeployRailway
MétricasPrometheus
MCPmcp-go (Mark3Labs)
SDKPython (PyPI)

Variáveis de ambiente

bash
# ObrigatóriasDATABASE_URL=postgres://databr:databr@localhost:5432/databrREDIS_URL=redis://localhost:6379
# x402 (testnet)WALLET_ADDRESS=0x...X402_NETWORK=base-sepoliaX402_FACILITATOR_URL=https://facilitator.x402.rs
# x402 (mainnet)# X402_NETWORK=base# X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402# CDP_KEY_ID=...# CDP_KEY_SECRET=...
# APIs externas (opcionais)TRANSPARENCIA_API_KEY=    # Portal da Transparência (CGU)DATAJUD_API_KEY=          # DataJud (CNJ)MINHARECEITA_URL=https://minhareceita.org

Links


Licença

MIT

Source: README.md at commit 608ea5c

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.