Skip to content

API · MCP · open test suite

Vietnamese payroll rules, by effective date, for your software and AI agents

Send numbers, get gross/net, personal income tax and social insurance back, with every step and the legal document it comes from.

Try itRead the docs

Without a key: 30 requests/minute and 1,000/day per IP.

Request
curl -s https://api.maxmin.vn/v1/luong/gross-net \
  -H 'content-type: application/json' \
  -d '{"gross":30000000,"ngay_ap_dung":"2026-09-27","vung":"I"}'
Response (trimmed)
{
  "ngay_ap_dung": "2026-09-27",
  "gross": 30000000,
  "bh_nld": 3150000,
  "thu_nhap_tinh_thue": 11350000,
  "thue_tncn": 635000,
  "bac": 2,
  "net": 26215000,
  "giai_trinh": [ ... ],
  "phien_ban_luat": "..."
}

What you get

12 endpointsgross-net, net-gross, insurance, PIT, annual finalisation, minimum wage, parameters, change log, test suiteMCP serverStreamable HTTP at mcp.maxmin.vn, works with Claude, Cursor, VS Code and other MCP clients426 test casesOpen under CC BY 4.0: input, expected output and the reasoning for each caseChange logMachine-readable, by effective date, including changes already announced for later dates

Who it is for

HR and accounting software

Measure your engine against the public test suite and follow the change log instead of re-reading every decree.

Global payroll and EOR

An English API for Vietnam: 2026 brackets and deductions, regional minimum wage, caps, dated.

AI agent builders

An MCP server your agent can call, so it does not guess tax figures from memory.

No personal data

The API takes numbers only (salary, dependants, region, date). No names, ID numbers or tax codes.

Every figure has a source

35 parameters, each with its effective dates and the article of the legal document (54 documents). 16 parameters are marked can_ra_soat (not yet matched word for word to the original text) and are listed in every result that uses them.

Sources last checked: 27/09/2026

Start in one minute

  1. Call the API without a key from the playground or curl.
  2. Add the MCP server to your agent: claude mcp add --transport http maxmin https://mcp.maxmin.vn/mcp
  3. Need higher limits? Ask for a free key. Get a key