Hungarian Postcode Validator
Hungarian postcode lookup + validation - 3,484 codes, sub-10ms lookups, bulk address endpoint.
What can you do with 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
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
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>'{
"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>"
}
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
| Tool | Purpose | Price |
|---|---|---|
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
| Event | USD 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/IrszHnkcompilation
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.
Frequently asked questions
What is Hungarian Postcode Validator?
Hungarian postcode lookup + validation - 3,484 codes, sub-10ms lookups, bulk address endpoint.
How do I install Hungarian Postcode Validator?
It runs as a remote server. In 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>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Hungarian Postcode Validator need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Hungarian Postcode Validator open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Hungarian Postcode Validator?
It is published by UnbearableDev. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.