@cyanheads/wsdot-mcp-server

v0.1.9 pre-1.0

Query WA highway conditions, ferry schedules, vessel locations, toll rates, border waits, and alerts via MCP. STDIO or Streamable HTTP.

@cyanheads/wsdot-mcp-server
claude mcp add --transport http wsdot-mcp-server https://wsdot.caseyjhand.com/mcp
codex mcp add wsdot-mcp-server --url https://wsdot.caseyjhand.com/mcp
{
  "mcpServers": {
    "wsdot-mcp-server": {
      "url": "https://wsdot.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http wsdot-mcp-server https://wsdot.caseyjhand.com/mcp
{
  "mcpServers": {
    "wsdot-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/wsdot-mcp-server@latest"
      ]
    }
  }
}
{
  "mcpServers": {
    "wsdot-mcp-server": {
      "type": "http",
      "url": "https://wsdot.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://wsdot.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

12

wsdot_get_mountain_passes

Returns current road conditions for all Washington State mountain passes: status, weather, road condition, traction laws, temperature, and elevation. Includes all ~12 passes (Snoqualmie, Stevens, White, Blewett, Cayuse, etc.). Use for "is the pass open?", traction law status, or winter driving planning.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_mountain_passes",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗

wsdot_search_alerts

Returns active WA highway alerts: incidents, construction, closures, and restrictions. Filter by state route (zero-padded 3-digit number, e.g. "005" for I-5, "090" for I-90, "520" for SR 520), WSDOT region (Northwest, Olympic, Southwest, South Central, North Central, Eastern), or milepost range. Omit all filters to return all current statewide alerts.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_search_alerts",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "stateRoute": {
      "description": "Zero-padded 3-digit state route number (e.g. \"005\" for I-5, \"090\" for I-90, \"520\" for SR 520).",
      "type": "string"
    },
    "region": {
      "description": "WSDOT region name as it appears in alert data: \"Northwest\", \"Olympic\", \"Southwest\", \"South Central\", \"North Central\", or \"Eastern\". Matching is case-insensitive.",
      "type": "string"
    },
    "startMilepost": {
      "description": "Start of milepost range to filter alerts.",
      "type": "number"
    },
    "endMilepost": {
      "description": "End of milepost range to filter alerts.",
      "type": "number"
    }
  },
  "additionalProperties": false
}
view source ↗

wsdot_get_travel_times

Returns current vs. average travel times for named WA highway corridors (I-5, I-90, SR 520, SR 99, I-405, SR 167, etc.). Use for "how congested is I-5?" or commute time estimates. Filter by partial route name (e.g. "I-5", "SR 520") to narrow results. When current time exceeds average, the corridor is congested.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_travel_times",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "route": {
      "description": "Optional text filter applied to corridor names (e.g. \"I-5\", \"SR 520\", \"I-405\"). Case-insensitive. Omit to return all corridors.",
      "type": "string"
    }
  },
  "additionalProperties": false
}
view source ↗

wsdot_get_toll_rates

Returns current dynamic toll rates for WA express lanes and tolled facilities: SR 99 (WSDOT Tunnel), SR 520 Bridge, I-405 Express Lanes, I-90 Two-Way Express Lanes, and SR 167 HOT Lanes. Rates are time-banded and change dynamically based on traffic conditions.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_toll_rates",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗

wsdot_get_border_waits

Returns current vehicle wait times at WA→Canada land border crossings on I-5 (Peace Arch and Pacific Highway, Blaine), SR 539 (Lynden), and SR 9 (Sumas), including Nexus-lane variants. crossingName is a route code (e.g. "I5", "I5Nexus", "SR539"); the readable name is in location.description. Wait times are in minutes; a crossing reporting no current data is omitted. Use for "how long is the border wait?" questions.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_border_waits",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗

wsdot_search_cameras

