{
  "$schema": "https://json.schemastore.org/mcp.json",
  "name": "triptiming-mcp",
  "version": "1.0.0",
  "title": "TripTiming AI Travel Timing Oracle",
  "description": "Model Context Protocol (MCP) server for TripTiming — precision seasonal travel timing, thermal comfort, crowd carrying capacity, and date-shift arbitrage across 100 global destinations.",
  "homepage": "https://triptiming.xyz/mcp",
  "author": "TripTiming",
  "license": "MIT",
  "transport": {
    "stdio": {
      "command": "npx",
      "args": ["-y", "triptiming-mcp"]
    },
    "http": {
      "endpoint": "https://triptiming.xyz/api/mcp",
      "type": "json-rpc"
    }
  },
  "tools": [
    {
      "name": "get_trip_timing",
      "description": "Query TripTiming empirical travel suitability metrics for any of 100 top global destinations on a specific date or month.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "city": { "type": "string", "description": "City name or slug (e.g. \"kyoto\", \"paris\", \"tokyo\")" },
          "date": { "type": "string", "description": "Specific date in YYYY-MM-DD format" },
          "month": { "type": "integer", "minimum": 1, "maximum": 12, "description": "Calendar month (1-12)" },
          "lens": { "type": "string", "enum": ["sweet_spot", "quiet", "value", "nightlife"] }
        },
        "required": ["city"]
      }
    },
    {
      "name": "check_date_arbitrage",
      "description": "Calculate whether shifting travel dates by ±3 to 21 days unlocks higher comfort, significantly lower crowds, or cheaper accommodation.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "city": { "type": "string" },
          "date": { "type": "string" },
          "radius": { "type": "integer", "default": 21 },
          "lens": { "type": "string", "enum": ["sweet_spot", "quiet", "value", "nightlife"] }
        },
        "required": ["city", "date"]
      }
    },
    {
      "name": "find_golden_destinations",
      "description": "Global Date Radar: Search across 100 destinations worldwide to discover which cities are experiencing their optimal Golden Window for specific travel dates.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "startDate": { "type": "string" },
          "duration": { "type": "integer", "default": 7 },
          "continent": { "type": "string", "enum": ["all", "europe", "asia", "americas", "other"] },
          "lens": { "type": "string", "enum": ["sweet_spot", "quiet", "value", "nightlife"] }
        },
        "required": ["startDate"]
      }
    }
  ]
}