# MAXMIN

> Vietnamese payroll rules as an API and an MCP server: gross/net salary, personal income tax (PIT), compulsory social/health/unemployment insurance and regional minimum wage, computed by effective date, each result with the legal basis. Built by ALODEV (alodev.vn). Data and test suite: CC BY 4.0.

Luật lương, thuế TNCN, BHXH Việt Nam chạy được theo ngày hiệu lực, kèm văn bản căn cứ, cho phần mềm và AI agent.

Key facts:
- Base URL: https://api.maxmin.vn (JSON in/out). No key needed for the anonymous tier (30 requests/minute, 1,000/day per IP).
- MCP server (Streamable HTTP): https://mcp.maxmin.vn/mcp
- Every calculation takes ngay_ap_dung (YYYY-MM-DD, Vietnam time). Money is whole VND.
- The API accepts numbers only, never names, ID numbers or tax codes.
- 35 legal parameters with effective dates, 54 source documents, 426 public test cases.

## Docs
- [API reference (English)](https://maxmin.vn/en/docs/): every endpoint, fields and curl examples
- [Tài liệu API (tiếng Việt)](https://maxmin.vn/tai-lieu/)
- [OpenAPI 3.1 spec](https://maxmin.vn/openapi.yaml)
- [MCP setup](https://maxmin.vn/en/mcp/): Claude Code, Claude Desktop, Cursor, VS Code

## Data
- [Legal parameters JSON](https://maxmin.vn/du-lieu/tham-so.json): values, effective dates, legal basis
- [Source documents JSON](https://maxmin.vn/du-lieu/van-ban.json)
- [Test cases: luong-thue-bh](https://maxmin.vn/du-lieu/ca-kiem/luong-thue-bh.json)
- [Test cases: lao-dong](https://maxmin.vn/du-lieu/ca-kiem/lao-dong.json)
- [Test cases: tro-cap](https://maxmin.vn/du-lieu/ca-kiem/tro-cap.json)
- [Test cases: bhxh-mot-lan](https://maxmin.vn/du-lieu/ca-kiem/bhxh-mot-lan.json)
- [Test cases: maxmin](https://maxmin.vn/du-lieu/ca-kiem/maxmin.json)
- [Test cases: vung-xa](https://maxmin.vn/du-lieu/ca-kiem/vung-xa.json)
- [Change log](https://maxmin.vn/thay-doi/)

## Optional
- [Parameters table (Vietnamese)](https://maxmin.vn/tham-so/)
- [Get a free key](https://maxmin.vn/en/key/)