Skip to main content
Glama

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-cep

Please 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  # Windows

3. Install dependencies with uv or pip

Using uv :

uv pip install -e ".[cli]"

Or with normal pip:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩 Setting up as an extension in Goose

  1. Execute:

goose configure
  1. Select Add Extension

  2. Choose Command-line Extension

  3. Fill in the fields:

Field

Value

Extension name

mcp-cep

Command to run

/caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py

Timeout

300

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-cep

And 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.

Install Server
A
license - permissive license
B
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

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/wendellbigato/mcp-cep'

If you have feedback or need assistance with the MCP directory API, please join our Discord server