# japan-seasons

Cherry blossoms, autumn foliage & festivals — one API for AI agents and developers

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ko-syun/japan-seasons

# Browse available tools
npx -y @smithery/cli@latest tool list ko-syun/japan-seasons

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ko-syun/japan-seasons get_sakura_status

# Call a tool
npx -y @smithery/cli@latest tool call ko-syun/japan-seasons get_sakura_status '{}'
```

## Direct MCP Connection

Endpoint: `https://japan-seasons--ko-syun.run.tools`

## Tools (10)

- `get_sakura_status` — Get the current cherry blossom (sakura) bloom status across Japan. Returns station-by-station status including bloom da…
- `get_sakura_forecast` — Get cherry blossom bloom forecast based on 30-year historical averages. Returns estimated bloom windows, full bloom win…
- `get_sakura_historical` — Get historical cherry blossom bloom records for a specific city. Includes bloom dates, statistics, and long-term trends…
- `get_sakura_locations` — List all 58 JMA cherry blossom observation stations across Japan. Returns city IDs, names, prefectures, regions, coordi…
- `recommend_sakura_timing` — Get a personalized cherry blossom viewing recommendation. Analyzes historical bloom data to estimate the likelihood of …
- `get_kouyou_status` — Get the current autumn foliage (kouyou) status across Japan. NOTE: This endpoint is coming soon — kouyou data is being …
- `get_kouyou_forecast` — Get autumn foliage forecast. NOTE: This endpoint is coming soon — kouyou data is being added.
- `get_kouyou_historical` — Get historical autumn foliage records. NOTE: This endpoint is coming soon — kouyou data is being added.
- `get_kouyou_locations` — List all kouyou observation locations. NOTE: This endpoint is coming soon — kouyou data is being added.
- `recommend_kouyou_timing` — Get autumn foliage viewing recommendation. NOTE: This endpoint is coming soon — kouyou data is being added.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ko-syun/japan-seasons <tool-name>
```