Japan Business Tools

jp.ossalt/jp-biz-tools · v0.9.0 · finance-and-payments

Japan Business Tools is healthy: it completed an MCP handshake in 2370 ms and exposes 13 tools.

Japanese holidays, business days, eras, postal codes, addresses and corporate numbers.

Endpoint: https://biz.ossalt.jp/mcp (streamable-http)

No repository listed · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count13
Latency2370 ms
Last checked (UTC)2026-10-16T18:40:51.949Z

Health history

Checked (UTC)StatusLatencyError
2026-10-16T18:40:51.949ZHealthy2370
2026-10-15T12:20:20.646ZHealthy2268

Tools (13)

list_holidaysList 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). / その年の国民の祝日・休日(振替休日・国民の休日を含む)の一覧。name は内容がわかる名前、offici
check_business_dayCheck 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 ho
add_business_daysReturn 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が負なら前)の日付。起算日は数えない。
count_business_daysCount 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年)まで。
adjust_to_business_dayIf 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. / 営業日ならその日、休みなら次(next)または前(previous)の営業日。支払日が休みのときなどに使う。
last_business_day_of_monthReturn the last business day of the given month. / その月の最終営業日。
to_japanese_eraConvert 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 19
from_japanese_eraConvert 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
lookup_postal_codeLook 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 buil
search_postal_codeFind 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
normalize_addressSplit 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 uniq
lookup_corporate_numberLook 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 verifi
search_corporation_by_nameFind 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