Skip to content

Brasil Data (pay-per-call via x402)

by brasil-data-x402.wagner-proc.workers.dev · remote · no sign-in to list tools · v0.1.0 · published by dev.workers.wagner-proc.brasil-data-x402

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

Final · 1Changes · 4

8 tools: 1 do something that can't be undone, 4 change things and 3 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http brasil-data https://brasil-data-x402.wagner-proc.workers.dev/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

8 tools

Can't be undone 1Claude Code: ask
  • business_daysBrazilian business-day calculator (national + banking holidays): count business days between two dates (DU convention, (from, to]) or add N business days to a date.No findings

    Why it is in this group

    • The input addresses people (input.to): what it sends cannot be taken back.
    Description, as the server wrote it
    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"}
Changes things 4Claude Code: ask
  • holidaysBrazilian national and banking holidays for a year (incl.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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_inflationBrazilian official inflation (IPCA, IBGE via BCB): latest monthly change, 12-month accumulated, and monthly history.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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_rateOfficial 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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_rateCurrent Brazilian policy rate (Selic target set by Copom), effective daily Selic and CDI, annualized, from Banco Central do Brasil.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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."}}
Only reads 3Claude Code: allow
  • bank_lookupBrazilian bank / payment institution lookup by COMPE code, ISPB, CNPJ or name, merged from Banco Central's STR participant list and active Pix participant list.No findings

    Why it is in this group

    • The name "bank_lookup" says "lookup": a word for reading.
    Description, as the server wrote it
    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}}]}
  • cep_lookupBrazilian postal code (CEP) to address: street, district, city, UF, IBGE city code, DDD.No findings

    Why it is in this group

    • The name "cep_lookup" says "lookup": a word for reading.
    Description, as the server wrote it
    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_lookupBrazilian company (CNPJ) registry lookup from Receita Federal open data, normalized: legal/trade name, status, CNAE activities, address, Simples/MEI, partners (QSA).No findings

    Why it is in this group

    • The name "cnpj_lookup" says "lookup": a word for reading.
    Description, as the server wrote it
    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"}]}

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http brasil-data https://brasil-data-x402.wagner-proc.workers.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__brasil-data__cnpj_lookup",
      "mcp__brasil-data__bank_lookup",
      "mcp__brasil-data__cep_lookup"
    ],
    "ask": [
      "mcp__brasil-data__selic_rate",
      "mcp__brasil-data__ipca_inflation",
      "mcp__brasil-data__ptax_exchange_rate",
      "mcp__brasil-data__business_days",
      "mcp__brasil-data__holidays"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as brasil-data. Review it before you use it.