Vietnam Address Converter (2025 reform)
Server Details
Convert old Vietnamese addresses to the post-2025 34 provinces and 3,321 communes. Official data.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- since98vn/vietnam-mcp-servers
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 7 tools
Each tool has a distinct role: structured conversion (convert_old_to_new), free-form parsing (normalize_address), reverse provenance (explain_merge), lookup (find_units), enumeration (list_provinces/list_wards), and metadata (data_info). The main risk is convert_old_to_new vs normalize_address, which both map old units to new ones, but the descriptions clearly separate structured parts from free-form address strings and list_wards explicitly defers to find_units for single-name lookups.
All names are snake_case and mostly verb_noun (convert_old_to_new, explain_merge, find_units, list_provinces, list_wards, normalize_address). The only deviation is data_info, a noun phrase rather than an action, but it is unambiguous within the set.
Seven tools is well-scoped for an address-conversion domain: conversion, normalization, reverse explanation, search, two listings and data provenance each earn their place. No tool looks redundant or missing at this scope.
The surface covers both directions of the reform mapping (old→new conversion/explanation of new units), search, enumeration at province and commune level, plus data reliability metadata. Minor gaps exist: no listing of old districts as a standalone operation and no batch/multi-address conversion, though find_units with scope=old partially mitigates the former.
Available Tools
7 toolsconvert_old_to_newConvert old address to new (2025 reform)ARead-onlyIdempotentInspect
Convert a Vietnamese administrative address from BEFORE 1 July 2025 (old province, district, commune) to the unit(s) valid AFTER the 2025 reform. Use when the user has an old address, an old ID card or registration address, or asks "what is my ward called now". Pass the parts you have; names may be written with or without diacritics, with prefixes or abbreviations, or as official codes. Returns the old unit, the new commune and province, the new address line, transition type (merge, unchanged, rename, retype, special_zone), partial=true when only part of the old commune went there, and resolution numbers. If the old commune was split between several new communes, ALL of them are returned and ambiguous=true: do not pick one, ask for the street or hamlet. Examples: {"province":"TP.HCM","district":"Quận 8","ward":"Phường 16"}; {"province":"Bình Dương","district":"Thủ Dầu Một","ward":"Phú Cường"}; {"ward":"27430"}.
Inputs: ward, district, province.
data_infoDataset version and sourcesARead-onlyIdempotentInspect
Return the dataset version, the official source (National Statistics Office of Viet Nam transition table, with checksum and fetch date), the list of resolutions with issue and effective dates (2025 reform and 2026 changes), unit counts and the coverage note. Use when the user asks how current or reliable the data is. Takes no arguments: {}.
Inputs: no named parameters.
explain_mergeExplain how a new unit was formedARead-onlyIdempotentInspect
Explain what a NEW (post-1 July 2025) commune or province was formed from: the old communes or provinces merged into it, whether each came whole or partially (split communes list the other new units their parts went to), the transition type and the resolution numbers. Use when the user asks "which wards were merged into X" or needs the legal basis. Takes the new unit code (5 digits for a commune, 2 for a province); get it from find_units or convert_old_to_new. Examples: {"code":"26734"}; {"code":"79"}.
Inputs: code (required).
find_unitsFind administrative units by nameARead-onlyIdempotentInspect
Search Vietnamese administrative units by name or code, ignoring case and diacritics. scope "new" (default) searches the post-reform units (34 provinces, 3,321 communes); scope "old" searches units as of 30 June 2025 (63 provinces, districts, communes). Use to check spelling, get a code, or see every place with the same name before converting. Returns code, full name, level, match quality (code, exact, partial) and parent district/province. Examples: {"query":"Bến Nghé","scope":"old"}; {"query":"thu duc"}; {"query":"Tân Phú","scope":"old","level":"ward","province":"79","limit":20}.
Inputs: query (required), level, limit, scope, +1 more.
list_provincesList provinces (34 new or 63 old)ARead-onlyIdempotentInspect
List Vietnam's provinces and centrally-run cities. scope "new" (default): the 34 provinces in force since 1 July 2025, each with its code, number of communes and the old provinces merged into it. scope "old": the 63 provinces before the reform, each with the new province it became part of. Use for overviews or to answer "which provinces were merged into X". Example: {"scope":"old"}.
Inputs: scope.
list_wardsList communes of a provinceARead-onlyIdempotentInspect
List all commune-level units (phường, xã, đặc khu) of one province. scope "new" (default): communes after the reform with codes and any 2026 changes; scope "old": communes as of 30 June 2025 with their district. The province may be a 2-digit code or a name. Example: {"province":"79"}; {"province":"Đà Nẵng","scope":"old"}. Output can be long (up to a few hundred entries); prefer find_units for a single name.
Inputs: province (required), scope.
normalize_addressRewrite a free-form address to the new unitsARead-onlyIdempotentInspect
Parse a free-form Vietnamese address line (street, commune, district, province; with or without diacritics, commas or abbreviations) and rewrite it with the post-reform units: drops the district and replaces the old commune and province. Returns status (converted, already_new, province_level when only a province was given, ambiguous, partial when the commune is missing, e.g. a district alone, not_found), confidence, the rewritten address, all candidates when ambiguous, which parts were recognised and which were not. Never invents a unit. Examples: {"address":"12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM"}; {"address":"so 1 phu cuong thu dau mot binh duong"}.
Inputs: address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Convert old Vietnamese addresses to the 2025 format and check new ones, per official resolutions.
Vietnam daily data briefing and the 2025 province-merge map
Thửa đất Hà Nội theo số tờ, số thửa, mã thửa hoặc tọa độ, với địa chỉ trước và sau sáp nhập 2025.
Vietnamese land parcels by code, sheet and parcel number or location, with HCMC and Đà Nẵng zoning.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to convert old Vietnamese addresses (63 provinces with district level) into post-2025 addresses (34 provinces, ward/province only), returning new ward codes, postal codes, confidence and all candidates when a unit was split or ambiguous. Also exposes tools to parse free-form addresses, search old/new administrative units, list provinces and wards, and trace which old units formed a new ward.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to normalize and convert old three-level Vietnamese addresses into the current 34-province, district-free structure using offline bundled data, with each response reporting confidence. Lookups can search both legacy and current units, and divided wards are flagged with alternatives rather than silently guessed.4MIT
- AlicenseBqualityAmaintenanceEnables AI agents to build and parse VietQR payments, convert old 63-province addresses to the 34-province structure, validate tax IDs and e-invoices, turn money amounts into Vietnamese words, and convert between solar and lunar calendar dates. All tools run offline with bundled data, returning structured ok/error results.40MIT
- AlicenseNot gradedqualityDmaintenanceEnables Hong Kong address lookup and correction using government data, with fuzzy matching and LLM-powered correction for both Chinese and English addresses.4ISC
Glama MCP Gateway
Add one secure layer between your agents and this server.