Brasil Data (pay-per-call via x402)

Working · 926 ms

dev.workers.wagner-proc.brasil-data-x402/brasil-datav0.1.0 Domain verified

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

Legal & Government Finance & Payments

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://brasil-data-x402.wagner-proc.workers.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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}}]}

querystring, required

COMPE code (e.g. 260), ISPB (8 digits), CNPJ, or name

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (8)

bank_lookup

Argument	Type	Description
query*	string	COMPE code (e.g. 260), ISPB (8 digits), CNPJ, or name

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "COMPE code (e.g. 260), ISPB (8 digits), CNPJ, or name"
    }
  }
}

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"}

Argument	Type	Description
to	string	End date YYYY-MM-DD (count mode, inclusive)
add	integer	Business days to add (negative to subtract)
date	string	Base date YYYY-MM-DD (add/check mode)
from	string	Start date YYYY-MM-DD (count mode, exclusive)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD (count mode, inclusive)"
    },
    "add": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Business days to add (negative to subtract)"
    },
    "date": {
      "type": "string",
      "description": "Base date YYYY-MM-DD (add/check mode)"
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (count mode, exclusive)"
    }
  }
}

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"}

Argument	Type	Description
cep*	string	CEP, 8 digits, e.g. 01001-000

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cep"
  ],
  "properties": {
    "cep": {
      "type": "string",
      "description": "CEP, 8 digits, e.g. 01001-000"
    }
  }
}

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"}]}

Argument	Type	Description
cnpj*	string	CNPJ, 14 chars, with or without punctuation (alphanumeric supported)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cnpj"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "CNPJ, 14 chars, with or without punctuation (alphanumeric supported)"
    }
  }
}

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"}]}

Argument	Type	Description
year*	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1990
    }
  }
}

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}]}

Argument	Type	Description
months	integer	Months of history (default 12)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "months": {
      "type": "integer",
      "maximum": 60,
      "minimum": 1,
      "description": "Months of history (default 12)"
    }
  }
}

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"}

Argument	Type	Description
date	string	YYYY-MM-DD (default today, BRT)
currency	string	ISO currency code (default USD)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (default today, BRT)"
    },
    "currency": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO currency code (default USD)"
    }
  }
}

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."}}

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}