mcpbeat Sign in

Japan Seasons MCP Server

by haomingkoo Your server? Claim it
answering

Japan Seasons is answering right now. Last checked moments ago. 142 installs a week from npm. It exposes 18 tools. Last commit 1 Nov 2026.

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

Installs per day peak 47 · avg 13 · -4% w/w
a month agotoday
Uptime history 91 days of history · worst day 0%
91 days agonow
100.0%
Uptime 24h
92 of 92 checks
18
Tools
read from the server
316 ms
Response time
average over 24h
142
Installs / week
npm and PyPI

What changed 6

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 23 October 2026. No other catalogue keeps this.

26 Oct 2 tool descriptions were rewritten festivals_list, fruit_farms
26 Oct 2 tools changed the parameters they ask for festivals_list, fruit_farms
26 Oct a tool appeared plan_by_date
23 Oct a tool description was rewritten koyo_best_dates

What the code does

We read the source, 6 d ago · tools taken from the live server · rules 995398eba69f

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.

Builds a database query by concatenation almanac/plan.js:133, public/app.js:1379
  const issued = fresh?.issued ? `JMC forecast issued ${fmtDay(isoToDay(fresh.issued))}${fresh.nextUpdate ? `, next update ${fresh.nextUpdate.replace(' (planned)', '')}` : ''}.` : 'Forecast from Japan Meteorological Corporation; observed dates replace forecasts once recorded.';
Page executes code built at runtime [пакет] public/status.html:227, public/status.html:232
      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 0 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}'
Settings → Connectors → Add custom connector, then paste this address
https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={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}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={mapLanguage}"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "japan-seasons": {
      "type": "http",
      "url": "https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={mapLanguage}"
    }
  }
}

Available tools 18

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 JMC forecasts of each city's JMA colouring date (the day JMA's reference tree turns). 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, optionally open on a month or on travel dates. Each farm's season says where it comes from: the farm's own listing, an estimate from other farms' listings in the same region, or the typical national 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 16 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 this year's likely dates (and how sure each date is), places, attendance, official URLs, notes, and GPS coordinates. Pass start_date and end_date to get only events during a trip. 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.
plan
plan_by_date
Use this when the user gives travel dates, optionally with a region, and wants everything seasonal happening then in one answer: the cherry blossom or autumn leaves forecast for those dates, festivals on, and fruit-picking farms open. Each date says how sure it is and where it comes from. For a single topic, use the specific tool instead.
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 311 ms 0 min ago

Alternatives to Japan Seasons

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

NWS MCP — US National Weather Service (no auth)

322 installs/wk 49 tools answering
CitySignal AI
by citysignalai

Live road, transit, weather, power and water signals for US cities, plus your own spots and routes.

23 tools answering
Commutescout
by nicglazkov

Trip planning and best time to leave, with live road data from 37 US states, traffic, weather.

18 tools answering
Travel Agent MCP
by forgemeshlabs

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

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

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

answering
Japan Weather Forecast MCP
by donniertf-hub

Official JMA short-term forecasts by prefecture.

3 tools answering
Weather MCP Server
by kushknows

An MCP server that provides weather data

111 installs/wk local only
US Severe Weather Alerts MCP
by donniertf-hub

Active National Weather Service warnings for any US ZIP code. Free weather_alerts tool.

3 tools answering

Japan Seasons — questions

Answers built from our own checks of this server.

What can Japan Seasons do?
It exposes 18 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 12 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 koyo, sakura 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 92 of 92 checks got a reply (100.0%), average response time 316 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 in the form 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 18 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 316 ms on average, which is faster than 44% 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 142 times in the last week. Week over week that is -4%. 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?
The code is open source: it is published under the MIT licence, written in JavaScript, 1 stars on GitHub and 8 open issues. The licence covers the code in the repository, not the hosted service at seasons.kooexperience.com, which runs on its operator's own terms.