# 台灣勞健保勞退試算 (npm · taiwan-payroll-mcp)

台灣勞保、健保、勞退、職災與二代健保補充保費試算，含薪資扣繳、破月與勞保老年給付。資料取自主管機關公告，對官方範例逐位元驗證。

- Trust score: 72/100 (medium)
- Change this week: +31
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `taiwan-payroll.simoko.workers.dev`: 66/100, [markdown](https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll.md), [page](https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll)
- npm · `taiwan-payroll-mcp`: 72/100 (this document), [markdown](https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll-mcp.md), [page](https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll-mcp)

## Channel facts

- Registry: `npm`
- Package: `taiwan-payroll-mcp`
- Version: `1.4.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, 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-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to supra126/taiwan-payroll).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 55 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 58/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3030 tokens (~336/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.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add supra126-taiwan-payroll -- npx -y taiwan-payroll-mcp
```

### Codex

```bash
codex mcp add supra126-taiwan-payroll -- npx -y taiwan-payroll-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "supra126-taiwan-payroll": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "taiwan-payroll-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add supra126-taiwan-payroll --command npx --arg -y --arg taiwan-payroll-mcp
```

### Hermes

```yaml
mcp_servers:
  supra126-taiwan-payroll:
    command: "npx"
    args: ["-y", "taiwan-payroll-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "supra126-taiwan-payroll": {
      "command": "npx",
      "args": [
        "-y",
        "taiwan-payroll-mcp"
      ]
    }
  }
}
```

## 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-08-02 (score 72, +55)

- [security improvement] Provenance: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: supra126/taiwan-payroll
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: MIT

### 2026-07-31 (score 17, −24)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 41)

First indexed and scored.

## MCP tools (9)

### `calculate_payroll` (~558 tokens)

計算台灣勞健保勞退

計算台灣某月薪資的勞保（含就保）、健保、勞退、職災各方（員工/雇主/政府）負擔。支援不同身份別、眷屬、自提、部分工時。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `dependents` (integer): 健保眷屬人數（計費上限 3 口），預設 0。
- `employmentInsurance` (boolean): 是否參加就業保險（勞保費率 12.5% 或 11.5%），預設 true。一般移工/家事移工一律視為不參加。
- `identity` (string): 身份別（預設 category1）：category1=本國勞工或外籍配偶；migrantGeneral=一般移工（勞保僅普通事故 11.5%、無就保/勞退）；migrantDomestic=家事移工（僅健保＋職災，職災費率請以 occupationalRate 傳 0.0018）。不適用的險種回傳 0。
- `monthlySalary` (number, required): 月薪資總額（經常性薪資），新臺幣元／月。
- `occupationalRate` (number): 職災行業別費率，小數比例（如 0.0021 表 0.21%；家事移工 0.0018），範圍 [0, 0.02)。省略則用該年度平均費率。
- `partTime` (boolean): 是否為部分工時：true 時未達基本工資者勞保/健保對到官方低級距（職保仍歸第 1 級）。預設 false。
- `pensionSelfContribution` (number): 勞工自願提繳率，小數（0~0.06，如 0.06 表 6%），預設 0。
- `rounding` (string): 進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

### `calculate_supplementary_premium` (~350 tokens)

二代健保補充保費

計算二代健保補充保費（費率 2.11%）。bonus 課徵年度累計超過當月投保額 4 倍部分；其餘五類單次達門檻全額課（單次上限 1,000 萬）。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `amount` (number, required): 單次給付金額，新臺幣元。
- `monthlyInsuredSalary` (number): （僅 bonus 必填）給付當月之投保金額，新臺幣元／月；門檻為其 4 倍。
- `rounding` (string): 進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。
- `type` (string, required): 所得類別：bonus=高額獎金、parttime=兼職薪資、professional=執行業務、dividend=股利、interest=利息、rent=租金。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。
- `ytdBonus` (number): （僅 bonus）本次給付前、同雇主同年度已累計之獎金，預設 0。

### `calculate_employer_supplementary_premium` (~279 tokens)

投保單位（雇主）補充保費

計算雇主端二代健保補充保費（費率 2.11%）：(每月支付薪資總額 − 受僱者當月健保投保金額總額) × 費率，無上限。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `monthlyInsuredTotal` (number, required): 受僱者當月健保投保金額總額 B，新臺幣元（全體受僱者投保金額合計）。
- `monthlyPaidTotal` (number, required): 每月支付薪資所得總額 A，新臺幣元（含薪資、獎金、兼職、車馬費、承攬等）。
- `rounding` (string): 進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

### `calculate_income_tax_withholding` (~275 tokens)

薪資所得扣繳稅額

計算薪資所得扣繳稅額：居住者固定月薪(公式法)、非每月給付獎金(5%，未達起扣標準免扣)、非居住者(18%；月薪≤1.5倍基本工資為6%)。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `amount` (number): 該筆給付金額，新臺幣元（僅 residentBonus）。
- `dependents` (integer): 配偶及受扶養親屬人數（僅 resident），預設 0。
- `monthlySalary` (number): 月薪資，新臺幣元（resident／nonResident 用）。
- `type` (string, required): 扣繳類型：resident=居住者固定月薪(公式法)、residentBonus=居住者非每月給付(獎金)5%、nonResident=非居住者18%/6%。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