Returns WSDOT highway camera locations, descriptions, and image URLs. Camera images are copyright WSDOT — only metadata and image URLs are returned, not image bytes. Filter by state route (e.g. "090" for I-90), WSDOT region, or milepost range. Omit all filters to list all cameras statewide (potentially hundreds).

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_search_cameras",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "stateRoute": {
      "description": "Zero-padded 3-digit state route number (e.g. \"005\" for I-5, \"090\" for I-90).",
      "type": "string"
    },
    "region": {
      "description": "WSDOT region code: NW (Northwest), SW (Southwest), OL (Olympic), ER (Eastern), SC (South Central), OS (Olympic South), NC (North Central), or WA (statewide). Matching is case-insensitive.",
      "type": "string"
    },
    "startMilepost": {
      "description": "Start of milepost range to filter cameras.",
      "type": "number"
    },
    "endMilepost": {
      "description": "End of milepost range to filter cameras.",
      "type": "number"
    }
  },
  "additionalProperties": false
}
view source ↗

wsdot_get_ferry_terminals

Returns all WSF ferry terminals with their numeric IDs, names, and abbreviations. Call this first to resolve human-readable terminal names (e.g. "Bainbridge Island", "Seattle", "Kingston") to the numeric terminal IDs required by the schedule and space tools. The terminal list is small (~22 terminals) and rarely changes.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_ferry_terminals",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗

wsdot_get_ferry_routes

Returns the main WSF ferry routes operating on a given date. Route IDs correspond to impactedRouteIds in ferry alerts from wsdot_get_ferry_alerts, though some alert route IDs (seasonal, San Juan interisland, or Sidney B.C.) may not appear in this list. To get terminal IDs for schedule and space lookups, use wsdot_get_ferry_terminals.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_ferry_routes",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "tripDate": {
      "description": "Date for which to list routes, in ISO 8601 format (YYYY-MM-DD). Defaults to today if omitted.",
      "type": "string"
    }
  },
  "additionalProperties": false
}
view source ↗

wsdot_get_ferry_schedule

Returns departure times for a specific WSF ferry route on a given date. Requires numeric terminal IDs — use wsdot_get_ferry_terminals to resolve terminal names to IDs. Set remainingOnly to true to show only future departures for today (useful for "next ferry" queries). For future dates, all sailings for that day are returned.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_ferry_schedule",
    "arguments": {
      "departingTerminalId": "<departingTerminalId>",
      "arrivingTerminalId": "<arrivingTerminalId>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "departingTerminalId": {
      "type": "number",
      "description": "Numeric ID of the departing terminal. Use wsdot_get_ferry_terminals to look up terminal IDs."
    },
    "arrivingTerminalId": {
      "type": "number",
      "description": "Numeric ID of the arriving terminal."
    },
    "tripDate": {
      "description": "Date in ISO 8601 format (YYYY-MM-DD). Defaults to today if omitted.",
      "type": "string"
    },
    "remainingOnly": {
      "description": "When true, returns only future sailings for today. Ignored for future dates. Default: false.",
      "type": "boolean"
    }
  },
  "required": [
    "departingTerminalId",
    "arrivingTerminalId"
  ],
  "additionalProperties": false
}
view source ↗

wsdot_get_vessel_locations

Returns real-time AIS positions, speed, heading, ETA, and dock status for all active WSF vessels. Use for "where is the ferry now?", vessel tracking, or checking if a vessel is in service. Position data may lag by 30–60 seconds. Many fields are null for vessels not currently operating.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_vessel_locations",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗

wsdot_get_terminal_space

Returns real-time drive-up and reservable vehicle space available at WSF terminals for upcoming sailings. Use for "will I make the ferry?" or "how full is the next sailing?" questions. Optionally filter to a specific terminal by ID (use wsdot_get_ferry_terminals for the ID). DriveUpSpaceCount is the key field — zero means the drive-up lane is full.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_terminal_space",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "departingTerminalId": {
      "description": "Filter to a specific terminal by numeric ID. Omit to return all terminals.",
      "type": "number"
    }
  },
  "additionalProperties": false
}
view source ↗

wsdot_get_ferry_alerts

Returns active WSF ferry service disruptions, delays, and bulletins. Each alert includes impacted route IDs — cross-reference with wsdot_get_ferry_routes to resolve route IDs to human-readable route names. Some IDs (seasonal, San Juan interisland, or international Sidney B.C. routes) may not appear in wsdot_get_ferry_routes for a given date.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wsdot_get_ferry_alerts",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
view source ↗