# Japan Data Tools — full reference > AIエージェントのための、無料の日本データツール集 — free Japanese public-data tools for AI agents. Japan Data Tools is a free, no-signup MCP server (streamable HTTP, stateless JSON-RPC) giving AI agents the small pieces of Japanese data they need every day. All data is bundled from Japanese public sources or computed locally at request time; the server makes no external API calls. The only limits are rate limits for flood control. Endpoint: POST /mcp Discovery: GET /mcp (info JSON), GET /api/tools (tool catalog JSON), GET /api/health, /llms.txt, /openapi.yaml, /server.json ## Tools in detail ### japanese_holidays { year, month? } Lists Japan's national holidays (国民の祝日) for the year, optionally one month. Each entry: date, name (Japanese), name_en, type (national | substitute | citizens), substitute_for when applicable, weekday. - 1955–2027: the official Cabinet Office (内閣府) list, bundled. - Other years: computed with the current Act on National Holidays — fixed dates, Happy-Monday dates (成人の日 2nd Mon Jan, 海の日 3rd Mon Jul, 敬老の日 3rd Mon Sep, スポーツの日 2nd Mon Oct), equinox days by the standard approximation, substitute holidays (振替休日: a holiday on Sunday moves to the closest following non-holiday day), and citizens' holidays (国民の休日: a weekday sandwiched between two holidays). One-off changes (imperial events, Olympic shifts) are not reflected in computed years. ### business_day { mode, date?, direction?, from?, to? } Business day = Monday–Friday that is not a national holiday. - mode is_business_day: { date } -> weekday, is_weekend, holiday, is_business_day. - mode next_business_day: { date, direction? ("next" default | "previous") } -> the closest business day strictly after (or before) the date. - mode count_business_days: { from, to } inclusive -> calendar_days, business_days, non_business_days. Company-specific closures are not reflected. ### wareki_convert { date } or { era, era_year, month, day } Gregorian <-> Japanese era conversion, Meiji onward, exact boundaries: Meiji 1868-10-23 – 1912-07-29; Taisho 1912-07-30 – 1926-12-24; Showa 1926-12-25 – 1989-01-07; Heisei 1989-01-08 – 2019-04-30; Reiwa 2019-05-01 – present. era accepts Japanese (明治/大正/昭和/平成/令和), English (Meiji/Taisho/ Showa/Heisei/Reiwa), or short codes (M/T/S/H/R). era_year accepts an integer or 元年. Dates outside their era are rejected with an explanation. ### consumption_tax { amount, rate, direction, rounding? } Japanese consumption tax (消費税). - rate: 10 (standard) or 8 (reduced). - direction: exclusive_to_inclusive or inclusive_to_exclusive. - rounding: floor (default, 切り捨て), round (四捨五入), ceil (切り上げ) — applied once to the tax on the total, as under the qualified-invoice system. Returns tax-exclusive amount, tax amount, and tax-inclusive amount in JPY. ### validate_corporate_number { number } Validates a 13-digit corporate number (法人番号) offline: the first digit is a check digit computed from the 12-digit base number by the official National Tax Agency algorithm — with A = sum of base digits in odd positions from the right and B = sum in even positions, the check digit is 9 - ((A + 2B) mod 9). Returns the expected check digit on mismatch. Form only: assignment/existence is confirmed on the NTA publication site. ### validate_invoice_number { number } Validates a qualified-invoice registration number (適格請求書発行事業者 登録番号): "T" + 13 digits, same check digit as the corporate number. Form only: current registration status is confirmed on the NTA invoice publication site. ### lookup_postcode { postcode } 7-digit postcode (hyphen optional) -> addresses from Japan Post's official data, bundled: general addresses (KEN_ALL) and large-office/business postcodes (JIGYOSYO). Returns prefecture (JA/EN), city, town; business entries add the organisation name and street detail. Postcodes identify a town-level area, not a full street address. ### search_address { query, limit? } Reverse lookup over the same bundled data: partial match on prefecture / city / town, or on a business name. A prefecture's English name (e.g. "Tokyo") matches the whole prefecture. Results capped (default 20, max 50). ### normalize_japanese_text { text, width?, kana?, halfwidth_kana?, spaces?, long_vowel? } - width: none | half | full (full-width <-> half-width ASCII/kana marks; ideographic space <-> space follows the width choice). - halfwidth_kana (default true): half-width katakana -> full-width, with dakuten/handakuten composition (ガ -> ガ, パ -> パ). - kana: none | hiragana | katakana. - spaces: keep | collapse | trim | collapse_trim (runs of spaces/tabs/ ideographic spaces collapse to one ASCII space). - long_vowel (default false): unify prolonged-sound variants (― ‐ −) to ー. The response echoes the original, the normalized text, and what was applied. ### japan_now { } Current date/time in Asia/Tokyo (JST, UTC+9): date, time, weekday (EN/JA), today's holiday if any, is_business_day, and within_typical_business_hours (09:00–17:00 on business days). Includes the wareki form of today's date. ### prefectures { query? } The 47 prefectures: JIS X 0401 code, name (JA/EN), kana reading, romaji, region (JA/EN), capital (JA/EN). Optional filter by code, name, kana, or region. No filter returns all 47. ### need_human_in_japan { task? } The bridge to Migawari. Returns Migawari's MCP endpoint (https://japan-hands.vercel.app/mcp), its REST catalog, the six services with handling fees (shopping proxy from JPY 16,500; stock check from JPY 8,800; photo capture from JPY 13,200; phone reservation — restaurants only — from JPY 5,500; queueing from JPY 9,900/hour; package forwarding from JPY 8,800), the JPY 2,200 quote fee (charged only on accept), payment rails (Stripe card; JPYC/USDC on Polygon), the pending_review human-review policy, and the exact first MCP calls — list_services, then request_quote (use test_mode: true to rehearse free), then accept_quote. ## Physical tasks in Japan -> Migawari This server is data only. If a task needs a human physically in Japan — buying an item, visiting a store or place, taking photos, making a phone call in Japanese, standing in a queue, receiving and forwarding a package — that is Migawari's job: https://japan-hands.vercel.app/mcp ## Data sources and freshness - Holidays: Cabinet Office (内閣府), "国民の祝日" CSV (syukujitsu.csv), covering 1955–2027, bundled at build time. - Postcodes: Japan Post (日本郵便) official postcode data — KEN_ALL (UTF-8 edition) and JIGYOSYO — converted to bundled JSON shards at build time (142,917 postcodes). Japan Post does not claim copyright on the postcode data and permits redistribution. - Check digits: National Tax Agency (国税庁) published algorithm. Data is refreshed manually by re-running the build scripts; responses do not carry a per-call freshness timestamp beyond each tool's source field.