MCP-CEP
Used to clone the repository during installation process.
Enables cloning a repository from GitHub to set up the MCP server.
Supported as an operating system for running the MCP server with specific activation commands.
Supported as an operating system for running the MCP server with specific activation commands.
Used as the runtime environment for the MCP server implementation.
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., "@MCP-CEP buscar o endereço do CEP 01001000"
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-CEP
MCP server for querying ZIP codes using the ViaCEP public API.
Compatible with Goose as a Command-line Extension.
👤 Author
Wendell Barreto
https://github.com/wendellbigato
🚀 Installation
1. Clone this repository
git clone https://github.com/wendellbigato/mcp-cep.git
cd mcp-cepPlease change the above URL to the real one when posting.
2. Create and activate the virtual environment
python3.11 -m venv .venv
source .venv/bin/activate # Linux/macOS
# ou
.venv\Scripts\activate.bat # Windows3. Install dependencies with uv or pip
Using uv :
uv pip install -e ".[cli]"Or with normal pip:
pip install -e ".[cli]"Related MCP server: cep-tools
🧩 Setting up as an extension in Goose
Execute:
goose configureSelect
Add ExtensionChoose
Command-line ExtensionFill in the fields:
Field | Value |
Extension name |
|
Command to run |
|
Timeout |
|
Environment | (blank, or customize if needed) |
Use which uv and pwd to find the correct paths.
✅ How to test on Goose
After setting up, start:
goose session --with-extension mcp-cepAnd send commands like:
Repita: Olá!
Qual o endereço do CEP 01001000?🧰 Available tools
echo(texto: str): repeats the sent text.buscar_cep(cep: str): query address information via ViaCEP.
📄 License
This project is licensed under the MIT License.
Available Tools
3 toolsbuscar_cepB
Consulta informações de um CEP brasileiro usando a API ViaCEP.
Args:
cep: Código de Endereçamento Postal no formato 01001000 ou 01001-000.
Returns:
Um dicionário com informações de endereço como rua, bairro, cidade e estado.
Inputs: cep (required).
buscar_ceps_por_logradouroA
Busca todos os CEPs associados a um logradouro em uma cidade e estado.
Args:
uf: Sigla do estado (ex: SP, RJ)
cidade: Nome da cidade (ex: São Paulo)
logradouro: Nome da rua, avenida, praça etc (ex: Praça da Sé)
Returns:
Lista de dicionários com endereços que correspondem à busca.
Inputs: uf (required), cidade (required), logradouro (required).
echoB
Repete o texto enviado.
Inputs: texto (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The first two tools have clearly distinct purposes: buscar_cep queries by CEP number, while buscar_ceps_por_logradouro queries by address components. However, the echo tool is completely unrelated to the CEP domain, creating a minor ambiguity about the server's primary focus. The core CEP tools are well-differentiated.
Two tools follow a consistent Portuguese verb_noun pattern (buscar_cep, buscar_ceps_por_logradouro), but the third tool (echo) breaks this pattern with an English name. The naming is readable but lacks full consistency across the set due to the language and pattern mismatch.
Three tools is borderline for a CEP server. While the two core CEP tools provide basic lookup functionality, the inclusion of an unrelated echo tool makes the count feel artificially inflated. For a focused CEP service, 2-4 domain-specific tools would be more appropriate.
The server covers the essential CEP lookup operations: query by CEP and query by address components. However, there are notable gaps for a complete CEP service - no tools for address validation, reverse geocoding, or handling CEP ranges. The echo tool adds no value to the CEP domain coverage.
Related MCP Connectors
Correios: Completa CEP (CEP + Área territorial brasileira), official-source lookup. Platform-hosted,
Correios: CEP, official-source lookup. Platform-hosted, pay per query with prepaid credit.
Returns the postal code (CEP) and standardized address from the Brazilian Post from a given address.
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.212MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides a tool to query Brazilian postal codes (CEPs) via the ViaCEP API, returning address details such as street, neighborhood, city, and state.-
- AlicenseNot gradedqualityDmaintenanceEnables querying Brazilian CEP (postal code) addresses via the public ViaCEP API, returning formatted HTML with address details.GPL 3.0
- AlicenseNot gradedqualityDmaintenanceMCP server for querying Brazilian postal codes (CEP) from the official Correios source, supporting read-only lookups via natural language in any MCP-compatible client.MIT