PostalDataPI MCP Server

आधिकारिक

Global postal code lookups, validation, and city search for 70+ countries. Sub-10ms responses.

दस्तावेज़

PostalDataPI MCP सर्वर

PostalDataPI के लिए MCP (मॉडल संदर्भ प्रोटोकॉल) सर्वर — AI एजेंटों को समृद्ध मेटाडेटा: समय क्षेत्र, प्रशासनिक क्षेत्र, ऊंचाई और निर्देशांक के साथ 240+ देशों और क्षेत्रों में डाक कोड देखने, मान्य करने और खोजने की सुविधा देता है।

उपकरण

उपकरण	विवरण
`lookup_postal_code`	डाक कोड (US ZIP, UK पोस्टकोड, जर्मन PLZ, आदि) के लिए शहर, राज्य/क्षेत्र और संक्षिप्त नाम प्राप्त करें
`validate_postal_code`	जाँचें कि किसी देश में डाक कोड मौजूद है या नहीं
`search_by_city`	किसी शहर के सभी डाक कोड खोजें
`get_postal_code_metadata`	पूर्ण मेटाडेटा: निर्देशांक, प्रशासनिक पदानुक्रम, समय क्षेत्र, ऊंचाई, और अधिक

सेटअप

1. API कुंजी प्राप्त करें

postaldatapi.com/register पर साइन अप करें — 1,000 मुफ्त क्वेरी, किसी क्रेडिट कार्ड की आवश्यकता नहीं।

2. इंस्टॉल करें

pip install postaldatapi-mcp

3. Claude Code के साथ कॉन्फ़िगर करें

claude mcp add --transport stdio postaldatapi -- \
  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Claude Desktop के साथ कॉन्फ़िगर करें

अपने Claude Desktop कॉन्फ़िग (macOS पर ~/Library/Application Support/Claude/claude_desktop_config.json) में जोड़ें:

{
  "mcpServers": {
    "postaldatapi": {
      "command": "postaldatapi-mcp",
      "env": {
        "POSTALDATAPI_KEY": "your_api_key_here"
      }
    }
  }
}

उपयोग

एक बार कॉन्फ़िगर हो जाने पर, Claude से स्वाभाविक रूप से पूछें:

"ZIP कोड 90210 कौन सा शहर है?"
"UK पोस्टकोड SW1A देखें"
"क्या 10115 एक वैध जर्मन डाक कोड है?"
"Beverly Hills, CA के डाक कोड क्या हैं?"
"जापान में डाक कोड 100-0001 के निर्देशांक प्राप्त करें"

Claude उत्तर देने के लिए स्वचालित रूप से PostalDataPI उपकरणों का उपयोग करेगा।

समर्थित देश

US, UK, कनाडा, जर्मनी, फ्रांस, जापान, ऑस्ट्रेलिया, ब्राजील, भारत और कई अन्य सहित 240+ देश और क्षेत्र। पूरी सूची postaldatapi.com/countries पर देखें।

समृद्ध मेटाडेटा

बुनियादी लुकअप से परे, get_postal_code_metadata उपकरण प्रति डाक कोड 18 फ़ील्ड तक लौटाता है, जिनमें शामिल हैं:

निर्देशांक (अक्षांश, देशांतर)
समय क्षेत्र (जैसे, America/Mexico_City, Europe/Berlin)
प्रशासनिक पदानुक्रम (राज्य/प्रांत, काउंटी, नगर पालिका)
ऊंचाई (समुद्र तल से मीटर में)
स्थान का नाम और देश की जानकारी

Mexico City 06000 के लिए उदाहरण प्रतिक्रिया:

{
  "postalCode": "06000",
  "country": "MX",
  "placeName": "Centro",
  "latitude": 19.4364,
  "longitude": -99.1553,
  "timezone": "America/Mexico_City",
  "adminLevel1": "Ciudad de México",
  "adminLevel2": "Cuauhtémoc",
  "elevation": 2239
}