# Vietnam Address Converter (2025 reform) (remote · since98.vn)

Convert old Vietnamese addresses to the post-2025 34 provinces and 3,321 communes. Official data.

- Trust score: 71/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `since98.vn`: 71/100 (this document), [markdown](https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address.md), [page](https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address)

## Channel facts

- Endpoint: `https://since98.vn/api/mcp/address`
- Transports: `streamable-http`
- Auth: `none`
- Version: `2026.11.20`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 68/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1622 tokens (~231/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "explain_merge" implies "merge" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the Vietnam Address Converter (2025 reform) MCP server?

Vietnam Address Converter (2025 reform) is a hosted endpoint at https://since98.vn/api/mcp/address, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http vn-since98-vietnam-address 'https://since98.vn/api/mcp/address'
```

### Cursor

```json
{
  "mcpServers": {
    "vn-since98-vietnam-address": {
      "url": "https://since98.vn/api/mcp/address"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "vn-since98-vietnam-address": {
      "type": "http",
      "url": "https://since98.vn/api/mcp/address"
    }
  }
}
```

### Codex

```toml
[mcp_servers.vn-since98-vietnam-address]
url = "https://since98.vn/api/mcp/address"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vn-since98-vietnam-address": {
      "type": "remote",
      "url": "https://since98.vn/api/mcp/address",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vn-since98-vietnam-address --url 'https://since98.vn/api/mcp/address' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  vn-since98-vietnam-address:
    url: "https://since98.vn/api/mcp/address"
```

### Netclaw

```json
{
  "McpServers": {
    "vn-since98-vietnam-address": {
      "Transport": "http",
      "Url": "https://since98.vn/api/mcp/address"
    }
  }
}
```

### Vellum

```bash
assistant mcp add vn-since98-vietnam-address -t streamable-http -u 'https://since98.vn/api/mcp/address'
```

### Other

```json
{
  "mcpServers": {
    "vn-since98-vietnam-address": {
      "type": "http",
      "url": "https://since98.vn/api/mcp/address"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 71)

First indexed and scored.

## MCP tools (7)

### `convert_old_to_new` (~361 tokens)

Convert old address to new (2025 reform)

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"}.

Input parameters:

- `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.
- `ward` (string): Old commune-level unit (phường / xã / thị trấn): name, abbreviation (P.16) or 5-digit code.

### `find_units` (~313 tokens)

Find administrative units by name

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}.

Input parameters:

- `level` (string): Restrict to one level. "district" exists only with scope "old".
- `limit` (integer): Maximum results, 1-50, default 10.
- `province` (string): Optional province filter in the same scope: code or name.
- `query` (string, required): 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).

### `list_provinces` (~150 tokens)

List provinces (34 new or 63 old)

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"}.

Input parameters:

- `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.

### `list_wards` (~189 tokens)

List communes of a province

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.

Input parameters:

- `province` (string, required): Province: 2-digit code (e.g. "79") or name (e.g. "Hồ Chí Minh", "Ha Noi").
- `scope` (string): "new" (default): communes after the reform. "old": communes as of 30 June 2025, with their district.

### `explain_merge` (~165 tokens)

Explain how a new unit was formed

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"}.

Input parameters:

- `code` (string, required): Code of a NEW unit: 5-digit commune code (e.g. "26734") or 2-digit province code (e.g. "79").

### `normalize_address` (~223 tokens)

Rewrite a free-form address to the new units

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"}.

Input parameters:

- `address` (string, required): 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".

### `data_info` (~77 tokens)

Dataset version and sources

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: {}.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address#diagnostics

## Score history

- 2026-11-21: 71

## Common questions

### What is the Vietnam Address Converter (2025 reform) MCP server?

Vietnam Address Converter (2025 reform) is an MCP server listed in the public MCP registry as vn.since98/vietnam-address. Convert old Vietnamese addresses to the post-2025 34 provinces and 3,321 communes. Official data. This page covers its hosted endpoint (https://since98.vn/api/mcp/address).

### Is the Vietnam Address Converter (2025 reform) MCP server safe to use?

Vietnam Address Converter (2025 reform) scores 71 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Vietnam Address Converter (2025 reform) MCP server expose?

Vietnam Address Converter (2025 reform) exposes 7 tools: convert_old_to_new, find_units, list_provinces, list_wards, explain_merge, and 2 more. Their descriptions and schemas cost roughly 1,478 tokens of context every time the server is loaded.

### Does the Vietnam Address Converter (2025 reform) MCP server require authentication?

No. We connected to Vietnam Address Converter (2025 reform) without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Vietnam Address Converter (2025 reform) MCP server still maintained?

Vietnam Address Converter (2025 reform) is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Vietnam Address Converter (2025 reform) MCP server?

VerifyMCP ran 12 checks on Vietnam Address Converter (2025 reform), covering TLS certificate, Authorization, HTTPS, HSTS header and 8 more. One item could not be completed, a gap on our side rather than a finding about Vietnam Address Converter (2025 reform): Stability. One category scores 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://since98.vn/api/mcp/address
- Repository: https://github.com/since98vn/vietnam-mcp-servers
- Website: https://since98.vn/tools/vietnam-address-converter/api
- Changelog RSS feed: https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address.xml
- Changelog JSON feed: https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address.json
- HTML version of this page: https://verifymcp.io/servers/vn-since98-vietnam-address/api-mcp-address
