MCP server

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

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

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

30

Token cost

About 17,347 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.jp-payroll-mcp]
url = "https://japan-payroll-api.tsumugi.workers.dev/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"jp-payroll-mcp":{"type":"http","url":"https://japan-payroll-api.tsumugi.workers.dev/mcp"}}}

Antigravity

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

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"jp-payroll-mcp","server_url":"https://japan-payroll-api.tsumugi.workers.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"jp-payroll-mcp","server_url":"https://japan-payroll-api.tsumugi.workers.dev/mcp"}

Tools

• business_days ~384 tokens
  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 holiday only because it sits between two others) and one-off imperial events, so the awkward years are right and not only the tidy ones. Set
• calculate_annual_cost ~790 tokens
  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 once a bonus is paid. 健康保険法第45条 caps the standard bonus cumulatively across the year — 5,730,000 from 1 April to 31 March — so the same bonus c
• calculate_bonus ~722 tokens
  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 thousand yen) under two caps that behave differently: health, long-term care and child support cap at 5,730,000 yen CUMULATIVELY across the
• calculate_overtime_pay Moves money · ~602 tokens
  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 under-pays wages. A night premium stacks on top: overtime at night is 1.25 + 0.25 = 1.5, holiday work at night is 1.35 + 0.25 = 1.6. But a s
• calculate_payroll_batch ~796 tokens
  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 more than two or three people are in play. A monthly payroll is not a sequence of unrelated questions — the employer share, the totals and
• calculate_payslip ~1380 tokens
  Full monthly deduction breakdown for one employee: health insurance, long-term care, pension, child support, employment insurance, withholding income tax and net pay, with the employer share as well. Use this rather than computing it yourself. Premiums are charged on 標準報酬月額 — a 50-grade step functi
• calculate_withholding_tax ~401 tokens
  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 the table with `period`: "monthly" for 月額表, "daily" for 日額表. The daily table has a third column, 丙, which applies to work engaged by the da
• calculate_year_end_adjustment ~1562 tokens
  Year-end adjustment (年末調整) for 2026 from the National Tax Agency's 令和8年分 booklet: the printed 給与所得控除後の給与等の金額 table (1,103 rows), the income-adjustment deduction, social/life/earthquake insurance deductions, spouse, specified-relative (19-22 with income), dependant, disability, widow/single-parent/st
• check_data_freshness ~167 tokens
  Japanese statutory figures change on fixed dates — insurance rates each March, employment insurance each April, minimum wage each October — and a stale table produces numbers that look plausible and are wrong. This reports what every dataset currently covers and when its next revision is due. Worth
• check_insurance_eligibility ~269 tokens
  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 worked, not on it. So an employee leaving on the LAST day of a month loses coverage on the 1st of the next month, and still owes that month's pr
• check_leave_exemption ~321 tokens
  Maternity and childcare leave look alike and behave differently. Maternity leave has no day-count test and exempts bonus premiums unconditionally; childcare leave gained a 14-day rule in October 2022 and exempts bonus premiums only when the leave exceeds one month. Two results catch people out and
• commuting_allowance_exemption ~570 tokens
  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 different bases, and that asymmetry is the part people get wrong. Social insurance counts a commuting allowance in full — it is 報酬 under 健康保険法第
• consumption_tax ~350 tokens
  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 worked out. Japan changed the rate four times since 1989 (3% → 5% → 8% → 10%), and the reduced rate has existed only since 2019-10-01. A back-
• decide_regular_remuneration ~587 tokens
  The yearly redetermination of standard remuneration, effective each September through the following August. Months below the payment-basis-day threshold drop OUT of the average entirely — they are not counted as zero, which is the usual mistake. If no month qualifies, the previous grade carries ove
• decide_regular_remuneration_batch ~885 tokens
  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 average of April, May and June pay, over the months with at least seventeen payment-basis days, applied from September to the following Aug
