How do I install the onebusaway mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MCP_TRANSPORT_TYPE`, `MCP_LOG_LEVEL`, `ONEBUSAWAY_API_KEY`, `ONEBUSAWAY_BASE_URL`, `MCP_HTTP_ENDPOINT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Onebusaway MCP Server

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

Remote serverstreamable-http

What is the Onebusaway MCP Server?

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

The short version

Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
Unified error handling — handlers throw, framework catches, classifies, and formats
Pluggable auth: none, jwt, oauth
Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
Structured logging with optional OpenTelemetry tracing
STDIO and Streamable HTTP transports

What it needs from you

Bun v1.3.0 or higher (or Node.js v24+). - An OneBusAway API key. TEST works on the Puget Sound instance for development. For production use or other instances, register at the relevant agency's developer portal.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
onebusaway_list_agencies	List all transit agencies on this OneBusAway instance with IDs, contact info, and geographic coverage
onebusaway_find_stops	Find bus stops near a lat/lon within a configurable radius, optionally filtered by stop code
onebusaway_search_stops	Search stops by name or code string to resolve a human-readable name to a stop ID
onebusaway_get_stop	Fetch details for a specific stop by agency-prefixed ID
onebusaway_find_routes	Find transit routes near a lat/lon, optionally filtered by name or number
onebusaway_search_routes	Search routes by name or number to resolve a route short name to a route ID
onebusaway_get_route	Fetch details for a specific route by agency-prefixed ID
onebusaway_list_routes_for_agency	List all routes operated by an agency
onebusaway_get_arrivals	Real-time arrivals and departures at a stop — GPS-tracked predictions, schedule deviation, vehicle positions, and active alerts
onebusaway_get_trip	Real-time status and full stop sequence for an active trip
onebusaway_get_vehicles	Real-time positions of all active vehicles for an agency, optionally filtered to one route
onebusaway_get_schedule_for_stop	Full-day departure schedule for a stop by route and direction
onebusaway_get_schedule_for_route	Full-day schedule for a route — all trips and stop sequences
onebusaway_get_alert	Fetch full service alert detail by situation ID — summary, description, reason, affected stops/routes, consequence, and active time windows

How to install the Onebusaway MCP Server

{
  "mcpServers": {
    "onebusaway-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/onebusaway-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "ONEBUSAWAY_API_KEY": "TEST"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Bun v1.3.0 or higher (or Node.js v24+). - An OneBusAway API key. TEST works on the Puget Sound instance for development. For production use or other instances, register at the relevant agency's developer portal.

Variable	Description	Required
MCP_TRANSPORT_TYPE	Configuration value read at startup.	Optional
MCP_LOG_LEVEL	Configuration value read at startup.	Optional
ONEBUSAWAY_API_KEY	Credential the server authenticates with.	Yes
ONEBUSAWAY_BASE_URL	Endpoint or connection string the server talks to.	Yes
MCP_HTTP_ENDPOINT_PATH	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Onebusaway to onebusaway list agencies.”
“Use Onebusaway to onebusaway find stops.”
“Use Onebusaway to onebusaway search stops.”

Frequently asked questions

Real-time transit stops, routes, arrivals, vehicle positions, and schedules via OneBusAway APIs. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.