프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

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

제작자: kishida-devil버전 0.4.5i★ 3i컴퓨터 또는 클라우드
레지스트리 이름io.github.kishida-devil/jp-payroll-mcp

설치 방법

개요

제작자가 쓴 설명(영어 원문)

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

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 컴퓨터 또는 클라우드
  • 전송 방식: stdio, Streamable HTTP
  • 카테고리: 회계, 재무 및 세금

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 4/4 통과 · 내가 묻는 내용은 제작자 서버(japan-payroll-api.tsumugi.workers.dev)를 거쳐요

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음 · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지

  1. Claude의 Connectors 페이지 열기

    CustomizeConnectors

    CustomizeConnectors1+ Add2https://…3Add4
  2. “+ Add” → “Add custom connector”를 누르고 이 2칸 채우기

    여기서 복사해 Claude의 같은 이름 칸에 붙여 넣고 Continue를 누르세요

    Name · 이름日本の給与・社会保険・労働法
    Remote MCP server URL · 주소https://japan-payroll-api.tsumugi.workers.dev/mcp

    Authentication은 Claude가 찾은 그대로 두고 Add를 누르세요

  3. 채팅에서 켜기

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

  4. 해 보기

    日本の給与・社会保険・労働法을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 日本の給与・社会保険・労働法을 쓰고 있다고 하거나 답에 日本の給与・社会保険・労働法 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT는 기업용 요금제에서만 연결돼요

웹의 ChatGPT Business, Enterprise, Edu에서 워크스페이스 관리자나 소유자가 추가해요 · Free, Plus, Pro를 쓰면: 내 ChatGPT 요금제로는 아직 MCP를 직접 연결할 수 없어요

  1. 웹 ChatGPT에서 MCP 추가 페이지 열기

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 이름과 주소 입력

    이름을 넣고 Connection에 주소를 붙여 넣은 뒤 경고에 체크하고 Create as a plugin을 누르세요

    Name · 이름日本の給与・社会保険・労働法
    Connection · 주소https://japan-payroll-api.tsumugi.workers.dev/mcp
  3. 채팅에서 日本の給与・社会保険・労働法 고르기

    새 채팅을 열고 입력 전에 플러그인 목록에서 日本の給与・社会保険・労働法을 고르세요

  4. 해 보기

    日本の給与・社会保険・労働法을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ ChatGPT가 日本の給与・社会保険・労働法을 쓰고 있다고 하거나 답에 日本の給与・社会保険・労働法 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 OpenAI 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Claude Code에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 터미널 열기

    Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기

  2. 이 명령을 붙여 넣고 Enter

    claude mcp add --transport http jp-payroll https://japan-payroll-api.tsumugi.workers.dev/mcp
  3. Claude Code에서 /mcp 입력

    日本の給与・社会保険・労働法이 목록에 있고 연결됨으로 보이면 돼요

  4. 해 보기

    日本の給与・社会保険・労働法을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude Code가 日本の給与・社会保険・労働法을 쓰고 있다고 하거나 답에 日本の給与・社会保険・労働法 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Cursor에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 이 버튼으로 Cursor 열기

    Cursor에서 열기

    Cursor가 설치를 확인하면 Install을 누르세요

  2. Cursor에서 AI 채팅을 Agent 모드로 열기

  3. 해 보기

    日本の給与・社会保険・労働法을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Cursor가 日本の給与・社会保険・労働法을 쓰고 있다고 하거나 답에 日本の給与・社会保険・労働法 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

VS Code에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 이 버튼으로 VS Code 열기

    VS Code에서 열기

    VS Code가 설치를 확인하면 Install을 누르세요

  2. VS Code에서 AI 채팅을 Agent 모드로 열기

  3. 해 보기

    日本の給与・社会保険・労働法을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 日本の給与・社会保険・労働法을 쓰고 있다고 하거나 답에 日本の給与・社会保険・労働法 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://japan-payroll-api.tsumugi.workers.dev/mcp

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? 日本の給与・社会保険・労働法을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

컴퓨터에 설치

