# Vietnam Payroll and Tax Calculator (remote · since98.vn)

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

- Trust score: 71/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `since98.vn`: 71/100 (this document), [markdown](https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll.md), [page](https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll)

## Channel facts

- Endpoint: `https://since98.vn/api/mcp/payroll`
- Transports: `streamable-http`
- Auth: `none`
- Version: `2026.11.21`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 59/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3676 tokens (~408/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 9 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 10 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the Vietnam Payroll and Tax Calculator MCP server?

Vietnam Payroll and Tax Calculator is a hosted endpoint at https://since98.vn/api/mcp/payroll, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http vn-since98-vietnam-payroll 'https://since98.vn/api/mcp/payroll'
```

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.vn-since98-vietnam-payroll]
url = "https://since98.vn/api/mcp/payroll"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vn-since98-vietnam-payroll": {
      "type": "remote",
      "url": "https://since98.vn/api/mcp/payroll",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vn-since98-vietnam-payroll --url 'https://since98.vn/api/mcp/payroll' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  vn-since98-vietnam-payroll:
    url: "https://since98.vn/api/mcp/payroll"
```

### Netclaw

```json
{
  "McpServers": {
    "vn-since98-vietnam-payroll": {
      "Transport": "http",
      "Url": "https://since98.vn/api/mcp/payroll"
    }
  }
}
```

### Vellum

```bash
assistant mcp add vn-since98-vietnam-payroll -t streamable-http -u 'https://since98.vn/api/mcp/payroll'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 71)

First indexed and scored.

## MCP tools (9)

### `gross_to_net` (~606 tokens)

Gross to net salary (Vietnam)

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"}.

Input parameters:

- `as_of` (string): Date of the calculation: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `dependents` (integer): Number of registered dependents (0-20, default 0). Residents only: 6.2 million VND per dependent per month.
- `gross` (integer, required): Monthly gross salary in VND (whole number), e.g. 30000000.
- `insurance_base` (integer): Salary used for compulsory insurance, if different from gross. Must not be below the regional minimum wage; capped at the ceilings automatically.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `nationality` (string): "vietnamese" (default) or "foreigner" = foreign citizen with a labour contract of 12 months or more: social and health insurance, no unemployment insurance.
- `region`: Regional minimum wage zone I, II, III or IV (default I); 1-4 and lower case are accepted. Chosen by the user; there is no locality lookup.
- `residency` (string): Tax residency: "resident" (default; progressive scale with deductions) or "non_resident" (flat 20% of gross, no deductions).
- `union_member` (boolean): Employee is a trade union member: deduct the 0.5% member fee (default false).

Output parameters:

- `as_of` (string)
- `data_version` (string)
- `disclaimer` (string)
- `employee_contributions` (object)
- `employer` (object)
- `gross` (number)
- `nationality` (string)
- `net` (number)
- `notes` (array)
- `pit` (object)
- `region` (string)
- `residency` (string)
- `sources` (array)

### `net_to_gross` (~554 tokens)

Net to gross salary (Vietnam)

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"}.

Input parameters:

- `as_of` (string): Date of the calculation: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `dependents` (integer): Number of registered dependents (0-20, default 0). Residents only: 6.2 million VND per dependent per month.
- `insurance_base` (integer): Salary used for compulsory insurance, if different from gross. Must not be below the regional minimum wage; capped at the ceilings automatically.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `nationality` (string): "vietnamese" (default) or "foreigner" = foreign citizen with a labour contract of 12 months or more: social and health insurance, no unemployment insurance.
- `net` (integer, required): Desired monthly net (take-home) salary in VND, e.g. 25000000.
- `region`: Regional minimum wage zone I, II, III or IV (default I); 1-4 and lower case are accepted. Chosen by the user; there is no locality lookup.
- `residency` (string): Tax residency: "resident" (default; progressive scale with deductions) or "non_resident" (flat 20% of gross, no deductions).
- `union_member` (boolean): Employee is a trade union member: deduct the 0.5% member fee (default false).

Output parameters:

- `as_of` (string)
- `data_version` (string)
- `disclaimer` (string)
- `employee_contributions` (object)
- `employer` (object)
- `gross` (number)
- `nationality` (string)
- `net` (number)
- `notes` (array)
- `pit` (object)
- `region` (string)
- `residency` (string)
- `sources` (array)

### `pit_only` (~332 tokens)

Personal income tax by bracket (Vietnam)

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"}.

Input parameters:

- `as_of` (string): Date of the calculation: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `residency` (string): Tax residency: "resident" (default; progressive scale with deductions) or "non_resident" (flat 20% of gross, no deductions).
- `taxable_income` (integer, required): Monthly taxable income in VND: for residents, salary after compulsory insurance and family deductions; for non-residents, the gross salary.

Output parameters:

- `as_of` (string)
- `data_version` (string)
- `disclaimer` (string)
- `method` (string)
- `notes` (array)
- `sources` (array)
- `tax` (number)
- `taxable_income` (number)

### `employer_cost` (~560 tokens)

Employer cost of a salary (Vietnam)

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"}.

Input parameters:

- `as_of` (string): Date of the calculation: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `dependents` (integer): Number of registered dependents (0-20, default 0). Residents only: 6.2 million VND per dependent per month.
- `gross` (integer, required): Monthly gross salary in VND (whole number), e.g. 30000000.
- `insurance_base` (integer): Salary used for compulsory insurance, if different from gross. Must not be below the regional minimum wage; capped at the ceilings automatically.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `nationality` (string): "vietnamese" (default) or "foreigner" = foreign citizen with a labour contract of 12 months or more: social and health insurance, no unemployment insurance.
- `region`: Regional minimum wage zone I, II, III or IV (default I); 1-4 and lower case are accepted. Chosen by the user; there is no locality lookup.
- `residency` (string): Tax residency: "resident" (default; progressive scale with deductions) or "non_resident" (flat 20% of gross, no deductions).
- `union_member` (boolean): Employee is a trade union member: deduct the 0.5% member fee (default false).

Output parameters:

- `as_of` (string)
- `data_version` (string)
- `disclaimer` (string)
- `employee_contributions` (object)
- `employer` (object)
- `gross` (number)
- `nationality` (string)
- `net` (number)
- `notes` (array)
- `pit` (object)
- `region` (string)
- `residency` (string)
- `sources` (array)

### `minimum_wage` (~238 tokens)

Regional minimum wage (Vietnam)

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"}.

Input parameters:

- `as_of` (string): Date of the calculation: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `region`: Optional region I-IV (or 1-4) to single out; all four regions are always listed.

Output parameters:

- `as_of` (string)
- `data_version` (string)
- `disclaimer` (string)
- `notes` (array)
- `regions` (array)
- `sources` (array)

### `withholding_10pct` (~344 tokens)

10% tax withholding without a labour contract (Vietnam)

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"}.

Input parameters:

- `amount` (integer, required): Amount of one payment in VND (before tax) to a resident without a labour contract or with a contract under 3 months.
- `as_of` (string): Payment date: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.

Output parameters:

- `amount` (number)
- `applies` (boolean)
- `as_of` (string)
- `data_version` (string)
- `disclaimer` (string)
- `notes` (array)
- `paid_out` (number)
- `sources` (array)
- `withheld` (number)

### `bhxh_lump_sum` (~475 tokens)

One-time social insurance payment (BHXH một lần)

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}.

Input parameters:

- `as_of` (string): Date of the social insurance agency's decision: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected.
- `average_salary` (integer): Alternative to salary_history: average monthly insurance salary, ALREADY indexed with the adjustment coefficients.
- `contributed_amount` (integer): Under one year of contributions only: the amount actually contributed; if omitted it is estimated at 22% of the salaries.
- `date` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `month` (string): Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date.
- `months_before_2014` (integer): With average_salary: months of contributions before 2014.
- `months_from_2014` (integer): With average_salary: months of contributions from 2014 on.
- `salary_history` (array): Simple list of years: {year, monthly_salary, months (default 12)}. Each year is indexed with the published adjustment coefficient; months before 2014 and from 2014 are counted from the years.

Output parameters:

- `amount` (number)
- `as_of` (string)
- `average_salary` (number)
- `case` (string)
- `data_version` (string)
- `disclaimer` (string)
- `notes` (array)
- `sources` (array)

### `amount_in_words` (~273 tokens)

Amount in words (Vietnamese and English)

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}.

Input parameters:

- `amount` (integer, required): Whole number from 0 to 10^15, e.g. 1234567891.
- `capitalize` (boolean): Capitalize the first letter. Default false.
- `currency` (boolean): Append the currency ("đồng" / "dong"). Default true; false gives the bare number.
- `language` (string): "vi", "en" or "both" (default).
- `vi_chan` (boolean): Vietnamese only: end with "đồng chẵn" (an exact amount), as on payment documents. Default false.
- `vi_zero` (string): Vietnamese word for a zero tens digit: "lẻ" (default) or "linh", e.g. 105 = một trăm lẻ năm.

Output parameters:

- `amount` (number)
- `data_version` (string)
- `disclaimer` (string)
- `en` (string)
- `vi` (string)

### `data_info` (~94 tokens)

Parameters, acts and coverage

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: {}.

Output parameters:

- `data_date` (string)
- `data_version` (string)
- `disclaimer` (string)
- `parameters` (object)
- `supported_from` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll#diagnostics

## Score history

- 2026-11-21: 71

## Common questions

### What is the Vietnam Payroll and Tax Calculator MCP server?

Vietnam Payroll and Tax Calculator is an MCP server listed in the public MCP registry as vn.since98/vietnam-payroll. Vietnam gross/net salary, PIT, social insurance, employer cost and minimum wage, with act numbers. This page covers its hosted endpoint (https://since98.vn/api/mcp/payroll).

### Is the Vietnam Payroll and Tax Calculator MCP server safe to use?

Vietnam Payroll and Tax Calculator scores 71 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Vietnam Payroll and Tax Calculator MCP server expose?

Vietnam Payroll and Tax Calculator exposes 9 tools: gross_to_net, net_to_gross, pit_only, employer_cost, minimum_wage, and 4 more. Their descriptions and schemas cost roughly 3,476 tokens of context every time the server is loaded.

### Does the Vietnam Payroll and Tax Calculator MCP server require authentication?

No. We connected to Vietnam Payroll and Tax Calculator without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Vietnam Payroll and Tax Calculator MCP server still maintained?

Vietnam Payroll and Tax Calculator is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Vietnam Payroll and Tax Calculator MCP server?

VerifyMCP ran 12 checks on Vietnam Payroll and Tax Calculator, covering TLS certificate, Authorization, HTTPS, HSTS header and 8 more. One item could not be completed, a gap on our side rather than a finding about Vietnam Payroll and Tax Calculator: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://since98.vn/api/mcp/payroll
- Repository: https://github.com/since98vn/vietnam-mcp-servers
- Website: https://since98.vn/tools/vietnam-salary-calculator/api
- Changelog RSS feed: https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll.xml
- Changelog JSON feed: https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll.json
- HTML version of this page: https://verifymcp.io/servers/vn-since98-vietnam-payroll/api-mcp-payroll
