# taiwan-payroll

Calculate Taiwan payroll deductions, insurance contributions, and old-age benefits. Useful for checking a pay estimate or comparing pension options.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1803 installs
- Author: supra126
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/supra126/taiwan-payroll
- Updated: 2026-06-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/taiwan-payroll

## What it does

This MCP server calculates labor and health insurance, pension contributions, and occupational accident insurance for Taiwan payroll. It also handles supplementary health premiums and income tax withholding. Payroll calculations account for worker categories, dependents, and voluntary contributions.

Separate tools estimate old-age pension benefits and contributions for a partial month when someone starts or leaves mid-month. Health insurance follows a month-end attribution rule: the start month counts in full, while the departure month does not. The supported years are 2024–2026. Treat the figures as estimates; official payment notices determine what is due, and the calculations are not legal or accounting advice.

## Requirements
- Remote server: `https://taiwan-payroll--supra126.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http taiwan-payroll https://taiwan-payroll--supra126.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add taiwan-payroll --url https://taiwan-payroll--supra126.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "taiwan-payroll": {
            "url": "https://taiwan-payroll--supra126.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "taiwan-payroll": {
            "type": "http",
            "url": "https://taiwan-payroll--supra126.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http taiwan-payroll https://taiwan-payroll--supra126.run.tools
```

## When to use it
- estimate Taiwan payroll deductions and contributions
- calculate a supplementary health insurance premium
- work out contributions for a partial employment month
- estimate a monthly old-age pension
- calculate salary income tax withholding

## Example prompts
- Calculate Taiwan payroll contributions and deductions for this monthly salary and year.
- Work out the contributions for an employee who leaves halfway through the month.
- Estimate the monthly old-age pension from this insurance history and insured salary.

## Similar
- [Fiskalizimi — Albanian tax & payroll](https://affpapa.org/en/nevibecode/mcp/fiskalizimi-albanian-tax-payroll.md) — MCP server
- [taiwan-equity-research-coverage](https://affpapa.org/en/nevibecode/skills/taiwan-equity-research-coverage.md) — skill · 809 installs
- [plan-payroll](https://affpapa.org/en/nevibecode/skills/plan-payroll.md) — skill · 1900 installs
- [payroll-prep](https://affpapa.org/en/nevibecode/skills/payroll-prep.md) — skill · 386 installs
- [NannyKeeper Household Payroll & Taxes](https://affpapa.org/en/nevibecode/mcp/nannykeeper-household-payroll-taxes.md) — MCP server
- [hr-payroll-wasp-drone](https://affpapa.org/en/nevibecode/agents/hr-payroll-wasp-drone.md) — subagent · ★ 96 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
