Skip to main content
Glama

Server Details

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

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A4/5.0

Scored across 13 tools

Disambiguation4/5

The tools are organized into clear families (business days/holidays, era conversion, corporate lookup, postal/address) and most operations are plainly distinct. The only mild overlap is between normalize_address and search_postal_code, both of which can help turn address information into postal codes, though their intended levels of structure differ.

Naming Consistency4/5

All names use snake_case and are mostly verb-first (add_, adjust_, check_, count_, list_, lookup_, normalize_, search_), which is highly predictable. Minor deviations are the paired prepositional names from_japanese_era / to_japanese_era and the noun-phrase last_business_day_of_month.

Tool Count5/5

Thirteen tools is well within a reasonable range and each tool corresponds to a specific operation in one of the four domains. There are no obvious filler tools; the business-day family is granular but each operation earns its place.

Completeness5/5

The surface covers the stated domain thoroughly: business-day calculation/checking, holiday listing, era conversion in both directions, corporate-number lookup plus name search, and postal-code lookup/search plus address normalization. No major lifecycle operation is missing for these purposes, and the descriptions explicitly note out-of-scope items such as invoice registry and coordinates.

Available Tools

13 tools
add_business_daysAdd business days / n営業日後・前A
Read-onlyIdempotent
Inspect

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. flags: estimated/unverified when the year's holidays are an estimate (tell the user). / 指定した日から n営業日後の日付を返します(n が負なら、n営業日前)。起算日そのものは数えません。その年の祝日が見込みのときは、flags に estimated・unverified が付きます(利用者に伝えてください)。

Inputs: date (required), days (required), calendar, extra_holidays, +1 more.

adjust_to_business_dayAdjust to a business day / 休みの日の前倒し・後ろ倒しA
Read-onlyIdempotent
Inspect

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. flags: estimated/unverified when the year's holidays are an estimate (tell the user). / その日が営業日ならその日を、休みなら次(next)または前(previous)の営業日を返します。支払日が休みのときの、前倒し・後ろ倒しに使えます。その年の祝日が見込みのときは、flags に estimated・unverified が付きます(利用者に伝えてください)。

Inputs: date (required), calendar, direction, extra_holidays, +1 more.

check_business_dayCheck a business day / 営業日かどうかの判定A
Read-onlyIdempotent
Inspect

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. / その日が営業日かどうかと、休みならその理由(土日、祝日の名前、銀行の休業日、指定された休日)を返します。reason_code は weekend・holiday・bank_closure・extra_holiday のどれかです。その年の祝日が見込みのときは、flags に estimated・unverified が付きます(利用者に伝えてください)。

Inputs: date (required), calendar, extra_holidays, extra_business_days.

count_business_daysCount business days / 期間の営業日数A
Read-onlyIdempotent
Inspect

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). flags: estimated/unverified when the year's holidays are an estimate (tell the user). / start から end までの営業日の数を返します(両端の日を含みます)。start が end より後のときは 0 です。期間は3,660日(約10年)までです。その年の祝日が見込みのときは、flags に estimated・unverified が付きます(利用者に伝えてください)。

Inputs: end (required), start (required), calendar, extra_holidays, +1 more.

from_japanese_eraConvert a Japanese era date (wareki) to a Gregorian date / 和暦から西暦A
Read-onlyIdempotent
Inspect

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. / 和暦の日付を西暦に変換します。元号の範囲の外の日付(平成31年5月1日など)も、年を数えて変換します。そのときは within_era が false になり、flags に outside_era が付きます。書かれた曜日が合わないときは、weekday_mismatch が付きます。

Inputs: wareki (required).

last_business_day_of_monthLast business day of a month / 月末の最終営業日B
Read-onlyIdempotent
Inspect

Return the last business day of the given month. flags: estimated/unverified when the year's holidays are an estimate (tell the user). / その月の最終営業日を返します。その年の祝日が見込みのときは、flags に estimated・unverified が付きます(利用者に伝えてください)。

Inputs: year (required), month (required), calendar, extra_holidays, +1 more.

