Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Vietnam Payroll and Tax Calculator

✓ since98.vn

by since98vnversion 2026.11.21i★ 0iRuns in the cloudOfficial site ↗
Registry namevn.since98/vietnam-payroll

How to install

What it does

Vietnam gross/net salary, PIT, social insurance, employer cost and minimum wage, with act numbers.

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Accounting, finance & tax

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars20/100Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-11-21

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 4/4 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Vietnam Payroll and Tax Calculator. Follow https://mcp.popnx.com/i/vn-since98-vietnam-payroll.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/4 checks · What you ask goes through the maker’s server (since98.vn) · ✓ Commands checked Nov 21, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Click this button: Claude opens the add-connector window already filled in

    Add Vietnam Payroll and Tax Calculator to Claude ↗

    The name and URL are filled in for you. Check them and click Add · if you are signed out, Claude asks you to sign in first

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

    Button not working? Fill it in yourself

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameVietnam Payroll and Tax Calculator
    Remote MCP server URL · Addresshttps://since98.vn/api/mcp/payroll
  2. Turn it on in a chat

    +ConnectorsVietnam Payroll and Tax Calculator

  3. Try it

    Use Vietnam Payroll and Tax Calculator and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Vietnam Payroll and Tax Calculator or shows a Vietnam Payroll and Tax Calculator tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameVietnam Payroll and Tax Calculator
    Connection · Addresshttps://since98.vn/api/mcp/payroll
  3. Pick Vietnam Payroll and Tax Calculator in a chat

    Start a new chat and pick Vietnam Payroll and Tax Calculator from your plugins before typing

  4. Try it

    Use Vietnam Payroll and Tax Calculator and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Vietnam Payroll and Tax Calculator or shows a Vietnam Payroll and Tax Calculator tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user vietnam-payroll https://since98.vn/api/mcp/payroll
  3. Type /mcp in Claude Code

    You should see Vietnam Payroll and Tax Calculator listed as connected

  4. Try it

    Use Vietnam Payroll and Tax Calculator and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Vietnam Payroll and Tax Calculator or shows a Vietnam Payroll and Tax Calculator tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Vietnam Payroll and Tax Calculator and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Vietnam Payroll and Tax Calculator or shows a Vietnam Payroll and Tax Calculator tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Vietnam Payroll and Tax Calculator and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Vietnam Payroll and Tax Calculator or shows a Vietnam Payroll and Tax Calculator tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://since98.vn/api/mcp/payroll

JSON settings are under “For developers” below

Stuck? Ask people who use Vietnam Payroll and Tax Calculator💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user vietnam-payroll https://since98.vn/api/mcp/payroll

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "vietnam-payroll": {
      "url": "https://since98.vn/api/mcp/payroll"
    }
  }
}

