Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Vn Skills is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Vietnam: VietQR, address, tax ID, CCCD, phone, holiday, names, number/date format, lunar, e-invoice
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user vn-skills-mcp '--' npx -y @vn-skills/mcp
# 2 — ask your agent for something these tools do
# vietqr_build, vietqr_parse, vietqr_decode and 29 more
Vn Skills costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Vn Skills as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user vn-skills-mcp '--' npx -y @vn-skills/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
32 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read from its source code. A server that builds its tool list when it starts can list more tools than this.
Create a VietQR (NAPAS 247) bank-transfer QR payload. Returns the EMVCo string, CRC and optionally a PNG image. Bank accepts BIN (970436), code (VCB) or name (Vietcombank). Amount is integer VND; note is sanitized (no diacritics, max 25 chars).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| bank | string | yes | Bank BIN, code or name, e.g. "VCB", "970436", "Vietcombank" |
| account | string | yes | Beneficiary account number |
| amount | no | Amount in VND (integer). Omit for a static QR. | |
| note | string | no | Transfer note / purpose |
| image | boolean | no | Also return a PNG image (base64). Default false. |
Decode a VietQR / EMVCo QR payload string: bank, account, amount, note, and whether the CRC is valid.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| payload | string | yes | The decoded QR text, starting with 000201 |
Read the QR code in a PNG image file and decode it like vietqr_parse: bank, account, amount, note, CRC validity. Returns READ_ERROR for an unreadable/non-PNG file and NO_QR when no QR code is found.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Path to a PNG image containing a VietQR code |
Search the NAPAS bank list by BIN, code, short name or full name. Empty query lists all banks.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | e.g. "vietcombank", "VCB", "9704" |
Parse a free-text Vietnamese address into province / ward / street using the post-01/07/2025 catalogue (34 provinces, no districts). Handles missing diacritics and abbreviations (TP.HCM, Q.1, P. Bến Nghé). Set mode "legacy" for pre-2025 addresses with districts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | yes | Free-text address |
| mode | string | no | Default auto |
Convert up to 1000 pre-July-2025 Vietnamese free-text addresses (63 provinces, districts, wards) into the new 2-level structure (34 provinces, wards) in one call. Returns per-row results plus a summary of converted and failed rows. Null, empty or non-string entries do not fail the call: they come…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| addresses | array | yes | Free-text old addresses (max 1000); null or empty entries become failed rows |
Convert a pre-July-2025 Vietnamese address (63 provinces, districts, wards) into the new 2-level structure (34 provinces, wards). Returns the new ward/province, mapping type (unchanged/merged/divided) and all candidates when the old ward was split.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | no | Free-text old address |
| province | string | no | — |
| district | string | no | — |
| ward | string | no | — |
| street | string | no | — |
Find current (post-2025) wards by name, optionally within a province.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | — |
| province | string | no | — |
| limit | integer | no | — |
Offline validation of a Vietnamese tax ID (mã số thuế): 10 digits (enterprise), 13 digits (branch, e.g. 0100233488-001) with check-digit verification, or 12-digit personal ID (format only). Does not query the tax authority.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| taxId | string | yes | — |
Offline validation and decoding of a 12-digit CCCD (province, sex, birth year; legacy province mapped to 2025 province) or format check of a 9-digit CMND. Format validity does not prove the identity exists.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
Normalise a Vietnamese phone number (0/84/+84, old 11-digit 01xx mobile prefixes) to national and E.164 forms and classify it: mobile (original carrier) or landline (area code, province). Offline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| phone | string | yes | — |
Split a Vietnamese full name into họ / tên đệm / tên (handles Tôn Thất, Nguyễn Phúc), plus slug and initials; or sort a list of names by tên with Vietnamese collation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Full name to split |
| names | array | no | Names to sort |
| ascii | boolean | no | Strip diacritics from initials |
Read an integer VND amount in Vietnamese words, e.g. 1200000 -> "một triệu hai trăm nghìn đồng". Also reads plain numbers without a unit with plain: true, e.g. 30 -> "ba mươi". Options: thousand "nghìn"/"ngàn", odd "lẻ"/"linh", capitalize, unit.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| amount | yes | — | |
| thousand | string | no | — |
| odd | string | no | — |
| unit | string | no | Default "đồng"; "" for none |
| capitalize | boolean | no | — |
| chan | boolean | no | Append "chẵn" for round amounts |
| plain | boolean | no | Read a plain number without a unit (default false); not with unit/chan |
Parse an amount written in Vietnamese words back to digits, e.g. "một triệu hai trăm nghìn đồng" -> "1200000". Returns value (digit string), negative, unit, chan.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | yes | — |
Format numbers/VND/dates the Vietnamese way (1.234.567,89; 1.200.000 ₫; 1,2 triệu; dd/MM/yyyy) or parse typed amounts ("1tr2", "500k", "1,5 tỷ"; "1.500" = 1500).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mode | string | yes | — |
| value | yes | — |
Convert a Gregorian date (dd/mm/yyyy or yyyy-mm-dd) to the Vietnamese lunar date with can chi (e.g. Ất Tỵ), zodiac, leap-month flag and solar term.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| date | string | yes | — |
Convert a Vietnamese lunar date to the Gregorian date. Set leap=true for the leap (nhuận) month.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| day | integer | yes | — |
| month | integer | yes | — |
| year | integer | yes | — |
| leap | boolean | no | — |
Calendar of a Gregorian month: each day with lunar date (leap flag, mùng 1, rằm), day can chi, solar term starts and holidays/days off.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| month | integer | yes | — |
| year | integer | yes | — |
List Vietnamese holidays for a solar year (Tết, Giỗ Tổ Hùng Vương, 30/4, 1/5, 2/9, Trung thu...). Lunar holidays are resolved to solar dates. publicOnly limits to official days off.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| year | integer | yes | — |
| publicOnly | boolean | no | — |
Official days off for public-sector staff in a year (2023-2199): Tết Dương lịch, Tết Âm lịch, Giỗ Tổ Hùng Vương, 30/4, 1/5, Quốc khánh, Ngày Văn hóa Việt Nam 24/11 (from 2026), with nghỉ bù and swapped working Saturdays from the Government notice. Unannounced years return the statutory days,…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| year | integer | yes | — |
Whether a date is a working day for public-sector staff (Monday-Friday minus holidays and nghỉ bù, plus swapped Saturdays). certain: false when the year is not announced and the date may still become a Tết or National Day day off.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| day | integer | yes | — |
| month | integer | yes | — |
| year | integer | yes | — |
The date n working days after (or before, n < 0) a date, skipping weekends, holidays and nghỉ bù; the start date is not counted. certain: false if unannounced days were crossed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| day | integer | yes | — |
| month | integer | yes | — |
| year | integer | yes | — |
| n | integer | yes | — |
Number of working days in (from, to]: the start date is not counted, the end date is; negative if to is before from. Skips weekends, holidays and nghỉ bù. certain: false if unannounced Tết or National Day days were crossed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | — |
| to | string | yes | — |
Validate an e-invoice (hóa đơn điện tử) object against the mandatory contents of Decree 123/2020 (series, date, seller tax ID, lines, VAT rates 0/5/8/10/KCT/KKKNT).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| invoice | object | yes | — |
Validate an invoice and compute line amounts, VAT per rate, grand total and the total in Vietnamese words.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| invoice | object | yes | — |
| thousand | string | no | — |
Issue an invoice through the in-memory MOCK provider (no real API, nothing persisted). Useful for testing integrations before wiring MISA/Viettel/VNPT sandbox adapters.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| invoice | object | yes | — |
Solar date of Tết (lunar new year) for a year, with can chi and leap month.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| year | integer | yes | Year, e.g. 2026 |
Can chi (e.g. Giáp Thìn) of a lunar year, with its leap month if any.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| year | integer | yes | Year, e.g. 2024 |
Compute the 10th check digit of a Vietnamese tax ID from its first 9 digits.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| first9 | string | yes | Exactly 9 digits |
List the 34 current Vietnamese provinces (since 01/07/2025) with ward counts.
No parameter schema on file.
Look up one current province by name, alias (e.g. "TP.HCM") or 2-digit code.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Province name, alias or code |
Return a valid example invoice object to start from.
No parameter schema on file.
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Vn Skills or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | minimal | capability blast radius (minimal) — client exposure if the model is manipulated | −0 |
| verification-discount | source | publisher verification (provenance) — cryptographic build provenance ties the artifact to its source | −0 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
Tools were statically extracted from the published source (28 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| vietqr_build | no tags | |
| vietqr_parse | no tags | |
| vietqr_decode | no tags | |
| vietqr_banks | no tags | |
| vn_address_parse | no tags | |
| vn_address_convert | no tags | |
| vn_address_search_wards | no tags | |
| vn_tax_id_validate | no tags | |
| vn_id_parse | no tags | |
| vn_phone | no tags | |
| vn_name | no tags | |
| vn_money_to_words | no tags | |
| vn_number_format | no tags | |
| vn_lunar_from_solar | no tags | |
| vn_lunar_to_solar | no tags | |
| vn_lunar_holidays | no tags | |
| vn_holidays_year | no tags | |
| vn_holidays_is_working_day | no tags | |
| vn_holidays_add_working_days | no tags | |
| vn_einvoice_validate | no tags | |
| vn_einvoice_totals | no tags | |
| vn_einvoice_mock_issue | no tags | |
| vn_lunar_tet | no tags | |
| vn_lunar_canchi | no tags | |
| vn_tax_id_check_digit | no tags | |
| vn_address_provinces | no tags | |
| vn_address_province | no tags | |
| vn_einvoice_example | no tags |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 0.7.0. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Vn Skills can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.