Claude Code

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

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "jp-payroll": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "jp-payroll-mcp"
      ]
    }
  }
}

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

한눈에 보기

주간 다운로드i
81/주
라이선스i
라이선스 표시 없음
연결 방식
컴퓨터 또는 클라우드
전송 방식
stdio, streamable-http
최신 버전i
0.4.5
레지스트리 공개i
2026년 9월 3일
코드 마지막 변경i
2026년 9월 4일
제작자
kishida-devil
패키지
npm: jp-payroll-mcp
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

인터넷으로 연결하는 앱

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

내 컴퓨터에서 실행하는 앱

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

모든 앱과 장단점 →

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 10일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • calculate_payslip

    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 5

  • 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 from the employee, unlike every other statutory premium. Rates run from 2.5/1000 to 88/1000 depending on the industry, a 35-

  • 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 thousand yen) under two caps that behave differently: health, long-term care and child support cap at 5,730,000 yen CUMUL

  • 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 the table with `period`: "monthly" for 月額表, "daily" for 日額表. The daily table has a third column, 丙, which applies to wor

  • 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 change routinely moves one and not the other. Above roughly 665,000 yen the pension table is exhausted, so a large raise

  • decide_regular_remuneration

    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 previou

  • 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 matters because returning to shorter hours usually cuts pay without changing any rate, so 随時改定 would not fire and the employ

  • 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 more than two or three people are in play. A monthly payroll is not a sequence of unrelated questions — the employer sha

  • 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 average of April, May and June pay, over the months with at least seventeen payment-basis days, applied from September t

  • 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 year. Available for 定時決定 (since April 2011) and 随時改定 (since October 2018). The 随時改定 figure is NOT a plain twelve-month

  • 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 clamped. Use it to check a grade, not to compute premiums — calculate_payslip does that.

  • 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 employee. Running a freelancer through the payslip returns a figure computed under a different scheme entirely, with nothing in

  • 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 once a bonus is paid. 健康保険法第45条 caps the standard bonus cumulatively across the year — 5,730,000 from 1 April to 31 March —

  • 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 days once six months of service are complete and attendance reaches eighty per cent of all working days, then adds one, t

  • 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 decide_regular_remuneration or judge_monthly_revision whenever the person is anything other than plainly full-time. Those too

  • 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 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 o

  • 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 leave gained a 14-day rule in October 2022 and exempts bonus premiums only when the leave exceeds one month. Two results ca

  • 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 insurance ends at 75 (transfer to 後期高齢者医療). Compute this here rather than by subtracting years. Under 年齢計算ニ関スル法律 an age is re

  • 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, social/life/earthquake insurance deductions, spouse, specified-relative (19-22 with income), dependant, disability, wi

  • 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 table for that year, resident-tax deductions (basic 430,000, spouse 330,000, dependants 330,000/450,000/380,000, life insu

  • 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 rates differ by prefecture and change each March; pension is national. Add business_type for the employment insurance rate

  • 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 past payroll rather than assuming the current rate applied. History runs back to FY2002.

  • 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 holiday only because it sits between two others) and one-off imperial events, so the awkward years are right and not only

  • 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 digit means the shape of the number is right and nothing more. 消費税法第57条の2 provides both for the Commissioner to revoke a re

  • 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 the number is well formed. It does NOT prove the number is registered, and it does not identify the holder: sole propriet

  • 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 worked out. Japan changed the rate four times since 1989 (3% → 5% → 8% → 10%), and the reduced rate has existed only since

  • 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 its words. Use this to quote the provision itself — a citation the reader can check beats a citation they have to take on

  • 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 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 +

  • 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 different bases, and that asymmetry is the part people get wrong. Social insurance counts a commuting allowance in full — it

  • 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 produces numbers that look plausible and are wrong. This reports what every dataset currently covers and when its next rev

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 11일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 kishida-devil 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 2개월 전

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • ✓ 통과

    엔드포인트 응답

    525ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 30개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

Google로 로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

Google로 로그인하고 리뷰 쓰기

