{
  "markdown": "# Hungarian Postcode & Address Validator\n\n> 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.**\n\n**Built by [Unbearable Labs](https://github.com/UnbearableDev).** Pay-per-event pricing — only billed when a tool is actually called.\n\n---\n\n## Available on\n\n- [Apify Actor Store](https://apify.com/unbearable_dev/hu-postcode-validator) — primary, metered usage (PPE)\n- MCPize — *pending submission*\n- MCP.so — *pending submission*\n- PulseMCP — *pending submission*\n- Smithery — *pending submission*\n- Glama — *pending submission*\n\n**Newsletter:** [Unbearable TechTips Weekly](https://unbearabletechtips.com) · **All Actors:** [github.com/UnbearableDev](https://github.com/UnbearableDev)\n\n## What it does\n\nPoint any MCP-capable client (Claude Desktop, Cursor, n8n, Make, Zapier, custom agents) at this server and get fast, structured answers to Hungarian address questions:\n\n- **Validate** a `(postcode, city)` pair before storing it in your DB\n- **Look up** the settlement and county for any HU postcode\n- **Find** all postcodes that serve a given city (handy for Budapest: 23 districts, 100+ postcodes)\n- **List** every postcode in a Hungarian county\n- **Map** Budapest district numbers (1–23 or I–XXIII) to their postcode ranges\n\n## Tools\n\n| Tool | Purpose | Price |\n|------|---------|-------|\n| `lookup_postcode(postcode)` | Settlement + county + (if BP) district for a 4-digit HU postcode | $0.001 |\n| `lookup_city(city)` | All postcodes for a city (diacritic-insensitive — `gyor` matches `Győr`) | $0.001 |\n| `validate_address(postcode, city)` | yes/no + corrected suggestion if mismatch | $0.001 |\n| `budapest_district_lookup(district)` | Budapest I-XXIII (or 1-23) → list of postcodes in that district | $0.001 |\n| `list_postcodes_in_county(county_name)` | Bulk listing — every postcode in a county | $0.005 |\n\n## Example responses\n\n**`lookup_postcode(1102)`**\n```json\n{\n  \"postcode\": 1102,\n  \"found\": true,\n  \"matches\": [\n    {\n      \"postcode\": 1102,\n      \"settlement\": \"Budapest\",\n      \"settlement_part\": \"X. kerület\",\n      \"county\": \"Budapest\"\n    }\n  ],\n  \"budapest_district\": \"X.\"\n}\n```\n\n**`validate_address(1102, \"Szeged\")`**\n```json\n{\n  \"valid\": false,\n  \"reason\": \"city_mismatch\",\n  \"postcode\": 1102,\n  \"city\": \"Szeged\",\n  \"expected_settlements\": [\"Budapest\"]\n}\n```\n\n**`budapest_district_lookup(14)` (or `\"XIV\"`)** returns all postcodes in District XIV.\n\n## Pricing\n\n| Event | USD per call |\n|-------|--------------|\n| `lookup-call` (most tools) | $0.001 |\n| `bulk-call` (`list_postcodes_in_county`) | $0.005 |\n\nEffectively a free utility for occasional use; meaningful at high call volumes.\n\n## Data sources\n\n- **Magyar Posta official postal catalog** (`Iranyitoszam-Internet_uj.xlsx`) — postcode → settlement mapping\n- **KSH (Hungarian Central Statistical Office) settlement registry** — county / district / KSH code per settlement, via the open [`tamas-ferenci/IrszHnk`](https://github.com/tamas-ferenci/IrszHnk) compilation\n\nCoverage: 3,484 postcode-settlement entries spanning 2,962 unique postcodes (1011–9985), all 19 Hungarian counties + Budapest. Refreshed quarterly.\n\n## Connecting from Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"hu-postcode\": {\n      \"transport\": \"streamable-http\",\n      \"url\": \"https://YOUR-ACTOR-URL.apify.actor/mcp\"\n    }\n  }\n}\n```\n\n## What's NOT covered\n\n- Street-level address validation (no clean public data source post-2022 KEKKH restrictions)\n- Fuzzy / Levenshtein city-name matching (v1.1)\n- Non-Hungarian addresses (consider another MCP for those)\n\n## Source / contact\n\nIssues and ideas: `unbearabledev@gmail.com` or the GitHub org [`UnbearableDev`](https://github.com/UnbearableDev).\n",
  "bytes": 3785,
  "sha": "e511071cd1a4f89e53cd18b11b38272b909a261a9538d9c6cffbbd15724e38bd",
  "repo_slug": "unbearabledev/hu-postcode-validator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_unbearabledev_hu_postcode_vali_4b30932f/readme"
}