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)
# 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 codebank-list- List all Brazilian banks
ddd-search- Find information about a Brazilian area code (DDD)
ibge-states-list- List all Brazilian states with their informationibge-state-search- Find information about a Brazilian state by its code or abbreviationibge-municipalities-list- List all municipalities of a Brazilian state by its abbreviation
cambio-currencies-list- List all available currencies for exchange ratescambio-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.