Tool reference
Every tool is available over MCP by name and over REST at the matching path (REST guide). All tools are read-only.
The 13 tools
Section titled “The 13 tools”Generated from the live server's tools/list (captured 2026-11-17).
list_holidays
List Japanese national holidays
List all Japanese national holidays and substitute holidays for a year, based on the National Holidays Act and verified against the Cabinet Office CSV. Each holiday has `name` (descriptive) and `official_name` (as written by the Cabinet Office).
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year (1980-2099) range: 1980 – 2099 |
check_business_day
Check a business day
Check whether a date is a business day in Japan, and if not, why (weekend, holiday name, bank closure, or a custom closed day). `reason` is Japanese text; `reason_code` is one of weekend, holiday, bank_closure, extra_holiday (null on business days). flags: `estimated`/`unverified` when the year's holidays are an estimate.
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Date (YYYY-MM-DD) |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | array<string> | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | array<string> | optional | Days treated as business days even if they are weekends or holidays. |
add_business_days
Add business days / n営業日後・前
Return the date that is N business days after (or before, if N is negative) the given date. The start date itself is not counted; e.g. 1 business day after a Friday is the next Monday unless it is a holiday. / n営業日後(nが負なら前)の日付。起算日は数えない。
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Start date (YYYY-MM-DD) |
days | integer | required | Number of business days (negative = before) range: -2000 – 2000 |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | array<string> | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | array<string> | optional | Days treated as business days even if they are weekends or holidays. |
count_business_days
Count business days
Count business days from start to end, inclusive of both ends. Returns 0 if start is after end. The period can be up to 3,660 days (about 10 years). / start から end までの営業日の数(両端を含む)。start が end より後なら 0。期間は3,660日(約10年)まで。
| Parameter | Type | Required | Description |
|---|---|---|---|
start | string | required | Start date (YYYY-MM-DD) |
end | string | required | End date (YYYY-MM-DD) |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | array<string> | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | array<string> | optional | Days treated as business days even if they are weekends or holidays. |
adjust_to_business_day
Adjust to a business day
If the date is a business day, return it as is; otherwise move to the next ("next") or previous ("previous") business day. Useful for payment due dates that fall on holidays.
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Date (YYYY-MM-DD) |
direction | string | optional | next = 後ろ倒し, previous = 前倒し values: next | previous |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | array<string> | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | array<string> | optional | Days treated as business days even if they are weekends or holidays. |
last_business_day_of_month
Last business day of a month
Return the last business day of the given month.
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | required | Year (1980-2099) range: 1980 – 2099 |
month | integer | required | Month (1-12) range: 1 – 12 |
calendar | string | optional | "standard": weekends and national holidays are closed. "bank": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日) values: standard | bank |
extra_holidays | array<string> | optional | Additional company-specific closed days (e.g. summer break). |
extra_business_days | array<string> | optional | Days treated as business days even if they are weekends or holidays. |
to_japanese_era
Convert a date to the Japanese era (wareki)
Convert a Gregorian date (YYYY-MM-DD) to the Japanese era calendar, e.g. 2026-10-07 → 令和8年10月7日 (wareki_short R8.10.07, zero-padded). Year 1 is written 元年. Supported from 1873-01-01 (the Gregorian calendar was adopted on 明治6年1月1日). Eras: 令和 (R) from 2019-05-01, 平成 (H) from 1989-01-08, 昭和 (S) from 1926-12-25, 大正 (T) from 1912-07-30, 明治 (M) from 1868-01-25. flags: `assumes_current_era` for dates after today (the era might change).
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | required | Date (YYYY-MM-DD) |
from_japanese_era
Convert a Japanese era date (wareki) to a Gregorian date
Convert a Japanese era date to YYYY-MM-DD. Accepts 令和8年10月7日, 令和元年5月1日, R8.10.7, H31/4/30, Reiwa 8.10.7, kanji numerals (昭和六十四年一月七日), a trailing weekday such as (水) or 水曜日, and full-width characters. `input_era`/`input_era_year` echo the input; `actual` is the correct era for that date. If the date is outside the input era (e.g. 平成31年5月1日, written after the era changed), it is still converted by counting years, `within_era` is false and flags has `outside_era`. If a weekday was given and does not match, `weekday_matches` is false and flags has `weekday_mismatch`.
| Parameter | Type | Required | Description |
|---|---|---|---|
wareki | string | required | Japanese era date, e.g. 令和8年10月7日 or R8.10.7 |
lookup_postal_code
Look up a Japanese postal code
Look up the address (prefecture, city, town) for a 7-digit Japanese postal code, from Japan Post data. Accepts forms like 1000001, 100-0001 or 〒100-0001. One code can cover several towns; all are returned. `town_detail` holds the parenthesized part as written by Japan Post (e.g. chome ranges or building floors). If the code is a business-specific code (大口事業所個別番号) or a PO box code, the business is returned in `offices`.
| Parameter | Type | Required | Description |
|---|---|---|---|
postal_code | string | required | 7-digit postal code, hyphen optional |
search_postal_code
Find postal codes by address
Find Japanese postal codes by prefecture, city and (optionally) part of the town name, from Japan Post data. The city must be the full municipality name (e.g. 札幌市中央区, 新宿区); the county name may be omitted. With `office_name`, searches business-specific codes (大口事業所個別番号) of businesses in that city by name instead. Returns up to 100 matches.
| Parameter | Type | Required | Description |
|---|---|---|---|
prefecture | string | optional | Prefecture, e.g. 東京都 (optional) |
city | string | required | Municipality, e.g. 新宿区 |
town | string | optional | Part of the town name, e.g. 西新宿 (optional) |
office_name | string | optional | Part of a business name, in kanji or katakana (optional) |
normalize_address
Normalize a Japanese address (to town level)
Split a Japanese address into prefecture, city, town and the rest (block numbers, building), matching Japan Post's address data, and return candidate postal codes. Absorbs full/half-width, spacing, kanji vs. arabic numerals, ヶ/ケ and omitted county names; fills in the prefecture when the city is unique. Does NOT verify block/house numbers and has no coordinates. `level` tells how far the match went: 0 = nothing matched, 1 = prefecture only (see `city_candidates` if the city name is ambiguous), 2 = city matched but not the town (`postal_codes` are city-wide candidates), 3 = town matched. `address` and `municipality_code` are null below level 2. flags: `partial` (level below 3), `ambiguous` (several city or postal code candidates — ask the user or show all).
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | required | Japanese address, e.g. 北海道札幌市中央区大通西10丁目1-1 |
lookup_corporate_number
Look up a Japanese corporate number
Look up a 13-digit Japanese corporate number (法人番号) in the National Tax Agency's monthly bulk data: name, furigana, English name, kind, registered address and postal code, assignment date, and closure (date, cause, successor) if the registry record was closed. The check digit (first digit) is verified first; a wrong check digit is reported as an input error. flags: `closed` (the registry record is closed — tell the user), `excluded_from_search`, `not_found`. This is not the invoice (qualified invoice issuer) registry.
| Parameter | Type | Required | Description |
|---|---|---|---|
corporate_number | string | required | 13-digit corporate number, hyphens/spaces allowed |
search_corporation_by_name
Find corporate numbers by name
Find Japanese corporations whose name starts with the given text (prefix match), in the National Tax Agency's monthly bulk data. Legal-form words such as 株式会社 or 一般社団法人 are ignored at either end, and full/half-width and spaces are normalized. Matching in the middle of a name and furigana search are not supported. flags: `truncated`, `exact_match_only` (too many names start with the input; only exact matches returned), `not_found`. Returns up to 100 matches (`total`, `returned`, `truncated`) with corporate number, name, prefecture, city and `is_closed` (registry record closed); use lookup_corporate_number for details. Corporations marked as excluded from search on the NTA site are not included.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Beginning of the corporate name (e.g. トヨタ自動車) |
prefecture | string | optional | Prefecture to narrow down (optional, e.g. 東京都 or 東京) |
Operated by Momonga