About Wsdot
Wsdot is an MCP server published by michaelpeterswa in the Developer Tools category: mcp server for the wsdot api.
The repository has 1 stars and 0 forks, with the last commit 3 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/michaelpeterswa/mcp-wsdotThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
get_current_timegets the current time in the PDT/PST timezone
Parameters not published.
get_route_schedulesgets the names and route id's for available ferry routes
Parameters not published.
get_schedules_today_by_route_idgets the sailing times for a route by route id
Parameters not published.
Ask AI
Ask AI about Wsdot
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
wsdot library | model context protocol | mcp-go
Development
Prerequisites
- For the best development experience, install bun so the MCP Inspector can be started (using
make mcp)
Building
- Please use
docker composeto run the application locally.- Docker Compose Instructions:
docker compose up -d --build && docker compose logs -f -t
- Docker Compose Instructions:
Run with docker-compose and check Grafana at http://localhost:3000 for metrics/traces.
Transports
The transport is selected with the TRANSPORT environment variable:
TRANSPORT |
description |
|---|---|
streamablehttp |
Default. The current MCP HTTP transport. Use this to host the server remotely (e.g. in Kubernetes). |
stdio |
For local clients that launch the binary directly (Claude Desktop, the MCP Inspector). |
sse |
The legacy HTTP+SSE transport. Deprecated by the MCP spec in favor of streamablehttp; kept only for older clients. |
streamablehttp and sse accept the following additional configuration:
| variable | default | description |
|---|---|---|
HTTP_PORT |
8080 |
Listen port. (SSE_PORT is still honored when HTTP_PORT is unset, for backward compatibility.) |
HTTP_PATH |
/mcp |
Path the MCP endpoint is served on (streamablehttp only). |
MCP_AUTH_TOKEN |
(unset) | When set, every MCP request must send Authorization: Bearer <token>. Unset disables auth. |
MCP_STATELESS |
false |
Disable session tracking so requests can be load balanced across replicas without sticky sessions. |
MCP_HEARTBEAT_INTERVAL |
30s |
Keep-alive interval for idle streams (helps through proxies/ingress). Zero disables it. |
SHUTDOWN_TIMEOUT |
15s |
Grace period for draining in-flight requests on SIGTERM. |
The HTTP transports also expose two unauthenticated health endpoints for
Kubernetes probes: GET /healthz (liveness) and GET /readyz (readiness).
Hosting remotely (Kubernetes)
To host this server in a cluster for a remote client to consume, run the
container with TRANSPORT=streamablehttp (the default) and a bearer token:
docker run -p 8080:8080 \
-e WSDOT_API_KEY=<your-key> \
-e TRANSPORT=streamablehttp \
-e MCP_AUTH_TOKEN=<a-long-random-token> \
ghcr.io/michaelpeterswa/mcp-wsdot:latest
A client then connects to http://<host>:8080/mcp over the streamable HTTP
transport, sending the token as an Authorization: Bearer header. For example,
an OpenClaw remote MCP server entry:
{
"mcpServers": {
"wsdot": {
"transport": "streamable-http",
"url": "https://wsdot.example.com/mcp",
"headers": { "Authorization": "Bearer <a-long-random-token>" }
}
}
}
For deployment guidance — probe paths, ports, and the full environment
variable reference — see the tables above. The container listens on :8080
(MCP) and :8081 (Prometheus metrics, when METRICS_ENABLED=true), runs as a
non-root user, and drains gracefully on SIGTERM.
Current Tools
| tool | description |
|---|---|
get_current_time |
gets the current time in the PDT/PST timezone |
get_route_schedules |
gets the names and route id's for available ferry routes |
get_schedules_today_by_route_id |
gets the sailing times for a route by route id |
MacOS Binary Notes
If you download the binary from the releases page on MacOS, you will need to exempt it from the quarantine security warnings. To do that, run the following command:
xattr -rd com.apple.quarantine <path-to-binary>
Example Question
What is the next three sailings for the Seattle to Bremerton Ferry Route? And the latest I can return tonight?
Asked to Claude Desktop 3.7 Sonnet
I'll help you find the next three sailings for the Seattle to Bremerton route and the latest return option tonight. Let me search for the current ferry schedule.
Now that I have the route information, let me check the specific schedule for the Seattle to Bremerton ferry route:
Based on the schedule information, here are the details you requested:
Next Three Sailings from Seattle to Bremerton:
- 12:20 PM today (April 20, 2025) - Vessel: Walla Walla
- 2:50 PM today (April 20, 2025) - Vessel: Walla Walla
- 5:30 PM today (April 20, 2025) - Vessel: Walla Walla
Latest Return from Bremerton to Seattle Tonight:
The latest sailing from Bremerton to Seattle tonight is at 11:40 PM (23:40) - Vessel: Walla Walla
All sailings are operated by the vessel Walla Walla, which is handicap accessible. This schedule >is part of the Spring 2025 service which runs from March 23 to June 14, 2025.
README fetched from the repository 7 days ago. The original is authoritative.