# Japan in Seasons

Live Japan seasonal travel data — cherry blossom forecasts, autumn leaves, fruit picking, flowers & festivals. 1,700+ spots from Japan Meteorological Corporation. Updated daily.

## Quick Start

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

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

# Get full schema for a tool
npx -y @smithery/cli@latest tool get haomingkoo/japan-seasons-mcp sakura.forecast

# Call a tool
npx -y @smithery/cli@latest tool call haomingkoo/japan-seasons-mcp sakura.forecast '{}'
```

## Direct MCP Connection

Endpoint: `https://japan-seasons-mcp--haomingkoo.run.tools`

**Optional config:**
- `dateStyle` (query) — How dates should be rendered in tool output.
- `temperatureUnit` (query) — Preferred temperature unit for weather output.
- `includeCoordinates` (query) — Whether GPS coordinates should be included for spots, farms, and festivals.
- `mapLanguage` (query) — Preferred language for forecast map links when both English and Japanese URLs are available.

## Tools (12)

- `sakura.forecast` — Use this when the user asks about cherry blossom timing, peak bloom, whether sakura has started, or how cities compare …
- `sakura.spots` — Use this when the user already knows the prefecture and needs exact cherry blossom viewing spots with current status an…
- `sakura.best_dates` — Use this when the user provides travel dates and wants to know where sakura is likely to be best during that trip. Retu…
- `kawazu.forecast` — Use this for January-February cherry blossom requests or when the user specifically asks about Kawazu-zakura, early blo…
- `koyo.forecast` — Use this when the user asks when autumn leaves peak, whether one city colors earlier than another, or wants a national …
- `koyo.spots` — Use this when the user already knows the prefecture and needs exact autumn leaves viewing spots. Returns Japan Meteorol…
- `koyo.best_dates` — Use this when the user gives autumn travel dates and wants the best cities during that window. Returns cities whose map…
- `weather.forecast` — Use this when short-range weather could change the recommendation, especially for sakura petal fall, rain risk, or pack…
- `flowers.spots` — Use this for non-sakura flower trips such as plum, wisteria, hydrangea, lavender, sunflower, or cosmos. Returns curated…
- `fruit.seasons` — Use this when the user asks what fruit is in season in a given month or which month is best for strawberries, grapes, p…
- `festivals.list` — Use this when the user wants recurring Japan events to plan around, such as fireworks, matsuri, or winter festivals. Re…
- `fruit.farms` — Use this when the user needs actual fruit-picking farms, booking links, and map coordinates. Returns farms from the loc…

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

## Prompts (2)

- `plan_japan_trip` (travel_dates) — Guide for planning a seasonal trip to Japan — cherry blossom, autumn leaves, fruit picking, wisteria, hydrangea, and mo…
- `plan_sakura_trip` (travel_dates) — Guide for planning a cherry blossom viewing trip to Japan. Use plan_japan_trip for full seasonal coverage.