English Français العربية

Hungarian Postcode Validator

السجل الرسمي أخرى

Hungarian postcode lookup + validation - 3,484 codes, sub-10ms lookups, bulk address endpoint.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع Hungarian Postcode Validator؟

  • Validate a (postcode, city) pair before storing it in your DB
  • Look up the settlement and county for any HU postcode
  • Find all postcodes that serve a given city (handy for Budapest: 23 districts, 100+ postcodes)
  • List every postcode in a Hungarian county
  • Map Budapest district numbers (1–23 or I–XXIII) to their postcode ranges

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hungarian-postcode-validator 'https://unbearable-dev--hu-postcode-validator.apify.actor/mcp' --header 'Authorization: <Apify API token. Format: '\''Bearer <YOUR_APIFY_TOKEN>'\''. Get yours at https://console.apify.com/account/integrations>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hungarian-postcode-validator": {
            "type": "http",
            "url": "https://unbearable-dev--hu-postcode-validator.apify.actor/mcp",
            "headers": {
                "Authorization": "<Apify API token. Format: 'Bearer <YOUR_APIFY_TOKEN>'. Get yours at https://console.apify.com/account/integrations>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Hungarian Postcode & Address Validator
  2. Available on
  3. What it does
  4. Tools
  5. Example responses
  6. Pricing
  7. Data sources
  8. Connecting from Claude Desktop
  9. What's NOT covered
  10. Source / contact

Hungarian Postcode & Address Validator

MCP server that validates Hungarian postcodes and addresses. Powered by the official Magyar Posta catalog and KSH (Hungarian Central Statistics Office) settlement data. Pennies per call.

Built by Unbearable Labs. Pay-per-event pricing — only billed when a tool is actually called.

Available on

  • Apify Actor Store — primary, metered usage (PPE)
  • MCPize — pending submission
  • MCP.so — pending submission
  • PulseMCP — pending submission
  • Smithery — pending submission
  • Glama — pending submission

Newsletter: Unbearable TechTips Weekly · All Actors: github.com/UnbearableDev

What it does

Point any MCP-capable client (Claude Desktop, Cursor, n8n, Make, Zapier, custom agents) at this server and get fast, structured answers to Hungarian address questions:

  • Validate a (postcode, city) pair before storing it in your DB
  • Look up the settlement and county for any HU postcode
  • Find all postcodes that serve a given city (handy for Budapest: 23 districts, 100+ postcodes)
  • List every postcode in a Hungarian county
  • Map Budapest district numbers (1–23 or I–XXIII) to their postcode ranges

Tools

ToolPurposePrice
lookup_postcode(postcode)Settlement + county + (if BP) district for a 4-digit HU postcode$0.001
lookup_city(city)All postcodes for a city (diacritic-insensitive — gyor matches Győr)$0.001
validate_address(postcode, city)yes/no + corrected suggestion if mismatch$0.001
budapest_district_lookup(district)Budapest I-XXIII (or 1-23) → list of postcodes in that district$0.001
list_postcodes_in_county(county_name)Bulk listing — every postcode in a county$0.005

Example responses

lookup_postcode(1102)

{
  "postcode": 1102,
  "found": true,
  "matches": [
    {
      "postcode": 1102,
      "settlement": "Budapest",
      "settlement_part": "X. kerület",
      "county": "Budapest"
    }
  ],
  "budapest_district": "X."
}

validate_address(1102, "Szeged")

{
  "valid": false,
  "reason": "city_mismatch",
  "postcode": 1102,
  "city": "Szeged",
  "expected_settlements": ["Budapest"]
}

budapest_district_lookup(14) (or "XIV") returns all postcodes in District XIV.

Pricing

EventUSD per call
lookup-call (most tools)$0.001
bulk-call (list_postcodes_in_county)$0.005

Effectively a free utility for occasional use; meaningful at high call volumes.

Data sources

  • Magyar Posta official postal catalog (Iranyitoszam-Internet_uj.xlsx) — postcode → settlement mapping
  • KSH (Hungarian Central Statistical Office) settlement registry — county / district / KSH code per settlement, via the open tamas-ferenci/IrszHnk compilation

Coverage: 3,484 postcode-settlement entries spanning 2,962 unique postcodes (1011–9985), all 19 Hungarian counties + Budapest. Refreshed quarterly.

Connecting from Claude Desktop

{
  "mcpServers": {
    "hu-postcode": {
      "transport": "streamable-http",
      "url": "https://YOUR-ACTOR-URL.apify.actor/mcp"
    }
  }
}

What's NOT covered

  • Street-level address validation (no clean public data source post-2022 KEKKH restrictions)
  • Fuzzy / Levenshtein city-name matching (v1.1)
  • Non-Hungarian addresses (consider another MCP for those)

Source / contact

Issues and ideas: unbearabledev@gmail.com or the GitHub org UnbearableDev.

الأسئلة الشائعة

ما هو Hungarian Postcode Validator؟

Hungarian postcode lookup + validation - 3,484 codes, sub-10ms lookups, bulk address endpoint.

كيف أثبّت Hungarian Postcode Validator؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hungarian-postcode-validator 'https://unbearable-dev--hu-postcode-validator.apify.actor/mcp' --header 'Authorization: <Apify API token. Format: '\''Bearer <YOUR_APIFY_TOKEN>'\''. Get yours at https://console.apify.com/account/integrations>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Hungarian Postcode Validator إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Hungarian Postcode Validator مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Hungarian Postcode Validator؟

ينشره UnbearableDev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.