io.github.kishida-devil/jp-payroll-mcp

up checked 2026-11-11T02:37:43.675Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

日本の給与・社会保険・労働法

Publisher-provided description

Japan payroll & social insurance. 日本の給与計算・社会保険。47都道府県の料率、源泉所得税、割増賃金、有給、標準報酬月額の改定、最低賃金。根拠の条文つき。

Summary by lookupd

Calculates Japanese payroll deductions, social insurance rates, overtime pay, bonuses, year-end tax adjustments and minimum wages, citing…

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http jp-payroll https://japan-payroll-api.tsumugi.workers.dev/mcp

Claude Code, npm package (stdio)

claude mcp add jp-payroll -- npx -y jp-payroll-mcp

Codex, remote (streamable-http)

codex mcp add jp-payroll --url https://japan-payroll-api.tsumugi.workers.dev/mcp

Codex, npm package (stdio)

codex mcp add jp-payroll -- npx -y jp-payroll-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "jp-payroll": {
      "url": "https://japan-payroll-api.tsumugi.workers.dev/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (30 tools)

Publisher-provided text

• calculate_payslip Full monthly deduction breakdown for one employee: health insurance, long-term care, pension, child support, employment insurance, withholding income tax and ne
• list_workers_compensation_rates Workers compensation (労災保険) rates by business type, and the employer premium on a given 賃金総額. The whole premium falls on the employer — nothing is deducted fro
• calculate_bonus Premiums and income tax on a 賞与. Both work differently from monthly pay and are routinely got wrong. Premiums are charged on 標準賞与額 (the bonus truncated to the
• calculate_withholding_tax Income tax to withhold from a payment, from the National Tax Agency tables. The taxable amount is pay AFTER social insurance has been deducted, not gross. Pick
• judge_monthly_revision Decides whether a pay change forces the standard remuneration to be revised, and answers SEPARATELY for health insurance and pension — the tables differ, so a c
• decide_regular_remuneration The yearly redetermination of standard remuneration, effective each September through the following August. Months below the payment-basis-day threshold drop O
• judge_leave_end_revision A separate route with a lower bar than 随時改定, and the one people forget. ONE grade of movement is enough, and fixed pay need not have changed at all — which matt
• calculate_payroll_batch Runs calculate_payslip for many employees in one call and returns the run totals: gross, employee deductions, net, and employer cost. Reach for this the moment
• decide_regular_remuneration_batch Runs the annual 定時決定 for a whole payroll in one call, and reports which employees moved grade. 健康保険法第41条 puts every insured employee on the same schedule — the
• judge_annual_average For work whose April-June happens to be its busiest or quietest quarter, where the ordinary calculation would fix a grade that is wrong for eleven months of the
• lookup_standard_remuneration Maps a monthly amount to its health grade (1-50) and pension grade (1-32), with the standard remuneration each resolves to and whether the pension grade was cla
• national_insurance For anyone outside employee cover: the self-employed, freelancers, people between jobs. Use this instead of calculate_payslip when the person is not an employe
• calculate_annual_cost What one employee costs an employer over a year, bonuses included. Reach for this rather than multiplying a payslip by twelve, because the two do not agree onc
• judge_annual_leave Works out how many days of paid leave someone has been granted, and whether the employer still owes the five days it must direct. 労働基準法第39条 grants ten working
• judge_worker_type Decides whether someone is covered by health and pension insurance, and on which payment-basis day count their annual determination runs. Call this before deci
• check_insurance_eligibility The single most expensive month-end mistake in Japanese payroll, and one an assistant will get wrong from memory. Coverage ends the day AFTER the last day work
• check_leave_exemption Maternity and childcare leave look alike and behave differently. Maternity leave has no day-count test and exempts bonus premiums unconditionally; childcare lea
• get_age_milestones Returns the exact date each threshold is crossed and which premium starts or stops: long-term care begins at 40 and ends at 65, pension ends at 70, health insur
• calculate_year_end_adjustment Year-end adjustment (年末調整) for 2026 from the National Tax Agency's 令和8年分 booklet: the printed 給与所得控除後の給与等の金額 table (1,103 rows), the income-adjustment deduction
• estimate_resident_tax Estimate of next fiscal year's resident tax (住民税: 道府県民税 + 市町村民税 + 森林環境税) from the previous year's income and the municipality: employment income from the NTA ta
• get_insurance_rates Health insurance, long-term care, pension and child-support rates for a prefecture, plus the bonus caps and the employer-only child-care contribution. Health ra
• get_minimum_wage Hourly 地域別最低賃金 for a prefecture. Revisions take effect prefecture by prefecture from October, on different days, so a date matters — pass one when checking a pa
• business_days Count business days in a range, shift a date by N business days, or check one date. Covers 1955-2027 including substitute holidays, 国民の休日 (a weekday that is a h
• validate_invoice_numbers_batch Checks the National Tax Agency check digit on many qualified-invoice registration numbers in one call. Be careful how you report the result. A passing check di
• validate_corporate_number Checks the National Tax Agency check digit on a 13-digit 法人番号, or on a qualified invoice registration number (the same 13 digits prefixed with T). This proves
• consumption_tax The consumption tax rate in force on a date, with the national and local parts, and the reduced 8% rate for food and newspapers. Pass amount to have the tax wor
• get_statute_text Returns the full text of a Japanese statutory provision, as published by e-Gov. The judgement tools name the statute or notice their answer rests on, but not i
• calculate_overtime_pay Works out statutory premium pay under 労働基準法第37条 — overtime, night work and work on a statutory holiday. The rates do not simply add up, and getting this wrong
• commuting_allowance_exemption Works out how much of a commuting allowance escapes income tax, and states the amount that still counts as remuneration for social insurance. These are two dif
• check_data_freshness Japanese statutory figures change on fixed dates — insurance rates each March, employment insurance each April, minimum wage each October — and a stale table pr

Details

• Version: 0.4.5
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 794 ms
• First indexed: 2026-11-01T09:37:31.614Z
• Last seen in registry: 2026-11-01T09:37:31.659Z
• Repository: https://github.com/kishida-devil/jp-payroll-mcp

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.kishida-devil/jp-payroll-mcp.svg)](https://lookupd.com/servers/io.github.kishida-devil/jp-payroll-mcp)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp