PostcodeDog MCP ServerBusca y valida códigos postales desde tus herramientas de IA
Conecta Claude, ChatGPT, Codex, Cursor, VS Code y otras herramientas de IA a PostcodeDog. Busca códigos postales en 82 países, valídalos con el formato nacional y descompón direcciones desde tu asistente.
https://postdog.zhangjunrock.workers.dev/mcpQué puedes hacer
Pregunta en lenguaje natural. Tu asistente elige la herramienta correcta.
Buscar y validar
Encuentra un código postal, una ciudad o un lugar en 82 países y comprueba el código con el formato nacional antes de usarlo en una dirección.
- ¿Qué es 90210 y qué otros países usan el mismo código?
- ¿75008 es un código postal francés válido?
- ¿Qué código postal tiene Shibuya, Tokio?
- Busca Múnich en Alemania y muéstrame tres códigos.
Ver la cobertura
Consulta qué países están cubiertos, qué formato usa cada uno y qué precisión tiene cada país.
- ¿Qué países europeos cubres y qué formatos usan?
- ¿Cómo son los códigos postales de Reino Unido y Canadá?
- ¿Cuántos códigos postales hay en la base?
- Enumera los países cubiertos en Asia con un código de ejemplo para cada uno.
Trabajar con direcciones
Divide una dirección completa en país, región, ciudad y código postal, y confirma que el código existe antes de ponerlo en un formulario o un envío.
- Descompón 1 Infinite Loop, Cupertino, CA 95014, USA.
- ¿Qué código postal corresponde a 10 Downing Street, Londres?
- Comprueba estos códigos alemanes uno a uno: 10115, 80331, 99999.
- Valida SW1A 1AA y dime qué zona de Londres cubre.
Instalación
Elige tu herramienta de IA. Sin registro y sin clave API: la URL del servidor es todo lo que necesitas.
Claude Code
claude mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Ejecuta el comando en tu terminal.
- Abre Claude Code, ejecuta /mcp y elige postcodedog.
Para probar: pregunta «¿Qué es 90210?»
Codex
codex mcp add postcodedog --url https://postdog.zhangjunrock.workers.dev/mcp[mcp_servers.postcodedog]
url = "https://postdog.zhangjunrock.workers.dev/mcp"- Añade el servidor con el comando o el bloque en ~/.codex/config.toml.
- Abre Codex. No hay paso de inicio de sesión: el servidor es público.
Para probar: pregunta «¿Qué código postal es Beverly Hills 90210?»
Gemini CLI
gemini mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp{
"mcpServers": {
"postcodedog": {
"httpUrl": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Añade el servidor con el comando o el bloque en los ajustes de Gemini CLI.
- Abre Gemini CLI y ejecuta /mcp para confirmar que postcodedog está conectado.
Para probar: pregunta «¿75008 es un código postal francés válido?»
VS Code
code --add-mcp '{"name":"postcodedog","type":"http","url":"https://postdog.zhangjunrock.workers.dev/mcp"}'{
"servers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Ejecuta el comando o guarda el bloque como .vscode/mcp.json en el workspace.
- Abre la vista MCP, inicia postcodedog y haz una pregunta de código postal.
Para probar: pregunta «¿Qué formatos tienen los códigos postales de Alemania y Japón?»
Cursor
{
"mcpServers": {
"postcodedog": {
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Combina el bloque en ~/.cursor/mcp.json o en .cursor/mcp.json del proyecto.
- Abre los ajustes de Cursor → MCP, activa postcodedog y recarga la ventana.
Para probar: pregunta «¿Qué países de Europa cubres?»
Claude
https://postdog.zhangjunrock.workers.dev/mcp- Abre Customize → Connectors y elige Add → Custom → Web.
- Ponle PostcodeDog, pega la URL del servidor y deja la autenticación vacía.
- Selecciona Connect: las herramientas están disponibles al instante, sin registro.
Para probar: pregunta «Descompón 1 Infinite Loop, Cupertino, CA 95014, USA.»
ChatGPT
https://postdog.zhangjunrock.workers.dev/mcp- Abre Plugins, elige + y luego Add custom MCP server.
- Ponle PostcodeDog, pega la URL y elige «No authentication».
- Crea el plugin y haz una pregunta de código postal en un chat nuevo.
Para probar: pregunta «¿Cuál es el código postal de Shibuya, Tokio?»
Amp
amp mcp add postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Ejecuta el comando.
- Amp se conecta en el primer uso; no hay inicio de sesión.
Para probar: pregunta «¿Existe 99999 en Alemania?»
opencode
opencode mcp add postcodedog --global --url https://postdog.zhangjunrock.workers.dev/mcp- Añade el servidor.
- Abre opencode y haz una pregunta de código postal; sin autenticación.
Para probar: pregunta «¿Cuántos lugares se llaman Springfield en EE. UU.?»
Other AI tools
Cualquier herramienta de IA que admita servidores MCP remotos por Streamable HTTP puede conectarse con la URL. No hay flujo OAuth ni registro de cliente.
{
"mcpServers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Apunta el cliente a la URL del servidor y deja la autenticación vacía.
- El servidor no tiene estado: sin cabecera de sesión, sin cookies, sin handshake initialize.
Para probar: pregunta «¿Qué es 90210?»
Preguntas
¿Qué es el servidor MCP de PostcodeDog?
Conecta herramientas de IA como Claude, ChatGPT, Cursor y Codex a la base de códigos postales de PostcodeDog mediante el Model Context Protocol. El asistente puede buscar códigos, lugares, validarlos con los formatos nacionales, descomponer direcciones e informar de la cobertura.
¿Necesito una clave API?
No. El servidor es público y de solo lectura: sin cuenta, sin OAuth y sin token. Pegar la URL es toda la configuración.
¿Con qué herramientas de IA funciona?
Con cualquier herramienta que admita servidores MCP remotos por Streamable HTTP. La guía cubre Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp y opencode.
¿Qué puede ver mi asistente?
Solo datos postales públicos: unos 1,8 millones de filas de GeoNames en 82 países, con nombres de lugares, regiones, condados, coordenadas y formatos nacionales. No hay cuentas, así que no hay datos personales.
¿Puede cambiar algo?
No. Las cinco herramientas son de solo lectura. El servidor no puede escribir, enviar ni modificar datos, no pone cookies y no guarda sesión.
¿Son exactos los datos?
Es la base postal de GeoNames, con licencia CC BY 4.0, actualizada en cada reconstrucción. Los nombres y las coordenadas provienen de registros reales. La precisión varía según el país; list_countries indica el formato y la cobertura disponible para cada uno.
¿Hay límite de peticiones?
No hay clave ni cuota estricta, pero PostcodeDog es un sitio pequeño: mantén los lotes a un ritmo razonable. Para uso intensivo o comercial, contáctanos antes.
¿Cómo desconecto?
Elimina el servidor de los ajustes de tu herramienta de IA. No guardamos nada por nuestra parte, así que no hay nada más que revocar.