list_holidaysList Japanese national holidays / 日本の祝日の一覧A
Read-onlyIdempotent
Inspect

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). flags: estimated/unverified when the year's holidays are an estimate (tell the user). / その年の国民の祝日・休日(振替休日・国民の休日を含む)の一覧を返します。name は内容がわかる名前、official_name は内閣府の表記です。その年の祝日が見込みのときは、flags に estimated・unverified が付きます(利用者に伝えてください)。

Inputs: year (required).

lookup_corporate_numberLook up a Japanese corporate number / 法人番号から法人の情報A
Read-onlyIdempotent
Inspect

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. / 法人番号(13桁)から、名前・フリガナ・英語の名前・法人の種類・所在地・郵便番号・指定の日・閉鎖の日と事由・承継先を返します。国税庁の全件データ(月1回の更新)を使います。先頭の1桁(チェックデジット)を確かめ、合わないときは入力の誤りとして返します。インボイス(適格請求書発行事業者)の登録の確認ではありません。

Inputs: corporate_number (required).

lookup_postal_codeLook up a Japanese postal code / 郵便番号から住所A
Read-onlyIdempotent
Inspect

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. flags: not_found when no such postal code exists. / 郵便番号から、住所(都道府県・市区町村・町域)を返します。日本郵便のデータを使います。1つの郵便番号に町域が複数あるときは、すべて返します。事業所の個別郵便番号のときは、事業所名と所在地を offices に返します。その郵便番号がないときは、flags に not_found が付きます。

Inputs: postal_code (required).

normalize_addressNormalize a Japanese address (to town level) / 住所の正規化(町域まで)A
Read-onlyIdempotent
Inspect

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). / 住所を、都道府県・市区町村・町域・残り(番地・建物名など)に分け、郵便番号の候補を返します(日本郵便のデータに当てはめます)。番地が実在するかは確かめず、緯度・経度も返しません。level は、0=わからない、1=都道府県まで、2=市区町村まで(町域はわからない)、3=町域まで、です。

Inputs: address (required).

search_corporation_by_nameFind corporate numbers by name / 法人の名前から法人番号A
Read-onlyIdempotent
Inspect

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. / 名前の先頭が合う法人を探します(前方一致)。「株式会社」などの言葉は、名前の前後どちらにあっても無視し、全角・半角や空白の違いも吸収します。名前の途中からの検索と、フリガナでの検索はできません。最大100件を返します。詳しい情報は、lookup_corporate_number で調べてください。国税庁のサイトで「検索対象除外」とされた法人は、含まれません。

Inputs: name (required), prefecture.

search_postal_codeFind postal codes by address / 住所から郵便番号A
Read-onlyIdempotent
Inspect

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. flags: truncated (more matches than returned), city_not_found (the city matches no municipality), ambiguous_city (it matches several), not_found. / 都道府県・市区町村・町域(部分一致、任意)から、郵便番号を探します。市区町村は正式な名前で指定してください(郡名は省いてかまいません)。office_name を指定すると、その市区町村にある事業所の個別郵便番号を、事業所名(部分一致)で探します。flags には、truncated(返した件数より多く該当がある)、city_not_found(市区町村名がどの自治体にも合わない)、ambiguous_city(複数の自治体に合う)、not_found が付きます。

Inputs: city (required), town, prefecture, office_name.

to_japanese_eraConvert a date to the Japanese era (wareki) / 西暦から和暦A
Read-onlyIdempotent
Inspect

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). / 西暦の日付を和暦に変換します。1年目は「元年」と書きます。明治6年(1873年)1月1日以降に対応します。今日より後の日付には、assumes_current_era の印が付きます。

Inputs: date (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying Japanese public holidays and calculating business days, including holiday checks, holiday lists, and business-day arithmetic.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Japanese business calendar operations such as holiday checking, business day calculations, payment date calculation, fiscal year determination, and deadline tracking, all locally without external API.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides accurate Japanese business day utilities including holiday checks, settlement day calculations, and fiscal period determination, all with embedded holiday data from 2020-2030.
      7
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources