haomingkoo avatar

Japan Seasons

haomingkoo/japan-seasons-mcp

Connects Claude to live cherry blossom forecasts, autumn foliage tracking, and seasonal travel data across 1,700+ locations in Japan. Pulls daily updates from the Japan Meteorological Corporation, the same source powering SAKURA NAVI. Seventeen tools let you query current bloom status, forecast dates by city or spot, find fruit picking farms, check flower seasons, and pull weather overlays. The sakura_now and japan_seasonal_answer tools handle natural prompts like "where should I see sakura April 10-14" and return real percentages, park names, and timing shifts based on this winter's temps. Useful when you need accurate seasonal windows instead of generic "late March" training data. Also covers koyo, festivals, wisteria, hydrangea, and 14 fruit varieties with GPS coordinates.

GitHub stars
1
tools
17
transport
STDIO, HTTP
env vars
5
last updated
Jul 13, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

japan_seasonal_answerAnswer a broad traveler question by routing to the right live or curated dataset and returning a ready-to-use recommendation.

Answer a broad traveler question by routing to the right live or curated dataset and returning a ready-to-use recommendation.

No parameter schema in public metadata yet.

sakura_nowCurrent cherry blossom answer summarizing what is good now, what is coming next, or what matched the user's trip dates.

Current cherry blossom answer summarizing what is good now, what is coming next, or what matched the user's trip dates.

No parameter schema in public metadata yet.

koyo_nowCurrent autumn leaves answer with koyo timing, maple/ginkgo peaks, trip-date matches, and next-step guidance.

Current autumn leaves answer with koyo timing, maple/ginkgo peaks, trip-date matches, and next-step guidance.

No parameter schema in public metadata yet.

searchProvider-friendly search tool for retrieval flows that returns result IDs.

Provider-friendly search tool for retrieval flows that returns result IDs.

No parameter schema in public metadata yet.

fetchProvider-friendly fetch tool that returns full text with a canonical URL.

Provider-friendly fetch tool that returns full text with a canonical URL.

No parameter schema in public metadata yet.

sakura_forecastAll 48 JMA observation cities in one call: this year's forecast, actual dates when observed, and comparison to the historical average.

All 48 JMA observation cities in one call: this year's forecast, actual dates when observed, and comparison to the historical average.

No parameter schema in public metadata yet.

sakura_spotsAbout 1,000 spots across Japan with current status, bloom percentages, and GPS coordinates.

About 1,000 spots across Japan with current status, bloom percentages, and GPS coordinates.

No parameter schema in public metadata yet.

sakura_best_datesMatch travel dates to bloom by returning cities where full bloom overlaps the window plus viewing spots.

Match travel dates to bloom by returning cities where full bloom overlaps the window plus viewing spots.

No parameter schema in public metadata yet.

kawazu_forecastKawazu early-season deep-pink cherry blossom forecast for Izu Peninsula spots.

Kawazu early-season deep-pink cherry blossom forecast for Izu Peninsula spots.

No parameter schema in public metadata yet.

koyo_forecastMaple and ginkgo autumn colour-change timing by city, compared to the historical normal.

Maple and ginkgo autumn colour-change timing by city, compared to the historical normal.

No parameter schema in public metadata yet.

koyo_best_datesMatch a travel window to cities in peak autumn colour.

Match a travel window to cities in peak autumn colour.

No parameter schema in public metadata yet.

koyo_spots687 autumn leaves viewing spots by prefecture with peak windows, leaf type, popularity, and GPS.

687 autumn leaves viewing spots by prefecture with peak windows, leaf type, popularity, and GPS.

No parameter schema in public metadata yet.

flowers_spots90 curated flower spots across 8 flower types, filterable by type, prefecture, or month.

90 curated flower spots across 8 flower types, filterable by type, prefecture, or month.

No parameter schema in public metadata yet.

festivals_list46 major recurring festivals and events with official URLs and attendance figures, filterable by type, month, and prefecture.

46 major recurring festivals and events with official URLs and attendance figures, filterable by type, month, and prefecture.

No parameter schema in public metadata yet.

fruit_seasonsFull-year calendar for 14 fruits showing what is in season and at peak for a given month.

Full-year calendar for 14 fruits showing what is in season and at peak for a given month.

No parameter schema in public metadata yet.

fruit_farms2,100+ fruit picking farms with GPS and booking links, filterable by month and region.

2,100+ fruit picking farms with GPS and booking links, filterable by month and region.

No parameter schema in public metadata yet.

weather_forecast3-day JMA weather forecast for 51 cities with temperature and rain probability.

3-day JMA weather forecast for 51 cities with temperature and rain probability.

No parameter schema in public metadata yet.

Sponsors

Configuration

JAPAN_SEASONS_DATE_STYLEdefault: friendly

How dates are rendered in tool output.

JAPAN_SEASONS_TEMPERATURE_UNITdefault: celsius

Preferred temperature unit for weather output.

JAPAN_SEASONS_INCLUDE_COORDINATESdefault: true

Whether spot, festival, and farm outputs include GPS coordinates.

JAPAN_SEASONS_MAP_LANGUAGEdefault: english

Preferred language for forecast map links when both English and Japanese versions exist.

PORTdefault: 3000

Local port used when starting the package in HTTP MCP mode.

Readme

🌸 japan-seasons-mcp

The cherry blossom front moving north across a map of Japan, day by day
▶ 30-second tour · Live app · kooexperience.com
Music: Sascha Ende, ende.app (CC BY 4.0)

Give your AI assistant live Japan travel data — cherry blossom forecasts, autumn leaves, fruit picking, flowers, festivals & more.

About 1,700 forecast spots plus flowers, festivals and fruit farms. 17 tools. Live data from Japan Meteorological Corporation.


View the full README on GitHub

Details

Repository
github.com/haomingkoo/japan-seasons-mcp
Package
japan-seasons-mcp
Transport
STDIO, HTTP
Registry
MCP registry, active

More from haomingkoo