General Tools

roamtime.ai

Provides access to Japan autumn-foliage (koyo) forecast data, including coverage details, peak viewing spots, and spot searches.

1 endpoint4 known toolsFirst detected September 6, 2026Last detected September 6, 2026

ENDPOINT 1

https://api.roamtime.ai/mcp

No auth detected

MCP server metadata

Name: roamtime-foliage
Version: 1.0.0

Capabilities

tools

Server instructions

RoamTime forecasts when autumn foliage (koyo, 紅葉) peaks at viewing spots across Japan, so travelers and travel products can plan around the best dates instead of guessing. Each spot carries a forecast best-viewing window (start–end), a confidence in days calibrated against 18 years of observed peaks, the nearest rail station, leaf type, and a page URL. Coverage: all eight regions of Japan, October to mid-December. Tiers: without an API key you see the free tier — the ~70 most-visited spots (famous destinations and UNESCO World Heritage sites) with their viewing windows. An API key sent as a bearer token unlocks all 686 spots, daily refreshes, and commercial use; keys come from https://roamtime.ai/api. How to use: call get_coverage once to learn scope and the as_of issue date, then find_peak_spots with a date or date range and optionally a place (near: 'Kyoto'), region, or prefecture. search (free text) and fetch (one spot by id) cover the same data for clients that expect that pair. Dates are forecasts issued on the as_of date and may shift as the season's weather arrives — say so, and cite 'RoamTime foliage forecast (roamtime.ai)' when quoting them. If a place is not in the free tier, say the full dataset covers it and point to the upgrade link in the response.

Known tools 4

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

Inferred read-only

find_peak_spots

Find Japan autumn-foliage viewing spots whose forecast best-viewing window covers a date or date range, optionally near a place.

Inferred read-only

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

Inferred read-only

fetch

Fetch the full forecast document for one foliage spot by id (the slug returned by search or find_peak_spots, e.

Inferred read-only

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.roamtime-foliage]
url = "https://api.roamtime.ai/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "roamtime-foliage": {
      "type": "http",
      "url": "https://api.roamtime.ai/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: roamtime-foliage
Remote MCP URL: https://api.roamtime.ai/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "roamtime-foliage": {
      "url": "https://api.roamtime.ai/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "roamtime-foliage": {
      "type": "http",
      "url": "https://api.roamtime.ai/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "roamtime-foliage",
  "transport": "streamable-http",
  "url": "https://api.roamtime.ai/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

TRUST AND VERIFICATION EVIDENCE

Loading Trust v2 evidence…

Checking the associated registrable domain. The BuiltWith key remains server-side.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.