Onebusaway MCP Server

Name: Onebusaway MCP Server
Author: cyanheads

by cyanheadsversion 0.3.0i★ –iComputer or cloud

Registry nameio.github.cyanheads/onebusaway-mcp-server

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiVery new↓ 123/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Travel, maps & weather

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 3 of 3 passed
Runs on the maker’s server: what you ask it goes through their server.
Can do 16 things (tools) onebusaway_list_agencies, onebusaway_find_stops, onebusaway_find_routes, onebusaway_search_stops …
You fill in yourself: ONEBUSAWAY_API_KEY, ONEBUSAWAY_BASE_URL, ONEBUSAWAY_RATE_LIMIT_REQUESTS, ONEBUSAWAY_RATE_LIMIT_WINDOW_MS, ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS, MCP_LOG_LEVEL

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://onebusaway.caseyjhand.com/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "onebusaway": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server"
      ],
      "env": {
        "ONEBUSAWAY_API_KEY": "your-value",
        "ONEBUSAWAY_BASE_URL": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_REQUESTS": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_WINDOW_MS": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS": "your-value",
        "MCP_LOG_LEVEL": "your-value"
      }
    }
  }
}

Run this in your terminal

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

Or run it on your computer

claude mcp add onebusaway --env ONEBUSAWAY_API_KEY=your-value --env ONEBUSAWAY_BASE_URL=your-value --env ONEBUSAWAY_RATE_LIMIT_REQUESTS=your-value --env ONEBUSAWAY_RATE_LIMIT_WINDOW_MS=your-value --env ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS=your-value --env MCP_LOG_LEVEL=your-value -- npx -y @cyanheads/onebusaway-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "onebusaway": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server"
      ],
      "env": {
        "ONEBUSAWAY_API_KEY": "your-value",
        "ONEBUSAWAY_BASE_URL": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_REQUESTS": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_WINDOW_MS": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS": "your-value",
        "MCP_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

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

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "onebusaway": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/onebusaway-mcp-server"
      ],
      "env": {
        "ONEBUSAWAY_API_KEY": "your-value",
        "ONEBUSAWAY_BASE_URL": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_REQUESTS": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_WINDOW_MS": "your-value",
        "ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS": "your-value",
        "MCP_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://onebusaway.caseyjhand.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

ONEBUSAWAY_API_KEY env
OneBusAway API key. TEST works on the Puget Sound instance for development.
ONEBUSAWAY_BASE_URL env
Base URL for the OneBusAway instance. Defaults to Puget Sound.
ONEBUSAWAY_RATE_LIMIT_REQUESTS env
Upstream requests the pacer allows per window.
ONEBUSAWAY_RATE_LIMIT_WINDOW_MS env
Width of the pacer's sliding rate window, in milliseconds.
ONEBUSAWAY_RATE_LIMIT_MAX_WAIT_MS env
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 env
Sets the minimum log level for output (e.g., 'debug', 'info', 'warning').

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

onebusaway_list_agencies
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_find_stops
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
onebusaway_find_routes
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_search_stops
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.
onebusaway_search_routes
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_get_stop
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_route
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_list_routes_for_agency
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_get_arrivals
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=fa
onebusaway_get_stop_context
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 woul
onebusaway_get_alert
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
onebusaway_get_trip
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_block
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 d
onebusaway_get_vehicles
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 ag
onebusaway_get_schedule_for_stop
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 se
onebusaway_get_schedule_for_route
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 fil

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account cyanheads, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 223 ms (HTTP 200)
– Not applicable
Sign-in with OAuth
No sign-in needed
✓ Pass
No hidden instructions in tool descriptions
Read 16 tool descriptions and found no hidden instructions to the AI

Compared with others in Travel, maps & weatheri

More stars than 0% of the other 1737 servers in this category
Published to the registry more recently than 68% of the other 1737 servers in this category
Basic checks equal to or better than 100% of the other 1737 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Onebusaway MCP Server safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.3.0) reached the registry 14 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Growkik Directorios, ViaFrei, Gogcli MCP Maps

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Growkik Directorios

75,000+ Mexican companies: construction, manufacturing, industrial parks, real estate, freight.

by growkik.comEarlyUpdated today

Runs in the cloud✓ growkik.com

Install

ViaFrei

The German Real-Time Mobility Context Platform for AI: traffic, trains, charging, parking, weather.

by mavrovdeEarlyUpdated today

Runs in the cloud✓ viafrei.de

Install

Gogcli MCP Maps

Google Places + trip maps via gogcli for Claude — places through gog maps, pins, shortlists, My Maps

by chrischallVery newUpdated today

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@cyanheads/onebusaway-mcp-server Query stops, routes, real-time arrivals, vehicle positions, and schedules from OneBusAway transit APIs via MCP. STDIO or Streamable HTTP. 16 Tools • 2 Resources

