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
| 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
- Call an endpoint (or MCP tool) without payment: you get HTTP 402 with the price, network (Base,
eip155:8453), asset (USDC) and receiving address. - Your x402 client signs the USDC payment and retries the same request.
- 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;
retrievedAtis the real query time. If the upstream is down, the last known record (up to 7 days) is returned withstale: 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.