Japan Business Day MCP

An MCP server providing access to Japan's business day and financial calendar data, including holidays, bank transfer value dates, payment terms, Tokyo Stock Exchange trading days, dividend record dates, and traditional calendar elements like rokuyo lucky days. It serves AI agents with pay-per-request pricing via USDC.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by matchan962

MCP endpoint (Streamable HTTP)

https://japan-business-day-api.matchan962.workers.dev/mcp

Vendor documentation

What its tools do

11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Not annotated (11)

is_business_day_free
is_business_day
add_business_days
list_holidays
payment_due_date
bank_value_date
jpx_trading_day
jpx_record_date
jpx_sq_date
japanese_koyomi
find_lucky_days_japan

11 of 11 have a description · 0 of 11 declare behavior hints · 9 of 11 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

Passed Endpoint answered the live check · Nov 6, 2026, 3:26 PM UTC
Availability 1 of 1 checks passed in 30 days

What you can do with it

Check if a specific date is a business day in Japan
Retrieve public holidays for a given year
Calculate bank transfer value dates
Find Tokyo Stock Exchange trading days

Source and maintenance

Community listingRegistry 1.0.0

mcp-registry: io.github.Rira365/japan-business-day@1.0.0

Protocol and capabilities

Server: japan-business-day 1.0.0
MCP protocol negotiated in check: 2025-11-25
Tools: 11 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": true
  }
}

Tools

11 advertised

is_business_day_free

Advertised by the server during the last successful anonymous check.

FREE: check whether a date between today and 90 days ahead (JST) is a business day in Japan. Official Cabinet Office holiday data, supports bank calendar (Dec 31 - Jan 3). For other dates, business-day arithmetic or holiday lists use the paid tools.

is_business_day_free input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD. Supported range 1955-01-01..2027-12-31"
    },
    "calendar": {
      "enum": [
        "national",
        "bank"
      ],
      "type": "string",
      "description": "national (default): weekends + national holidays. bank: also Dec 31 - Jan 3 bank holidays"
    }
  },
  "additionalProperties": false
}

is_business_day

Advertised by the server during the last successful anonymous check.

Check whether a date is a business day in Japan (official Cabinet Office holiday data). Returns holiday name (JA/EN) and next/previous business day. Price: $0.005 USDC via x402.

is_business_day input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD. Supported range 1955-01-01..2027-12-31"
    },
    "calendar": {
      "enum": [
        "national",
        "bank"
      ],
      "type": "string",
      "description": "national (default): weekends + national holidays. bank: also Dec 31 - Jan 3 bank holidays"
    }
  },
  "additionalProperties": false
}

add_business_days

Advertised by the server during the last successful anonymous check.

Add or subtract N Japanese business days from a date (settlement T+N, delivery ETA). Price: $0.01 USDC via x402.

add_business_days input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "days"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD. Supported range 1955-01-01..2027-12-31"
    },
    "days": {
      "type": "integer",
      "maximum": 366,
      "minimum": -366
    },
    "calendar": {
      "enum": [
        "national",
        "bank"
      ],
      "type": "string",
      "description": "national (default): weekends + national holidays. bank: also Dec 31 - Jan 3 bank holidays"
    }
  },
  "additionalProperties": false
}

list_holidays

Advertised by the server during the last successful anonymous check.

List Japanese national holidays for a year with JA/EN names. Price: $0.01 USDC via x402.

list_holidays input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "integer"
    },
    "calendar": {
      "enum": [
        "national",
        "bank"
      ],
      "type": "string",
      "description": "national (default): weekends + national holidays. bank: also Dec 31 - Jan 3 bank holidays"
    }
  },
  "additionalProperties": false
}

payment_due_date

Advertised by the server during the last successful anonymous check.

Japanese payment terms (shimebi/shiharaibi) calculator, e.g. month-end close paid end of next month; shifts to the previous/next business day on weekends/holidays. Price: $0.01 USDC via x402.

payment_due_date input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date",
    "closing",
    "payDay"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Transaction or invoice date (YYYY-MM-DD)"
    },
    "adjust": {
      "enum": [
        "previous",
        "next",
        "none"
      ],
      "type": "string",
      "description": "Shift when not a business day; default previous"
    },
    "payDay": {
      "anyOf": [
        {
          "$ref": "#/properties/closing/anyOf/0"
        },
        {
          "$ref": "#/properties/closing/anyOf/1"
        }
      ],
      "description": "Payment day of month (1-31) or 'end'"
    },
    "closing": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 31,
          "minimum": 1
        },
        {
          "type": "string",
          "const": "end"
        }
      ],
      "description": "Closing day of month (1-31) or 'end'"
    },
    "calendar": {
      "enum": [
        "national",
        "bank"
      ],
      "type": "string",
      "description": "national (default): weekends + national holidays. bank: also Dec 31 - Jan 3 bank holidays"
    },
    "monthOffset": {
      "type": "integer",
      "maximum": 3,
      "minimum": 0,
      "description": "Months after closing; default 1 (next month)"
    }
  },
  "additionalProperties": false
}

