mcpField
V
vn-skills

vn-skills

Local
github.com/beiryuBusiness & Marketing0Updated 1d ago
Repository

About vn-skills

vn-skills is a stdio MCP server that exposes functions for Vietnamese formats and services. It is intended for clients that need tools for payments, addresses, tax IDs, dates, names, and e-invoices.

Key features

  1. 01Build, parse, and decode VietQR
  2. 02Parse and convert Vietnamese addresses
  3. 03Validate Vietnamese tax IDs
  4. 04Convert money amounts to words
  5. 05Convert solar and lunar dates
  6. 06Validate and total e-invoices

Use cases

  1. 01Create or inspect VietQR payment data
  2. 02Normalize Vietnamese address records
  3. 03Check tax IDs and e-invoice totals
  4. 04Convert dates and format money amounts

MCP support

Exposes vn-skills functions as tools through a stdio MCP server.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "beiryu-vn-skills": {
      "command": "npx",
      "args": [
        "-y",
        "@vn-skills/mcp"
      ]
    }
  }
}
Run commandnpx -y @vn-skills/mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@vn-skills/mcp0.7.0

Tools

28

Saved tool list · updated 3d ago

ParameterTypeRequiredDescription
bankstringYesBank BIN, code or name, e.g. "VCB", "970436", "Vietcombank"
notestringNoTransfer note / purpose
imagebooleanNoAlso return a PNG image (base64). Default false.
amountnumber|stringNoAmount in VND (integer). Omit for a static QR.
accountstringYesBeneficiary account number

Details

From the project README

@vn-skills/mcp

MCP server (stdio) exposing the vn-skills functions as tools.

claude mcp add vn-skills -- npx -y @vn-skills/mcp

{ "mcpServers": { "vn-skills": { "command": "npx", "args": ["-y", "@vn-skills/mcp"] } } }

Tools: vietqr_build, vietqr_parse, vietqr_decode, vietqr_banks, vn_address_parse, vn_address_convert, vn_address_search_wards, vn_tax_id_validate, vn_money_to_words, vn_lunar_from_solar, vn_lunar_to_solar, vn_lunar_holidays, vn_einvoice_validate, vn_einvoice_totals, vn_einvoice_mock_issue, vn_name.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.