wsdot-mcp-server
Public Hosted Server: https://wsdot.caseyjhand.com/mcp
Overview
Washington State roads and ferries from WSDOT. Check mountain passes, travel times, tolls, border waits, alerts, and traffic cameras, and track ferry schedules, fares, vessel locations, and terminal space.
Tools
Tool | Description |
| Current conditions for all WA mountain passes: status, road condition, traction laws, temperature, elevation. |
| Active highway alerts — incidents, construction, closures — filterable by state route, WSDOT region, and milepost range. |
| Current vs. average travel times for named WA highway corridors (I-5, I-90, SR 520, etc.) with congestion delay. |
| Dynamic toll rates for WA express lanes and tolled facilities — SR 99, SR 167 HOT, I-405 Express, SR 509, SR 520 — filterable by route. |
| Current vehicle wait times at all WA/Canada land border crossings. |
| Highway camera metadata and image URLs, filterable by state route, region, milepost range, and title words. |
| All WSF ferry terminals with numeric IDs needed for schedule, fare, and space lookups, plus coordinates. |
| WSF routes operating on a given date — route ID, abbreviation, description, and the terminal pairs each serves, for route discovery, schedule lookups, and ferry-alert cross-reference. |
| Departure times for a specific WSF route — today-remaining or full-day future mode — with each sailing's vessel, loading rule, and notes. |
| WSF fares for a terminal pair on a date — passenger, vehicle and driver by length, motorcycle, bicycle, and multi-ride card line items, one way or round trip, with WSF's statement of which terminal collects which fares. |
| Real-time AIS positions, speed, heading, ETA, and dock status for all active WSF vessels. |
| Drive-up and reservable vehicle space available for upcoming sailings, at the terminals WSF reports space for. |
| Active WSF service disruptions and bulletins with impacted route IDs. |
Resources
Resource | Description |
| Ferry trip guidance for combining schedules, fares, alerts, space, and vessel positions. |
Related MCP server: @cyanheads/onebusaway-mcp-server
Capability reference
skill://wsdot-guide/SKILL.md resource
Ferry trip guidance for combining schedules, fares, service alerts, live vehicle space, and vessel positions. Also included in plugin installs as
wsdot-guide.
wsdot_get_mountain_passes tool
No input — current conditions for all 16 WA mountain passes (Snoqualmie, Stevens, White, Blewett, Cayuse, and others) in one call
Each pass carries road condition, weather, temperature, elevation, and up to two directional traction/travel restrictions
wsdot_search_alerts tool
Optional
stateRoute,region(Northwest, Olympic, Southwest, South Central, North Central, Eastern), andstartMilepost/endMilepost— an alert matches when its extent overlaps the range; omit all for every statewide alert. Ordered byalertId, paged (default 20; a largerlimitreturns at most 500 with a notice)headlineDescriptionandextendedDescriptionrender incontent[]one line at a time, each trimmed and escaped, with a run of blank lines becoming one paragraph break; the headline's first line is the alert's heading.structuredContentkeeps the raw textAn unknown region fails as
invalid_regionand a start above the end asinvalid_milepost_range, each with a recovery hint
wsdot_get_travel_times tool
Optional
route— a route designation ("I-5","5","SR 520") returns corridors that start or end on that route or write it in their name ("via 520"), never digits inside another number ("5"does not match I-405 or SR 522); other text matches corridor names ("Everett","1A"), and the first number in it, read as a route, also matches every corridor that starts or ends on that route, in both directions —"I-405 southbound"returns northbound I-405 corridors too, since the direction word is not applied. A designation that matches nothing gets a notice saying so. Paged (default 50; a largerlimitreturns at most 500 with a notice)Each corridor reports current and average minutes — current above average means congestion, and the delta is the delay. A reversible express-lane corridor closed in the queried direction omits its figures rather than reporting zero
wsdot_get_toll_rates tool
Covers SR 99 (WSDOT Tunnel), SR 167 HOT Lanes, I-405 Express Lanes, the SR 509 tolled segment, and the SR 520 Bridge. Optional
stateRoutematches the posted designation ("I-405","SR 520"); a route with no tolled facility returns an empty page whose notice names the tolled routes. Paged (default 50; a largerlimitreturns at most 500 with a notice)Each row leads with its
startLocationName → endLocationNamesegment.stateRouteis the feed's bare zero-padded number ("099") andtravelDirectionthe feed's code, which SR 99, SR 509, and SR 520 fix per facility — read direction from the segment's ends
wsdot_get_border_waits tool
No input — eleven lane entries in
crossings[]across I-5 (Peace Arch), SR 543 (Pacific Highway), SR 539 (Lynden), and SR 9 (Sumas): a general-purpose and a Nexus lane at each, plus truck lanes at SR 539 and SR 543crossingNameis a route code (I5,SR543Trucks) andlocation.descriptionthe readable name; a lane with no current data omitswaitTimeInMinutes
wsdot_search_cameras tool
Optional
stateRoute,regioncode (NW,SW,OL,ER,SC,NC,OSfor the Oregon TripCheck cameras,WAfor airport cameras),startMilepost/endMilepost, andtitleContains(every word, any order). Ordered bycameraId, paged (default 50; a largerlimitreturns at most 500 with a notice)A milepost bound matches the feed's
milePostor the milepost written in the title (titleMilePost); a camera with nomilePostis always included. On theAirportsroad name,milePostis a position in WSDOT's airport list (1 = Anacortes, 4 = Bellingham), not a milepostReturns metadata and image URLs, not image bytes. Each image belongs to the owner the camera lists (
owner,ownerUrl), and to WSDOT when none is listed. An unknown region fails asinvalid_regionand a reversed range asinvalid_milepost_range
wsdot_get_ferry_terminals tool
No input — all 20 WSF terminals, each with its numeric ID, abbreviation, and latitude/longitude
Resolves names ("Bainbridge Island", "Seattle") to the IDs
wsdot_get_ferry_schedule,wsdot_get_ferry_fares, andwsdot_get_terminal_spacetake
wsdot_get_ferry_routes tool
Optional
tripDate(YYYY-MM-DD, default today); a date outside the range WSF has published fails asinvalid_datestating that rangeEach route carries its ID (the
impactedRouteIdsofwsdot_get_ferry_alerts), abbreviation, description, andterminalPairs— the departing → arriving pairswsdot_get_ferry_scheduleandwsdot_get_ferry_faresaccept that day. The whole call runs under a 50-second deadline; one that spends it fails asretry_deadline_exceededwith a retry hint
wsdot_get_ferry_schedule tool
Requires
departingTerminalIdandarrivingTerminalId(a pair fromterminalPairsonwsdot_get_ferry_routes); optionaltripDate(default today) andremainingOnly(future departures only, today only)Each sailing carries
departureTime/arrivalTimein ISO 8601 UTC (tripDateis the Pacific service day) besidedepartureTimeLocal/arrivalTimeLocal, the same instant with its Pacific offset (2026-11-05T05:30:00.000-08:00);content[]renders<local> (<UTC>). Each also hasserviceDate,vesselId,loadingRule, and indexes into the pair'sannotations. There is no cancellation flag — WSF drops a cancelled sailing, so checkwsdot_get_ferry_alertsWith
remainingOnly, a query before 03:00 Pacific also lists the previous service day's sailings still to depart, first, each carrying that day'sserviceDate. When that day's schedule can't be read, a notice says so and the list holds today's sailings onlyA pair with no schedule that day fails as
invalid_terminal_pairand a date with none asinvalid_date, never as an empty schedule. The whole call runs under a 50-second deadline; one that spends it fails asretry_deadline_exceededwith a retry hint
wsdot_get_ferry_fares tool
Requires
departingTerminalIdandarrivingTerminalId(a pair fromterminalPairsonwsdot_get_ferry_routes); optionaltripDate(default today) androundTrip(WSF's round-trip total for a trip starting at the departing terminal; default one way)Returns every fare line item — passenger, senior and youth, vehicle and driver by length, motorcycle, bicycle, multi-ride cards — with
amountInDollarsas WSF gives it, in WSF's orderWSF collects most fares at one terminal only, so a line reads
0on a leg whose departing terminal doesn't collect it.collectionDescriptionis WSF's statement of which terminal collects which fares, and it leadscontent[]; read it before quoting a0as free travel, and query the reverse direction to see where the fare is charged. If that statement can't be read, the fares still return and a notice says soA pair with no fares that day fails as
invalid_terminal_pairand a date WSF has no fares for asinvalid_date. The whole call runs under a 50-second deadline; one that spends it fails asretry_deadline_exceededwith a retry hint
wsdot_get_vessel_locations tool
No input — position, speed, heading, ETA, and dock status for every active WSF vessel
Positions may lag 30–60 seconds; many fields are absent for a vessel not in service, and one between assignments reports
opRouteAbbrevasnone reportedleftDock,eta,scheduledDeparture, andtimestampstay in UTC besideleftDockLocal,etaLocal,scheduledDepartureLocal, andtimestampLocal, the same instants in Pacific time
wsdot_get_terminal_space tool
Optional
departingTerminalId(fromwsdot_get_ferry_terminals), else every terminal WSF reports space for; paged by terminal (default 5; a largerlimitreturns at most 20 with a notice), with every sailing of a returned terminal includedWSF publishes space for select terminals only (12 of 20 on 2026-11-12), and at times for none. A terminal missing from the feed has unconfirmed space rather than a wrong ID: an empty feed and an uncovered terminal ID each return an empty page whose notice says which, the second listing the terminals the feed covers. Departure times carry a
departureLocalPacific siblingdriveUpSpaceCountis the key field — zero means the drive-up lane is full, and an oversubscribed sailing's negative upstream count floors to zero.arrivingTerminalIdschains intowsdot_get_ferry_schedule
wsdot_get_ferry_alerts tool
No input — active WSF disruptions, delays, and bulletins, each with
alertTitle, a one-linealertDescription, and the fullbulletinText(detail such as a replacement sailing appears only in the body)publishDatecarries apublishDateLocalPacific sibling;impactedRouteIdsmap towsdot_get_ferry_routes;affectsAllRoutes: truemarks a fleet-wide alert, whose empty route list then means every route
Features
Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
WSDOT-specific:
Dual API integration — WSDOT Traffic API and WSF Ferry API share a single
WSDOT_ACCESS_CODECross-tool linking built into tool descriptions — ferry tools point to
wsdot_get_ferry_terminals/wsdot_get_ferry_routesfor ID resolution before a lookupNormalized response shapes across both APIs — sparse upstream fields surface as optional rather than omitted or defaulted
Stable pagination — the alert and camera feeds return the same set in more than one row order upstream, so results are sorted by ID to keep a given offset reproducible
Paged list tools take
offset/limit; a page ends only atlimitor at the end of the set, and a notice names the next offset. Alimitabove a tool's maximum returns the maximum with a notice, or is rejected whenWSDOT_CLAMP_LIMITS=falseRoute filters take the forms people write —
"I-90","90","090","SR 520"— and every text filter accepts at most 200 characters
Agent-friendly output:
Typed failure —
invalid_access_codeandapi_unavailableerrors carry an explicit recovery hint distinguishing configuration faults from transient upstream onesdriveUpSpaceCount: 0and congestion delta fields (delayInMinutes) give agents actionable signal without string parsingPlain text from HTML — alert descriptions, sailing notes, and bulletins arrive from upstream as HTML and are returned as text, with links inline as
link text (url)Partial data preserved — sparse upstream payloads surface
null/undefinedrather than synthetic defaults (e.g. an omittedwaitTimeInMinutes, an absentarrivalTime)content[]andstructuredContentcarry the same values, not just the same fields — afalseflag, an empty list, and one populated half of a coordinate pair all render rather than dropping out of the markdown surface that some clients read; a blank or whitespace-only upstream string is absent from both, and a populated one arrives trimmed
Getting started
Connect to the hosted instance, no install:
claude mcp add --transport http wsdot-mcp-server https://wsdot.caseyjhand.com/mcpOr run it locally:
claude mcp add wsdot-mcp-server -e WSDOT_ACCESS_CODE=your-access-code -- npx -y @cyanheads/wsdot-mcp-serverFor other clients, add this to the MCP config file:
{
"mcpServers": {
"wsdot-mcp-server": {
"command": "npx",
"args": ["-y", "@cyanheads/wsdot-mcp-server"],
"env": {
"WSDOT_ACCESS_CODE": "your-access-code"
}
}
}
}Get a free access code at wsdot.wa.gov/Traffic/api/. For Docker or a source build, see Running the server.
Configuration
All configuration is validated at startup via Zod schemas in src/config/server-config.ts. Key environment variables:
Variable | Description | Default |
| Required. WSDOT Traveler API access code. Register at wsdot.wa.gov/Traffic/api/. | — |
| Optional. Clamp a paged tool's |
|
| Transport: |
|
| HTTP server port. |
|
| HTTP server hostname. |
|
| HTTP endpoint path. |
|
| Public origin for TLS-terminating reverse-proxy deployments. | — |
| Session handling: |
|
| Authentication: |
|
| Log level ( |
|
| Directory for log files (Node.js only). |
|
| Storage backend: |
|
| Log each failed tool call's arguments and result (key-name redaction only). |
|
| Enable OpenTelemetry instrumentation (spans, metrics, completion logs). |
|
| OTLP base URL; traces go to | — |
| Opt-in OTLP log export; the base endpoint never enables it. | — |
See .env.example for the full list of optional overrides.
Running the server
Local development
Requires Bun v1.4.4 or higher (or Node.js v24+).
Clone and install:
git clone https://github.com/cyanheads/wsdot-mcp-server.git cd wsdot-mcp-server && bun install cp .env.example .env # set WSDOT_ACCESS_CODEBuild and run:
# One-time build bun run rebuild # Run the built server bun run start:stdio # or bun run start:httpRun checks and tests:
bun run devcheck # Lint, format, typecheck, security bun run test # Vitest test suite bun run lint:mcp # Validate MCP definitions against spec
Docker
docker run --rm -e WSDOT_ACCESS_CODE=your-access-code -p 3010:3010 ghcr.io/cyanheads/wsdot-mcp-server:latestThe image defaults to HTTP transport, stateless session mode, and logs to /var/log/wsdot-mcp-server. For stdio, use docker run -i --rm -e MCP_TRANSPORT_TYPE=stdio -e WSDOT_ACCESS_CODE=your-access-code ghcr.io/cyanheads/wsdot-mcp-server:latest. To build locally, run docker build -t wsdot-mcp-server .; OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
Project structure
Directory | Purpose |
|
|
| Server-specific environment variable parsing and validation with Zod. |
| Tool definitions ( |
| WSDOT Traffic API service (mountain passes, alerts, travel times, toll rates, border waits, cameras). |
| WSF Ferry API service (terminals, routes, schedule, fares, vessel locations, space, alerts). |
| Published ferry trip guide, also served as an MCP skill resource. |
| Unit and integration tests, mirroring the |
Development guide
See CLAUDE.md for development guidelines and architectural rules. The short version:
Handlers throw, framework catches — no
try/catchin tool logicUse
ctx.logfor request-scoped logging,ctx.statefor tenant-scoped storageRegister new tools in the
createApp()arrays insrc/index.tsWrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields
Contributing
Issues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run testLicense
Apache-2.0 — see LICENSE for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
US & Canada 511 road data: incidents, closures, cameras, truck restrictions. Paid API key.
Transport for NSW MCP — journey planning, live departures, service alerts and commuter car-park…
NJ Transit rail, bus and PATH schedules via MCP (scheduled, plus live PATH)
Look up PUBLIC vehicle and traffic data from official sources, the same information a citizen access
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides real-time access to BC highway conditions, road closures, weather alerts, and traffic incidents through the Open511-DriveBC API with smart caching.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying stops, routes, real-time arrivals, vehicle positions, and schedules from OneBusAway transit APIs via MCP, supporting STDIO or Streamable HTTP.149 npm2Apache 2.0
- AlicenseAqualityBmaintenanceProvides live California road conditions, route planning, and an AI assistant over MCP, enabling natural-language queries about traffic, closures, chain controls, and more.185MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying real-time BART and SF Muni transit data, including departures, trip planning, fares, advisories, routes, alerts, vehicle positions, and schedules, from any MCP-compatible client.1MIT