### `calculate_old_age_pension` (~264 tokens)

計算勞保老年年金（月領）

依勞保老年年金法定公式（擇優兩式、提前/延後增減給每年 ±4%，上限 ±5 年（±20%））試算月領金額；年資未滿 15 年不符年金請領資格。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `avgInsuredSalary` (number, required): 平均月投保薪資（最高 60 個月平均），新臺幣元。
- `claimOffsetMonths` (integer): 提前(負)/延後(正)請領月數，相對法定請領年齡；每年 ±4%，上限 ±5 年（±20%）。預設 0。
- `months` (integer): 保險年資：月（0–11），預設 0。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。
- `years` (integer, required): 保險年資：年。

### `calculate_old_age_lump_sum` (~270 tokens)

計算勞保老年一次金

依勞保老年一次金法定公式（平均月投保薪資 × 給付月數；年資每滿 1 年給 1 個月、逾 60 歲後之年資最多計入 5 年）試算給付金額。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `avgInsuredSalary` (number, required): 平均月投保薪資（最高 60 個月平均），新臺幣元。
- `months` (integer): 保險年資：月（0–11），預設 0。
- `postSixtyMonths` (integer): 逾 60 歲以後之保險年資（月），最多計入 5 年（60 個月），超過部分不計。不得超過總保險月數。預設 0。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。
- `years` (integer, required): 保險年資：年。

### `calculate_old_age_single_payment` (~376 tokens)

計算勞保一次請領老年給付

依勞保一次請領老年給付法定公式（基數制：前 15 年每年 1 個基數、第 16 年起每年 2 個基數、60 歲前最高 45 個基數、逾 60 歲後年資每年 2 個基數最多計 5 年、合併最高 50 個基數）試算給付金額。適用 98 年前已有保險年資者。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `avgInsuredSalary` (number, required): 平均月投保薪資（採退保前 3 年內最高 36 個月平均），新臺幣元。
- `postSixtyMonths` (integer): 逾 60 歲以後之保險年資：月（0–11），預設 0。
- `postSixtyYears` (integer): 逾 60 歲以後之保險年資：年。逾 60 歲後最多計入 5 年，超過部分不計。預設 0。
- `preSixtyMonths` (integer): 60 歲（含）以前之保險年資：月（0–11），預設 0。
- `preSixtyYears` (integer, required): 60 歲（含）以前之保險年資：年。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

### `calculate_prorated` (~613 tokens)

月中到職／離職破月計算

計算月中到職或離職當月的破月保費。勞保/職保/勞退按日（30 日基準）；健保採官方「月底歸屬」——到職當月計整月、離職當月不計。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Input parameters:

- `dependents` (integer): 健保眷屬人數（計費上限 3 口），預設 0。
- `employmentInsurance` (boolean): 是否參加就業保險（勞保費率 12.5% 或 11.5%），預設 true。一般移工/家事移工一律視為不參加。
- `endDate` (string): 離職日（YYYY-MM-DD）。
- `identity` (string): 身份別（預設 category1）：category1=本國勞工或外籍配偶；migrantGeneral=一般移工（勞保僅普通事故 11.5%、無就保/勞退）；migrantDomestic=家事移工（僅健保＋職災，職災費率請以 occupationalRate 傳 0.0018）。不適用的險種回傳 0。
- `monthlySalary` (number, required): 月薪資總額（經常性薪資），新臺幣元／月。
- `occupationalRate` (number): 職災行業別費率，小數比例（如 0.0021 表 0.21%；家事移工 0.0018），範圍 [0, 0.02)。省略則用該年度平均費率。
- `partTime` (boolean): 是否為部分工時：true 時未達基本工資者勞保/健保對到官方低級距（職保仍歸第 1 級）。預設 false。
- `pensionSelfContribution` (number): 勞工自願提繳率，小數（0~0.06，如 0.06 表 6%），預設 0。
- `rounding` (string): 進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。
- `startDate` (string): 到職日（YYYY-MM-DD）。startDate 與 endDate 至少擇一，且兩者須為同一月份。
- `year` (integer): 年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

### `list_years` (~45 tokens)

列出可用年度

列出目前支援的年度、資料版本與基本工資（月薪/時薪）。計算前可先用本工具確認有效的 year 值。

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll-mcp#diagnostics

## Score history

- 2026-08-03: 72
- 2026-08-02: 72
- 2026-08-01: 17
- 2026-07-31: 17
- 2026-07-30: 41
- 2026-07-28: 41
- 2026-07-27: 41

## Links

- npm package: https://www.npmjs.com/package/taiwan-payroll-mcp
- Socket report: https://socket.dev/npm/package/taiwan-payroll-mcp
- Repository: https://github.com/supra126/taiwan-payroll
- Changelog RSS feed: https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/supra126-taiwan-payroll/taiwan-payroll-mcp