Brasil API MCP
A Model Context Protocol (MCP) server that provides tools to query various Brazilian data services via the [Brasil API](https://brasilapi.com.br/).
Overview
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)
Installation
Usage
To run the server:
This will start the MCP server that communicates via standard input/output (stdio).
Available Tools
CEP (Postal Codes)
- `cep-search` - Query address information from a Brazilian postal code (CEP)
CNPJ (Company Registration)
- `cnpj-search` - Query information about a Brazilian company by its CNPJ (National Registry of Legal Entities)
Banks
- `bank-search` - Find information about a Brazilian bank by its code
- `bank-list` - List all Brazilian banks
DDD (Area Codes)
- `ddd-search` - Find information about a Brazilian area code (DDD)
IBGE (Geography and Statistics)
- `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 (Currency Exchange)
- `cambio-currencies-list` - List all available currencies for exchange rates
- `cambio-rate` - Get exchange rates for a specific currency on a specific date
Registro BR (Domain Registration)
- `registrobr-domain-check` - Check the status and availability of a .br domain name
Integration Examples
Querying a Brazilian Address by Postal Code
Getting Currency Exchange Rates
Credits
This project uses the [Brasil API](https://brasilapi.com.br/) 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.
License
MIT [Guilherme Lirio Tomasi de Oliveira](https://github.com/guilhermelirio)