RoamTime Japan Foliage Forecast

Working · 1.6 s

ai.roamtime/foliagev1.0.0 Domain verified

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

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.roamtime.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

fetch Read-only

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.

idstring, required

Spot id (slug) from search.

Tools (4)

fetch

read-only

Argument	Type	Description
id*	string	Spot id (slug) from search.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Spot id (slug) from search."
    }
  },
  "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}.

read-only

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

Input schema (JSON)

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

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?'

read-only

No arguments.

Input schema (JSON)

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

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'.

read-only

Argument	Type	Description
query*	string	Free-text search query.

Input schema (JSON)

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