# BR Intelligence

Paid x402 API turning Brazilian public registration data into decision-ready intelligence for AI agents.
Responses are cached and enriched — not raw passthrough.

## Endpoints (pay-per-call, USDC via x402)
- GET /v1/validate?type=cnpj&value=...  ($0.005) — validate CPF, CNPJ, EAN-13, NF-e keys, phone.
- GET /v1/company?cnpj=...              ($0.01)  — structured company registration data.
- GET /v1/score?cnpj=...               ($0.02)  — company health/risk score 0-100 with explainable factors (KYB triage).
- GET /v1/dossier?cnpj=...             ($0.10)  — full dossier: company data + signals + health score.
- GET /v1/batch?cnpjs=A,B,C            ($0.015 per valid CNPJ, up to 10) — health score for a list of suppliers/customers in one call.
- GET /v1/boleto?code=...              ($0.005) — validate/decode a boleto (digitable line or barcode): bank, amount, due date, check digits.
- GET /v1/pix?payload=...              ($0.005) — validate/decode a PIX copia-e-cola: CRC, key, merchant, amount, txid.
- GET /v1/cep?cep=...                  ($0.003) — address by CEP, IBGE codes, coordinates.
- GET /v1/bank?code=... | ?ispb=...    ($0.002) — bank by COMPE code or ISPB.
- GET /v1/business-days?date=...[&add=N | &end=...] ($0.003) — business-day checks, add N business days, count business days.
- GET /v1/rates                        ($0.005) — Selic target, CDI, IPCA, USD/BRL from the Central Bank (SGS), with reference dates.

## MCP
- Same capabilities as MCP tools at /mcp (Streamable HTTP), paid per call with x402 in _meta.

## Notes
- Score is an explainable heuristic over public cadastral data (Receita via BrasilAPI). Not a credit score.
- Network: Base mainnet (eip155:8453). Settlement in USDC via the Coinbase CDP facilitator.