</>
Consulta de CEP
Model Context Protocol

MCP Server para Consulta de CEP

Integre a consulta de CEP diretamente nas suas ferramentas de IA. Claude, ChatGPT, Cursor, Windsurf, VS Code e qualquer cliente MCP compatível.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA acessem ferramentas externas de forma padronizada. Com o MCP Server do Consulta de CEP, qualquer IA compatível pode buscar CEPs e endereços brasileiros diretamente durante uma conversa.

Em vez de você copiar e colar CEPs manualmente, basta pedir: "Busca o CEP da Praça da Sé em São Paulo" — e a IA faz a consulta automaticamente.

Tools disponíveis

TOOLbuscar_cep

Consulta um CEP e retorna o endereço completo (logradouro, bairro, cidade, UF, IBGE).

Parâmetro: cep — 8 dígitos (ex: 01001000)
TOOLbuscar_endereco

Pesquisa CEPs por endereço. Retorna até 50 resultados.

Parâmetros: uf — sigla do estado (ex: SP), cidade — nome da cidade, logradouro — nome da rua

Instalação

Claude.ai (chat web)

No Claude.ai, vá em Settings → Integrations → Add More e adicione a URL:

https://consultadecep.com/api/mcp

Funciona direto no navegador — sem instalar nada. Basta adicionar e começar a usar.

Claude Code / Claude Desktop

Adicione ao seu arquivo de configuração MCP (~/.claude/settings.json ou claude_desktop_config.json):

{
  "mcpServers": {
    "consultadecep": {
      "command": "npx",
      "args": ["-y", "@consultadecep/mcp-server"]
    }
  }
}

Cursor

Adicione ao arquivo .cursor/mcp.json do seu projeto:

{
  "mcpServers": {
    "consultadecep": {
      "command": "npx",
      "args": ["-y", "@consultadecep/mcp-server"]
    }
  }
}

VS Code (Copilot)

Adicione ao .vscode/mcp.json:

{
  "servers": {
    "consultadecep": {
      "command": "npx",
      "args": ["-y", "@consultadecep/mcp-server"]
    }
  }
}

Windsurf

Adicione ao ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "consultadecep": {
      "command": "npx",
      "args": ["-y", "@consultadecep/mcp-server"]
    }
  }
}

ChatGPT

Use nosso GPT pronto na loja do ChatGPT — basta clicar e começar a consultar:

Usar no ChatGPTAbrir GPT "Consulta de CEP" na loja
Ou crie seu próprio GPT personalizado
  1. Acesse chatgpt.com/gpts/editor
  2. Na aba Configure, dê um nome e uma descrição
  3. Em Actions → Create new action → Import from URL:
https://consultadecep.com/api/openapi

Clique em Save e pronto — seu GPT já consulta CEPs.

Exemplos de uso com IA

Buscar um CEP:

"Qual o endereço do CEP 01001-000?"
A IA chamará buscar_cep com o CEP informado e retornará o endereço completo.

Pesquisar por endereço:

"Busca o CEP da Avenida Paulista em São Paulo"
A IA chamará buscar_endereco com UF=SP, cidade=São Paulo e logradouro=Paulista.

Uso em desenvolvimento:

"Preciso do CEP do escritório na Rua Nove de Julho em Ribeirão Preto para configurar no .env"
A IA busca o endereço e já pode sugerir a configuração com o CEP correto.

Código fonte

O MCP Server é open source e está disponível no GitHub. Contribuições são bem-vindas.