MCP server

Onebusaway

io.github.cyanheads/onebusaway-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Real-time transit stops, routes, arrivals, vehicle positions, and schedules via OneBusAway APIs.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

16

Token cost

About 4,753 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http onebusaway-mcp-server https://onebusaway.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.onebusaway-mcp-server]
url = "https://onebusaway.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"onebusaway-mcp-server":{"httpUrl":"https://onebusaway.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"onebusaway-mcp-server":{"url":"https://onebusaway.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"onebusaway-mcp-server":{"type":"http","url":"https://onebusaway.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add onebusaway-mcp-server https://onebusaway.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"onebusaway-mcp-server","server_url":"https://onebusaway.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"onebusaway-mcp-server","server_url":"https://onebusaway.caseyjhand.com/mcp"}

Tools

• onebusaway_find_routes ~397 tokens
  Find transit routes near a location, optionally filtered by name or number. Returns routes with IDs, short names, and descriptions. Use routeId values to fetch schedules, vehicles, or stop sequences.
• onebusaway_find_stops ~328 tokens
  Find bus stops near a location. Returns stops within a radius, each with ID, name, direction, served routes, and wheelchair boarding status. Use stopId values from results to fetch real-time arrivals with onebusaway_get_arrivals. Optionally filter by stop code (the number printed on the stop sign, e
• onebusaway_get_alert ~191 tokens
  Fetch full detail for a service alert (situation) by ID. Returns the summary, description, reason (e.g. detour, construction), affected stops and routes, consequence description, and active time windows. Situation IDs appear in onebusaway_get_arrivals responses under situationIds and situations[].id
• onebusaway_get_arrivals ~368 tokens
  Real-time arrivals and departures at a stop. Returns predicted arrival times, schedule deviation (how many seconds late/early), vehicle positions, and any active service alerts. The predicted boolean on each arrival indicates whether GPS tracking backs the estimate — predicted=false means schedule-o
• onebusaway_get_block ~436 tokens
  Fetch block trip sequences with their stop times and service-calendar conditions. Top-level fields describe the first returned configuration; every remaining alternative is included without choosing a calendar date. Optionally select an exact tripId or complete trips having any departure in a half-o
• onebusaway_get_route ~164 tokens
  Fetch details for a specific route by ID. Returns short name, description, agency, route type, and schedule URL. Route IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_100259").
• onebusaway_get_schedule_for_route ~537 tokens
  Full-day schedule for a route — all trips, stop sequences, and departure times for the specified date (defaults to today). Optionally select an exact tripId or complete trips having any departure in a half-open GTFS-seconds interval; selection includes counts before and after filtering. Without sele
• onebusaway_get_schedule_for_stop ~516 tokens
  Full-day departure schedule for a stop. Lists every departure by route and direction for the specified date (defaults to today). Optionally filter departure rows by routeId and a half-open Unix-millisecond interval; selection includes counts before and after filtering. Without selectors, returns the
• onebusaway_get_stop ~194 tokens
  Fetch details for a specific stop by ID. Returns the stop's name, coordinates, direction, served routes, and wheelchair accessibility. Stop IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_75403" for Metro Transit stop 75403).
• onebusaway_get_stop_context ~401 tokens
  Everything happening at a stop in one call: the stop's details, its real-time arrivals, and full detail for every service alert on the stop or on any arrival in the window. Returns what onebusaway_get_stop, onebusaway_get_arrivals, and one onebusaway_get_alert call per alert would, from a single ups
• onebusaway_get_trip ~259 tokens
  Real-time status and stop sequence for a trip. Returns vehicle position, schedule deviation, current phase, and remaining stops. Use tripId from onebusaway_get_arrivals to look up a specific vehicle's progress.
• onebusaway_get_vehicles ~252 tokens
  Real-time positions of active vehicles for an agency. Optionally filter to a single route (client-side). Returns GPS coordinates, counter-clockwise orientation from east, schedule deviation, and current trip. Reports agency records omitted for missing position coordinates. Use agencyId values from o
• onebusaway_list_agencies ~120 tokens
  List all transit agencies served by this OneBusAway instance. Returns agency IDs, names, contact info, timezone, and geographic coverage center. Agency IDs are needed for onebusaway_list_routes_for_agency and onebusaway_get_vehicles.
• onebusaway_list_routes_for_agency ~175 tokens
  List all routes operated by an agency. Returns route IDs, short names, and descriptions. Use to enumerate an agency's full service before searching for a specific route. Get agencyId values from onebusaway_list_agencies.
• onebusaway_search_routes ~211 tokens
  Search for routes by name or number. Returns matching routes with IDs. Use to resolve a route short name (e.g. "44") to a route ID for schedule or vehicle lookups with onebusaway_get_vehicles or onebusaway_get_schedule_for_route.
• onebusaway_search_stops ~204 tokens
  Search for stops by name or code. Returns matching stops with IDs and coordinates. Use to resolve a human-readable stop name or number to a stop ID for arrivals lookups with onebusaway_get_arrivals.

Browse

• GitHub tools
• Calendars
• GitHub and code hosting

Related MCP servers

• Transit MCP
  Trips, departures, alerts and vehicles for NYC, DC and the SF Bay Area.
• Wmata
  WMATA MCP.
• Cta
  CTA MCP — Chicago Transit Authority real-time trains ('L') + buses
• Trimet
  TriMet MCP — live arrivals, stop lookup, vehicle positions and service
• Lviv Public Transport
  Lviv public transport MCP: stops, timetables, routes, and live vehicle positions. No API key.
• Fleet Route Optimizer
  Splits deliveries across vehicles and orders each route: time windows, capacities, road times. Free.
• 511 Sf Bay
  511 SF Bay Transit MCP — live departures, vehicle positions and service alerts for every transit…
• Mbta
  MBTA MCP — Boston real-time transit via the MBTA v3 API (api-v3.mbta.com)

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/onebusaway-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/onebusaway-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents