onebusaway-mcp-server — Claude Code MCP server: real-time transit
MCP server for querying stops, routes, arrivals, vehicle positions, and schedules through OneBusAway APIs. Pre-configured for Puget Sound, works with any OneBusAway instance.
Apache-2.0 1,254 installs ★ 2 updated 2026-10-09
claude mcp add --transport http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.toolsWhat onebusaway-mcp-server does
The server exposes 16 tools: stop and route lookup by coordinates or name (onebusaway_find_stops, onebusaway_search_routes), live arrivals with schedule deviation and vehicle positions (onebusaway_get_arrivals), full-day schedules for stops or routes, active vehicle positions for an agency, trip and block data (a vehicle's sequence of trips over a service day). Two resources return stop and route metadata.
Installation via the public HTTP server at https://onebusaway-mcp-server--cyanheads.run.tools requires no API key. If the OneBusAway instance lacks a route-search endpoint (Puget Sound included), onebusaway_search_routes will return endpoint_unavailable — use onebusaway_find_routes or onebusaway_list_routes_for_agency instead.
Every tool returns a limitExceeded flag when the upstream API caps the result list; there is no pagination to fetch the remainder. Tools onebusaway_get_stop and onebusaway_get_route throw stop_not_found and route_not_found on unknown IDs.
What it helps with
- check arrival times at a stop with live schedule deviations
- locate routes within a radius of coordinates
- track an agency's active vehicles in real time
- retrieve the stop sequence for a trip
- verify wheelchair accessibility of a stop
Example prompts for the agent
- Find stops within 500 meters of 47.6062, -122.3321
- Show live arrivals at stop
1_75403with schedule deviation - Where are the buses for route
1_100479operated by King County Metro right now
How to install onebusaway-mcp-server
Platform CLI: remote server
claude mcp add --transport http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add onebusaway-mcp-server --url https://onebusaway-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"onebusaway-mcp-server": {
"url": "https://onebusaway-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"onebusaway-mcp-server": {
"type": "http",
"url": "https://onebusaway-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about onebusaway-mcp-server
How to install onebusaway-mcp-server in Claude Code?
Run claude mcp add --transport http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.tools.
What does onebusaway-mcp-server do?
Provides access to public transit data through OneBusAway APIs: stops, routes, live arrivals, vehicle positions, and schedules. 16 tools for searching, querying, and monitoring transit.
What does onebusaway-mcp-server require to work?
The public HTTP server at https://onebusaway-mcp-server--cyanheads.run.tools needs no API key. It is configured for Puget Sound but works with any OneBusAway instance.