Provides access to Brasil API's data services through GitHub, as the MCP server is hosted and can be cloned from GitHub (https://github.com/guilhermelirio/brasil-api-mcp).
Enables package management for the Brasil API MCP server, allowing users to install dependencies and build the project using npm commands.
Supports TypeScript integration as shown in the example code snippets for querying Brazilian address data and currency exchange rates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Brasil API MCP what's the address for postal code 01311000?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server that provides tools to query various Brazilian data services via the Brasil API.
Brasil API MCP is a bridge that connects AI assistants to Brazilian public data services through the standardized Model Context Protocol. It provides access to various information such as:
Postal Codes (CEP)
Company Registration (CNPJ)
Bank information
Area codes (DDD)
IBGE (Brazilian Institute of Geography and Statistics) data
Currency exchange rates
Domain registration status (.br domains)
Related MCP server: mcp-brasil
# Clone the repository
git clone https://github.com/guilhermelirio/brasil-api-mcp
cd brasil-api-mcp
# Install dependencies
npm install
# Build the project
npm run buildTo run the server:
npm startThis will start the MCP server that communicates via standard input/output (stdio).
cep-search - Query address information from a Brazilian postal code (CEP)
cnpj-search - Query information about a Brazilian company by its CNPJ (National Registry of Legal Entities)
bank-search - Find information about a Brazilian bank by its code
bank-list - List all Brazilian banks
ddd-search - Find information about a Brazilian area code (DDD)
ibge-states-list - List all Brazilian states with their information
ibge-state-search - Find information about a Brazilian state by its code or abbreviation
ibge-municipalities-list - List all municipalities of a Brazilian state by its abbreviation
cambio-currencies-list - List all available currencies for exchange rates
cambio-rate - Get exchange rates for a specific currency on a specific date
registrobr-domain-check - Check the status and availability of a .br domain name
// Sample request to the CEP tool
const response = await callMcpTool("cep-search", {
cep: "01001000"
});
// Response provides address details:
// {
// cep: "01001000",
// state: "SP",
// city: "São Paulo",
// neighborhood: "Sé",
// street: "Praça da Sé",
// service: "viacep"
// }// Sample request to get USD exchange rate
const response = await callMcpTool("cambio-rate", {
currency: "USD",
date: "2023-08-10"
});
// Response provides detailed exchange informationThis project uses the Brasil API service, which aggregates various APIs related to Brazilian public data. Special thanks to the Brasil API team for providing this valuable service to the community.
List all Brazilian banks
Inputs: no named parameters.
Find information about a Brazilian bank by its code
Inputs: code (required).
List all available currencies for exchange rates
Inputs: no named parameters.
Get exchange rates for a specific currency on a specific date
Inputs: currency (required), date (required).
Query address information from a Brazilian postal code (CEP)
Inputs: cep (required).
Query information about a Brazilian company by its CNPJ (National Registry of Legal Entities)
Inputs: cnpj (required).
Get information about a Brazilian area code (DDD) including state and cities
Inputs: ddd (required).
List all municipalities of a Brazilian state by its abbreviation
Inputs: uf (required).
Find information about a Brazilian state by its code or abbreviation
Inputs: code (required).
List all Brazilian states with their information
Inputs: no named parameters.
Check the status and availability of a .br domain name
Inputs: domain (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 11 tools
Each tool has a clearly distinct purpose targeting different Brazilian data domains: banks, exchange rates, postal codes, company registrations, area codes, IBGE geographic data, and domain checks. There is no overlap in functionality, and an agent can easily distinguish between them based on their specific resource focus.
The naming follows a mostly consistent pattern using hyphen-separated words (e.g., bank-list, cep-search), with clear verb-noun or noun-verb structures. Minor deviations exist, such as 'cambio-currencies-list' (noun-noun-verb) and 'registrobr-domain-check' (brand-noun-verb), but overall, the naming is predictable and readable.
With 11 tools, the server is well-scoped for providing Brazilian data services. Each tool serves a distinct and useful purpose, covering key areas like banking, geography, and business data without being overwhelming or sparse, making it efficient for agents to navigate.
The tool set offers comprehensive coverage for querying Brazilian data, including banks, exchange rates, postal addresses, company information, area codes, state and municipality details, and domain checks. There are no obvious gaps; it supports a wide range of common data retrieval needs in this domain.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Open Finance API and MCP discovery for developers and AI agents building in Brazil.
