Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.tools
Open on GitHub

What 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_75403 with schedule deviation
  • Where are the buses for route 1_100479 operated 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.tools

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open