Public Hosted Server: https://onebusaway.caseyjhand.com/mcp

Overview

Real-time transit from OneBusAway, set up for Puget Sound (King County Metro, Sound Transit, Pierce Transit, Community Transit, and more) and compatible with any OneBusAway instance. Find stops and routes, track live arrivals and vehicle positions, and pull schedules and service alerts.

Tools

Tool	Description
`onebusaway_list_agencies`	List the transit agencies on the instance, with IDs, contact info, and coverage area
`onebusaway_find_stops`	Find stops near a lat/lon, optionally filtered by stop code
`onebusaway_search_stops`	Resolve a stop name or code to a stop ID
`onebusaway_get_stop`	Fetch one stop by ID
`onebusaway_find_routes`	Find routes near a lat/lon, optionally filtered by name or number
`onebusaway_search_routes`	Resolve a route name or number to a route ID
`onebusaway_get_route`	Fetch one route by ID
`onebusaway_list_routes_for_agency`	List every route an agency operates
`onebusaway_get_arrivals`	Real-time arrivals and departures at a stop, with schedule deviation, vehicle positions, and active alerts
`onebusaway_get_stop_context`	Stop details, real-time arrivals, and full detail for every alert at the stop, from one upstream request
`onebusaway_get_alert`	Full service alert detail by situation ID
`onebusaway_get_trip`	Real-time status and stop sequence for a trip
`onebusaway_get_block`	Every trip one vehicle runs in a service day, in order, with stop times
`onebusaway_get_vehicles`	Real-time positions of an agency's active vehicles, optionally for 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: every trip and its stop sequence

Resources

Resource	Description
`onebusaway://stop/{stopId}`	Stop metadata: name, coordinates, served routes, wheelchair accessibility
`onebusaway://route/{routeId}`	Route metadata: short name, description, agency, schedule URL

The same data is available to tool-only clients through onebusaway_get_stop and onebusaway_get_route.

Capability reference

`onebusaway_list_agencies` tool

No input; returns every agency with id, contact info, timezone, and coverageCenter / coverageSpan
limitExceeded flags an upstream-capped list, with no pagination to fetch the rest

`onebusaway_find_stops` tool

lat / lon required; radius in meters, default 300, max 1600; optional query matches the stop code printed on the sign
Each stop carries id, code, direction, routeIds, and wheelchairBoarding (ACCESSIBLE / NOT_ACCESSIBLE / UNKNOWN); limitExceeded means more stops exist within the radius

`onebusaway_search_stops` tool

query (stop name fragment or stop code) required; maxCount up to 100, default 10
Same stop shape as onebusaway_find_stops; limitExceeded means more stops matched than maxCount

`onebusaway_get_stop` tool

Single stopId; returns name, code, coordinates, direction, routeIds, and wheelchairBoarding
Unknown IDs fail as stop_not_found, with recovery via onebusaway_find_stops or onebusaway_search_stops

`onebusaway_find_routes` tool

lat / lon required; radius in meters, default 500, max 1600, or a latSpan + lonSpan box (both set) in its place; optional query by route name or number
Each route carries shortName, longName, agencyId, GTFS type (0=tram … 5=cable_car), color, and schedule url; limitExceeded means more routes exist in the area

`onebusaway_search_routes` tool

query (route name or number) required; maxCount up to 100, default 10
Returns shortName, longName, agencyId, and GTFS type; limitExceeded means more routes matched than maxCount
Fails as endpoint_unavailable on instances whose route-search endpoint returns 404, Puget Sound among them; use onebusaway_find_routes or onebusaway_list_routes_for_agency instead

`onebusaway_get_route` tool

Single routeId; returns shortName, longName, description, agency, GTFS type, color, and schedule url
Unknown IDs fail as route_not_found, with recovery via onebusaway_find_routes or onebusaway_search_routes

`onebusaway_list_routes_for_agency` tool

agencyId required; unknown agencies fail as agency_not_found
Every route with shortName, longName, GTFS type, color, and url; limitExceeded flags an upstream-capped list with no pagination

`onebusaway_get_arrivals` tool

stopId required; the window is minutesBefore (integer 0–60, default 5) / minutesAfter (integer 0–240, default 35), with longer horizons left to onebusaway_get_schedule_for_stop; unknown stops fail as stop_not_found
Each arrival carries predicted (false = schedule-only), scheduleDeviation in seconds (positive = late, meaningful only when predicted), predictedArrivalTime, vehiclePosition, stopsAway, and tripId
Active alerts arrive in situations[]: those on the stop itself plus those linked from each arrival's situationIds, each once

`onebusaway_get_stop_context` tool