VS Code (mcp.json)

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

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Verified domain
✓ since98.vn
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
2026.11.21
Published to registryi
Nov 21, 2026
Code last changedi
Nov 21, 2026
Last checked
Nov 21, 2026
Maker
since98vn
Website
since98.vn
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 21, 2026. The maker wrote them, not us; we show them as plain text.

  • gross_to_net

    Calculate monthly take-home pay from a gross salary in Vietnam: employee social (8%), health (1.5%) and unemployment (1%) insurance with the ceilings for the date and region, family deductions (15.5 million VND for the taxpayer, 6.2 million per dependent), personal income tax by

  • net_to_gross

    Find the gross monthly salary that gives a desired net (take-home) pay in Vietnam, for offers quoted in net. Exact to the dong: target_net and net_difference show the match. Returns the same breakdown as gross_to_net (insurance by fund, deductions, tax by bracket, employer cost).

  • pit_only

    Calculate Vietnamese personal income tax on a monthly taxable income that is already known (salary after compulsory insurance and family deductions), with the amount and tax of each bracket of the 5-bracket scale (5%, 10%, 20%, 30%, 35%; thresholds 10, 30, 60, 100 million VND). F

  • employer_cost

    Calculate what a monthly gross salary costs an employer in Vietnam: social insurance (sickness and maternity 3%, retirement 14%, occupational accident 0.5%), health insurance 3%, unemployment insurance 1% (not for foreigners), the 2% trade union fund, and the total cost; the empl

  • minimum_wage

    Return Vietnam's regional minimum wages (monthly and hourly, regions I-IV) in force on a date from January 2026, including the new rates from 1 January 2027, with the unemployment insurance ceiling of each region (20 x the minimum). The region of a workplace is set by the decree'

  • withholding_10pct

    Calculate the 10% personal income tax an organisation withholds from a payment to a resident individual without a labour contract or with a contract under 3 months (freelance, service fees). Threshold per payment: 2 million VND before 1 July 2026, 5 million VND from that date (th

  • bhxh_lump_sum

    Estimate the one-time social insurance payment in Vietnam: 1.5 months of the average insurance salary for each year of contributions before 2014 and 2 months for each year from 2014; leftover months round to half or a full year; under one year it is the amount contributed, capped

  • amount_in_words

    Write a whole number or VND amount (0 to 10^15) in words, in Vietnamese (as on invoices and payment orders: lẻ or linh for a zero tens digit, mốt, tư, lăm; nghìn, triệu, tỷ; optional "đồng chẵn") and in English. Examples: {"amount":1234567891}; {"amount":105,"language":"vi","vi_z

  • data_info

    Return the parameters this calculator uses for each period from January 2026 (tax scale, family deductions, base salary, insurance ceilings, regional minimum wages, contribution rates, trade union rates, lump-sum rules, adjustment coefficients) with act numbers and verification s

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 22, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain since98.vn (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • – Not applicable

    Has a licence

    Not applicable: a cloud server run by the owner of since98.vn; you don't run code from the repo

  • ✓ Pass

    Endpoint responds

    Responded in 139 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 9 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/vn-since98-vietnam-payroll.svg)](https://mcp.popnx.com/en/servers/vn-since98-vietnam-payroll)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 0% of the other 3641 servers in this category
  • Published to the registry more recently than 97% of the other 3641 servers in this category
  • Basic checks equal to or better than 99% of the other 3641 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Vietnam Payroll and Tax Calculator safe?

It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (2026.11.21) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 264Updated 14 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 735 Stars for the whole repoUpdated 2 months ago

Runs in the cloud✓ service owner · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

by twelvedataGrowing★ 87Updated 18 days ago

Runs in the cloud✓ service owner · twelvedata.com
Compared with similar ones
This one
Vietnam Payroll and Tax Calculator
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to install
Needs a keyNoNoNoNoYesNo
Add with + in ClaudeNoNoNoNoNoYes
Basic checks4/45/54/44/45/54/4
LicenseMITMITNOASSERTIONMITMIT–
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Vietnam MCP servers by Since98

Free remote MCP servers and REST APIs for working with Vietnam: post-2025 addresses, payroll and personal income tax, and Zalo business messaging prices and rules.

No API key. No sign-up. Read-only. Every answer carries the data version, the official source and the act or page it comes from.

ServerMCP endpoint (Streamable HTTP)REST APITools
Vietnam Address Converter (2025 reform)https://since98.vn/api/mcp/addresshttps://since98.vn/api/v1/address/7
Vietnam Payroll and Tax Calculatorhttps://since98.vn/api/mcp/payrollhttps://since98.vn/api/v1/payroll/9
Zalo Business Reference (ZBS Template Message, OA)https://since98.vn/api/mcp/zalohttps://since98.vn/api/v1/zalo/7

Add a URL to your AI assistant and ask in plain words:

*"My customer list still has 'Phường Phú Cường, TP Thủ Dầu Một, Bình Dương'. What is the address now?"*

*"Gross salary 30,000,000 VND in Region I with one dependant: what is the net pay in November 2026?"*

*"What do 10,000 ZNS order updates with a website button cost?"*

This repository holds the documentation, client configs, request examples and registry metadata. The servers run on since98.vn; there is no code to install.


Contents

  • The servers and their tools
  • Connect a client
  • REST examples
  • Data sources and versions
  • Limits and larger volumes
  • Privacy
  • Disclaimers
  • Reporting a data error
  • About Since98
  • Tiếng Việt

The servers and their tools

All tools are read-only (readOnlyHint: true, destructiveHint: false) and have a title. The lists below match tools/list on the live servers.

1. Vietnam Address Converter (2025 reform)

On 1 July 2025 Vietnam went from 63 provinces to 34 and abolished districts; 10,035 old communes became 3,321 new ones. This server converts addresses written the old way to the new units, using the official transition table of the National Statistics Office (Cục Thống kê). When an old commune was split, it returns every resulting unit and marks the answer as ambiguous instead of guessing.

ToolWhat it does
convert_old_to_newConvert an old province, district and commune to the new units (2025 reform)
normalize_addressRewrite a free-form address, with or without diacritics, to the new units
find_unitsFind administrative units by name, old or new
list_provincesList the 34 new or the 63 old provinces
list_wardsList the communes of a province
explain_mergeExplain how a new unit was formed and which resolution did it
data_infoDataset version, source file checksum and the resolutions used

Web tool: Vietnam address converter · Vietnamese version · API and MCP docs

2. Vietnam Payroll and Tax Calculator

Monthly payroll under the rules in force from 1 January 2026: social, health and unemployment insurance, personal income tax by bracket, family deductions, regional minimum wages (including the 2027 rates), the 10% withholding without a labour contract and the one-time social insurance payment. Every line is rounded to the dong, and every answer lists the act numbers behind the figures.

ToolWhat it does
gross_to_netGross to net salary, with every insurance line and the tax by bracket
net_to_grossThe gross salary needed for a target net pay
pit_onlyPersonal income tax by bracket for a taxable income
employer_costWhat a salary costs the employer, with each contribution
minimum_wageRegional minimum wage (Regions I–IV) for a date
withholding_10pct10% tax withholding for payments without a labour contract
bhxh_lump_sumOne-time social insurance payment (BHXH một lần)
amount_in_wordsAn amount in words, in Vietnamese and English, for invoices and contracts
data_infoParameters, acts and the dates they cover

Web tools: Salary calculator · Vietnamese version · Number to words · API and MCP docs

3. Zalo Business Reference (ZBS Template Message, OA)

Prices and rules for businesses that message customers on Zalo: ZBS Template Message (formerly ZNS) prices by template type, buttons and delivery, Official Account plans, formal checks of a template draft, sending windows and quotas, and Zalo error codes. Figures Zalo does not publish come back as null with a status; they are never guessed. Nothing is sent to Zalo, and no tokens or phone numbers are accepted.

ToolWhat it does
estimate_message_costPrice per ZBS template message and the total for a campaign, with a line breakdown
oa_plan_compareCompare Zalo OA plans and pick the smallest one that fits
validate_templateCheck a template draft against Zalo's published formal rules
check_sending_rulesSending window by tag, daily quota and promotion limits
choose_channelWhich Zalo channel fits a task: template message, free reply, broadcast or Mini App
error_lookupExplain a Zalo error code and what to check
data_infoSources, figures Zalo does not publish, and where Zalo's own pages disagree

Web tool: Zalo ZNS cost calculator · Vietnamese version · API and MCP docs


Connect a client

The servers use Streamable HTTP, are stateless, and need no authentication or headers. Replace the URL with the server you want; you can add all three. Ready-made files are in examples/.

Claude (web and desktop)
  1. Open Customize → Connectors, choose + Add → Add custom connector. On Team and Enterprise plans, an owner adds it in Organization settings → Connectors.
  2. Enter a name, for example *Vietnam payroll*, and the URL https://since98.vn/api/mcp/payroll.
  3. Choose No sign in and click Add.

Free plans can add one custom connector. Source: Claude Help Center.

Claude Code
claude mcp add --transport http since98-address https://since98.vn/api/mcp/address

claude mcp add --transport http since98-payroll https://since98.vn/api/mcp/payroll claude mcp add --transport http since98-zalo https://since98.vn/api/mcp/zalo

Add --scope user to use them in every project, or commit examples/claude-code.mcp.json as .mcp.json to share them with your team. Check with /mcp inside a session. Source: Claude Code docs.

Cursor

Put this in ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{

"mcpServers": { "since98-address": { "url": "https://since98.vn/api/mcp/address" }, "since98-payroll": { "url": "https://since98.vn/api/mcp/payroll" }, "since98-zalo": { "url": "https://since98.vn/api/mcp/zalo" } } }

Source: Cursor docs.

VS Code (GitHub Copilot)

Run MCP: Add Server from the Command Palette, choose HTTP, paste the URL and give it an ID. Or add the servers to the Copilot configuration (~/.copilot/mcp-config.json, or .mcp.json at the workspace root):

{

"mcpServers": { "since98-address": { "type": "http", "url": "https://since98.vn/api/mcp/address" }, "since98-payroll": { "type": "http", "url": "https://since98.vn/api/mcp/payroll" }, "since98-zalo": { "type": "http", "url": "https://since98.vn/api/mcp/zalo" } } }

Older setups that still use .vscode/mcp.json take the same entries under a servers key: see examples/vscode.mcp.json. Source: VS Code docs.

ChatGPT

On chatgpt.com, open the plugins page, choose + → Add custom MCP server, paste the server URL and choose No authentication. Availability depends on your plan and workspace settings. Source: OpenAI docs.

Any other MCP client

Add a remote MCP server by URL. Transport: Streamable HTTP. No key, no OAuth, no headers. Protocol versions from 2024-11-05 to 2026-07-28 are accepted.

Try it without a client
curl -s https://since98.vn/api/mcp/payroll \

-H 'content-type: application/json' \ -H 'accept: application/json, text/event-stream' \ -H 'mcp-protocol-version: 2025-06-18' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gross_to_net","arguments":{"gross":30000000,"region":"I","dependents":1}}}'


REST examples

Each API also publishes an OpenAPI 3.1 document: address, payroll, zalo. Endpoints that take text a person typed, or a salary, also accept POST: the body stays out of URLs and server logs. More in examples/rest.sh.

Rewrite an old address (POST keeps the address out of logs):

curl -s https://since98.vn/api/v1/address/normalize \

-H 'content-type: application/json' \ -d '{"address":"123 Le Loi, Phuong Ben Thanh, Quan 1, TP Ho Chi Minh"}'

{"status":"converted","ambiguous":false,"confidence":"high","address":"123 Le Loi, Phường Bến Thành, Thành phố Hồ Chí Minh", ...}

Convert an old commune:

curl -s "https://since98.vn/api/v1/address/convert?province=Binh%20Duong&district=Thu%20Dau%20Mot&ward=Phu%20Cuong"

Returns *Phường Thủ Dầu Một, Thành phố Hồ Chí Minh*, with the resolution number.

Gross to net:

curl -s https://since98.vn/api/v1/payroll/gross-to-net \

-H 'content-type: application/json' \ -d '{"gross":30000000,"region":"I","dependents":1,"month":"2026-11"}'

{"as_of":"2026-11-01","region":"I","gross":30000000,"net":26592500,"employee_contributions":{...,"total":3150000},"pit":{...,"tax":257500}, ...}

Regional minimum wage from 2027:

curl -s "https://since98.vn/api/v1/payroll/minimum-wage?region=I&month=2027-01"

ZBS template message cost:

curl -s "https://since98.vn/api/v1/zalo/message-cost?template_type=custom&buttons=business_website&count=10000"

Returns 400 VND per message (300 for the template, 100 for the website button) and 4,000,000 VND for 10,000 delivered messages, excluding VAT.

Zalo error code:

curl -s "https://since98.vn/api/v1/zalo/errors?code=-133"

Check a template draft (POST only):

curl -s https://since98.vn/api/v1/zalo/validate-template \

-H 'content-type: application/json' \ -d '{"template_type":"custom","tag":1,"title":"Order confirmed","paragraphs":["Hello , your order is on its way."]}'

The examples above were run against the live APIs on 2026-11-21. Figures change when the law or Zalo's prices change; check data_version in each answer.


Data sources and versions

ServerData versionSource

| Address | 2026.11.20 | Official administrative-unit transition table of the National Statistics Office of Viet Nam (Cục Thống kê, Ministry

Only the beginning is shown; read the rest in the repo