bank_value_date

Advertised by the server during the last successful anonymous check.

When will a Japanese bank transfer be credited? Returns the value date under standard processing (same day before the cutoff, default 15:00 JST, on a bank business day; otherwise next bank business day). Price: $0.01 USDC via x402.

bank_value_date input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cutoff": {
      "type": "string",
      "description": "Bank cutoff HH:MM JST, default 15:00"
    },
    "datetime": {
      "type": "string",
      "description": "Submission time ISO 8601 (default now; no offset = JST)"
    },
    "extraDays": {
      "type": "integer",
      "maximum": 30,
      "minimum": 0,
      "description": "Additional bank business days"
    }
  },
  "additionalProperties": false
}

jpx_trading_day

Advertised by the server during the last successful anonymous check.

Is the Tokyo Stock Exchange (JPX) open on a date? Next/previous trading day, first/last trading day of the year. Price: $0.005 USDC via x402.

jpx_trading_day input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD. Supported range 1955-01-01..2027-12-31"
    }
  },
  "additionalProperties": false
}

jpx_record_date

Advertised by the server during the last successful anonymous check.

Japanese stocks: last cum-rights trading day and ex-rights date for a dividend/benefit record date (T+2 settlement, holiday-aware). Price: $0.01 USDC via x402.

jpx_record_date input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "recordDate"
  ],
  "properties": {
    "recordDate": {
      "type": "string",
      "description": "Record date (kenri kakutei-bi) YYYY-MM-DD"
    }
  },
  "additionalProperties": false
}

jpx_sq_date

Advertised by the server during the last successful anonymous check.

Nikkei 225 futures/options SQ day and last trading day for a contract month (2nd Friday, moved earlier on holidays). Price: $0.01 USDC via x402.

jpx_sq_date input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "month"
  ],
  "properties": {
    "month": {
      "type": "string",
      "description": "Contract month YYYY-MM"
    }
  },
  "additionalProperties": false
}

japanese_koyomi

Advertised by the server during the last successful anonymous check.

Japanese traditional calendar for a date: rokuyo (taian/butsumetsu lucky days), Reiwa era date, lunisolar date, 24 solar terms. Price: $0.005 USDC via x402.

japanese_koyomi input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (1955-2032)"
    }
  },
  "additionalProperties": false
}

find_lucky_days_japan

Advertised by the server during the last successful anonymous check.

Find auspicious Japanese dates: days in a range matching rokuyo (e.g. taian) and optional weekdays (e.g. sat,sun) for weddings, moving, contracts. Price: $0.01 USDC via x402.

find_lucky_days_japan input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD (max 366 days)"
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD"
    },
    "rokuyo": {
      "type": "string",
      "description": "Comma-separated: taian,shakko,sensho,tomobiki,sakimake,butsumetsu (default taian)"
    },
    "weekdays": {
      "type": "string",
      "description": "Comma-separated weekdays, e.g. sat,sun"
    }
  },
  "additionalProperties": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

2026-11-06: 1 of 1 checks answered
2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 1061 ms
95th percentile latency: 1061 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 6, 2026, 3:26 PM UTC · probe · passed · 1061 ms · metadata changed · 11 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http japan-business-day-mcp https://japan-business-day-api.matchan962.workers.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add japan-business-day-mcp --url https://japan-business-day-api.matchan962.workers.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable japan-business-day-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "japan-business-day-mcp": {
      "url": "https://japan-business-day-api.matchan962.workers.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "japan-business-day-mcp": {
      "type": "streamableHttp",
      "url": "https://japan-business-day-api.matchan962.workers.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start japan-business-day-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "japan-business-day-mcp": {
      "type": "http",
      "url": "https://japan-business-day-api.matchan962.workers.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http japan-business-day-mcp https://japan-business-day-api.matchan962.workers.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.

Claude Desktop configuration

https://japan-business-day-api.matchan962.workers.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "japan-business-day-mcp": {
      "serverUrl": "https://japan-business-day-api.matchan962.workers.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Japan Business Day MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows