RoamTime Japan Foliage Forecast

Official4 tools

by roamtime

Forecast peak autumn-foliage dates for viewing spots across Japan. Free tier, no key.

ai.roamtime/foliage — Model Context Protocol (MCP) Server

This MCP server, ai.roamtime/foliage, provides functionality to forecast peak autumn-foliage dates for viewing spots across Japan. The service is offered on a free tier and is described as having no key requirement.

🛠️ Key Features

Forecasts peak autumn-foliage dates
Targets viewing spots across Japan
Operates under a free tier with no key requirement
Exposed via 4 tools

🚀 Use Cases

Planning visits around peak autumn foliage in Japan
Checking expected peak viewing dates for specific locations

⚡ Developer Benefits

Fixed capability scope: foliage peak date forecasting for Japan
No API key dependency indicated for the free tier
Available through 4 MCP tools

⚠️ Limitations

Limited to peak autumn-foliage date forecasting (no other described domains)

Captured live from the server via tools/list.

get_coverage

Describe what the RoamTime Japan autumn-foliage (koyo) forecast covers: forecast year and issue date, season span, regions and prefectures, spot count, and the access tier (free tier or full dataset). Call this first to orient yourself, to check whether a place or date is in scope, and to learn the as_of date to cite. Takes no arguments. Example prompts: 'What does the RoamTime foliage forecast cover?', 'Is Hokkaido included?'

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

find_peak_spots

Find Japan autumn-foliage viewing spots whose forecast best-viewing window covers a date or date range, optionally near a place. Use it for 'where should I go on <date>?', 'when does <place> peak?', and 'is <spot> still at peak on <date>?' questions. Give a date (or date_from/date_to) plus optionally a location: near (city or prefecture name, e.g. 'Kyoto') or lat/lon, with radius_km; or restrict by region or prefecture. Returns each spot's forecast peak window (start–end), confidence in days, nearest rail station, leaf type, and a page URL, sorted by prominence then proximity. Example prompts: 'Which foliage spots near Kyoto peak on 20 November?', 'Best koyo in Tohoku the first week of November', 'Is Nikko past peak by 1 December?'. Example call: {date: '2026-11-20', near: 'Kyoto', radius_km: 60}.

Parameters11

date	string	optional	Target date, YYYY-MM-DD. Use this OR date_from/date_to.
date_from	string	optional	Start of a date range, YYYY-MM-DD (pair with date_to).
date_to	string	optional	End of a date range, YYYY-MM-DD (pair with date_from).
near	string	optional	City or prefecture name to search around, e.g. 'Kyoto', 'Nikko', 'Aomori'.
lat	number	optional	Latitude, alternative to near.
lon	number	optional	Longitude, alternative to near.
radius_km	number	optional	Search radius around the location in km. Default 60 (day-trip range).
region	string	optional	Restrict to one region of Japan.
prefecture	string	optional	Restrict to one prefecture, e.g. 'Aomori'.
status	string	optional	'peak' (default): spots whose best-viewing window covers the date(s). 'any': no status filtering, statuses labeled.
limit	number	optional	Max results, default 10, max 25.

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Target date, YYYY-MM-DD. Use this OR date_from/date_to."
    },
    "date_from": {
      "type": "string",
      "description": "Start of a date range, YYYY-MM-DD (pair with date_to)."
    },
    "date_to": {
      "type": "string",
      "description": "End of a date range, YYYY-MM-DD (pair with date_from)."
    },
    "near": {
      "type": "string",
      "description": "City or prefecture name to search around, e.g. 'Kyoto', 'Nikko', 'Aomori'."
    },
    "lat": {
      "type": "number",
      "description": "Latitude, alternative to near."
    },
    "lon": {
      "type": "number",
      "description": "Longitude, alternative to near."
    },
    "radius_km": {
      "type": "number",
      "description": "Search radius around the location in km. Default 60 (day-trip range)."
    },
    "region": {
      "type": "string",
      "enum": [
        "Hokkaido",
        "Tohoku",
        "Kanto",
        "Chubu",
        "Kansai",
        "Chugoku",
        "Shikoku",
        "Kyushu"
      ],
      "description": "Restrict to one region of Japan."
    },
    "prefecture": {
      "type": "string",
      "description": "Restrict to one prefecture, e.g. 'Aomori'."
    },
    "status": {
      "type": "string",
      "enum": [
        "peak",
        "any"
      ],
      "description": "'peak' (default): spots whose best-viewing window covers the date(s). 'any': no status filtering, statuses labeled."
    },
    "limit": {
      "type": "number",
      "description": "Max results, default 10, max 25."
    }
  },
  "additionalProperties": false
}

search

Search Japan autumn-foliage viewing spots by free text: a spot name (English or Japanese), a prefecture, a region, or a month such as 'November'. Returns matching spot ids, titles, and page URLs; pass an id to fetch for the full forecast. Example queries: 'Kyoto', 'Nikko', '奥入瀬', 'Tohoku November'.

Parameters1

query

string

required

Free-text search query.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search query."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

fetch

Fetch the full forecast document for one foliage spot by id (the slug returned by search or find_peak_spots, e.g. 'tenryuji-temple'): peak window, confidence, status, nearest rail station, leaf type, and page URL.

Parameters1

string

required

Spot id (slug) from search.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Spot id (slug) from search."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Install

Tools (4)

get_coveragefind_peak_spotssearchfetch

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.roamtime.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "foliage": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.roamtime.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.roamtime/foliage — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_coverage

find_peak_spots

search

fetch

Install

Remote endpoint

Related servers