MCP Brazil Public Data
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lookup_cnpjA | Look up the registration data of a Brazilian company by its CNPJ. Returns legal name, trade name, registration status, legal nature, CNAE (primary and secondary activities), address, partners (QSA) and share capital. Source: Brazilian Federal Revenue via BrasilAPI. |
| lookup_cepA | Look up the full address for a Brazilian postal code (CEP). Returns street, neighborhood, city, state (UF) and, when available, geographic coordinates. Uses BrasilAPI's CEP v2 endpoint, which aggregates multiple providers (Correios, ViaCEP and others). |
| list_banksA | List all banks registered in Brazil (~250 institutions). Each item includes the COMPE code ( |
| get_bankA | Get a bank's data by its COMPE code. Returns ISPB, name, full name and bank code. |
| lookup_dddA | Look up the state and cities served by a Brazilian area code (DDD). Returns the state (UF) and the list of municipalities covered by the code. |
| list_holidaysA | List the Brazilian national holidays for a given year. Returns each holiday with its date (YYYY-MM-DD), name and type (national, movable, etc.). Does not include state or municipal holidays. |
| lookup_isbnA | Look up a book's metadata by its ISBN. Returns title, authors, publisher, year, synopsis and dimensions when available, aggregating providers such as CBL, Mercado Editorial and Google Books. |
| list_ratesA | List all available economic rates and indices with their current values. Includes indicators such as SELIC, CDI and IPCA. Each item has the symbol
( |
| get_rateB | Get the current value of an economic rate/index by its symbol. Returns the name and the current value of the indicator. |
| lookup_brokerA | Look up a CVM-authorized brokerage firm by its CNPJ. Returns trade name, legal name, status, address and contacts registered with the CVM (Brazilian Securities and Exchange Commission). |
| list_currenciesA | List the foreign currencies available for quotes (USD, EUR and others). Each item includes the symbol, name and type of the currency. Use the
returned symbol with |
| get_exchange_rateA | Get the buy/sell exchange rate of a currency on a specific date. Returns the Central Bank's PTAX rates (buy/sell) for the given date. Note: quotes are only available on business days. |
| list_statesA | List the 27 Brazilian federative units (states) with their IBGE codes. Each item includes the id (IBGE code), abbreviation (UF), name and region. |
| list_municipalitiesA | List the municipalities of a state with their IBGE codes. Returns the name and IBGE code of each municipality in the given state. |
| check_br_domainA | Check the status of a .br domain at Registro.br. Returns the status (available, registered, etc.), suggestions and, for registered domains, the creation, expiration and last-processed dates. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_company | Generate a structured analysis of a company from its CNPJ. |
| economic_overview | Build an economic overview combining current rates and the year's holidays. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Most tools are distinct (CNPJ, CEP, DDD, ISBN, bank, broker, domain are clearly separate). However, list_rates/get_rate and list_currencies/get_exchange_rate are legitimate duos, but list_banks/get_bank alongside list_rates/get_rate create a repetitive pattern where the list/get pairing could cause an agent to pick the wrong 'get' for a given symbol/code. list_states and list_municipalities are related but distinct enough.
The set follows a mostly consistent pattern: list_X for enumeration (list_states, list_banks, list_holidays, list_rates, list_currencies, list_municipalities), lookup_X for single-record lookups by identifier (lookup_cnpj, lookup_cep, lookup_ddd, lookup_isbn, lookup_broker), and get_X for fetching specific values (get_bank, get_rate, get_exchange_rate). The mixing of 'lookup' and 'get' for similar operations is the only inconsistency, though both are clear.
15 tools is slightly on the higher side but reasonable for a broad 'public data' server covering multiple domains (geography, companies, finance, telecom, books, domains). Each tool targets a distinct data source, so none feel redundant. Could arguably be trimmed, but the scope justifies the count.
The server covers a broad but shallow set of disjoint domains. Within each domain there are clear gaps: holidays has no state/municipal holidays (noted in description), banks has list+get but no search-by-name, rates/currencies are read-only with no historical range beyond specific date for exchange. The domain is inherently a heterogeneous reference service, so completeness is hard to define, but several common lookups (e.g., CNPJ search by name, CEP range) are absent.