Vietnam Payroll and Tax Calculator
Server Details
Vietnam gross/net salary, PIT, social insurance, employer cost and minimum wage, with act numbers.
- 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
Scored across 9 tools
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.
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.
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.
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 toolsamount_in_wordsAmount in words (Vietnamese and English)ARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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 coverageARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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
Vietnam 2026 household-business tax and salary income tax with legal citations; loan calculators.
Year-correct, cited payroll and tax numbers for Asia (Vietnam first) plus ~8,000 calculators.
Indonesia 2026: full income tax return, net salary, gross for net, employer cost, vs the Netherlands
Poland 2026: full income tax return, net salary, gross for net, employer cost, vs the Netherlands
Related MCP Servers
- AlicenseAqualityCmaintenanceTaiwan 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.92MIT
- AlicenseAqualityBmaintenanceRussian 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.7MIT
- AlicenseAqualityBmaintenanceEnables 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.4MIT
- AlicenseAqualityCmaintenanceSource-backed Sri Lanka payslip tools for APIT/PAYE, EPF, ETF, stamp duty, net pay, and employer cost.3MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.