Same input as onebusaway_get_arrivals, and the same stop_not_found / rate_limited failures; one call issues one upstream request
Returns stop (the onebusaway_get_stop fields minus routeIds), arrivals in the onebusaway_get_arrivals shape, and alerts in the onebusaway_get_alert shape — every alert on the stop or on an arrival in the window, including stop-wide alerts no arrival in the window carries
When the upstream response omits the stop, stop is null; a referenced alert missing from the response is left out; either way a notice names the tool to fetch it with

`onebusaway_get_alert` tool

Single situationId, from onebusaway_get_arrivals (situations[].id or arrivals[].situationIds); unknown IDs fail as situation_not_found
Returns a TPEG reason code, severity, consequenceMessage, affects (agency, route, stop, or trip scope), consequences with diversion stop IDs, and activeWindows

`onebusaway_get_trip` tool

tripId required; serviceDateMs (non-negative integer, midnight local) only for a trip on a previous service day; includeSchedule (default true) adds the stop sequence with GTFS times and distanceAlongTripMeters
status carries phase (e.g. in_progress, layover_before), predicted, position, scheduleDeviation, and nextStop; blockId (null when the trip has none) feeds onebusaway_get_block
Fails as trip_not_found when the trip isn't active for the service date; a completed trip's times come from onebusaway_get_schedule_for_route

`onebusaway_get_block` tool

Single blockId, from onebusaway_get_trip; unknown IDs fail as block_not_found
Top-level trips, activeServiceIds, and inactiveServiceIds describe the first returned configuration; alternateConfigurations preserves every remaining configuration in order. Service IDs are calendar conditions, not a claim that a configuration operates today
Each trip carries distanceAlongBlock, accumulatedSlackTime (layover seconds), and blockStopTimes. Optional exact tripId or departureFromSec / departureBeforeSec selects complete trips independently in every configuration, retaining empty configuration slots
With selectors, selection.total / returned count trip occurrences across configurations; configurationCounts[0] describes the top-level configuration, then one entry per alternative

Example: {"blockId":" ","departureFromSec":86400,"departureBeforeSec":90000} selects trips with any departure from 24:00 inclusive to 25:00 exclusive, retaining their complete stop sequences.

`onebusaway_get_vehicles` tool

agencyId required, unknown agencies fail as agency_not_found; optional routeId is filtered client-side after all of the agency's vehicles are fetched
Each vehicle carries position, orientation, phase, scheduleDeviation, tripId, nextStop, and predicted (reporting real-time GPS); limitExceeded flags an upstream-capped list with no pagination
tripId prefers the active trip; route and headsign metadata resolve only from that trip. orientation preserves counter-clockwise degrees from east (0=east, 90=north, 180=west, 270=south), not a compass bearing
Records missing latitude or longitude are skipped: omittedWithoutPosition counts them across the agency, and omittedWithoutPositionOnRoute counts resolved matches when filtering by route. These counts are independent of upstream truncation

`onebusaway_get_schedule_for_stop` tool

stopId required; optional date as a real YYYY-MM-DD calendar date, default (omitted or blank) today in the agency's timezone; unknown stops fail as stop_not_found
Departures grouped by route and direction, each with scheduledDepartureTime and tripId
serviceDateMs preserves the upstream schedule-date marker: query time for an omitted/blank date, instance-local midnight for an explicit date; it is not rounded to a service-day boundary
Optional routeId, `d

Only the beginning is shown; read the rest in the repo

Onebusaway MCP Server

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Travel, maps & weatheri

Common questions

Alternatives

Growkik Directorios

ViaFrei

Gogcli MCP Maps

README from the maker

Overview

Tools

Resources

Capability reference

onebusaway_list_agencies tool

onebusaway_find_stops tool

onebusaway_search_stops tool

onebusaway_get_stop tool

onebusaway_find_routes tool

onebusaway_search_routes tool

onebusaway_get_route tool

onebusaway_list_routes_for_agency tool

onebusaway_get_arrivals tool

onebusaway_get_stop_context tool

onebusaway_get_alert tool

onebusaway_get_trip tool

onebusaway_get_block tool

onebusaway_get_vehicles tool

onebusaway_get_schedule_for_stop tool

`onebusaway_list_agencies` tool

`onebusaway_find_stops` tool

`onebusaway_search_stops` tool

`onebusaway_get_stop` tool

`onebusaway_find_routes` tool

`onebusaway_search_routes` tool

`onebusaway_get_route` tool

`onebusaway_list_routes_for_agency` tool

`onebusaway_get_arrivals` tool

`onebusaway_get_stop_context` tool

`onebusaway_get_alert` tool

`onebusaway_get_trip` tool

`onebusaway_get_block` tool

`onebusaway_get_vehicles` tool

`onebusaway_get_schedule_for_stop` tool