Skip to main content
Glama

Vietnam Payroll and Tax Calculator

Server Details

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

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
since98vn/vietnam-mcp-servers
GitHub Stars
0
ChatGPT
–
Claude
–

TDQS

A4.2/5.0

Scored across 9 tools

Disambiguation3/5

Most tools are clearly distinct (amount_in_words, bhxh_lump_sum, minimum_wage, data_info, withholding_10pct), and pit_only explicitly redirects to gross_to_net when starting from a gross salary. However, employer_cost and gross_to_net take the same gross input and both return the employer contributions, total cost, and net pay, so the boundary between them is genuinely blurred even though the descriptions hint at an employer vs. employee framing.

Naming Consistency4/5

All names are snake_case and descriptive, with a clean gross_to_net / net_to_gross mirror pair and predictable suffixes (gross, net, cost, wage, sum). Minor deviations only: the Vietnamese acronym bhxh_lump_sum is opaque without domain knowledge, and withholding_10pct embeds a number in the name.

Tool Count5/5

Nine tools is well within the sweet spot and each maps to a distinct payroll/tax question an agent would actually ask. None look like padding, and no obvious missing dimension forces an extra tool.

Completeness4/5

The surface covers the core Vietnam payroll lifecycle: gross↔net conversion, employer cost, PIT bracket breakdown, freelancer withholding, minimum wage lookup, BHXH lump sum, plus metadata and number-to-words helpers. Gaps remain around annual tax finalization, overtime/allowance handling, and severance or job-loss allowances, but these are edge workflows an agent can work around.

Available Tools

9 tools
amount_in_wordsAmount in words (Vietnamese and English)A
Read-onlyIdempotent
Inspect

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_zero":"linh"}; {"amount":25000000,"vi_chan":true,"capitalize":true}.

Inputs: amount (required), vi_chan, vi_zero, currency, +2 more. Returns: en, vi, amount, disclaimer, +1 more

bhxh_lump_sumOne-time social insurance payment (BHXH một lần)A
Read-onlyIdempotent
Inspect

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 at 2 months of the average. Pass salary_history (years with monthly insurance salary; each year is indexed with the published BHXH coefficients) or an already indexed average_salary with months_before_2014 and months_from_2014. Eligibility is not checked. Examples: {"salary_history":[{"year":2012,"monthly_salary":5000000},{"year":2013,"monthly_salary":6000000},{"year":2025,"monthly_salary":15000000,"months":7}],"as_of":"2026-09"}; {"average_salary":12000000,"months_before_2014":30,"months_from_2014":50}.

Inputs: date, as_of, month, average_salary, +4 more. Returns: case, as_of, notes, amount, +4 more

data_infoParameters, acts and coverageA
Read-onlyIdempotent
Inspect

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 status, the rounding rule, what is not included, and the data version. Use when the user asks how current or reliable the figures are. Takes no arguments: {}.

Inputs: no named parameters. Returns: data_date, disclaimer, parameters, data_version, +1 more

employer_costEmployer cost of a salary (Vietnam)A
Read-onlyIdempotent
Inspect

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 employee's net pay is included. Options: as_of (YYYY-MM or YYYY-MM-DD, default today; month and date are accepted as synonyms), region I-IV or 1-4 (default I), dependents (residents only), residency resident|non_resident, nationality vietnamese|foreigner (foreigner = contract of 12 months or more: no unemployment insurance), insurance_base (if the insured salary differs from gross; not below the regional minimum), union_member (0.5% member fee, default false). Examples: {"gross":20000000}; {"gross":80000000,"nationality":"foreigner","as_of":"2026-08"}.

Inputs: gross (required), date, as_of, month, +6 more. Returns: net, pit, as_of, gross, +9 more

gross_to_netGross to net salary (Vietnam)A
Read-onlyIdempotent
Inspect

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 bracket (5-bracket scale 5% to 35%, or 20% flat for non-residents), net pay, and the employer contributions and total cost. Options: as_of (YYYY-MM or YYYY-MM-DD, default today; month and date are accepted as synonyms), region I-IV or 1-4 (default I), dependents (residents only), residency resident|non_resident, nationality vietnamese|foreigner (foreigner = contract of 12 months or more: no unemployment insurance), insurance_base (if the insured salary differs from gross; not below the regional minimum), union_member (0.5% member fee, default false). Examples: {"gross":30000000}; {"gross":50000000,"dependents":2,"as_of":"2026-08","region":"II"}; {"gross":120000000,"nationality":"foreigner"}.

Inputs: gross (required), date, as_of, month, +6 more. Returns: net, pit, as_of, gross, +9 more

minimum_wageRegional minimum wage (Vietnam)A
Read-onlyIdempotent
Inspect

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's annex of communes; this tool does not look it up. Examples: {}; {"as_of":"2027-02","region":"I"}.

Inputs: date, as_of, month, region. Returns: as_of, notes, regions, sources, +2 more

net_to_grossNet to gross salary (Vietnam)A
Read-onlyIdempotent
Inspect

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). Options: as_of (YYYY-MM or YYYY-MM-DD, default today; month and date are accepted as synonyms), region I-IV or 1-4 (default I), dependents (residents only), residency resident|non_resident, nationality vietnamese|foreigner (foreigner = contract of 12 months or more: no unemployment insurance), insurance_base (if the insured salary differs from gross; not below the regional minimum), union_member (0.5% member fee, default false). Examples: {"net":25000000}; {"net":40000000,"dependents":1,"as_of":"2027-02"}.

Inputs: net (required), date, as_of, month, +6 more. Returns: net, pit, as_of, gross, +9 more

pit_onlyPersonal income tax by bracket (Vietnam)A
Read-onlyIdempotent
Inspect

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). For non-residents: flat 20% of the income. Use gross_to_net instead when you start from a gross salary. Examples: {"taxable_income":24500000}; {"taxable_income":80000000,"as_of":"2026-03"}; {"taxable_income":50000000,"residency":"non_resident"}.

Inputs: taxable_income (required), date, as_of, month, +1 more. Returns: tax, as_of, notes, method, +4 more

withholding_10pct10% tax withholding without a labour contract (Vietnam)A
Read-onlyIdempotent
Inspect

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 (the effective date of Decree 253/2026/ND-CP); below it nothing is withheld. Caveat on the date: the decree also applies its provisions on residents' salary income to the whole tax year 2026, so the 5 million threshold may be read as applying from 1 January 2026; this is not confirmed, and for January-June 2026 the tool uses 2 million and says so in the notes. Notes cover the commitment-form exemption. Examples: {"amount":8000000}; {"amount":3000000,"as_of":"2026-03-15"}.

Inputs: amount (required), date, as_of, month. Returns: as_of, notes, amount, applies, +5 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Taiwan statutory payroll calculation — labor & health insurance, labor pension, 2nd-gen NHI supplementary premium, income-tax withholding, and old-age benefits. Sourced from official gazettes, verified against official sample data.
      9
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Russian payroll calculator (2025-2026 rules): net/gross salary with progressive 13-22% income tax, employer contributions incl. SME/IT tariffs, vacation pay, sick pay and unused-vacation compensation. Fully local, no API key.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables calculating Malaysian statutory payroll deductions—EPF, SOCSO, EIS and MTD/PCB—for a resident employee's fixed monthly salary, citing the official rate table or rule behind each figure.
      4
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.