BR Intelligence

Brazilian business and payments data for AI agents. Validate CPF, CNPJ (including the new alphanumeric CNPJ from July 2026), EAN-13, NF-e keys and phones; look up companies by CNPJ with an explainable 0-100 KYB risk score (single or batch); decode and validate boletos and PIX copia-e-cola; look up addresses by CEP and banks by COMPE/ISPB; compute business days; and get Selic, CDI, IPCA and USD/BRL from the Central Bank. Remote MCP (Streamable HTTP) at /mcp. No signup and no API key: pay per call in USDC on Base via x402. Errors are never charged.

Размещённый MCP-сервер

npx add-mcp 'https://br-intelligence.brverify-api.workers.dev/mcp'

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

BR Intelligence

Brazilian payments and business data for AI agents. Decode boletos and PIX, validate CPF/CNPJ (including the new alphanumeric CNPJ), score companies for KYB, look up CEPs and banks, compute business days and read Central Bank rates. Pay per call in USDC — no signup, no API key.

x402 v2 · USDC on BaseHTTP + MCP11 endpoints · from $0.002Errors never charged

Quick start

Claude Code

claude mcp add --transport http br-intelligence https://br-intelligence.brverify-api.workers.dev/mcp

Any MCP client

https://br-intelligence.brverify-api.workers.dev/mcp

Streamable HTTP. The free about tool lists prices.

HTTP

curl -i "https://br-intelligence.brverify-api.workers.dev/v1/rates"

Returns 402 with a PAYMENT-REQUIRED header; any x402 client pays and retries.

Endpoints and prices

HTTPMCP toolPriceWhat it does
Payments
GET /v1/boleto

?code=00190500954014481606906809350314337370000000100

decode_boleto$0.005Validate and decode a boleto (cobrança or arrecadação): bank, amount, due date, check digits. Handles the Febraban 2025 due-date factor reset and flags ambiguous dates.
GET /v1/pix

?payload=000201…

decode_pix$0.005Validate and decode a PIX copia-e-cola (BR Code): CRC16, key and key type, receiver, city, amount, txid.
GET /v1/bank

?code=260

lookup_bank$0.002Bank by COMPE code or ISPB: short and full legal name.
Companies
GET /v1/validate

?type=cnpj&value=12ABC34501DE35

validate_identifier$0.005Validate CPF, CNPJ (including the alphanumeric CNPJ issued from July 2026), EAN-13, NF-e access key, phone.
GET /v1/company

?cnpj=11222333000181

get_company$0.01Registration data by CNPJ: legal name, status, address, partners (QSA), CNAE, capital.
GET /v1/score

?cnpj=11222333000181

get_company_score$0.02Explainable 0-100 health/risk score for KYB and supplier triage, with the factors behind it. Not a credit score.
GET /v1/dossier

?cnpj=11222333000181

get_company_dossier$0.10Registration data, signals and score in one call.
GET /v1/batch

?cnpjs=11222333000181,19131243000197

batch_company_score$0.015 / CNPJScore up to 10 CNPJs in one call. Invalid-format CNPJs are not billed.
Reference
GET /v1/cep

?cep=38400100

lookup_cep$0.003Address by CEP, IBGE codes and coordinates when available.
GET /v1/business-days

?date=2026-10-09&add=1

business_days$0.003Is it a business day, next/previous business day, add N business days, count business days (national holidays).
GET /v1/ratesget_rates$0.005Selic target, CDI, IPCA and USD/BRL from the Central Bank (SGS), each with its reference date.

How payment works

  1. Call an endpoint (or MCP tool) without payment: you get HTTP 402 with the price, network (Base, eip155:8453), asset (USDC) and receiving address.
  2. Your x402 client signs the USDC payment and retries the same request.
  3. The request runs and the payment settles through the Coinbase CDP facilitator. Invalid input and upstream failures return 4xx/5xx and are not charged.

Data sources and limits

  • Company data: Receita Federal public registry via BrasilAPI, cached up to 24h; retrievedAt is the real query time. If the upstream is down, the last known record (up to 7 days) is returned with stale: true. Nothing is fabricated.
  • Rates: Banco Central do Brasil, SGS series 432, 4389, 12, 433, 13522 and 1, each value with its own reference date.
  • Boleto: Febraban layout (modulo 10/11) and bank specifications. After the 22/02/2025 due-date factor reset some factors map to two dates; the response flags this and returns the alternative.
  • PIX: Banco Central BR Code specification (EMV MPM, CRC16-CCITT). Payloads are not stored.
  • Business days: national holidays only (includes Carnaval and Corpus Christi); state and municipal holidays are not included.
  • The company score is an explainable heuristic over public registration data, not a credit score.

Machine-readable