unbearabledev avatar

Hungarian Postcode Validator

unbearabledev/hu-postcode-validator

Connects Claude or any MCP client to 3,484 Hungarian postcodes from the official Magyar Posta catalog and KSH settlement registry. Exposes five tools: validate postcode/city pairs before database writes, look up settlement and county from a four-digit code, find all postcodes serving a city (Budapest alone has 100+), map Budapest's 23 districts to their postcode ranges, or list every code in a county. Sub-10ms lookups, diacritic-insensitive city matching, and pay-per-call metering at a tenth of a cent per query. Reach for this when you're building Hungarian e-commerce checkouts, logistics routing, CRM data cleanup, or any system that needs to validate HU addresses without maintaining your own postal database.

tools
5
auth
Secret needed
transport
HTTP
last updated
Jun 10, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

lookup_postcodeSettlement + county + (if BP) district for a 4-digit HU postcode

Settlement + county + (if BP) district for a 4-digit HU postcode

No parameter schema in public metadata yet.

lookup_cityAll postcodes for a city (diacritic-insensitive — gyor matches Győr)

All postcodes for a city (diacritic-insensitive — gyor matches Győr)

No parameter schema in public metadata yet.

validate_addressyes/no + corrected suggestion if mismatch

yes/no + corrected suggestion if mismatch

No parameter schema in public metadata yet.

budapest_district_lookupBudapest I-XXIII (or 1-23) → list of postcodes in that district

Budapest I-XXIII (or 1-23) → list of postcodes in that district

No parameter schema in public metadata yet.

list_postcodes_in_countyBulk listing — every postcode in a county

Bulk listing — every postcode in a county

No parameter schema in public metadata yet.

Sponsors

Readme

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:


View the full README on GitHub

Details

Repository
github.com/unbearabledev/hu-postcode-validator
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from unbearabledev