Taiwan Payroll

What is Taiwan Payroll?

Taiwan Payroll is an open-source calculation engine for Taiwan’s statutory labor insurance, health insurance, pension, occupational accident, and second-generation NHI supplementary premium. It supports multiple identities, pro‑rated calculations for mid‑month join/leave, generation of NHI supplementary premium filing CSV files, and old‑age pension benefit trials. The engine is available as TypeScript (npm), Python (PyPI), and an MCP server for AI assistants.

How to use Taiwan Payroll?

Install the core library via npm install taiwan-payroll or pip install taiwan-payroll. For AI assistants, use the MCP server remotely at https://taiwan-payroll.simoko.workers.dev/mcp (Streamable HTTP) or locally with npx taiwan-payroll-mcp (stdio). Call functions like createPayrollEngine({ year }) then engine.calculate(...) with salary and identity parameters.

Key features of Taiwan Payroll

• Zero runtime dependencies in core packages.
• Cross‑language consistency between TypeScript and Python.
• Built‑in official parameters for years 2024–2026.
• Generates NHI supplementary premium filing CSV (Big5).
• Calculates old‑age pension benefits (annuity, lump sum, single payment).
• Pro‑rated calculations follow official “end‑of‑month attribution” rule for health insurance.

Use cases of Taiwan Payroll

• Compute employee and employer contributions for a given monthly salary and identity.
• Pro‑rate labor insurance, pension, and health insurance for employees joining or leaving mid‑month.
• Generate NHI supplementary premium filing files for all six categories.
• Trial old‑age pension amounts (annuity, lump sum, single payment) based on official formulas.

FAQ from Taiwan Payroll

What calculations does Taiwan Payroll support?

It calculates labor insurance (including employment insurance), health insurance, pension, occupational accident premium, and second‑generation NHI supplementary premium for both employee and employer sides. It also handles pro‑rated amounts, supplementary premium filing, and old‑age pension benefits.

What are the runtime dependencies?

The core packages have zero runtime dependencies. The MCP server may require a Node.js runtime but no extra frameworks.

Which years are supported?

Taiwan Payroll includes built‑in parameters for the years 2024, 2025, and 2026. You can specify the year with createPayrollEngine({ year }) and list available years via getAvailableYears().

How can I use Taiwan Payroll as an MCP server with an AI assistant?

You can either use the remote Streamable HTTP endpoint (no local installation) or run the server locally with npx taiwan-payroll-mcp (stdio). The server is listed on the official MCP Registry, Smithery, and Glama.

Is the calculation legally guaranteed?

No. The engine is a reference implementation based on official tables and rates. Actual amounts are determined by the Labor Insurance Bureau and National Health Insurance Administration. Taiwan Payroll does not constitute legal or accounting advice.