japan-seasons — Claude Code MCP server: seasons and setup
The japan-seasons MCP server gives agents cherry blossom data for Japan, including forecasts and city history. Use it to plan viewing dates and locations.
no license 1,010 installs updated 2026-03-29
claude mcp add --transport http japan-seasons https://japan-seasons--ko-syun.run.toolsWhat japan-seasons does
japan-seasons connects an agent to an HTTP API for Japan’s cherry blossom season. It can return current conditions by observation station, estimate bloom and peak periods, list available locations, and retrieve past records for a city. The sakura history reaches from 1953 to the present.
A planning tool compares travel dates with historical bloom patterns and suggests other cities when the timing is a poor match. The server endpoint is https://japan-seasons--ko-syun.run.tools. It can be added to Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and the other listed clients.
The service also exposes tools for autumn foliage, but those endpoints are still being added. Calls such as get_kouyou_status, get_kouyou_forecast, get_kouyou_historical, get_kouyou_locations, and recommend_kouyou_timing are not ready to use yet.
What it helps with
- check current sakura conditions by Japanese city
- estimate blossom dates for a trip
- retrieve past bloom records for one city
- find another city when travel dates miss the bloom window
Example prompts for the agent
- Show the current cherry blossom status across Japan.
- Compare my travel dates with the sakura forecast and suggest suitable cities.
- Find historical cherry blossom records for this city.
How to install japan-seasons
Platform CLI: remote server
claude mcp add --transport http japan-seasons https://japan-seasons--ko-syun.run.toolsPlatform CLI: remote server
codex mcp add japan-seasons --url https://japan-seasons--ko-syun.run.toolsConfig file
{
"mcpServers": {
"japan-seasons": {
"url": "https://japan-seasons--ko-syun.run.tools"
}
}
}Config file
{
"servers": {
"japan-seasons": {
"type": "http",
"url": "https://japan-seasons--ko-syun.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http japan-seasons https://japan-seasons--ko-syun.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about japan-seasons
How do I install japan-seasons in Claude Code?
Run claude mcp add --transport http japan-seasons https://japan-seasons--ko-syun.run.tools.
What does japan-seasons do?
It gives an agent current, forecast, and historical cherry blossom data, then supports timing and city recommendations for viewing.
Are the autumn foliage tools ready?
The status, forecast, history, location, and recommendation calls for autumn foliage are still being added and are not ready to use.