# Brasil Data (pay-per-call via x402)

> Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).

- name: dev.workers.wagner-proc.brasil-data-x402/brasil-data
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 63/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/dev.workers.wagner-proc.brasil-data-x402%2Fbrasil-data
- tools: https://api.protogrid.dev/v1/servers/dev.workers.wagner-proc.brasil-data-x402%2Fbrasil-data/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "brasil-data": {
      "type": "http",
      "url": "https://brasil-data-x402.wagner-proc.workers.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 98
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-94% +updated-13d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 63/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: cnpj_lookup (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); selic_rate (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); bank_lookup (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,321 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 8 tool changes in 30 days
- fail `stability.rug_pull`: 3 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 1,321 tokens to load them all
- tool set hash: faec334a8f1bf4163c7fa20c8ed5b1b2
- tools last changed: 2026-10-15T16:31:30.111Z
- badge: [![protogrid quality](https://protogrid.dev/badge/dev.workers.wagner-proc.brasil-data-x402/brasil-data.svg)](https://protogrid.dev/servers/dev.workers.wagner-proc.brasil-data-x402/brasil-data)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-15 `holidays` changed (description) **meaning changed**
  - before: Brazilian national and banking holidays for a year (incl. Carnival, Good Friday, Corpus Christi, Nov 20). Free.
  - after: Brazilian national and banking holidays for a year (incl. Carnival, Good Friday, Corpus Christi, Nov 20). Free. Example response: {"year":2026,"holidays":[{"date":"2026-01-01","name":"Confraternização Universal","name_en":"New Year's Day","kind":"national"},{"date":"2026-02-16","name":"Carnaval (segunda-feira)","kind":"banking"}]}
- 2026-10-15 `cep_lookup` changed (description) **meaning changed**
  - before: Brazilian postal code (CEP) to address: street, district, city, UF, IBGE city code, DDD. Free.
  - after: Brazilian postal code (CEP) to address: street, district, city, UF, IBGE city code, DDD. Free. Example response: {"cep":"01001000","street":"Praça da Sé","district":"Sé","city":"São Paulo","uf":"SP","region":"Sudeste","city_ibge":"3550308","ddd":"11"}
- 2026-10-15 `bank_lookup` changed (description)
  - before: Brazilian bank / payment institution lookup by COMPE code, ISPB, CNPJ or name, merged from Banco Central's STR participant list and active Pix participant list. Price: $0.005 USDC per call via x402.
  - after: Brazilian bank / payment institution lookup by COMPE code, ISPB, CNPJ or name, merged from Banco Central's STR participant list and active Pix participant list. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"query":"260","count":1,"results":[{"ispb":"18236120","compe_code":"260","short_name":"NU PAGAMENTOS - IP","cnpj":"18236120000158","pix":{"participant":true}}]}
- 2026-10-15 `business_days` changed (description)
  - before: Brazilian business-day calculator (national + banking holidays): count business days between two dates (DU convention, (from, to]) or add N business days to a date. Price: $0.005 USDC per call via x402.
  - after: Brazilian business-day calculator (national + banking holidays): count business days between two dates (DU convention, (from, to]) or add N business days to a date. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"mode":"count","from":"2026-10-01","to":"2026-10-31","business_days":20,"calendar":"BR national + banking holidays"}
- 2026-10-15 `ptax_exchange_rate` changed (description)
  - before: Official PTAX exchange rate (BRL per unit of foreign currency) published by Banco Central do Brasil for a given date; falls back to the last bulletin before a weekend/holiday. Price: $0.005 USDC per call via x402.
  - after: Official PTAX exchange rate (BRL per unit of foreign currency) published by Banco Central do Brasil for a given date; falls back to the last bulletin before a weekend/holiday. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"currency":"USD","requested_date":"2026-10-14","quote_date":"2026-10-14","buy_brl":5.0435,"sell_brl":5.0441,"bulletin":"Fechamento PTAX"}
- 2026-10-15 `ipca_inflation` changed (description)
  - before: Brazilian official inflation (IPCA, IBGE via BCB): latest monthly change, 12-month accumulated, and monthly history. Price: $0.005 USDC per call via x402.
  - after: Brazilian official inflation (IPCA, IBGE via BCB): latest monthly change, 12-month accumulated, and monthly history. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"latest_month":{"reference":"2026-09","value":0.82,"unit":"% a.m."},"accumulated_12m":{"reference":"2026-09","value":4.58,"unit":"%"},"history":[{"reference":"2026-08","value":-0.32},{"reference":"2026-09","value":0.82}]}
- 2026-10-15 `selic_rate` changed (description)
  - before: Current Brazilian policy rate (Selic target set by Copom), effective daily Selic and CDI, annualized, from Banco Central do Brasil. Price: $0.005 USDC per call via x402.
  - after: Current Brazilian policy rate (Selic target set by Copom), effective daily Selic and CDI, annualized, from Banco Central do Brasil. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"selic_target":{"value":13.75,"unit":"% a.a.","as_of":"2026-10-15"},"selic_daily_annualized":{"value":13.65,"unit":"% a.a."},"cdi_annualized":{"value":13.65,"unit":"% a.a."}}
- 2026-10-15 `cnpj_lookup` changed (description) **meaning changed**
  - before: Brazilian company (CNPJ) registry lookup from Receita Federal open data, normalized: legal/trade name, status, CNAE activities, address, Simples/MEI, partners (QSA). Supports alphanumeric CNPJ. Price: $0.01 USDC per call via x402.
  - after: Brazilian company (CNPJ) registry lookup from Receita Federal open data, normalized: legal/trade name, status, CNAE activities, address, Simples/MEI, partners (QSA). Supports alphanumeric CNPJ. Price: $0.01 USDC per call via x402; first call per tool per day is free. Example response: {"cnpj":"19131243000197","legal_name":"OPEN KNOWLEDGE BRASIL","trade_name":"REDE PELO CONHECIMENTO LIVRE","status":{"description":"ATIVA","since":"2013-10-03"},"opened_on":"2013-10-03","main_activity":{"cnae":"9430800","description":"Atividades de associações de defesa de direitos sociais"},"address":{"street":"AVENIDA PAULISTA 37","district":"BELA VISTA","city":"SAO PAULO","uf":"SP","cep":"01311902"},"simples_nacional":{"opted":null},"partners":[{"name":"LUIZ CARLOS PINHO GUEDES","role":"Diretor"}]}

Full history: https://api.protogrid.dev/v1/servers/dev.workers.wagner-proc.brasil-data-x402%2Fbrasil-data/changes

## Remotes

- https://brasil-data-x402.wagner-proc.workers.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.94)

## Packages

_none_

## Tools (8)

- `bank_lookup`: Brazilian bank / payment institution lookup by COMPE code, ISPB, CNPJ or name, merged from Banco Central's STR participant list and active Pix participant list. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"query":"260","count":1,"results":[{"ispb":"18236120","compe_code":"260","short_name":"NU PAGAMENTOS - IP","cnpj":"18236120000158","pix":{"participant":true}}]}
- `business_days`: Brazilian business-day calculator (national + banking holidays): count business days between two dates (DU convention, (from, to]) or add N business days to a date. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"mode":"count","from":"2026-10-01","to":"2026-10-31","business_days":20,"calendar":"BR national + banking holidays"}
- `cep_lookup`: Brazilian postal code (CEP) to address: street, district, city, UF, IBGE city code, DDD. Free. Example response: {"cep":"01001000","street":"Praça da Sé","district":"Sé","city":"São Paulo","uf":"SP","region":"Sudeste","city_ibge":"3550308","ddd":"11"}
- `cnpj_lookup`: Brazilian company (CNPJ) registry lookup from Receita Federal open data, normalized: legal/trade name, status, CNAE activities, address, Simples/MEI, partners (QSA). Supports alphanumeric CNPJ. Price: $0.01 USDC per call via x402; first call per tool per day is free. Example response: {"cnpj":"19131243000197","legal_name":"OPEN KNOWLEDGE BRASIL","trade_name":"REDE PELO CONHECIMENTO LIVRE","status":{"description":"ATIVA","since":"2013-10-03"},"opened_on":"2013-10-03","main_activity":{"cnae":"9430800","description":"Atividades de associações de defesa de direitos sociais"},"address":{"street":"AVENIDA PAULISTA 37","district":"BELA VISTA","city":"SAO PAULO","uf":"SP","cep":"01311902"},"simples_nacional":{"opted":null},"partners":[{"name":"LUIZ CARLOS PINHO GUEDES","role":"Diretor"}]}
- `holidays`: Brazilian national and banking holidays for a year (incl. Carnival, Good Friday, Corpus Christi, Nov 20). Free. Example response: {"year":2026,"holidays":[{"date":"2026-01-01","name":"Confraternização Universal","name_en":"New Year's Day","kind":"national"},{"date":"2026-02-16","name":"Carnaval (segunda-feira)","kind":"banking"}]}
- `ipca_inflation`: Brazilian official inflation (IPCA, IBGE via BCB): latest monthly change, 12-month accumulated, and monthly history. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"latest_month":{"reference":"2026-09","value":0.82,"unit":"% a.m."},"accumulated_12m":{"reference":"2026-09","value":4.58,"unit":"%"},"history":[{"reference":"2026-08","value":-0.32},{"reference":"2026-09","value":0.82}]}
- `ptax_exchange_rate`: Official PTAX exchange rate (BRL per unit of foreign currency) published by Banco Central do Brasil for a given date; falls back to the last bulletin before a weekend/holiday. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"currency":"USD","requested_date":"2026-10-14","quote_date":"2026-10-14","buy_brl":5.0435,"sell_brl":5.0441,"bulletin":"Fechamento PTAX"}
- `selic_rate`: Current Brazilian policy rate (Selic target set by Copom), effective daily Selic and CDI, annualized, from Banco Central do Brasil. Price: $0.005 USDC per call via x402; first call per tool per day is free. Example response: {"selic_target":{"value":13.75,"unit":"% a.a.","as_of":"2026-10-15"},"selic_daily_annualized":{"value":13.65,"unit":"% a.a."},"cdi_annualized":{"value":13.65,"unit":"% a.a."}}