Zip-Codes.com MCPサーバー
コミット 2026年11月11日米国の住所検証を行い、郵便番号(ZIP code)に基づくジオコーディング、国勢調査のデモグラフィックス、学区、および空間分析を提供します。
別名 ZIP-Codes-API/zip-codes-mcp, zip-codes-mcp
- スター
- 0
- ツール
- 12
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.1.0
- 最終コミット
- 2026年11月11日
- ライセンス
- —
Zip-Codes.com MCPとは
Zip-Codes.comはMCPサーバーです。 米国の住所検証を行い、郵便番号(ZIP code)に基づくジオコーディング、国勢調査のデモグラフィックス、学区、および空間分析を提供します。. 12個のツールを提供しており、about_data, buy_credits, city_name_rulesなどがあります。
プロジェクトのREADMEから生成された概要
Zip-Codes.com MCP server について
このMCP serverは、AIクライアント内から米国の住所検証および国勢調査デモグラフィックスの取得を可能にします。開発者はこれを利用して、不完全な地名を正確な位置データに変換したり、通り住所を標準化して特定のZIP+4コードを特定したりできます。また、毎月更新されるUSPSのデータと国勢調査の境界線から、所得、住宅、学区情報を含む高度な空間インテリジェンスを提供します。
ユーザーは streamable HTTP 経由でサーバーに接続するため、Claude Code、Cursor、VS Code との互換性があります。無料キーでは1日2,500クレジットまで利用可能ですが、サーバーは buy_credits ツールを通じて Machine Payments Protocol をサポートしています。これにより、エージェントは Stripe Link などの MPP ウォレットを使用して、プリペイドAPIキーの購入やクレジットの直接追加を行うことができます。
ツールセットには、完全なレコードを取得する zip_lookup、近隣の郵便エリアを検索する radius_search、2点間の距離を計算する distance など、12個の特化型関数が含まれています。都市圏のリファレンスから、2010年から2026年までの履歴的な国勢調査 TIGER/Line 境界線まで幅広くカバーしています。
できること
- 1米国の郵送先住所の標準化エージェントが通り住所を検証して正確性を確認し、特定の ZIP+4 コードを取得できます。
- 2近隣地域のデモグラフィックス分析開発者は、特定の場所に関する所得や住宅統計を含む詳細な国勢調査区データをリクエストできます。
- 3空間半径検索の実行中心点から特定の距離内にある米国のすべてのZIP Codeまたはカナダの郵便エリアを検索するようAIに指示できます。
- 4APIクレジット管理の自動化自律型エージェントは、必要に応じて接続されたウォレットを使用してAPIクレジットを追加購入できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Zip-Codes.com MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにZip-Codes.com MCPをインストール
$ claude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpCursorにZip-Codes.com MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp"
}
}
}VS CodeにZip-Codes.com MCPをインストール
.vscode/mcp.json
{
"servers": {
"zip-codes-mcp": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp"
}
}
}VS Code CLIにZip-Codes.com MCPをインストール
$ code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'CodexにZip-Codes.com MCPをインストール
$ codex mcp add zip-codes-mcp --url https://mcp.zip-codes.com/mcpCodex config.tomlにZip-Codes.com MCPをインストール
~/.codex/config.toml
[mcp_servers.zip-codes-mcp] url = "https://mcp.zip-codes.com/mcp"
Gemini CLIにZip-Codes.com MCPをインストール
$ gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpGemini settings.jsonにZip-Codes.com MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"zip-codes-mcp": {
"url": "https://mcp.zip-codes.com/mcp",
"type": "http"
}
}
}Zip-Codes.com MCPツール 12
READMEから検出about_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 | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能zip-codes-api/zip-codes-mcp is public and reachablegithub.com/zip-codes-api/zip-codes-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-11github.com/zip-codes-api/zip-codes-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない12 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 225 ms合格
README
GitHubで見るZip-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
Zip-Codes.com MCPのよくある質問
Zip-Codes.com MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http zip-codes-mcp https://mcp.zip-codes.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Zip-Codes.com MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Zip-Codes.com MCPが提供するツールは
12個のツールを提供しており、about_data, buy_credits, city_name_rules, county_reference, distanceなどがあります。
米国の住所検証からどのような情報を取得できますか?
米国の通り住所を検証し、1回の呼び出しでZIP+4、国勢調査区のデモグラフィックス、所得、住宅、および学区の情報を取得できます。
AIエージェントはどのようにクレジットを追加購入できますか?
エージェントは buy_credits ツールを使用し、所有者の承認を得た上で、Stripe LinkなどのMPPウォレットを使用してクレジットパックを購入できます。
無料プランはありますか?
はい、キーなしで開始でき、無料キーを使用する場合は1日あたり2,500クレジットを利用可能です。