Skip to content
Agentmart
Submit a tool

Onebusaway MCP Server

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

Connector by cyanheads · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)Remote (HTTP)★ 1
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/cyanheads-onebusaway-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://onebusaway.caseyjhand.com/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
16 read · 0 write · 0 deleteRead-only
Secrets
1 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 16

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 16 · Look things up without changing anything.

  • onebusaway_find_routes
  • onebusaway_find_stops
  • onebusaway_get_alert
  • onebusaway_get_arrivals
  • onebusaway_get_block
  • onebusaway_get_route
  • onebusaway_get_schedule_for_route
  • onebusaway_get_schedule_for_stop
  • onebusaway_get_stop
  • onebusaway_get_stop_context
  • onebusaway_get_trip
  • onebusaway_get_vehicles
Show 4 more tools
  • onebusaway_list_agencies
  • onebusaway_list_routes_for_agency
  • onebusaway_search_routes
  • onebusaway_search_stops

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • ONEBUSAWAY_API_KEY

Other settings (environment variables or headers).

  • MCP_LOG_LEVEL
  • ONEBUSAWAY_BASE_URL
  • ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS
  • ONEBUSAWAY_RATE_LIMIT_REQUESTS
  • ONEBUSAWAY_RATE_LIMIT_WINDOW_MS

Network hosts it talks to 1

  • onebusaway.caseyjhand.com · found in remote endpoint, install command

Tools (16)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • onebusaway_find_routesFind Routes Near Locationread-only

    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_stopsFind Stops Near Locationread-only

    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.g. "75403").

  • onebusaway_get_alertGet Service Alert Detailread-only

    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_arrivalsGet Real-Time Arrivalsread-only

    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-only. Use tripId from results for follow-up onebusaway_get_trip calls. Stop IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_75403").

  • onebusaway_get_blockGet Block Scheduleread-only

    Fetch the full-day block schedule for a vehicle by block ID. A block is the ordered sequence of trips a single vehicle makes in one service day. Returns all trips in order with their stop times. Useful for 'when will this bus return?' and fleet tracking. Block IDs appear as blockId in onebusaway_get_trip responses; obtain a tripId from onebusaway_get_arrivals first.

  • onebusaway_get_routeGet Route Detailsread-only

    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_routeGet Route Scheduleread-only

    Full-day schedule for a route — all trips, stop sequences, and departure times for the specified date (defaults to today). Returns up to all trips for the route. For live predictions, use onebusaway_get_arrivals at specific stops instead.

  • onebusaway_get_schedule_for_stopGet Stop Scheduleread-only

    Full-day departure schedule for a stop. Lists every departure by route and direction for the specified date (defaults to today). Useful for planning or when real-time data isn't needed. For live predictions, use onebusaway_get_arrivals instead.

  • onebusaway_get_stopGet Stop Detailsread-only

    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_contextGet Stop Contextread-only

    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 upstream request — arrivals in the onebusaway_get_arrivals shape, alerts in the onebusaway_get_alert shape. The stop omits its served-route list; use onebusaway_get_stop for routeIds. Stop IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_75403").

  • onebusaway_get_tripGet Trip Statusread-only

    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_vehiclesGet Real-Time Vehicle Positionsread-only

    Real-time positions of all active vehicles for an agency. Optionally filter to a single route (client-side). Returns GPS coordinates, heading, schedule deviation, and current trip. Useful for "where are all the buses on route X right now?" Use agencyId values from onebusaway_list_agencies.

  • onebusaway_list_agenciesList Transit Agenciesread-only

    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_agencyList Routes for Agencyread-only

    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_routesSearch Routes by Name or Numberread-only

    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.

Show 1 more tools
  • onebusaway_search_stopsSearch Stops by Name or Coderead-only

    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.

Signals

Stars
1
Forks
0
Open issues
2
Weekly downloads
90
Last commit
Oct 9, 2026 (20 days ago)
Last release
Oct 26, 2026 (3 days ago)
Last package publish
Oct 9, 2026 (20 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.cyanheads/onebusaway-mcp-server
Version
0.3.0
Auth
Auth not stated
License
Apache-2.0
First seen
Oct 24, 2026
Last checked
Oct 26, 2026

More from cyanheads

Cite this page

Onebusaway MCP Server. Agent Mart. https://agentmart.dev/connectors/cyanheads-onebusaway-mcp-server (last updated 2026-10-26)