• estimate_resident_tax ~1646 tokens
  Estimate of next fiscal year's resident tax (住民税: 道府県民税 + 市町村民税 + 森林環境税) from the previous year's income and the municipality: employment income from the NTA table for that year, resident-tax deductions (basic 430,000, spouse 330,000, dependants 330,000/450,000/380,000, life insurance capped at 70,0
• get_age_milestones ~222 tokens
  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 insurance ends at 75 (transfer to 後期高齢者医療). Compute this here rather than by subtracting years. Under 年齢計算ニ関スル法律 an age is reached the day BEFOR
• get_insurance_rates ~358 tokens
  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 rates differ by prefecture and change each March; pension is national. Add business_type for the employment insurance rates, which change each
• get_minimum_wage ~254 tokens
  Hourly 地域別最低賃金 for a prefecture. Revisions take effect prefecture by prefecture from October, on different days, so a date matters — pass one when checking a past payroll rather than assuming the current rate applied. History runs back to FY2002.
• get_statute_text ~277 tokens
  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 its words. Use this to quote the provision itself — a citation the reader can check beats a citation they have to take on trust, and Japanese
• judge_annual_average ~706 tokens
  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 year. Available for 定時決定 (since April 2011) and 随時改定 (since October 2018). The 随時改定 figure is NOT a plain twelve-month average: it is the
• judge_annual_leave ~680 tokens
  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 days once six months of service are complete and attendance reaches eighty per cent of all working days, then adds one, two, four, six, eigh
• judge_leave_end_revision ~459 tokens
  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 matters because returning to shorter hours usually cuts pay without changing any rate, so 随時改定 would not fire and the employee would keep overpa
• judge_monthly_revision ~690 tokens
  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 change routinely moves one and not the other. Above roughly 665,000 yen the pension table is exhausted, so a large raise for a well-paid empl
• judge_worker_type ~694 tokens
  Decides whether someone is covered by health and pension insurance, and on which payment-basis day count their annual determination runs. Call this before decide_regular_remuneration or judge_monthly_revision whenever the person is anything other than plainly full-time. Those tools take a worker_ty
• list_workers_compensation_rates ~268 tokens
  Workers compensation (労災保険) rates by business type, and the employer premium on a given 賃金総額. The whole premium falls on the employer — nothing is deducted from the employee, unlike every other statutory premium. Rates run from 2.5/1000 to 88/1000 depending on the industry, a 35-fold spread, so thi
• lookup_standard_remuneration ~154 tokens
  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 clamped. Use it to check a grade, not to compute premiums — calculate_payslip does that.
• national_insurance ~529 tokens
  For anyone outside employee cover: the self-employed, freelancers, people between jobs. Use this instead of calculate_payslip when the person is not an employee. Running a freelancer through the payslip returns a figure computed under a different scheme entirely, with nothing in the answer to say s
• validate_corporate_number ~256 tokens
  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 the number is well formed. It does NOT prove the number is registered, and it does not identify the holder: sole proprietors receive invoice
• validate_invoice_numbers_batch ~368 tokens
  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 digit means the shape of the number is right and nothing more. 消費税法第57条の2 provides both for the Commissioner to revoke a registration and for

Browse

• GitHub tools
• Calendars
• Payments
• Invoicing and accounting
• Web analytics

Related MCP servers

• Mart402 Extract
  Web extraction, OCR (Japanese-strong), invoice and company data for AI agents. x402, no API key.
• Swiss Living Index
  Official Swiss data for all 26 cantons and 2,100 communes: tax, rent, health premiums, fuel, jobs.
• XBOSS
  Korean national tax and social insurance filings, invoices and payroll data as MCP tools.
• Mart402 Docs
  Documents and web for AI agents: PDF parse, OCR, web extract, invoice checks. x402, no API key.
• CalcBright Calculators
  160+ calculators: take-home pay for 166 countries, mortgage, loan, VAT, BMI, dates, units, currency.
• UpGrowth: business data for Algeria, Tunisia and Morocco
  Official business data for Algeria, Tunisia and Morocco: activity codes, legal forms, tax, gazettes.
• FreeToolHub
  44 calculators for AI agents: US tax, finance, business + an MCP engineering & security suite.
• SiteCheck Shop & Social
  113 pay-per-call agent tools: e-commerce, product, price and social media data tools. x402

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.kishida-devil/jp-payroll-mcp.svg)](https://aptlynx.net/servers/io.github.kishida-devil/jp-payroll-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents