@triptiming/mcp (triptiming-mcp)

Official Model Context Protocol (MCP) server for TripTiming — the precision seasonal travel timing intelligence oracle.

Evaluate empirical travel timing metrics, crowd carrying capacities, thermal comfort, and date-shift arbitrage across 100 global benchmark destinations.

Quickstart

Run directly without installation:

npx -y triptiming-mcp

Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "triptiming": {
      "command": "npx",
      "args": ["-y", "triptiming-mcp"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Add this to your .cursor/mcp.json (or Cursor Settings > Features > MCP):

{
  "mcpServers": {
    "triptiming": {
      "command": "npx",
      "args": ["-y", "triptiming-mcp"]
    }
  }
}

Smithery

Install with one command:

npx -y @smithery/cli install triptiming-mcp --client claude

Available Tools

1. get_trip_timing

Query TripTiming empirical travel suitability metrics for any destination on a specific date or month.

• Parameters:
  • city (string, required): e.g. "kyoto", "tokyo", "paris", "rome"
  • date (string, optional): "YYYY-MM-DD"
  • month (integer, optional): 1 to 12
  • lens (string, optional): "sweet_spot" | "quiet" | "value" | "nightlife"

2. check_date_arbitrage

Calculate whether shifting travel dates by $\pm 3$ to $21$ days unlocks higher comfort, significantly lower crowds, or cheaper accommodation.

• Parameters:
  • city (string, required)
  • date (string, required): "YYYY-MM-DD"
  • radius (integer, optional): Search radius in days (default: 21)
  • lens (string, optional)

3. find_golden_destinations

Global Date Radar: Search across 100 destinations worldwide to discover which cities are experiencing their optimal Golden Window for specific travel dates.

• Parameters:
  • startDate (string, required): "YYYY-MM-DD"
  • duration (integer, optional): Trip duration in days (default: 7)
  • continent (string, optional): "all" | "europe" | "asia" | "americas" | "other"
  • lens (string, optional)

License

MIT © TripTiming