회계, 재무 및 세금 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 3121개 중 94%보다 스타가 많아요
  • 이 카테고리의 다른 서버 3121개 중 31%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 3121개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

日本の給与・社会保険・労働法, 안전한가요?

해당하는 기본 점검 4개 중 4개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 2개월 전 변경됐고, 최신 버전(0.4.5)은 2개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 지원하는 앱에서도 쓸 수 있어요. 예: ChatGPT Business 이상.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: CCXT, Finance Toolkit, AKQuant

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

CCXT

Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets

제작자: ccxt널리 사용됨↓ 667/주★ 4.5만2개월 전 업데이트

내 컴퓨터에서 실행

Finance Toolkit

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

제작자: JerBouma널리 사용됨↓ 1.6만/주★ 5.5천그저께 업데이트

컴퓨터 또는 클라우드

AKQuant

Write and backtest trading strategies with AKQuant: API lookup, strategy checks, backtest runs

제작자: akfamily널리 사용됨↓ 3.3천/주★ 2.6천그저께 업데이트

내 컴퓨터에서 실행

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

jp-payroll-mcp

日本の給与計算・社会保険・労務を、表を引くのではなく計算して返すAPIとMCPサーバーです。 47都道府県の保険料率、源泉所得税、標準報酬月額の決定と改定、休業中の保険料免除、 割増賃金、年次有給休暇、最低賃金、営業日計算、令和8年分の年末調整、住民税の見込み額まで。答えには根拠の条文または通知が付きます。

公表されている料額表・税額表と1セルずつ突き合わせ、変更のたびに 4,689件 の検証を実行します。

使いかたは2通り

MCPサーバー — AIアシスタントに日本語で聞く。30ツール、無料、APIキー不要。 URL を貼るだけ(remote MCP)か、npx で入れるか:

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

Claude.ai のカスタムコネクタ、ChatGPT、Cursor には https://japan-payroll-api.tsumugi.workers.dev/mcp を貼ります。

HTTP API — ソフトウェアに組み込む。45エンドポイント、OpenAPI 3.0、一括処理:

curl "https://japan-payroll-api.tsumugi.workers.dev/v1/payroll?prefecture=Tokyo&monthly_salary=350000&birth_date=1986-04-01"

MCPサーバーはAPIの薄い層なので、どちらも同じ答えを返します。 人が聞くのか、プログラムが聞くのかの違いです。

なぜ要るのか

