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.
Brasil API MCP
A Model Context Protocol (MCP) server that provides tools to query various Brazilian data services via the Brasil API.
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 codebank-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 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 (Currency Exchange)
cambio-currencies-list
- List all available currencies for exchange ratescambio-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 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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.
Related MCP Servers
- -securityFlicense-qualityA versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.Last updated -13Python
- AsecurityFlicenseAqualityA Model Context Protocol server providing AI assistants with access to healthcare data tools, including FDA drug information, PubMed research, health topics, clinical trials, and medical terminology lookup.Last updated -71616JavaScript
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -161TypeScript
- -securityFlicense-qualityA Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.Last updated -1Python