com.mart402/jp-statutory

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Japan statutory calculations: net pay, social insurance, tax walls, holidays. Cited sources, x402.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "jp-statutory": {
      "url": "https://mart402.com/mcp/jp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• get_catalog read-only

  Mart402 product catalog: all products, prices, payment config, error codes, rate limits. Free.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_receipt read-only

  Re-fetch a previously paid result for free by receipt id (every paid response carries receipt_id).

  Parameters:

  • receipt_id (required) — string — receipt_id from a paid response (rcpt_...)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_sample read-only

  Free recorded sample response for a paid product (from real production runs, marked sample:true) - see the exact response shape before paying anything. Available: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify.

  Parameters:

  • product (required) — string — One of: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify. Product id (see the enum)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• jp_company_profile

  Japanese company site to a standard profile JSON (name, address, representative, capital, contact). $0.03/site. Choose this when you have the URL of a Japanese company's OWN site and want its standard profile fields read from the page; for name/domain lookups use enrich_company (country_hint: jp).

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_payroll_net

  Annual gross salary to net take-home (social insurance + income tax + resident tax). Exact NTA Beppyo-5 table. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for a whole YEAR: annual gross salary to annual take-home after social insurance, income tax and resident tax. For one bonus use jp_bonus_net; for one month's premiums only use jp_social_insurance; to check an actual payslip use jp_payslip_audit.

  Parameters:

  • annual_gross_yen (required) — integer — Annual gross salary in yen
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • year — integer — Calendar year
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • dependents — object — Dependents object (see /catalog input spec)
  • annual_bonus_yen — integer — Annual bonus total in yen

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_bonus_net

  Bonus net pay: social insurance and withholding tax (official rate table, based on previous month salary). $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for ONE bonus payment: its social insurance and withholding tax (the tax rate depends on the previous month's salary after social insurance). For annual totals use jp_payroll_net.

  Parameters:

  • bonus_yen (required) — integer — Bonus amount in yen
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • dependents — integer — Dependents object (see /catalog input spec)
  • ytd_bonus_yen — integer — Bonus paid so far in the fiscal year (health-insurance annual cap check)
  • previous_month_after_si_yen — integer — Previous month's pay after social insurance (withholding table lookup)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_social_insurance

  Monthly social insurance premiums from the official Kyokai-Kenpo grade table (FY2026). $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this when you only need the monthly social insurance premiums for a given monthly remuneration (official grade table); no tax is computed - for take-home pay use jp_payroll_net.

  Parameters:

  • monthly_remuneration_yen (required) — integer — Monthly remuneration in yen (grade table lookup)
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_dependent_threshold

  Income-wall analysis: tax, social insurance (1.06M/1.30M), spousal and student-dependent walls. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for 'how much can be earned before ...' questions: it locates the income walls (tax, social insurance, spousal, student dependent) for an annual income. It does not compute take-home pay (use jp_payroll_net).

  Parameters:

  • annual_income_yen (required) — integer — Expected annual income in yen
  • year — integer — Calendar year
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_consumption_tax

  Consumption tax: per-rate invoice rounding, qualified-invoice validation, simplified taxation, 20% special. $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end.

  Parameters:

  • mode — string — Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end.
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • lines — array — Invoice lines [{amount_yen, qty, rate_key: standard|reduced}]
  • category — string — Simplified-taxation business class 1-6
  • document — object — Qualified-invoice fields to validate (registration_number etc.)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • taxable_period_end — string — Taxable period last day YYYY-MM-DD (two_percent)
  • taxable_period_start — string — Taxable period first day YYYY-MM-DD (two_percent)
  • taxable_sales_excl_yen — integer — Taxable sales excluding tax, in yen

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_business_days

  Japanese holidays, business-day arithmetic, statutory filing deadlines with holiday shift, wareki conversion. $0.003/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date.

  Parameters:

  • to — string — End date YYYY-MM-DD
  • date — string — Date YYYY-MM-DD
  • days — integer — Number of business days to add
  • from — string — Start date YYYY-MM-DD
  • kind — string — One of: withholding_tax_monthly, social_insurance_monthly, corporate_tax, consumption_tax_corporate, income_tax_final, consumption_tax_individual, depreciable_assets, legal_records. Statutory deadline kind (see enum)
  • mode — string — Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date.
  • year — integer — Calendar year
  • base_date — string — Base date YYYY-MM-DD for deadline calculation
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • saturday_off — boolean — Treat Saturdays as non-business days (default true)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_overtime_wage

  Overtime premium pay (Labor Standards Act Art.37, official rounding notice) and Article-36 limit check. $0.015/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours.

  Parameters:

  • mode — string — Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours.
  • hours — object — Hours worked
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • monthly_salary_yen — integer — Monthly base salary in yen
  • monthly_overtime_hours — array — List of monthly overtime hours (36-agreement check)
  • monthly_scheduled_hours — number — Scheduled working hours per month

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_retirement_tax

  Retirement income tax: deduction by years of service, half-taxation rules, exact withholding rounding. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed.

  Parameters:

  • payout_yen (required) — integer — Retirement allowance paid, in yen
  • years_of_service (required) — integer — Years of service (retirement income deduction)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • disability — boolean — True if retirement is due to disability (extra deduction)
  • is_officer — boolean — True for an officer/executive (short-service officer rules)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_mortgage

  Mortgage schedules (level payment/principal), total interest, prepayment effect. $0.005/call. Deterministic, cites primary sources; errors and unverified rules are never billed.

  Parameters:

  • principal_yen (required) — integer — Loan principal in yen
  • annual_rate (required) — number — Annual interest rate as a decimal, e.g. 0.01
  • months (required) — integer — Loan term in months
  • method — string — One of: level_payment, level_principal. Cost method: total_average or moving_average
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • prepayment — object — Optional prepayment {at_month, amount_yen, mode: reduce_term|reduce_payment}

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_payslip_audit

  Audit a Japanese payslip: recompute statutory premiums and withholding tax from official tables and diff against the actual amounts, with per-item verdicts (match/explainable/mismatch). $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this when you HAVE an actual payslip and want each deduction checked against the official tables (match/explainable/mismatch); to compute expected amounts from a salary alone use jp_payroll_net or jp_social_insurance.

  Parameters:

  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • payslip (required) — object — Payslip fields to audit - see /catalog input spec
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • standard_monthly_yen — integer — Standard monthly remuneration if known (else estimated from salary)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_crypto_tax

  Japan crypto-asset tax: realized income under the NTA total-average or moving-average method (sell/spend/exchange as disposals, fees deductible), verified against the official NTA FAQ examples. $0.05/call. Deterministic, cites primary sources; errors and unverified rules are never billed.

  Parameters:

  • transactions (required) — array — Crypto transactions list (max 300) - see /catalog input spec
  • year — integer — Calendar year
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • method — string — One of: total_average, moving_average. Cost method: total_average or moving_average
  • opening — array — Carried-over holdings [{asset, qty, cost_jpy}]
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • other_taxable_income_yen — integer — Other taxable income in yen (returns incremental income tax as reference)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_payroll_suite

  Japan payroll suite: net salary + social insurance + income walls (+bonus) in one call. Flat $0.05. Choose this when you want take-home pay, social insurance and the income walls (and the bonus, if given) together from one annual figure in one call; if you only need the take-home amount, jp_payroll_net is cheaper.

  Parameters:

  • annual_gross_yen (required) — integer — Annual gross salary in yen
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • dependents — object — Dependents object (see /catalog input spec)
  • annual_bonus_yen — integer — Annual bonus total in yen
  • previous_month_after_si_yen — integer — Previous month's pay after social insurance (withholding table lookup)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.