Onebusaway MCP Server

by cyanheadsio.github.cyanheads/onebusaway-mcp-serverv0.2.0

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

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active15d ago

Install Onebusaway MCP server

claude mcp add onebusaway -- npx -y @cyanheads/onebusaway-mcp-server run start:stdio

{
  "mcpServers": {
    "onebusaway": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "onebusaway": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "onebusaway": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "onebusaway": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ONEBUSAWAY_API_KEY	—	—	OneBusAway API key. TEST works on the Puget Sound instance for development.
ONEBUSAWAY_BASE_URL	—	—	Base URL for the OneBusAway instance. Defaults to Puget Sound.
ONEBUSAWAY_RATE_LIMIT_REQUESTS	—	—	Upstream requests the pacer allows per window.
ONEBUSAWAY_RATE_LIMIT_WINDOW_MS	—	—	Width of the pacer's sliding rate window, in milliseconds.
ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS	—	—	Longest a call may wait in the pacer queue, in milliseconds. Keep it under the SDK client's 60 s request timeout.
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warning').
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.

Remote endpoints

streamable-httphttps://onebusaway.caseyjhand.com/mcp

Freshness

Active — last maintenance signal 15d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-25 · 15d ago · GitHub
Latest release
2026-09-25 · 15d ago · GitHub · v0.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-25 · 15d ago · official registry · v0.2.0

FAQ

›How do I install the Onebusaway MCP server in Claude Code?

Run: claude mcp add onebusaway -- npx -y @cyanheads/onebusaway-mcp-server run start:stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Onebusaway require an API key?

No required environment variables are declared in its published metadata.

›Can I use Onebusaway as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Onebusaway in the official MCP registry?

Yes, as io.github.cyanheads/onebusaway-mcp-server.