RoamTime Japan Foliage Forecast
v1.0.0Forecast peak autumn-foliage dates for viewing spots across Japan. Free tier, no key.
Endpoint health
online- Last checked
- 11/20/2026, 5:16:25 AM
- Latency
- 41 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:ai.roamtime%2Ffoliage
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"ai.roamtime/foliage": {
"url": "https://api.roamtime.ai/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
Fetch a spot forecast
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.
Schema valid · SHA-256 02b8ee7ce750…
View input schema
{ "type": "object", "properties": { "id": { "type": "string", "description": "Spot id (slug) from search." } }, "required": [ "id" ], "additionalProperties": false }Find foliage spots at peak
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}.
Schema valid · SHA-256 c279062e3fd5…
View input 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 }
Connections
streamable-http
https://api.roamtime.ai/mcp