Tax Compass — Japan tax rules by date
Server Details
Japan tax rules by date: invoice tax, tax rates, withholding, stamp duty, deadlines, rule changes
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 16 tools
Most tools target clearly distinct resources: business-day math (add vs. between), era conversion, holiday listing, rate lookup, and separate rule calculators (transitional credit, small-business special, withholding, stamp duty) are easy to tell apart. The main soft spots are the invoice cluster — jp_invoice_amount is a composite that wraps jp_invoice_consumption_tax and jp_withholding_tax_fees, so an agent must decide between the aggregate and the primitives — and jp_tax_consumption_rate vs. jp_invoice_consumption_tax, which descriptions do disambiguate (rate lookup vs. per-invoice rounding).
15 of 16 tools follow a clean jp_<domain>_<noun/action> snake_case convention (jp_tax_*, jp_invoice_*, jp_business_days_*), which is highly predictable. The single outlier, x_post_weighted_length, breaks both the prefix and the domain, but the set is otherwise uniform.
16 tools is at the upper edge of comfortable but each maps to a genuinely different Japanese tax/date rule, so none feel redundant. The one questionable inclusion is x_post_weighted_length, which has nothing to do with the server's stated purpose and only inflates the surface.
Coverage of the stated domain is strong: holiday/business-day calendars, era conversion, filing deadlines, consumption tax rates and invoice math, withholding, stamp duty, basic deduction, and upcoming rule changes. Gaps remain — no resident tax, corporate tax, or social-insurance lookups, item-2 professional withholding is explicitly excluded, and there is no invoice registration-number validation — but these are documented boundaries an agent can work around.
Available Tools
16 toolsjp_add_business_daysN 営業日後・前の日ARead-onlyIdempotentInspect
Return the date N Japanese business days after (or before, if N is negative) a start date; the start date itself is never counted. Same calendars as jp_business_days_between (national holidays from the Cabinet Office CSV; "bank" also skips Dec 31–Jan 3). Use it for "5営業日後" style deadlines. N must be a non-zero integer from -400 to 400.
Inputs: days (required), start (required), calendar. Returns: notes, result, doc_url, sources, +3 more
jp_business_days_between2つの日の間の営業日の数ARead-onlyIdempotentInspect
Count Japanese business days (営業日) between two dates, skipping Saturdays, Sundays and the official Japanese holidays from the Cabinet Office CSV. Calendar "bank" also skips Dec 31–Jan 3 (銀行の休日, 銀行法施行令 第5条). By default the start date is not counted and the end date is counted. It is meant for deadlines, payment terms (支払期日), delivery dates and "how many 営業日" questions. At most 1,100 days apart; dates outside the holiday data (currently up to 2027-12-31) return an error.
Inputs: end (required), start (required), calendar, count_end, +1 more. Returns: notes, result, doc_url, sources, +3 more
jp_era_convert和暦と西暦の変換(令和・平成・昭和)ARead-onlyIdempotentInspect
Convert between Gregorian dates and Japanese era dates (和暦: 昭和 Showa, 平成 Heisei, 令和 Reiwa), handling the exact switch days (昭和 began 1926-12-25, 平成 began 1989-01-08, 令和 began 2019-05-01) and 元年 (first year). Use it when filling Japanese forms, contracts or documents that require 和暦, or when reading a 和暦 date. Modes: {to:"wareki", date:"YYYY-MM-DD"}; {to:"seireki", era, year, month, day}; {to:"wareki", year_only} (lists every era in that year). A 平成 date after 2019-04-30 (e.g. 平成31年5月1日) is read as that day and the correct 令和 form is returned with a note; a Showa date from 1989-01-08 on (e.g. 昭和64年1月8日, Showa 64-01-08), dates that do not exist, and dates before 1926-12-25 return an error.
Inputs: to (required), day, era, date, +3 more. Returns: notes, result, doc_url, sources, +3 more
jp_filing_deadlines個人事業主の届け出・申告・納付の期限の目安ARead-onlyIdempotentInspect
List the usual deadlines for a sole proprietor in Japan for one year, from National Tax Agency pages: the opening notice (開業届, due by the income-tax return deadline of the opening year), the blue-return application (青色申告承認申請: March 15, or within 2 months of opening when the business started on or after January 16), the income-tax return (March 15 of the next year), the consumption-tax return for individuals (March 31), the two estimated-tax installments (予定納税: July 31, November 30) and the special withholding-tax payment dates (納期の特例: July 10, January 20). Each date is moved to the next day when it falls on a weekend, national holiday, December 29–31 or January 1–3 (国税通則法 第10条第2項). Give the year and/or the opening date; each item says when it applies, and the caller decides which apply. For a business opened before 2026-01-01 the opening-notice deadline is not given (the article changed on that day). Years are accepted up to one year before the end of the holiday data.
Inputs: year, business_start_date. Returns: notes, result, doc_url, sources, +3 more
jp_holidays日本の祝日・休日(内閣府のデータ)ARead-onlyIdempotentInspect
List Japanese national holidays (国民の祝日) and official substitute/citizens' holidays (振替休日・国民の休日, shown as 「休日」) between two dates, or check one date, using the Cabinet Office (内閣府) official CSV. The dates come from the published CSV only, including 春分の日/秋分の日, substitute holidays and one-off holidays. Give either date, or from and to (at most 1,100 days apart). Returns an error for dates outside the published data (currently 1955-01-01 to 2027-12-31) instead of guessing.
Inputs: to, date, from. Returns: notes, result, doc_url, sources, +3 more
jp_invoice_amount請求書の金額(小計・消費税・源泉徴収・振込額・支払期日)ARead-onlyIdempotentInspect
Work out the amounts on a Japanese invoice in one call by combining the other Tax Compass calculations: subtotal, consumption tax rounded once per tax rate (国税庁 Q&A 問57), withholding tax on item-1 fees paid to a resident individual (No.2795; on the tax-excluded fee when the consumption tax (or its equivalent) is stated separately on the invoice, which the NTA allows also for issuers not registered for the invoice system; otherwise on the tax-included amount), the transfer amount (振込額), the payment due dates under 取適法 if terms are given, and a check of numbers already written on the invoice. For an issuer not registered for the invoice system (免税事業者) it adds the NTA Q&A 問26-2 notes on what such an invoice may and may not show. Whether a fee is subject to withholding and which tax rate applies are chosen by the caller.
Inputs: lines (required), rounding (required), price_basis (required), issuer_registered (required), +4 more. Returns: notes, result, doc_url, sources, +3 more
jp_invoice_consumption_taxインボイスの消費税の端数(税率ごとに1回)ARead-onlyIdempotentInspect
Calculate Japanese consumption tax on a qualified invoice (適格請求書 / インボイス) the way Japan's National Tax Agency requires: sum the lines per tax rate (10% standard, 8% reduced, and 1% for food sold 2027-04-01 to 2029-03-31 — that 1% rate is still a bill in the Diet, so give each 1% line its transaction date and the answer marks it rule_status bill), then round the tax ONCE per rate per invoice — never per line. It applies to writing, checking or explaining a Japanese invoice, receipt (適格簡易請求書) or delivery note total (納品書), and to questions about why per-item tax (消費税 端数処理) adds up differently. It calculates one invoice from a single issuer; when one document carries invoices of several businesses, the agency-delivery case (代理交付) must be rounded per business and per rate. Rounding direction (切り捨て floor / 四捨五入 round_half_up / 切り上げ ceil) is the issuer's choice. All lines of one invoice must use the same price basis (税抜 or 税込). Returns per-rate totals, the correct tax, and what per-line rounding would have given, with NTA sources. It does not check other invoice requirements such as the registration number.
Inputs: lines (required), rounding (required), price_basis (required), transaction_date. Returns: notes, result, doc_url, sources, +3 more
jp_payment_due_date支払期日の計算(取適法の60日・締め日と支払日)ARead-onlyIdempotentInspect
Compute payment-term dates under Japan's 中小受託取引適正化法 (取適法, in force from 2026-01-01, formerly the 下請法) Article 3, using the JFTC text: the 60th day counted with the receipt date as day 1, the deemed due dates (receipt date if no due date was set; the 60th day if it was set later), and for an agreed due date or a monthly cut-off rule (締め日・支払月・支払日) the payment date, its day number and whether it is within 60 days. For a monthly rule only (the two-month treatment applies to monthly cut-off rules, not to an agreed due date) it also gives the last day of the JFTC's two-month treatment (受領後2か月以内) and whether the payment is within it, and whether the payment date is a bank holiday and the postponement fits the JFTC's conditions. Special cut-off rules for continuously provided services are not covered. It does not decide whether the act applies to a transaction. Dates must be within the holiday data (currently up to 2027-12-31).
Inputs: received_on (required), monthly, agreed_due_date. Returns: notes, result, doc_url, sources, +3 more
jp_rules_changesこれから変わる日本の決まり(改正カレンダー・日付順)ARead-onlyIdempotentInspect
Upcoming (and in-progress) changes to Japanese business rules in date order — consumption tax (the proposed 1% food rate, still a bill), invoice transitional credit steps (80→70→50→30→0%), the 2割/3割 special rules, income tax basic deduction, withholding tables, the defense special income tax, minimum wage, employment insurance rates, the child-support levy, the working-pension threshold and the departure tax. Each item has effective dates, a status (in_force / enacted / bill / planned) computed against today, a one-line summary in Japanese, the official source URL and the date Cyclix Agents checked it, and the Tax Compass tool that calculates it if there is one. Filter by as_of (list items that start on or after it, or are still in effect on it — a change with no end date stays in effect), until, areas and statuses. Only items whose numbers were checked against the official source are listed; it is not a complete list of all law changes.
Inputs: areas, as_of, until, statuses. Returns: notes, result, doc_url, sources, +3 more
jp_stamp_duty印紙税はいくら?(領収書・不動産の譲渡・請負の契約書)ARead-onlyIdempotentInspect
Look up Japanese stamp duty (印紙税) for a paper receipt for sales proceeds (領収書, 第17号の1 売上代金の受取書), a real-estate transfer contract (不動産売買契約書, 第1号の1) or a contract for work (請負契約書, 第2号), including the reduced rates for real-estate transfer and construction contracts made from 2014-04-01 to 2027-03-31. It looks up the amount in the NTA table for the document type the caller specifies (e.g. receipts under ¥50,000 are non-taxable); which document type a document is, is chosen by the caller (the user). amount is the tax-inclusive total written on the document (pass null when no amount is written; omitting it is an error); when consumption tax is stated separately (or both tax-inclusive and tax-exclusive prices are written), set consumption_tax_separately_stated with consumption_tax_amount, or pass amount_excluding_consumption_tax (with consumption_tax_separately_stated: true) instead of amount — consumption tax is then excluded, as the NTA circular says. Per NTA No.7108, a contract based on a construction contract that also lists design or other work is treated as a whole as a construction contract. Based on National Tax Agency tables (laws as of 2026-04-01). It does not decide which document number a document falls under, and does not cover other document types or electronic documents.
Inputs: document_type (required), amount, created_on, business_related, +3 more. Returns: notes, result, doc_url, sources, +3 more
jp_tax_basic_deduction所得税の基礎控除と「年収の壁」(年分ごと・令和7〜12年分)ARead-onlyIdempotentInspect
Japanese income tax basic deduction (基礎控除) for a given year (年分, 2025–2030), with the table by total income (合計所得金額) and, optionally, the deduction for one total income. The 2026 tax reform (enacted 2026-03-31, in force 2026-12-01) raised it: for 2026 and 2027 it is ¥1,040,000 up to ¥4.89 million of total income, ¥670,000 up to ¥6.55 million, ¥620,000 up to ¥23.5 million, then 480k/320k/160k/0; from 2028 it is ¥990,000 up to ¥1.32 million and ¥620,000 above. 2025 is the earlier table (95/88/68/63/58万円). Also returns the minimum employment income deduction (給与所得控除の最低保障: 65万 / 74万 / 69万) and the income line for dependants (扶養親族の所得要件 58万 → 62万), and the salary-only income tax line (年収の壁 160万 → 178万 → 168万円). The extra amount on top of ¥620,000 applies to residents only. Income tax only — not resident tax or social insurance.
Inputs: year, as_of, resident, total_income. Returns: notes, result, doc_url, sources, +3 more
jp_tax_consumption_rate消費税の税率(日付と区分で・食料品 1% の法案の印つき)ARead-onlyIdempotentInspect
Look up the Japanese consumption tax rate (消費税率) that applies on a given date (as_of = the date of the sale) for a category the caller chooses: standard (10%: dining out 外食, alcohol 酒類 and most goods), reduced_food (8% reduced rate for food and drinks 飲食料品) or newspaper (8% for subscription newspapers issued twice a week or more). It answers with the rate under the law now in force, its national/local split, and a separate pending_change for the proposed 1% food rate for sales from 2027-04-01 to 2029-03-31 (消費税 1% いつから) — that cut is still a bill in the Diet (it had not been enacted when checked on 2026-11-21), so it is marked rule_status bill and answer_is_final false, never as the confirmed rate. Use it for questions such as 'what is the consumption tax rate on date X'. Dates from 2019-10-01 to 2031-12-31.
Inputs: category (required), as_of. Returns: notes, result, doc_url, sources, +3 more
jp_tax_invoice_transitional_credit免税事業者からの仕入れの控除の割合(80%→70%→50%→30%→0)ARead-onlyIdempotentInspect
Japanese invoice system (インボイス) transitional measure (経過措置): how much of the deemed input consumption tax on a purchase from a tax-exempt business or a consumer (免税事業者等からの課税仕入れ) may still be credited on a given purchase date — 80% until 2026-09-30, 70% from 2026-10-01 to 2028-09-30, 50% to 2030-09-30, 30% to 2031-09-30, then 0% (2割控除・7割控除 いつから). The percentage follows the date of the purchase (services: the day the whole service is completed; goods: the day of delivery). With an optional tax-included amount it also computes the deemed creditable amount: amount × 7.8/110 (reduced rate: 6.24/108) × percent, rounded once (NTA invoice Q&A 問130). Amended by the 2026 tax reform law enacted 2026-03-31. Dates from 2023-10-01 to 2031-12-31.
Inputs: rate, as_of, amount, rounding. Returns: notes, result, doc_url, sources, +3 more
jp_tax_small_business_special2割特例・3割特例の期間(課税期間が入るか)ARead-onlyIdempotentInspect
Japanese consumption tax special rules for small businesses that became taxable because they registered for invoices: the 2割特例 (pay 20% of output tax) applies to each taxable period that contains any day from 2023-10-01 to 2026-09-30, and the new 3割特例 (pay 30% of output tax, individuals only) applies to the 2027 and 2028 calendar years. Give a date and the taxpayer type (individual = calendar year; corporation = give the business year start and end) and it says whether that taxable period is inside each window. It only checks the period; whether the other conditions are met (base-period sales of ¥10 million or less, not taxable anyway, etc.) is for the caller to decide. From the 2026 tax reform law enacted 2026-03-31 (NTA invoice Q&A 問114, 114-2).
Inputs: taxpayer_type (required), as_of, period_end, period_start. Returns: notes, result, doc_url, sources, +3 more
jp_withholding_tax_fees源泉徴収税額(原稿料・講演料・デザイン料など)ARead-onlyIdempotentInspect
Calculate Japanese withholding income tax (源泉徴収税額, including the special reconstruction surtax / from 2027 the defense surtax) on fees paid to a RESIDENT INDIVIDUAL for manuscripts, lectures, design, illustration, photos for print, translation and similar work (所得税法 第204条第1項第1号 fees). Formula: up to ¥1,000,000 → 10.21%; above → (amount − 1,000,000) × 20.42% + 102,100; yen fractions are dropped. Use it when drafting or checking a Japanese freelance invoice or payment (請求書の源泉徴収・手取り). Handles consumption tax shown separately on the invoice. Does NOT cover lawyers, tax accountants, judicial scriveners (司法書士) and other item-2 professionals, sales agents (外交員), hostesses, prizes, corporations or non-residents — corporations and non-residents return an error. It does not judge whether a payment is such a fee.
Inputs: amount (required), fee_kind (required), payee_type (required), income_date, +2 more. Returns: notes, result, doc_url, sources, +3 more
x_post_weighted_lengthX(旧 Twitter)の投稿の文字数(日本語は140字)ARead-onlyIdempotentInspect
Count the length of a post on X (formerly Twitter) exactly as X does, using X's official twitter-text library: weighted characters where CJK (Japanese, Chinese, Korean) and emoji count 2, most Latin characters count 1, every URL counts 23, text is NFC-normalized, and the limit is 280 (about 140 Japanese characters). It is meant for checking X posts, especially Japanese ones, against the limit. is_valid is also false for an empty text or text with characters X does not accept. Counts only the text given (auto-added reply @mentions and attached media are not counted by X). Long posts for paid accounts are not covered; the text may be at most 1,000 UTF-16 code units, also after NFC normalization. The text is not stored or returned.
Inputs: text (required). Returns: notes, result, doc_url, sources, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Japanese business days, holiday checks and invoice due dates for your AI agent.
Japanese holidays, business days, eras, postal codes, addresses and corporate numbers.
Japan payroll & social insurance. 日本の給与計算・社会保険。47都道府県の料率、源泉所得税、割増賃金、有給、標準報酬月額の改定、最低賃金。根拠の条文つき。
Renamed to com.cyclixagents/japan-tax-rules (Tax Compass). This old URL still works.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides Japanese tax and invoice utilities such as consumption tax calculation, withholding tax, invoice number validation, and tax rate summarization, enabling AI assistants to perform these operations locally without external APIs.MIT
- AlicenseAqualityDmaintenanceMCP server for Japanese business days, public holidays, wareki dates, and tax arithmetic, helping AI agents avoid common Japanese date and tax errors.7MIT

ISZ™ 仕訳AI MCP サーバーofficial
FlicenseNot gradedqualityBmaintenanceEnables AI assistants to estimate year-end tax adjustment refunds or additional withholding, look up account titles and sample journal entries, validate qualified invoice registration numbers against published data, and compare consumption tax payment methods.2,181 npm-- AlicenseNot gradedqualityDmaintenanceExposes machine-readable Japanese crypto-asset tax rules with statutory citations, tax parameters, and transition logic for AI agents.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.