# onebusaway-mcp-server

MCP server for querying stops, routes, arrivals, vehicle positions, and schedules through OneBusAway APIs. Pre-configured for Puget Sound, works with any OneBusAway instance.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1254 installs · ★ 2 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/onebusaway-mcp-server
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/onebusaway-mcp-server

## What it 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.

## Requirements
- Remote server: `https://onebusaway-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add onebusaway-mcp-server --url https://onebusaway-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "onebusaway-mcp-server": {
            "url": "https://onebusaway-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "onebusaway-mcp-server": {
            "type": "http",
            "url": "https://onebusaway-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http onebusaway-mcp-server https://onebusaway-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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

## Similar
- [Where's my train? MTA Guide](https://affpapa.org/en/nevibecode/mcp/wheres-my-train-mta-guide.md) — MCP server · 3733 installs
- [LibraryAPI](https://affpapa.org/en/nevibecode/mcp/libraryapi.md) — MCP server
- [InfraNode](https://affpapa.org/en/nevibecode/mcp/infranode-infranode.md) — MCP server · 384 installs
- [linkfox-google-trend-get-trend-by-time](https://affpapa.org/en/nevibecode/skills/linkfox-google-trend-get-trend-by-time.md) — skill · 237 installs
- [Malaysia Open Data MCP Server](https://affpapa.org/en/nevibecode/mcp/malaysia-open-data-mcp-server.md) — MCP server · 5119 installs
- [felo-search](https://affpapa.org/en/nevibecode/skills/felo-search.md) — skill · 288 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
