Real-time transit stops, routes, arrivals, vehicle positions, and schedules via OneBusAway APIs.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Latitude of the search center, in [-90, 90].
Longitude of the search center, in [-180, 180].
Filter by route name or number (e.g. "44" or "Link Light Rail").
Search radius in meters. Must be positive; capped at 1600m. Defaults to 500m. Ignored when latSpan and lonSpan are both set.
Optional bounding-box height in degrees, as an alternative to radius. Takes effect only when lonSpan is also set, in which case radius is ignored.
Optional bounding-box width in degrees, as an alternative to radius. Takes effect only when latSpan is also set, in which case radius is ignored.
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.
| Argument | Type | Description |
|---|---|---|
| lat* | number | Latitude of the search center, in [-90, 90]. |
| lon* | number | Longitude of the search center, in [-180, 180]. |
| query | string | Filter by route name or number (e.g. "44" or "Link Light Rail"). |
| radius | number | Search radius in meters. Must be positive; capped at 1600m. Defaults to 500m. Ignored when latSpan and lonSpan are both set. |
| latSpan | number | Optional bounding-box height in degrees, as an alternative to radius. Takes effect only when lonSpan is also set, in which case radius is ignored. |
| lonSpan | number | Optional bounding-box width in degrees, as an alternative to radius. Takes effect only when latSpan is also set, in which case radius is ignored. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the search center, in [-90, 90]."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the search center, in [-180, 180]."
},
"query": {
"type": "string",
"description": "Filter by route name or number (e.g. \"44\" or \"Link Light Rail\")."
},
"radius": {
"type": "number",
"default": 500,
"maximum": 1600,
"description": "Search radius in meters. Must be positive; capped at 1600m. Defaults to 500m. Ignored when latSpan and lonSpan are both set.",
"exclusiveMinimum": 0
},
"latSpan": {
"type": "number",
"description": "Optional bounding-box height in degrees, as an alternative to radius. Takes effect only when lonSpan is also set, in which case radius is ignored.",
"exclusiveMinimum": 0
},
"lonSpan": {
"type": "number",
"description": "Optional bounding-box width in degrees, as an alternative to radius. Takes effect only when latSpan is also set, in which case radius is ignored.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}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").
| Argument | Type | Description |
|---|---|---|
| lat* | number | Latitude of the search center, in [-90, 90]. |
| lon* | number | Longitude of the search center, in [-180, 180]. |
| query | string | Optional stop code filter (the number printed on the stop sign, e.g. "75403"). When provided, returns only stops matching this code within the radius. |
| radius | number | Search radius in meters. Must be positive; capped at 1600m, beyond which results degrade. Defaults to 300m. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the search center, in [-90, 90]."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the search center, in [-180, 180]."
},
"query": {
"type": "string",
"description": "Optional stop code filter (the number printed on the stop sign, e.g. \"75403\"). When provided, returns only stops matching this code within the radius."
},
"radius": {
"type": "number",
"default": 300,
"maximum": 1600,
"description": "Search radius in meters. Must be positive; capped at 1600m, beyond which results degrade. Defaults to 300m.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| situationId* | string | Situation/alert ID from onebusaway_get_arrivals (situations[].id or arrivals[].situationIds[]). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"situationId"
],
"properties": {
"situationId": {
"type": "string",
"minLength": 1,
"description": "Situation/alert ID from onebusaway_get_arrivals (situations[].id or arrivals[].situationIds[])."
}
},
"additionalProperties": false
}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").
| Argument | Type | Description |
|---|---|---|
| stopId* | string | Agency-prefixed stop ID (e.g. "1_75403" for Metro Transit stop 75403). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs. |
| minutesAfter | integer | Include arrivals expected within the next N minutes — an integer from 0 to 240. Defaults to 35. For a longer horizon, use onebusaway_get_schedule_for_stop. |
| minutesBefore | integer | Include arrivals that departed up to this many minutes ago — an integer from 0 to 60. Defaults to 5. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"stopId"
],
"properties": {
"stopId": {
"type": "string",
"minLength": 1,
"description": "Agency-prefixed stop ID (e.g. \"1_75403\" for Metro Transit stop 75403). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs."
},
"minutesAfter": {
"type": "integer",
"default": 35,
"maximum": 240,
"minimum": 0,
"description": "Include arrivals expected within the next N minutes — an integer from 0 to 240. Defaults to 35. For a longer horizon, use onebusaway_get_schedule_for_stop."
},
"minutesBefore": {
"type": "integer",
"default": 5,
"maximum": 60,
"minimum": 0,
"description": "Include arrivals that departed up to this many minutes ago — an integer from 0 to 60. Defaults to 5."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| blockId* | string | Block ID from a trip record. Obtain a tripId from onebusaway_get_arrivals, then call onebusaway_get_trip to get the blockId. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"blockId"
],
"properties": {
"blockId": {
"type": "string",
"minLength": 1,
"description": "Block ID from a trip record. Obtain a tripId from onebusaway_get_arrivals, then call onebusaway_get_trip to get the blockId."
}
},
"additionalProperties": false
}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").
| Argument | Type | Description |
|---|---|---|
| routeId* | string | Agency-prefixed route ID (e.g. "1_100259"). Use onebusaway_find_routes or onebusaway_search_routes to discover IDs. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"routeId"
],
"properties": {
"routeId": {
"type": "string",
"minLength": 1,
"description": "Agency-prefixed route ID (e.g. \"1_100259\"). Use onebusaway_find_routes or onebusaway_search_routes to discover IDs."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| date | any | Service date as YYYY-MM-DD (e.g. "2026-05-23"). Must be a real calendar date. Omit or leave blank for today. |
| routeId* | string | Agency-prefixed route ID (e.g. "1_100259"). Use onebusaway_find_routes or onebusaway_search_routes to discover IDs. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"routeId"
],
"properties": {
"date": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "A real calendar date in YYYY-MM-DD form (e.g. \"2026-05-23\")."
}
],
"description": "Service date as YYYY-MM-DD (e.g. \"2026-05-23\"). Must be a real calendar date. Omit or leave blank for today."
},
"routeId": {
"type": "string",
"minLength": 1,
"description": "Agency-prefixed route ID (e.g. \"1_100259\"). Use onebusaway_find_routes or onebusaway_search_routes to discover IDs."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| date | any | Service date as YYYY-MM-DD (e.g. "2026-05-23"). Must be a real calendar date. Omit or leave blank for today in the agency's timezone. |
| stopId* | string | Agency-prefixed stop ID (e.g. "1_75403"). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"stopId"
],
"properties": {
"date": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "A real calendar date in YYYY-MM-DD form (e.g. \"2026-05-23\")."
}
],
"description": "Service date as YYYY-MM-DD (e.g. \"2026-05-23\"). Must be a real calendar date. Omit or leave blank for today in the agency's timezone."
},
"stopId": {
"type": "string",
"minLength": 1,
"description": "Agency-prefixed stop ID (e.g. \"1_75403\"). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs."
}
},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| stopId* | string | Agency-prefixed stop ID (e.g. "1_75403" for Metro Transit stop 75403, "40_100239" for Sound Transit). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"stopId"
],
"properties": {
"stopId": {
"type": "string",
"minLength": 1,
"description": "Agency-prefixed stop ID (e.g. \"1_75403\" for Metro Transit stop 75403, \"40_100239\" for Sound Transit). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs."
}
},
"additionalProperties": false
}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").
| Argument | Type | Description |
|---|---|---|
| stopId* | string | Agency-prefixed stop ID (e.g. "1_75403" for Metro Transit stop 75403). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs. |
| minutesAfter | integer | Include arrivals expected within the next N minutes — an integer from 0 to 240. Defaults to 35. For a longer horizon, use onebusaway_get_schedule_for_stop. |
| minutesBefore | integer | Include arrivals that departed up to this many minutes ago — an integer from 0 to 60. Defaults to 5. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"stopId"
],
"properties": {
"stopId": {
"type": "string",
"minLength": 1,
"description": "Agency-prefixed stop ID (e.g. \"1_75403\" for Metro Transit stop 75403). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs."
},
"minutesAfter": {
"type": "integer",
"default": 35,
"maximum": 240,
"minimum": 0,
"description": "Include arrivals expected within the next N minutes — an integer from 0 to 240. Defaults to 35. For a longer horizon, use onebusaway_get_schedule_for_stop."
},
"minutesBefore": {
"type": "integer",
"default": 5,
"maximum": 60,
"minimum": 0,
"description": "Include arrivals that departed up to this many minutes ago — an integer from 0 to 60. Defaults to 5."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| tripId* | string | Trip ID from an arrivals response or schedule lookup. |
| serviceDateMs | integer | Service date as Unix milliseconds (midnight local time) — a non-negative integer. Only needed for trips from a previous service day. Omit to use today. |
| includeSchedule | boolean | Whether to include the full stop sequence with times. Defaults to true. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tripId"
],
"properties": {
"tripId": {
"type": "string",
"minLength": 1,
"description": "Trip ID from an arrivals response or schedule lookup."
},
"serviceDateMs": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Service date as Unix milliseconds (midnight local time) — a non-negative integer. Only needed for trips from a previous service day. Omit to use today."
},
"includeSchedule": {
"type": "boolean",
"default": true,
"description": "Whether to include the full stop sequence with times. Defaults to true."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| routeId | string | Optional agency-prefixed route ID to filter results to one route. Filtering is client-side — all agency vehicles are fetched first. |
| agencyId* | string | Agency ID (e.g. "1" for Metro Transit, "40" for Sound Transit). Use onebusaway_list_agencies to discover IDs. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"agencyId"
],
"properties": {
"routeId": {
"type": "string",
"description": "Optional agency-prefixed route ID to filter results to one route. Filtering is client-side — all agency vehicles are fetched first."
},
"agencyId": {
"type": "string",
"minLength": 1,
"description": "Agency ID (e.g. \"1\" for Metro Transit, \"40\" for Sound Transit). Use onebusaway_list_agencies to discover IDs."
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| agencyId* | string | Agency ID (e.g. "1" for Metro Transit, "40" for Sound Transit). Use onebusaway_list_agencies to discover IDs. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"agencyId"
],
"properties": {
"agencyId": {
"type": "string",
"minLength": 1,
"description": "Agency ID (e.g. \"1\" for Metro Transit, \"40\" for Sound Transit). Use onebusaway_list_agencies to discover IDs."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | string | Route name or number (e.g. "44", "Link", or "RapidRide"). |
| maxCount | integer | Maximum number of results to return. A positive integer, at most 100. Defaults to 10. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Route name or number (e.g. \"44\", \"Link\", or \"RapidRide\")."
},
"maxCount": {
"type": "integer",
"default": 10,
"maximum": 100,
"description": "Maximum number of results to return. A positive integer, at most 100. Defaults to 10.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| query* | string | Stop name fragment or stop code (e.g. "University Way" or "75403"). |
| maxCount | integer | Maximum number of results to return. A positive integer, at most 100. Defaults to 10. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Stop name fragment or stop code (e.g. \"University Way\" or \"75403\")."
},
"maxCount": {
"type": "integer",
"default": 10,
"maximum": 100,
"description": "Maximum number of results to return. A positive integer, at most 100. Defaults to 10.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}