Convert old Vietnamese addresses to the post-2025 34 provinces and 3,321 communes. Official data.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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"}.
Old commune-level unit (phường / xã / thị trấn): name, abbreviation (P.16) or 5-digit code.
Old district (quận / huyện / thị xã / thành phố): name, abbreviation (Q.1, H. Củ Chi) or 3-digit code.
Old (pre-1 July 2025) province or city: name with or without diacritics, abbreviation (TP.HCM, HN) or 2-digit code. A post-reform province name is also accepted.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http vietnam-address https://since98.vn/api/mcp/address
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"}.
| Argument | Type | Description |
|---|---|---|
| ward | string | Old commune-level unit (phường / xã / thị trấn): name, abbreviation (P.16) or 5-digit code. |
| district | string | Old district (quận / huyện / thị xã / thành phố): name, abbreviation (Q.1, H. Củ Chi) or 3-digit code. |
| province | string | Old (pre-1 July 2025) province or city: name with or without diacritics, abbreviation (TP.HCM, HN) or 2-digit code. A post-reform province name is also accepted. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ward": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 100,
"minLength": 1,
"description": "Old commune-level unit (phường / xã / thị trấn): name, abbreviation (P.16) or 5-digit code."
},
"district": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 100,
"minLength": 1,
"description": "Old district (quận / huyện / thị xã / thành phố): name, abbreviation (Q.1, H. Củ Chi) or 3-digit code."
},
"province": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 100,
"minLength": 1,
"description": "Old (pre-1 July 2025) province or city: name with or without diacritics, abbreviation (TP.HCM, HN) or 2-digit code. A post-reform province name is also accepted."
}
}
}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: {}.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}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"}.
| Argument | Type | Description |
|---|---|---|
| code* | string | Code of a NEW unit: 5-digit commune code (e.g. "26734") or 2-digit province code (e.g. "79"). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^\\d{1,5}$",
"description": "Code of a NEW unit: 5-digit commune code (e.g. \"26734\") or 2-digit province code (e.g. \"79\")."
}
}
}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}.
| Argument | Type | Description |
|---|---|---|
| level | string | Restrict to one level. "district" exists only with scope "old". |
| limit | integer | Maximum results, 1-50, default 10. |
| query* | string | Unit name or code to look up, e.g. "Bến Nghé", "ben nghe", "Thủ Đức", "26734". Case and diacritics are ignored. |
| scope | string | "new" (default): units after the 2025 reform (34 provinces, 3,321 communes). "old": units as of 30 June 2025 (63 provinces, districts, 10,035 communes). |
| province | string | Optional province filter in the same scope: code or name. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"level": {
"enum": [
"province",
"district",
"ward"
],
"type": "string",
"description": "Restrict to one level. \"district\" exists only with scope \"old\"."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum results, 1-50, default 10."
},
"query": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 100,
"minLength": 1,
"description": "Unit name or code to look up, e.g. \"Bến Nghé\", \"ben nghe\", \"Thủ Đức\", \"26734\". Case and diacritics are ignored."
},
"scope": {
"enum": [
"new",
"old"
],
"type": "string",
"description": "\"new\" (default): units after the 2025 reform (34 provinces, 3,321 communes). \"old\": units as of 30 June 2025 (63 provinces, districts, 10,035 communes)."
},
"province": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 100,
"minLength": 1,
"description": "Optional province filter in the same scope: code or name."
}
}
}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"}.
| Argument | Type | Description |
|---|---|---|
| scope | string | "new" (default): 34 provinces after 1 July 2025, with the old provinces merged into each. "old": 63 provinces before the reform, with the new province each went into. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"scope": {
"enum": [
"new",
"old"
],
"type": "string",
"description": "\"new\" (default): 34 provinces after 1 July 2025, with the old provinces merged into each. \"old\": 63 provinces before the reform, with the new province each went into."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| scope | string | "new" (default): communes after the reform. "old": communes as of 30 June 2025, with their district. |
| province* | string | Province: 2-digit code (e.g. "79") or name (e.g. "Hồ Chí Minh", "Ha Noi"). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"province"
],
"properties": {
"scope": {
"enum": [
"new",
"old"
],
"type": "string",
"description": "\"new\" (default): communes after the reform. \"old\": communes as of 30 June 2025, with their district."
},
"province": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 100,
"minLength": 1,
"description": "Province: 2-digit code (e.g. \"79\") or name (e.g. \"Hồ Chí Minh\", \"Ha Noi\")."
}
}
}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"}.
| Argument | Type | Description |
|---|---|---|
| address* | string | Free-form Vietnamese address, with or without diacritics, e.g. "12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM" or "so 1 phu cuong thu dau mot binh duong". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 300,
"minLength": 1,
"description": "Free-form Vietnamese address, with or without diacritics, e.g. \"12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM\" or \"so 1 phu cuong thu dau mot binh duong\"."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.