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.

Built by Unbearable Labs. Free to use — bring your own Apify token.

---

Available on

• Apify Actor Store — primary
• Smithery

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

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

Example

Call: lookup_postcode("6720")

Output:

{
  "postcode": "6720",
  "city": "Szeged",
  "county": "Csongrád-Csanád",
  "region": "Dél-Alföld",
  "country": "HU",
  "valid": true
}

Call: validate_address(postcode="1051", city="Budapest")

Output:

{
  "valid": true,
  "postcode": "1051",
  "city": "Budapest",
  "district": "V. kerület",
  "county": "Budapest",
  "region": "Közép-Magyarország"
}

Call: budapest_district_lookup("1117")

Output:

{
  "postcode": "1117",
  "district": "XI. kerület",
  "district_name": "Újbuda",
  "city": "Budapest"
}

Pricing

Free to use — hosted on Apify, bring your own Apify token.

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://unbearable-dev--hu-postcode-validator.apify.actor/mcp",
      "headers": { "Authorization": "Bearer <YOUR_APIFY_TOKEN>" }
    }
  }
}

What's NOT covered

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

Source / contact

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

---

Built by Noel @ Unbearable Labs — more like this in the weekly newsletter: https://unbearabletechtips.beehiiv.com