BR Intelligence

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

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

HTTP	MCP tool	Price	What it does
Payments
GET /v1/boleto ?code=00190500954014481606906809350314337370000000100	decode_boleto	$0.005	Validate 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.005	Validate 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.002	Bank by COMPE code or ISPB: short and full legal name.
Companies
GET /v1/validate ?type=cnpj&value=12ABC34501DE35	validate_identifier	$0.005	Validate 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.01	Registration data by CNPJ: legal name, status, address, partners (QSA), CNAE, capital.
GET /v1/score ?cnpj=11222333000181	get_company_score	$0.02	Explainable 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.10	Registration data, signals and score in one call.
GET /v1/batch ?cnpjs=11222333000181,19131243000197	batch_company_score	$0.015 / CNPJ	Score up to 10 CNPJs in one call. Invalid-format CNPJs are not billed.
Reference
GET /v1/cep ?cep=38400100	lookup_cep	$0.003	Address by CEP, IBGE codes and coordinates when available.
GET /v1/business-days ?date=2026-10-09&add=1	business_days	$0.003	Is it a business day, next/previous business day, add N business days, count business days (national holidays).
GET /v1/rates	get_rates	$0.005	Selic 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

• llms.txt · OpenAPI 3.1 · x402 manifest · skill.md
• Listed on the official MCP Registry (io.github.Mironfvjr/br-intelligence), x402scan and mcpservers.org.