MBTA Transit

Other

Provides real-time MBTA transit info including next departures, service alerts, live vehicle locations, stop searches, and route listings for Boston-area tra...

Install

openclaw skills install mbta-transit

MBTA Transit Skill

Query real-time MBTA (Massachusetts Bay Transportation Authority) transit data: next departures, service alerts, and live vehicle positions for subway, bus, commuter rail, and ferry.

What This Skill Does

Next departures — Get upcoming departures from any MBTA stop, with route, destination, and predicted time
Service alerts — Check active disruptions, delays, or closures for a stop or route
Vehicle positions — See where trains/buses are right now on a given route
Stop search — Find stop IDs by name
Route listing — Browse all MBTA routes by type

Environment Variables

Variable	Required	Description
`MBTA_API_KEY`	Optional	Higher rate limits (1000 req/min vs 20). Free at https://api-v3.mbta.com/

Script: `scripts/mbta.py`

Commands

`stops <search_term>` — Find stops by name

python3 scripts/mbta.py stops "South Station"
python3 scripts/mbta.py stops "Harvard"
python3 scripts/mbta.py stops "Kenmore"

Returns: Stop IDs, names, platform info, city.

`departures <stop_id_or_name> [limit]` — Next departures

python3 scripts/mbta.py departures place-sstat 10
python3 scripts/mbta.py departures "Back Bay" 5
python3 scripts/mbta.py departures place-north

Returns: Departure times, route names, destinations.

`alerts [--stop <id>] [--route <id>]` — Active service alerts

python3 scripts/mbta.py alerts --route Red
python3 scripts/mbta.py alerts --stop place-sstat
python3 scripts/mbta.py alerts --route Orange --stop place-dwnxg
python3 scripts/mbta.py alerts   # all active alerts

Returns: Alert header, effect type, severity, description, last updated.

`vehicles <route_id>` — Live vehicle positions

python3 scripts/mbta.py vehicles Red
python3 scripts/mbta.py vehicles Orange
python3 scripts/mbta.py vehicles "Green-D"
python3 scripts/mbta.py vehicles 1   # Route 1 bus

Returns: Vehicle label, current stop/status, heading, occupancy, last update time.

`routes [--type <0-4>]` — List routes

python3 scripts/mbta.py routes
python3 scripts/mbta.py routes --type 1   # Subway/Heavy Rail
python3 scripts/mbta.py routes --type 2   # Commuter Rail
python3 scripts/mbta.py routes --type 3   # Bus

Route types: 0=Light Rail, 1=Heavy Rail, 2=Commuter Rail, 3=Bus, 4=Ferry

Natural Language Requests This Handles

"When's the next Red Line train from South Station?" → departures place-sstat 5 (filter mentally to Red Line)
"Are there any delays on the Orange Line?" → alerts --route Orange
"What's the next commuter rail departure from Back Bay?" → departures place-bbsta 10
"Where are the Green Line D trains right now?" → vehicles Green-D
"Find the stop ID for Kenmore Station" → stops Kenmore
"Any service alerts near Downtown Crossing?" → alerts --stop place-dwnxg
"How crowded is the Blue Line?" → vehicles Blue (shows occupancy when available)

Common Stop IDs (Quick Reference)

Station	Stop ID
South Station	`place-sstat`
North Station	`place-north`
Back Bay	`place-bbsta`
Downtown Crossing	`place-dwnxg`
Park Street	`place-pktrm`
Harvard	`place-harsq`
Kendall/MIT	`place-knncl`
Alewife	`place-alfcl`
Airport	`place-aport`
Kenmore	`place-kencl`
Copley	`place-coecl`
Boylston	`place-boyls`

Common Route IDs

Route	ID
Red Line	`Red`
Orange Line	`Orange`
Blue Line	`Blue`
Green-B/C/D/E	`Green-B`, `Green-C`, `Green-D`, `Green-E`
Silver Line 1	`741`
Silver Line 2	`742`

Tips for the AI Agent

Always use stop IDs over names when you have them — more reliable
Search for stop IDs first if you only have a station name: stops "Name"
Parent station IDs (e.g., place-sstat) cover all platforms — use these for departures
Predictions may be empty at night or when service isn't running
Alerts with no filter returns ALL system alerts — often noisy; filter by route or stop when possible
Vehicle tracking isn't available for all routes (some buses don't report positions)
For commuter rail departures, stop IDs are usually the station name like Back Bay

References

See references/API.md for full MBTA V3 API documentation, including all filter parameters, response formats, and complete lists of stop/route IDs.