# japan-seasons

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1010 installs
- Author: ko-syun
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/ko-syun/japan-seasons
- Updated: 2026-03-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/japan-seasons

## What it 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.

## Requirements
- Remote server: `https://japan-seasons--ko-syun.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http japan-seasons https://japan-seasons--ko-syun.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add japan-seasons --url https://japan-seasons--ko-syun.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "japan-seasons": {
            "url": "https://japan-seasons--ko-syun.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "japan-seasons": {
            "type": "http",
            "url": "https://japan-seasons--ko-syun.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http japan-seasons https://japan-seasons--ko-syun.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [Japan in Seasons](https://affpapa.org/en/nevibecode/mcp/japan-in-seasons.md) — MCP server · 4124 installs
- [Japan Business MCP](https://affpapa.org/en/nevibecode/mcp/japan-business-mcp.md) — MCP server · 800 installs
- [japan-weather-alert-mcp](https://affpapa.org/en/nevibecode/mcp/japan-weather-alert-mcp.md) — MCP server · 202 installs
- [japan-holiday-mcp](https://affpapa.org/en/nevibecode/mcp/japan-holiday-mcp.md) — MCP server · 337 installs
- [japan-data-mcp](https://affpapa.org/en/nevibecode/mcp/japan-data-mcp.md) — MCP server · ★ 13 repo stars
- [Shirabe Calendar API](https://affpapa.org/en/nevibecode/mcp/shirabe-calendar-api.md) — MCP server · 2944 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
