# BR Intelligence

> Pay-per-call API (x402, USDC on Base) that turns Brazilian public company registration data (CNPJ) into decision-ready answers for AI agents: identifier validation, company lookup, explainable health/risk score (KYB triage) and full dossier. No signup, no API key: call, receive HTTP 402 with payment requirements, pay, retry.

## When to use
- Validate a Brazilian CPF, CNPJ, EAN-13 barcode, NF-e access key or phone number before storing or acting on it. Supports the new alphanumeric CNPJ (IN RFB 2.229/2024, issued from July 2026).
- Look up a Brazilian company by CNPJ (legal name, status, address, partners/QSA, CNAE activities, capital).
- Triage a supplier, customer or counterparty in Brazil with a 0-100 health/risk score and the factors behind it.
- Check a boleto before paying it: is the digitable line valid, which bank, how much, when is it due.
- Check a PIX copia-e-cola before paying it: is it intact (CRC), who receives it, which key, how much.
- Fill or validate a Brazilian address from a CEP; resolve a bank from a boleto or account code.
- Compute due dates and deadlines in business days; get current Selic, CDI, IPCA and dollar rates.

## Endpoints
- [GET /v1/validate?type={cpf|cnpj|ean13|nfe|phone}&value=...](https://br-intelligence.brverify-api.workers.dev/v1/validate): $0.005
- [GET /v1/company?cnpj=...](https://br-intelligence.brverify-api.workers.dev/v1/company): $0.01
- [GET /v1/score?cnpj=...](https://br-intelligence.brverify-api.workers.dev/v1/score): $0.02
- [GET /v1/dossier?cnpj=...](https://br-intelligence.brverify-api.workers.dev/v1/dossier): $0.10
- [GET /v1/batch?cnpjs=A,B,C](https://br-intelligence.brverify-api.workers.dev/v1/batch): $0.015 per valid CNPJ, up to 10 per call. Invalid-format CNPJs are not billed; if no item can be resolved, nothing is charged.
- [GET /v1/boleto?code=...](https://br-intelligence.brverify-api.workers.dev/v1/boleto): $0.005. Boleto de cobranca (47-digit line / 44-digit barcode) and arrecadacao (48 / 44 starting with 8). Returns bank, amount, due date and check digit results. The Febraban due-date factor reset (22/02/2025) makes some factors ambiguous: the most likely date is returned with "dueDateAmbiguous" and the alternative date.
- [GET /v1/pix?payload=...](https://br-intelligence.brverify-api.workers.dev/v1/pix): $0.005. PIX copia-e-cola (BR Code): CRC16 check, key and key type (CPF, CNPJ, e-mail, phone, random), merchant name/city, amount, txid, static or dynamic. Payloads are not stored.
- [GET /v1/cep?cep=...](https://br-intelligence.brverify-api.workers.dev/v1/cep): $0.003. Street, neighborhood, city, state, IBGE city/state codes and coordinates when available.
- [GET /v1/bank?code=...](https://br-intelligence.brverify-api.workers.dev/v1/bank): $0.002. Bank by COMPE code (or ?ispb=8 digits): short and full legal name, ISPB.
- [GET /v1/business-days?date=YYYY-MM-DD](https://br-intelligence.brverify-api.workers.dev/v1/business-days): $0.003. Without extra params: is it a business day, holiday name, next/previous business day. With &add=N: date after N business days. With &end=YYYY-MM-DD: business days between (start inclusive, end exclusive). National holidays only (includes Carnaval and Corpus Christi); state and municipal holidays are not included.
- [GET /v1/rates](https://br-intelligence.brverify-api.workers.dev/v1/rates): $0.005. Central Bank SGS series: Selic target (432), CDI annual (4389) and daily (12), IPCA monthly (433) and 12-month (13522), USD/BRL sell (1). Values carry their own reference date; future-dated Selic entries are ignored.

## MCP server
- Endpoint (Streamable HTTP): https://br-intelligence.brverify-api.workers.dev/mcp
- Tools: validate_identifier ($0.005), get_company ($0.01), get_company_score ($0.02), get_company_dossier ($0.10), batch_company_score ($0.015 per valid CNPJ), decode_boleto ($0.005), decode_pix ($0.005), lookup_cep ($0.003), lookup_bank ($0.002), business_days ($0.003), get_rates ($0.005), about (free).
- Paid tools use the x402 MCP transport: call without payment to receive PaymentRequired, retry with the payment in _meta["x402/payment"].

## Docs
- [OpenAPI](https://br-intelligence.brverify-api.workers.dev/openapi.json)
- [Agent skill](https://br-intelligence.brverify-api.workers.dev/skill.md)
- [x402 manifest](https://br-intelligence.brverify-api.workers.dev/.well-known/x402)

## Notes
- Data source: Receita Federal public registry via BrasilAPI. Responses cached up to 24h; "retrievedAt" is the real time the registry was queried.
- If the upstream registry is down, the last known record (up to 7 days old) is returned with "stale": true instead of failing.

## Contact
- norimjr@gmail.com
- The score is an explainable heuristic over public registration data. It is not a credit score.