自前で書くと、もっともらしく見えて間違っている数字が出ます。3月31日退職と3月30日退職では 1か月分の社会保険料が動きます(東京・40歳・月給30万円で労使合計95,130円)。4月1日生まれの人は 3月31日に40歳になるので介護保険料が1か月早く始まります。随時改定の「2等級以上」は健康保険法に 書いておらず、昭和36年保発第4号にあります。

  • 解説記事: [日本の給与計算・社会保険をAPIとMCPにしました](https://zenn.dev/kishida_devil/articles/9d5a645a105c0b)
  • MCPサーバーの詳細: [mcp/README.md](mcp/README.md)
  • 大量処理の有料プラン: RapidAPI

以下は英語の詳細仕様です。


Japanese payroll, social insurance and labour law, computed rather than looked up — premiums for all 47 prefectures, withholding tax, standard remuneration decisions and revisions, leave exemptions, minimum wage — with the statute or ministerial notice each answer rests on.

Verified against the published tables cell by cell: 4,689 assertions on every change.

Two ways in

As an MCP server, for asking questions through an AI assistant. 30 tools, free, no key. Remote (paste a URL) or local (npx):

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

For Claude.ai custom connectors, ChatGPT and Cursor, the URL is https://japan-payroll-api.tsumugi.workers.dev/mcp.

As an HTTP API, for building it into software. 45 endpoints, OpenAPI 3.0, batch:

curl "https://japan-payroll-api.tsumugi.workers.dev/v1/payroll?prefecture=Tokyo&monthly_salary=350000&birth_date=1986-04-01"

The MCP server is a thin layer over the API, so both give the same answers. Which you want depends on whether a person or a program is asking.

  • MCP server source and its own README: mcp/ · English
  • Live API: https://japan-payroll-api.tsumugi.workers.dev
  • OpenAPI spec: /openapi.json

Related tools

Japanese statutory MCP servers mostly *retrieve* — they hand you the text of a law and leave the reasoning to you. This one *computes*, and returns the provision it relied on. They fit together rather than compete:

"What does the law say?""So what do I pay?"
labor-law-mcp45 labour and social insurance laws, MHLW and JAISH notices—
tax-law-mcp24 tax laws, 17 NTA circulars, tribunal decisions—
hourei-mcp-serverAny Japanese law, via e-Gov—
jp-payroll-mcpThe 28 provisions it cites, in fullPremiums, withholding tax, grade revisions, exemptions

If you already run one of those, add this alongside it. An assistant with both picks the right one per question.

Why this exists

  • No consolidated API exists. Developers assemble this from 協会けんぽ, 厚生労働省 and each prefectural labour bureau separately.
  • The rules are fiddly. Premiums are computed on the *standard monthly remuneration* (a 50-grade step function), not on actual salary — except employment insurance, which uses actual salary. Pension caps at grade 32. Long-term care applies only to ages 40–64. The employee share rounds *half down* (≤ 0.50 yen truncates). Getting one of these wrong produces numbers that look plausible and are wrong.

MCP server

Source in mcp/, with its own README (日本語) · English. Test it with npm run mcp:test — it drives a real stdio transport with the real MCP client, because a tool with a broken handler still lists perfectly and only fails when something calls it.

The MCP server is free and always will be. It is a distribution channel rather than a revenue one: npm pays nothing and MCP has no billing of its own. That is deliberate — the problem was never billing, which RapidAPI already handles, but discovery, and MCP is where the traffic for Japanese statutory data measurably is.

Endpoints

EndpointDescription
GET /API info and endpoint list
Payroll and insurance
GET /v1/prefecturesAll 47 prefectures with JIS codes
GET /v1/insurance-rates?prefecture=TokyoHealth, long-term care, pension, child-support rates
GET /v1/standard-remuneration?remuneration=350000Grade lookup for a monthly amount
GET /v1/standard-remuneration/tableFull 50-grade table
GET /v1/employment-insurance?business_type=generalEmployment insurance rates
GET /v1/payroll?prefecture=Tokyo&monthly_salary=350000&age=40Full deduction breakdown
Minimum wage
GET /v1/minimum-wage?prefecture=Tokyo&date=2020-01-01Rate in effect on a date
GET /v1/minimum-wage/history?prefecture=TokyoFull history since FY2002
Calendar
GET /v1/holidays?year=2026Public holidays (or from=/to= for a range)
GET /v1/holidays/check?date=2026-01-01Holiday / weekend / business-day flags
GET /v1/business-days?from=&to=Count business days in a range
GET /v1/business-days/shift?date=&days=1Move N business days forward or back
Tax
GET /v1/consumption-tax?date=&amount=&reduced=Rate in force, optionally applied to an amount
GET /v1/consumption-tax/historyEvery rate change since 1989
Identifiers
GET /v1/corporate-number/validate?number=8700110005901法人番号 check digit (Peppol ICD 0188)
GET /v1/corporate-number/check-digit?base=700110005901Check digit for a 12-digit base number
GET /v1/invoice-number/validate?number=T8700110005901Qualified invoice registration number
Withholding tax
GET /v1/withholding-tax?taxable_amount=300000&dependants=2Monthly withholding income tax (月額表)
GET /v1/withholding-tax/daily?taxable_amount=12000&column=heiDaily table (日額表), including the 丙 column
GET /v1/withholding-tax/computer?taxable_amount=400000Same, by the formula method (電算機計算の特例)
Bonuses
GET /v1/bonus-tax?bonus=500000&previous_month_pay=350000Withholding on a bonus (賞与の算出率表)
GET /v1/bonus-insurance?prefecture=Tokyo&bonus=800000&age=40Social insurance on a bonus, with both caps
Standard remuneration decisions
GET /v1/standard-remuneration/regular?months=350000:30,352000:31,349000:30定時決定 (算定基礎) from April–June
GET /v1/standard-remuneration/revision?current_remuneration=&months=&fixed_pay_change=Is a 随時改定 (月額変更) due?
GET /v1/standard-remuneration/leave-end?kind=childcare&current_remuneration=&months=Revision on returning from leave
POST /v1/standard-remuneration/annual-average年間平均による保険者算定, for seasonal work
Year-end adjustment
POST /v1/year-end-adjustment年末調整 (令和8年分): every box of the 源泉徴収簿 from ⑦ to ㉗, plus an "if filed" estimate for medical/donation/casualty deductions
Resident tax
POST /v1/resident-tax住民税の見込み額 from last year's income and the municipality: income and per-capita levies, adjustment credit, ふるさと納税, exemptions, every prefecture's surtax
Eligibility and leave
GET /v1/eligibility?month=2026-03&left_on=2026-03-30Is a premium due in a joining or leaving month?
GET /v1/leave-exemption?kind=childcare&start=&end=Which months a maternity or childcare leave exempts
GET /v1/age-milestones?birth_date=1986-04-01When 40, 65, 70 and 75 are reached, and what changes
Batch
POST /v1/payroll/batchUp to 500 payslips in one call, with run totals
Statutes
GET /v1/statute?ref=健康保険法第43条Full text of a provision this API cites
GET /v1/statute/indexEvery provision available, with its law
include=statute_textAdd to any endpoint to attach the text of whatever it cited
Meta
GET /v1/enumsEvery accepted enum value and error code
GET /v1/data-freshnessWhat each dataset covers and when it changes next

prefecture accepts an English name (Tokyo, case-insensitive), Japanese (東京 or 東京都), or a JIS code (13).

The one call that matters

Running payroll for one employee is a single request:

curl "https://japan-payroll-api.tsumugi.workers.dev/v1/payroll?prefecture=Tokyo&monthly_salary=350000&age=40&dependants=2"
gross                    350,000

social insurance -55,750


after social insurance 294,250 <- the base withholding tax is charged on withholding income tax -4,480


net pay 289,770

That middle line is the point. Income tax is charged on pay after social insurance, not on gross pay, and deriving it by hand is the mistake this endpoint exists to stop. The response also carries the grade that was resolved, every premium split into employee and employer shares, and which bracket produced the tax — so the arithmetic can be audited rather than trusted.

Resident tax (住民税) is assessed by the municipality and notified to the employer; no API can compute it. Pass resident_tax= and it will be subtracted from net pay.

Pass income_tax=false to get social insurance only.

Before you integrate
  • GET /v1/enums lists every accepted value — business_type, column, calendar — and every error code, so they can be read at build time instead of discovered from a 400.
  • Errors carry a stable code. invalid_request and missing_parameter mean fix the call; out_of_coverage means the input was valid but falls outside what is published, which needs a different branch. Do not match on the English prose — it will change.
  • GET /v1/data-freshness tells you how current each dataset is.

Data

DatasetCoverageSource
Social insurance rates47 prefectures, FY2026 (令和8年度), effective 2026-03協会けんぽ 保険料額表
Standard remuneration table50 health grades / 32 pension gradessame
Employment insurance3 business types, FY2026, effective 2026-04-01厚生労働省
Minimum wage47 prefectures × 24 years (FY2002–FY2025)厚生労働省 地域別最低賃金
Public holidays1,067 days, 1955–2027内閣府 国民の祝日について
Consumption tax4 rate periods since 1989, with reduced rate国税庁 No.6303
Corporate number check digitalgorithm, no dataset国税庁 チェックデジットの計算
Withholding tax (monthly)231 brackets + 9 high-income anchors, 令和8年分国税庁 源泉徴収税額表
Withholding tax (formula)4 statutory tables, 令和8年分以降電算機計算の特例

All figures are extracted programmatically from the official spreadsheets — not transcribed by hand. See `scrip

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요