MCP server de Zip-Codes.com
Commit 11 nov 2026Valida direcciones de EE. UU. y proporciona geocodificación, datos demográficos del censo, distritos escolares y análisis espacial para códigos ZIP.
También conocido como ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- Stars
- 0
- Herramientas
- 12
- Descargas, 30 días
- —
- Última versión
- 1.1.0
- Último commit
- 11 nov 2026
- Licencia
- —
¿Qué es Zip-Codes.com MCP?
Zip-Codes.com es un MCP server. Valida direcciones de EE. UU. y proporciona geocodificación, datos demográficos del censo, distritos escolares y análisis espacial para códigos ZIP. Expone 12 herramientas, como about_data, buy_credits, city_name_rules.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Zip-Codes.com
Este servidor permite validar direcciones de EE. UU. y obtener datos demográficos del censo directamente desde un cliente de IA. Los desarrolladores pueden usarlo para transformar nombres de lugares parciales en datos de ubicación precisos o estandarizar direcciones de calles para encontrar códigos ZIP+4 específicos. Proporciona inteligencia espacial profunda, incluyendo información sobre ingresos, vivienda y distritos escolares, extrayendo datos de USPS actualizados mensualmente y límites del Censo.
Los usuarios se conectan al servidor a través de un transporte streamable HTTP, lo que lo hace compatible con Claude Code, Cursor y VS Code. Aunque una clave gratuita permite 2,500 créditos diarios, el servidor admite el Machine Payments Protocol mediante una herramienta buy_credits. Esto permite que un agente utilice una billetera MPP, como Stripe Link, para comprar claves de API prepagadas o añadir créditos directamente.
El conjunto de herramientas incluye doce funciones especializadas como zip_lookup para registros completos, radius_search para encontrar áreas postales cercanas y distance para calcular el kilometraje entre dos puntos. Cubre desde referencias de áreas metropolitanas hasta límites históricos de Census TIGER/Line que abarcan de 2010 a 2026.
Qué puedes hacer con él
- 1Estandarizar direcciones postales de EE. UU.Un agente puede validar una dirección de calle para asegurar que sea correcta y recuperar el código ZIP+4 específico.
- 2Analizar la demografía de un vecindarioUn desarrollador puede solicitar datos detallados del sector censal, incluyendo estadísticas de ingresos y vivienda para una ubicación específica.
- 3Realizar búsquedas de radio espacialPuedes instruir a una IA para que encuentre todos los códigos ZIP de EE. UU. o áreas postales de Canadá dentro de una distancia específica desde un punto central.
- 4Automatizar la gestión de créditos de la APIUn agente autónomo puede usar una billetera conectada para comprar más créditos de la API cuando sea necesario.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Zip-Codes.com MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Zip-Codes.com MCP en Claude Code
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpInstalar Zip-Codes.com MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Instalar Zip-Codes.com MCP en VS Code
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}Instalar Zip-Codes.com MCP en VS Code CLI
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'Instalar Zip-Codes.com MCP en Codex
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpInstalar Zip-Codes.com MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Instalar Zip-Codes.com MCP en Gemini CLI
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpInstalar Zip-Codes.com MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Herramientas de Zip-Codes.com MCP 12
Detectado desde el READMEabout_databuy_creditscity_name_rulescounty_referencedistancemetro_area_referencequick_zipradius_searchsuggest_placesvalidate_addresszip_factszip_lookup
| about_data | — | |
| buy_credits | — | |
| city_name_rules | — | |
| county_reference | — | |
| distance | — | |
| metro_area_reference | — | |
| quick_zip | — | |
| radius_search | — | |
| suggest_places | — | |
| validate_address | — | |
| zip_facts | — | |
| zip_lookup | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblezip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 225 msAprobado
README
Ver en GitHubZip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics
Location intelligence for US addresses and ZIP Codes, through the Model Context Protocol. Zip-Codes.com can validate a US street address and return its ZIP+4, census tract demographics, income, housing and school district in one call. It answers from current USPS data, updated monthly, and Census boundaries, so an agent looks addresses and ZIP Codes up instead of guessing them. Request the enrichments you need. The survey estimates describe the census tract and carry margins of error.
ZIP boundaries follow USPS carrier routes and are refreshed quarterly. Coverage includes PO Box and single-organization ZIP Codes that Census ZIP-area files leave out. Boundary enrichments show which counties and districts a ZIP overlaps, with shares measured by area. The USPS county assignment is available alongside the mapped counties.
For history, request Census TIGER/Line boundaries from 2010–2026. American Community Survey profiles use consistent field names across the 2011–2024 releases, for ZIP Code areas and census tracts alike. A ZIP's survey estimates come from the Census ZCTA with the same code.
MPP-capable: an optional buy_credits tool lets an agent with an MPP wallet (such as Stripe Link) buy a prepaid API key or add credits to one; the wallet's owner approves each payment.
Connect
Server URL: https://mcp.zip-codes.com/mcp (Streamable HTTP).
Claude Code
claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp
claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp --header "X-Api-Key: YOUR_KEY"
Cursor (~/.cursor/mcp.json) and other mcpServers clients
{
"mcpServers": {
"zip-codes": {
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": "YOUR_KEY"
}
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"zip-codes": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": "YOUR_KEY"
}
}
}
}
Clients that only take a bearer token can send Authorization: Bearer YOUR_KEY instead.
Claude / Claude Desktop custom connector
Add https://mcp.zip-codes.com/mcp as a custom connector. It runs in demo mode unless the connector form has a Request headers section (a beta for a limited set of organizations): there, add x-api-key with your key.
Tools (12)
| Tool | Title | What it does |
|---|---|---|
about_data |
About this data | Where this server's data comes from: for each dataset the authority behind it, the edition served where the source publishes editions (TIGER/Line, ACS, ZCTA), how often a new release is taken, and a ready-made citation string. |
buy_credits |
Buy credits | Buy a credit pack with a wallet that pays MPP (Machine Payments Protocol) challenges, such as Stripe Link. |
city_name_rules |
City name rules | How USPS names a ZIP Code, and which of those names may be used on mail. |
county_reference |
County reference | US counties and county equivalents — all 3,235 of them — with their Census and USPS names, which disagree for over a hundred, plus ANSI code, legal type, land and water area, and USPS delivery footprint. |
distance |
Distance between two places | Distance between two places, in miles and kilometres, plus the compass bearing from the first to the second. |
metro_area_reference |
Metro area reference | US metropolitan and micropolitan statistical areas (CBSAs) — all 935. |
quick_zip |
Quick ZIP / ZIP+4 / reverse geocode | The fast, small answer for a postal code. |
radius_search |
Radius search | Find every US ZIP Code and Canadian postal area within a radius of a centre point, with the distance to each. |
suggest_places |
Place search (type-ahead) | Search for a place by partial name, misspelled name, or partial code — the resolver that turns what a person typed into something the other tools can look up. |
validate_address |
Validate a US address | Validate and standardise a US street address and return its ZIP+4. |
zip_facts |
ZIP Code facts | Statistics about US ZIP Codes and Canadian postal codes: how many exist, how they break down by type, delivery point and carrier route totals, per-state tables, and ranked lists such as the ZIP Codes with the most carrier routes. |
zip_lookup |
ZIP Code lookup | The full record for a postal code — the main location-intelligence tool. |
Pricing
No key needed to start. A free key gives 2,500 credits a day; plans and credit packs: https://www.zip-codes.com/api/pricing
Support
Email jharris@zip-codes.com. Issues are turned off on this repository; email reaches the people who run the server.
Privacy policy: https://www.zip-codes.com/privacy-policy.asp
Links
- Overview: https://www.zip-codes.com/api/mcp
- API docs: https://api.zip-codes.com/docs
- Server overview for agents: https://mcp.zip-codes.com/llms.txt
License
Proprietary. All rights reserved; see LICENSE. Use of the server, API and data is governed by the Terms of Service: https://www.zip-codes.com/api/tos
Preguntas sobre Zip-Codes.com MCP
¿Cómo agrego Zip-Codes.com MCP a Claude Code?
Ejecuta claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Zip-Codes.com MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Zip-Codes.com MCP?
Expone 12 herramientas, incluidas about_data, buy_credits, city_name_rules, county_reference, distance.
¿Qué información puedo obtener de una validación de direcciones de EE. UU.?
Puedes validar una dirección de calle en EE. UU. y recibir su código ZIP+4, datos demográficos del sector censal, ingresos, vivienda e información del distrito escolar en una sola llamada.
¿Cómo puede un agente de IA comprar más créditos?
Los agentes pueden usar la herramienta buy_credits para comprar paquetes de créditos mediante una billetera MPP, como Stripe Link, con la aprobación del propietario.
¿Hay un nivel gratuito disponible?
Sí, puedes empezar sin una clave, y una clave gratuita proporciona 2,500 créditos por día.