台灣勞健保勞退試算

NPM · TAIWAN-PAYROLL-MCP · 2 COMPONENTS · SCANNED AUG 3

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

Available components

remote · taiwan-payroll.simoko.workers.dev 66 npm · taiwan-payroll-mcp 72

+31 this week 72 72 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to supra126/taiwan-payroll). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 55 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability58

AI-judged instruction clarity (excellent).Pass
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. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

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

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · taiwan-payroll-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +55
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- 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 security
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 41

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: supra126/taiwan-payroll
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/supra126/taiwan-payroll/.github/workflows/publish.yml@refs/tags/v1.4.0
Rekor log index:: 1754668195
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:da83bf8899e35be1b9dab1c2e38ada8ba402ebdb3a3df996e8002655f3a537b46fc92cfe339e7690b9c24990fd91c430b59045bf1f713891e274a2542
Discovery method:: attestation_endpoint

Dependencies 95 packages

95 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 9 exposed · ~3,030 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

calculate_employer_supplementary_premium 投保單位（雇主）補充保費 ~279

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

Input Output Examples

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

No output schema declared.

No examples provided.

calculate_income_tax_withholding 薪資所得扣繳稅額 ~275

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

Input Output Examples

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

No output schema declared.

No examples provided.

calculate_old_age_lump_sum 計算勞保老年一次金 ~270

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

Input Output Examples

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

No output schema declared.

No examples provided.

calculate_old_age_pension 計算勞保老年年金（月領） ~264

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

Input Output Examples

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

No output schema declared.

No examples provided.

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

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

Input Output Examples

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

No output schema declared.

No examples provided.

calculate_payroll 計算台灣勞健保勞退 ~558

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

Input Output Examples

Name	Type	Req	Description
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	yes	月薪資總額（經常性薪資），新臺幣元／月。
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 查可用年度。

No output schema declared.

No examples provided.

calculate_prorated 月中到職／離職破月計算 ~613

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

Input Output Examples

Name	Type	Req	Description
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	yes	月薪資總額（經常性薪資），新臺幣元／月。
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 查可用年度。

No output schema declared.

No examples provided.

calculate_supplementary_premium 二代健保補充保費 ~350

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

Input Output Examples

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

No output schema declared.

No examples provided.

list_years 列出可用年度 ~45

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug