MCP Brasil API
Click on "Install 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., "@MCP Brasil APIconsulta CEP 01310-000"
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.
MCP Brasil API
Plugando a Brasil API em todos os LLMs através do Model Context Protocol
Visão Geral
MCP Brasil API é um projeto open source que disponibiliza dados da Brasil API através do Model Context Protocol (MCP). Funcionando como um adaptador universal (similar a uma porta USB-C para integrações de IA), este projeto transforma endpoints de dados brasileiros em serviços MCP padronizados, facilitando o acesso a informações locais por assistentes de IA, LLMs e aplicações que utilizam o padrão MCP.
Related MCP server: Brasil API MCP
Recursos Disponíveis
Consulta de CEP: Obtenha informações detalhadas de endereços a partir de um CEP
Consulta de CNPJ: Recupere dados cadastrais de empresas a partir de um CNPJ
Consulta de DDD: Consulte estado e cidades atendidas por um DDD brasileiro
Consulta de Cambio: Consulte o cambio internacional pareado com o Real
Consulta de Bancos: Consulte informações dos bancos através do nome ou codigo bancário
Por que MCP?
Com a crescente demanda por integrações entre LLMs e dados reais, o Model Context Protocol (MCP) oferece:
Integração Padronizada: Conecte diversos dados e serviços com um único protocolo
Escalabilidade: Adicione ou substitua servidores MCP sem alterar a lógica do cliente
Segurança e Eficiência: Gerencie integrações com melhores práticas de segurança e desempenho
Flexibilidade: Permite expandir facilmente para novos endpoints da Brasil API conforme necessário
Instalação
# Instale via pip
pip install mcp-brasil-api
# Ou clone o repositório
git clone https://github.com/lucianfialho/mcp-brasil-api
cd mcp-brasil-api
pip install -e .Configuração
Crie um arquivo .env baseado no .env.example com as seguintes configurações:
API_BASE_URL=https://brasilapi.com.br/api
USER_AGENT=brasil-api/1.0Uso
Executando o servidor MCP
# Iniciar o servidor
brasil-api-mcpConfiguração com Smithery
O projeto inclui configuração para Smithery, permitindo inicialização rápida:
# Configuração em smithery.yaml
api_base_url: "https://brasilapi.com.br/api"
user_agent: "brasil-api/1.0"Exemplos de uso com cliente MCP
from mcp.client import McpClient
# Conecte ao servidor MCP Brasil API
client = McpClient("http://localhost:8000")
# Liste as ferramentas disponíveis
tools = client.list_tools()
print(tools)
# Consulte um CEP
cep_info = client.invoke_tool("consultar_cep", "01001-000")
print(cep_info)
# Consulte um CNPJ
cnpj_info = client.invoke_tool("consultar_cnpj", "00.000.000/0001-91")
print(cnpj_info)
# Consulte um DDD
ddd_info = client.invoke_tool("consultar_ddd", "11")
print(ddd_info)
# Consulte um feriados
feriados_info = client.invoke_tool("consultar_feriados", "1989")
print(feriados_info)
# Consulte cotação de moedas comparadas ao Real
cambio_info = client.invoke_tool("consultar_cambio", {"moeda": "USD"}, {"data": "2025-05-02"})
print(cambio_info)
# Consulte cotação de moedas comparadas ao Real
cambio_info = client.invoke_tool("consultar_cambio_info", "USD", "2025-05-02")
print(cambio_info)
# Consulte informações bancárias
banco_info = client.invoke_tool("consultar_banco_info", "1")
print(banco_info)
# Consulte os feriados de um ano
feriados_info = client.invoke_tool("consultar_feriados", "2025")
print(feriados_info)Integração com LLMs (Claude, ChatGPT, etc.)
from anthropic import Anthropic
from mcp.client import McpClient
# Configure cliente MCP
mcp_client = McpClient("http://localhost:8000")
tools = mcp_client.list_tools()
# Configure o cliente Claude com as ferramentas do MCP
anthropic = Anthropic()
response = anthropic.messages.create(
model="claude-3-5-sonnet-20240229",
max_tokens=1000,
temperature=0,
system="Você tem acesso a dados brasileiros via MCP.",
messages=[{
"role": "user",
"content": "Encontre informações sobre o CEP 01001-000"
}],
tools=tools # Registra as ferramentas do MCP Brasil API
)Estrutura do Projeto
mcp-brasil-api/
├── src/
│ ├── tools/ # Implementações das ferramentas MCP
│ │ ├── cep.py # Ferramenta para consulta de CEP
│ │ └── cnpj.py # Ferramenta para consulta de CNPJ
│ ├── utils/ # Funções utilitárias
│ │ ├── api.py # Cliente HTTP para Brasil API
│ │ ├── formatters.py # Formatação de dados
│ │ └── validators.py # Validação de dados
│ └── config.py # Configurações da aplicação
├── server.py # Servidor MCP principal
├── Dockerfile # Containerização
├── pyproject.toml # Configuração do pacote Python
└── smithery.yaml # Configuração para SmitheryRoadmap
Consulta de CEP
Consulta de CNPJ
Consulta de DDD
Suporte a câmbio
Suporte a bancos e instituições financeiras
Suporte a feriados nacionais
Taxas e índices econômicos
Cotações de moedas
🤝 Contribuições
Contribuições são bem-vindas! Por favor, leia nosso guia de contribuição antes de enviar pull requests.
Faça um fork do projeto
Crie sua branch de recurso (
git checkout -b feature/novo-recurso)Commit suas mudanças (
git commit -m 'Adiciona novo recurso')Push para a branch (
git push origin feature/novo-recurso)Abra um Pull Request
📄 Licença
Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.
🙏 Agradecimentos
Brasil API por fornecer os dados públicos
MCP (Model Context Protocol) por padronizar a comunicação entre modelos e fontes de dados
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseBqualityDmaintenanceQuery a variety of data from Brasil resources seamlessly. Access information on postal codes, area codes, banks, holidays, taxes, and more through a unified interface. Enhance your AI agents and applications with rich and updated data from BrasilAPI effortlessly.67
- AlicenseAqualityDmaintenanceA 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.1194MIT
- Alicense-quality-maintenanceConnects AI agents to 28 Brazilian public APIs, providing over 200 tools to access data on economy, legislation, transparency, and the judiciary. It enables complex queries and cross-referencing of government datasets like IBGE, the Central Bank, and the National Congress through natural language.
- AlicenseAqualityCmaintenanceExposes the BrasilAPI as MCP tools, enabling AI agents to query Brazilian public data such as CEP, CNPJ, DDD, IBGE, banks, PIX, FIPE, NCM, exchange rates, taxes, weather, CVM information, holidays, ISBN, domains, stock tickers, and TUSS.41Apache 2.0
Related MCP Connectors
Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.
Validate LatAm IDs: Mexican CLABE, Brazilian CNPJ/CPF checksums + BrasilAPI company/CEP/bank lookups
Free Brazilian CNPJ lookup (legal name, status, partners) + lawsuit discovery. Public data, no login
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/lucianfialho/mcp-brasil-api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server