openapi: 3.1.0
info:
  title: Japan Data Tools
  version: 0.1.0
  description: >-
    Free Japanese public-data tools for AI agents: national holidays and
    business days, wareki conversion, consumption tax, corporate-number and
    invoice-number check-digit validation, postcode/address lookup,
    prefecture data, and Japanese text normalization. Bundled public data,
    no external calls. Physical tasks in Japan are handled by the sister
    service Migawari (https://japan-hands.vercel.app/mcp).
servers:
  - url: https://japan-data-tools.vercel.app
paths:
  /mcp:
    post:
      summary: MCP endpoint (streamable HTTP, stateless JSON-RPC). Tools — japanese_holidays, business_day, wareki_convert, consumption_tax, validate_corporate_number, validate_invoice_number, lookup_postcode, search_address, normalize_japanese_text, japan_now, prefectures, need_human_in_japan.
      responses: { "200": { description: JSON-RPC response } }
    get:
      summary: Server info (name, positioning, tool names, usage)
      responses: { "200": { description: OK } }
  /api/tools:
    get:
      summary: Tool catalog as plain JSON (same content as MCP tools/list)
      responses: { "200": { description: OK } }
  /api/health:
    get:
      summary: Health check ({ok, service, version, time})
      responses: { "200": { description: OK } }
