calculate_prorated · Taiwan Payroll MCP: Risk & Policy

WHAT IT DOES

What calculate_prorated does on Taiwan Payroll

AI agents call calculate_prorated to retrieve information from Taiwan Payroll without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

PARAMETERS

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

Parameters from the server's own tool schema.

WHY IT NEEDS A POLICY

Why calculate_prorated needs a policy

This tool performs a statutory calculation (labor/health insurance proration) and returns a computed result. It reads inputs and produces output with no side effects, no financial transaction, and no data mutation. The disclaimer explicitly states results are for reference only and do not constitute legal or accounting advice.

From the tool's definition 計算月中到職或離職當月的破月保費 — computes prorated premiums for mid-month hire/termination; result is advisory only ('僅供參考'), no data is written or committed

Risk signalsHigh parameter count (11 properties)

Attacks that exploit this kind of access

Questions about calculate_prorated

What does the calculate_prorated tool do? +

計算月中到職或離職當月的破月保費。勞保/職保/勞退按日（30 日基準）；健保採官方「月底歸屬」——到職當月計整月、離職當月不計。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。. It is categorised as a Read tool in the Taiwan Payroll MCP Server, which means it retrieves data without modifying state.

What parameters does calculate_prorated accept? +

calculate_prorated accepts 11 parameters: year, endDate, identity, partTime, rounding, startDate, dependents, monthlySalary, occupationalRate, employmentInsurance, pensionSelfContribution. Required: monthlySalary. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on calculate_prorated? +

Register the Taiwan Payroll MCP server in PolicyLayer and add a rule for calculate_prorated: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Taiwan Payroll. Nothing to install.

What risk level is calculate_prorated? +

calculate_prorated is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit calculate_prorated? +

Yes. Add a rate_limit block to the calculate_prorated rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block calculate_prorated completely? +

Set action: deny in the PolicyLayer policy for calculate_prorated. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides calculate_prorated? +

calculate_prorated is provided by the Taiwan Payroll MCP server (taiwan-payroll-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.