MCPサーバー

RoamTime Japan Foliage Forecast

ai.roamtime/foliage
旅行・ホスピタリティ 公開・接続可能 MCP 2026-07-28

このMCPでできること

Forecasts peak autumn-foliage viewing dates for locations across Japan.

fetch
Fetch a spot forecast
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Spot id (slug) from search.'}}, 'additionalProperties': False}
find_peak_spots
Find foliage spots at peak
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}.
読み取り専用 冪等
入力スキーマ
{'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
Forecast 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?'
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': False}
search
Search foliage spots
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'.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Free-text search query.'}}, 'additionalProperties': False}
追加
fetch
2026年9月17日7:57
追加
search
2026年9月17日7:57
追加
find_peak_spots
2026年9月17日7:57
追加
get_coverage
2026年9月17日7:57