mcpbeat Sign in

Japan Seasons MCP Server

by haomingkoo Your server? Claim it
answering

Japan Seasons is answering right now. Last checked 5 min ago. 83 installs a week from npm. It exposes 17 tools. Last commit 28 Aug 2026.

Live Japan seasonal travel MCP: sakura, autumn leaves, flowers, festivals, fruit farms, weather.

Installs per day peak 77 · avg 18 · +152% w/w
a month agotoday
Uptime history 51 days of history · worst day 97%
51 days agonow
97.8%
Uptime 24h
89 of 91 checks
17
Tools
read from the server
332 ms
Response time
average over 24h
83
Installs / week
npm and PyPI

What the code does

We read the source, 7 h ago · tools taken from the live server · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

      tbody.innerHTML = rows.map(([tool, count]) =>

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 min ago.

run in your terminal
claude mcp add japan-seasons --transport http https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={mapLanguage}
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "japan-seasons": {
      "url": "https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}\u0026temperatureUnit={temperatureUnit}\u0026includeCoordinates={includeCoordinates}\u0026mapLanguage={mapLanguage}"
    }
  }
}
~/.codex/config.toml
[mcp_servers.japan-seasons]
url = "https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={mapLanguage}"
.cursor/mcp.json
{
  "mcpServers": {
    "japan-seasons": {
      "url": "https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}\u0026temperatureUnit={temperatureUnit}\u0026includeCoordinates={includeCoordinates}\u0026mapLanguage={mapLanguage}"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "japan-seasons": {
      "url": "https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}\u0026temperatureUnit={temperatureUnit}\u0026includeCoordinates={includeCoordinates}\u0026mapLanguage={mapLanguage}"
    }
  }
}

This one needs environment variables set before it will start: PORT (Local port used when starting the package in HTTP MCP mode.), JAPAN_SEASONS_DATE_STYLE (How dates are rendered in tool output.), JAPAN_SEASONS_TEMPERATURE_UNIT (Preferred temperature unit for weather output.), JAPAN_SEASONS_INCLUDE_COORDINATES (Whether spot, festival, and farm outputs include GPS coordinates.), JAPAN_SEASONS_MAP_LANGUAGE (Preferred language for forecast map links when both English and Japanese versions exist.). The author declared them in the registry entry; get the values from the project itself.

Available tools 17

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

koyo
koyo_best_dates
Use this when the user gives autumn travel dates and wants the best cities during that window. Returns cities whose maple or ginkgo viewing windows overlap the trip, based on forecast peak dates. Do not use this for general climate questions or for exact park recommendations without dates; use koyo_spots when the prefecture is already known.
koyo_forecast
Use this when the user asks when autumn leaves peak, whether one city colors earlier than another, or wants a national overview for October-December. Returns city-level maple and ginkgo forecast dates, forecast maps, and regional commentary from Japan Meteorological Corporation. Do not use this for specific temples, gardens, or GPS-tagged locations; call koyo_spots next for those.
koyo_now
Use this first for broad autumn leaves prompts such as 'How are autumn leaves looking?', 'Where is koyo good now?', 'Kyoto autumn leaves forecast', or 'Where should I see fall foliage in Japan?'. Returns a concise current answer from live Japan Meteorological Corporation maple and ginkgo forecast data. Do not use this for cherry blossoms, fruit picking, hotels, trains, or generic itinerary planning.
koyo_spots
Use this when the user already knows the prefecture and needs exact autumn leaves viewing spots. Returns Japan Meteorological Corporation koyo spots for one prefecture with best start, peak, and end dates, leaf type, popularity rating, and GPS coordinates. Omit prefecture to get a top-destinations guide. Do not use this for cross-city date matching; use koyo_forecast or koyo_best_dates first.
sakura
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. Returns cities whose viewing window overlaps the requested date range, based on observed or forecast full-bloom dates. Do not use this for January-February early-bloom Kawazu requests; use kawazu_forecast for those.
sakura_forecast
Use this when the user asks about cherry blossom timing, peak bloom, whether sakura has started, or how cities compare across Japan. Returns Japan Meteorological Corporation forecast bloom dates, full-bloom dates, observed dates when available, historical averages, and status for 48 observation cities. Do not use this for specific parks or temples; call sakura_spots next for prefecture-level viewing spots.
sakura_now
Use this first for broad cherry blossom prompts such as 'How is the sakura forecast?', 'Is sakura blooming now?', 'Where should I view sakura today?', 'Where should I see cherry blossoms this week?', or 'How is Kyoto sakura looking?'. Returns a concise current answer from live Japan Meteorological Corporation forecast and observation data, including specific viewing spot suggestions when current spot data is available, plus next-step guidance for the full park list and weather. Do not use this for autumn leaves, non-sakura flowers, hotels, trains, or generic itinerary planning.
sakura_spots
Use this when the user already knows the prefecture and needs exact cherry blossom viewing spots with current status and GPS coordinates. Each spot uses JMC reporter observations as the primary status when filed within the last 48 hours (states: pre-bloom through hazakura/green leaves); falls back to the JMC bloom-meter estimate otherwise, with any stale observation shown as secondary context. Also returns the prefecture's JMA reference station summary. Do not use this for nationwide timing comparisons or date matching; use sakura_forecast or sakura_best_dates first.
fruit
fruit_farms
Use this when the user needs actual fruit-picking farms, booking links, and map coordinates. Returns farms from the local dataset, and month filtering automatically narrows results to fruits that are in season. If the user only asks which fruit is in season, call fruit_seasons first.
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, peaches, apples, and similar picking trips. Returns the fruit season calendar, peak months, best regions, and notes for 14 fruits. Call fruit_farms next if the user needs actual farm listings, map coordinates, or booking links.
festivals
festivals_list
Use this when the user wants recurring Japan events to plan around, such as fireworks, matsuri, or winter festivals. Returns curated events with typical dates, attendance, official URLs, notes, and GPS coordinates. Do not use this for bloom timing, one-off concerts, or weather forecasts.
fetch
fetch
Use this after search to retrieve a full Japan in Seasons result with citation URL and text. For live sakura or autumn leaves result IDs, this fetches the current forecast answer from live JMC data.
flowers
flowers_spots
Use this for non-sakura flower trips such as plum, wisteria, hydrangea, lavender, sunflower, or cosmos. Returns curated flower spots with peak windows, official URLs, notes, and GPS coordinates. Do not use this for cherry blossom or autumn leaves timing; use the sakura or koyo tools for those live forecasts.
japan
japan_seasonal_answer
Use this first when the user asks a broad Japan seasonal travel question, including cherry blossom forecasts, autumn leaves, flowers, festivals, fruit picking, or what is good during travel dates. This is the best entry point for natural traveler prompts because it routes to the right live dataset and returns a ready-to-use recommendation. Do not use this for hotels, flights, trains, visas, restaurants, or generic itinerary planning unrelated to seasonal timing.
kawazu
kawazu_forecast
Use this for January-February cherry blossom requests or when the user specifically asks about Kawazu-zakura, early blossoms, or the Izu Peninsula. Returns the Japan Meteorological Corporation forecast comment, forecast map links, and Kawazu cherry spots with bloom percentages, full-bloom percentages, forecast dates, and coordinates. Do not use this for standard Somei-Yoshino sakura elsewhere in Japan.
search
search
Use this for ChatGPT/deep-research style retrieval over Japan in Seasons. Searches live seasonal-travel dataset guides and returns result IDs for fetch. Use for questions about Japan cherry blossom forecasts, autumn leaves, seasonal flowers, festivals, fruit picking, weather, or the MCP server itself. Do not use for hotels, flights, trains, visas, or restaurants.
weather
weather_forecast
Use this when short-range weather could change the recommendation, especially for sakura petal fall, rain risk, or packing advice. Returns the next 3 days of Japan Meteorological Agency forecast text, temperatures, and 6-hour rain probabilities for one supported city. Do not use this for seasonal bloom timing months in advance; use the sakura or koyo forecast tools for that.

Endpoints

URLTransportStateLatencyChecked
https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={mapLanguage} streamable-http answering 304 ms 5 min ago

Alternatives to Japan Seasons

same job, measured the same way
Nws
by pipeworx-io

NWS MCP — US National Weather Service (no auth)

41 tools answering
Travel Agent MCP
by forgemeshlabs

Free travel tools plus live x402 Travel Pulse, day trips, weekends, weather, creator, and mobility.

44 installs/wk local only
Nowah Travel
by nowah-xyz

Your personal AI travel concierge — flights, hotels, 116M+ POIs, visas, weather & more

answering
Vedar — Kamchatka travel
by vedarai

Kamchatka travel: live tours and availability, safety alerts, places, weather, stays, trip plans

13 tools answering
Weather MCP Server
by kushknows

An MCP server that provides weather data

46 installs/wk local only
Ipma Pt
by pipeworx-io

IPMA Portugal MCP — weather, UV, sea state, and earthquakes from the

36 tools answering
MCP Weather Server
by hyg900928

An MCP server for weather information.

30 installs/wk local only
Weather
by bellvijay

An MCP server for weather information.

29 installs/wk local only

Japan Seasons — questions

Answers built from our own checks of this server.

What can Japan Seasons do?
It exposes 17 tools, read directly from the server on our last check. Among them: festivals_list, fetch, flowers_spots, fruit_farms, fruit_seasons, japan_seasonal_answer and 11 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
What is Japan Seasons mostly used for?
Its tools cluster around sakura, koyo and fruit. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is Japan Seasons working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 89 of 91 checks got a reply (97.8%), average response time 332 ms. The bar chart above shows every period we have measured.
How do I connect Japan Seasons?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Japan Seasons need an API key?
No. Japan Seasons completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 17 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Japan Seasons?
It answers our handshake in 332 ms on average, which is faster than 49% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
How many people use Japan Seasons?
The npm package japan-seasons-mcp was installed 83 times in the last week. Week over week that is +152%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Japan Seasons open source?
Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.