| name | mta |
| description | NYC MTA transit — real-time subway arrivals, bus predictions, service alerts, and route info for the New York City subway and bus system. Use when the user asks about NYC public transit, subway times, MTA bus arrivals, service alerts, or nearby stops. |
| homepage | https://github.com/brianleach/mta-skill |
| license | MIT |
| metadata | {"clawdbot":{"emoji":"🚇","tags":["transit","nyc","mta","transportation","subway","bus","train","schedule"],"requires":{"bins":["node"],"env":["MTA_BUS_API_KEY"]},"files":["scripts/mta.mjs","proto/gtfs-realtime.proto","proto/nyct-subway.proto"],"install":[{"id":"npm-deps","kind":"shell","command":"npm install --prefix $SKILL_DIR","label":"Install Node.js dependencies (protobufjs)"}]}} |
NYC MTA Transit
Real-time New York City MTA transit data — subway arrivals (GTFS-RT protobuf), bus predictions (SIRI JSON API), service alerts, and route information. Subway and alerts work with zero config; bus data requires a free API key.
When to Use
- User asks about NYC subway, MTA, the train, or specific lines (1/2/3, A/C/E, N/Q/R/W, etc.)
- User asks "when is the next train" in a New York City context
- User mentions specific NYC stations (Times Square, Penn Station, Grand Central, Union Square, etc.)
- User asks about NYC bus routes (M1, B52, Bx12, Q44, S79, etc.)
- User asks about MTA service alerts, delays, planned work, weekend service changes
- User asks about MTA fares, MetroCard, OMNY
- User asks about subway status or weekend service changes
- User asks about nearby subway stops or bus stops in NYC
Data Sources
NYC MTA is multiple transit agencies with different data formats:
Subway Real-Time Feeds (GTFS-RT Protobuf, NO key required)
Feeds are grouped by line division. Each returns protobuf binary with NYCT extensions (direction, track info).
| Feed | Lines | URL |
|---|
| 1234567/GS | 1, 2, 3, 4, 5, 6, 7, Grand Central Shuttle | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs |
| ACE | A, C, E, Rockaway Shuttle, Franklin Shuttle | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-ace |
| BDFM | B, D, F, M | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-bdfm |
| G | G | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-g |
| JZ | J, Z | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-jz |
| L | L | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-l |
| NQRW | N, Q, R, W | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-nqrw |
| SIR | Staten Island Railway | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs-si |
Feeds update every ~30 seconds. No API key required.
Bus Real-Time (SIRI JSON API, requires MTA_BUS_API_KEY)
Get a free key at: https://register.developer.obanyc.com/
| Endpoint | Description |
|---|
| SIRI StopMonitoring | Arrivals at a specific bus stop |
| SIRI VehicleMonitoring | All vehicles on a bus route |
| OneBusAway Stop Info | Stop details and nearby stops |
| OneBusAway Routes | Route discovery |
Rate limit: 1 request per 30 seconds.
Service Alerts (GTFS-RT Protobuf, NO key required)
| Feed | URL |
|---|
| Subway Alerts | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/camsys/subway-alerts |
| Bus Alerts | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/camsys/bus-alerts |
| All Alerts | https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/camsys/all-alerts |
GTFS Static Feed
| Feed | URL |
|---|
| Subway | http://web.mta.info/developers/data/nyct/subway/google_transit.zip |
Implementation
Script: scripts/mta.mjs
Main entry point. Supports these commands:
node scripts/mta.mjs arrivals --stop-search "times square"
node scripts/mta.mjs arrivals --stop-search "penn station" --line A
node scripts/mta.mjs arrivals --stop 127N
node scripts/mta.mjs arrivals --station "Grand Central"
node scripts/mta.mjs bus-arrivals --stop MTA_308209
node scripts/mta.mjs bus-arrivals --stop MTA_308209 --route M1
node scripts/mta.mjs vehicles --line 1
node scripts/mta.mjs bus-vehicles --route B52
node scripts/mta.mjs alerts
node scripts/mta.mjs alerts --subway
node scripts/mta.mjs alerts --bus
node scripts/mta.mjs alerts --line A
node scripts/mta.mjs routes
node scripts/mta.mjs bus-routes
node scripts/mta.mjs stops --search "grand central"
node scripts/mta.mjs stops --near 40.7484,-73.9856
node scripts/mta.mjs bus-stops --near 40.7484,-73.9856
node scripts/mta.mjs bus-stops --route M1
node scripts/mta.mjs route-info --line A
node scripts/mta.mjs refresh-gtfs
Setup: Bus API Key
Subway and alert commands work with zero configuration. For bus commands:
- Get a free key at https://register.developer.obanyc.com/
- Set environment variable:
MTA_BUS_API_KEY
Setup: GTFS Static Data
On first use, run node scripts/mta.mjs refresh-gtfs to download subway stop/route data to ~/.mta/gtfs/. Refresh periodically (data updates hourly).
NYC Subway Lines Reference
| Line | Color | Route | Terminals |
|---|
| 1 | Red | 7th Ave Local | Van Cortlandt Park-242 St ↔ South Ferry |
| 2 | Red | 7th Ave Express | Wakefield-241 St ↔ Flatbush Ave-Brooklyn College |
| 3 | Red | 7th Ave Express | Harlem-148 St ↔ New Lots Ave |
| 4 | Green | Lexington Ave Express | Woodlawn ↔ Crown Heights-Utica Ave |
| 5 | Green | Lexington Ave Express | Eastchester-Dyre Ave ↔ Flatbush Ave-Brooklyn College |
| 6 | Green | Lexington Ave Local | Pelham Bay Park ↔ Brooklyn Bridge-City Hall |
| 7 | Purple | Flushing | Flushing-Main St ↔ 34 St-Hudson Yards |
| A | Blue | 8th Ave Express | Inwood-207 St ↔ Far Rockaway / Ozone Park-Lefferts Blvd |
| C | Blue | 8th Ave Local | 168 St ↔ Euclid Ave |
| E | Blue | 8th Ave Local | Jamaica Center ↔ World Trade Center |
| B | Orange | 6th Ave Express | Bedford Park Blvd ↔ Brighton Beach |
| D | Orange | 6th Ave Express | Norwood-205 St ↔ Coney Island-Stillwell Ave |
| F | Orange | 6th Ave Local | Jamaica-179 St ↔ Coney Island-Stillwell Ave |
| M | Orange | 6th Ave Local | Middle Village-Metropolitan Ave ↔ Forest Hills-71 Ave |
| G | Light Green | Brooklyn-Queens Crosstown | Court Sq ↔ Church Ave |
| J | Brown | Nassau St | Jamaica Center ↔ Broad St |
| Z | Brown | Nassau St Express | Jamaica Center ↔ Broad St (Peak only) |
| L | Gray | 14th St-Canarsie | 8 Ave ↔ Canarsie-Rockaway Pkwy |
| N | Yellow | Broadway Express | Astoria-Ditmars Blvd ↔ Coney Island-Stillwell Ave |
| Q | Yellow |
Key Bus Routes Reference
| Route | Name | Borough |
|---|
| M1 | 5th Ave / Madison Ave | Manhattan |
| M15 | 1st Ave / 2nd Ave | Manhattan |
| M34 | 34th Street Crosstown | Manhattan |
| M42 | 42nd Street Crosstown | Manhattan |
| M60 | LaGuardia Airport Link | Manhattan/Queens |
| B44 | Nostrand Ave | Brooklyn |
| B52 | Gates Ave/Greene Ave | Brooklyn |
| Bx12 | Fordham Road/Pelham Pkwy | Bronx |
| Q44 | Merrick Blvd/Cross Island | Queens |
| S79 | Hylan Blvd | Staten Island |
| X27 | Bay Ridge-Downtown Manhattan Express | Brooklyn |
MTA Fares Reference (2025)
| Fare Type | Price |
|---|
| Subway/Bus (OMNY tap or MetroCard) | $2.90 |
| Bus-to-bus / subway-to-bus transfer | Free within 2 hours |
| Express Bus | $7.00 |
| 7-Day Unlimited | $34.00 |
| 30-Day Unlimited | $132.00 |
| Single Ride (vending machine only) | $3.25 |
| Reduced Fare | $1.45 |
Payment via OMNY (contactless tap), MetroCard, or Ventra. Free transfers between subway and bus within 2 hours with OMNY.
Tips for Users
- Subway stop IDs end with
N (northbound/uptown) or S (southbound/downtown). Example: 127N = Times Sq northbound
- Subway works with zero config — no API key needed for any subway command
- Bus requires a free API key — get one at https://register.developer.obanyc.com/
- Alerts always work — no key needed
- Multiple subway feeds exist; the skill automatically fetches the right one(s) for the line requested
- Use
--stop-search for fuzzy name matching, --stop for exact stop IDs
Error Handling
- If
MTA_BUS_API_KEY is not set, bus commands print a helpful message with the signup URL; subway commands still work
- Invalid station/stop searches show "No matching station found"
- Network errors and API error responses produce friendly messages
- If a subway feed returns empty data, note that real-time data may be temporarily unavailable
Response Formatting
When presenting transit info to the user:
- Lead with the most actionable info (next arrival time, active alerts)
- Show line letter/number + direction (e.g., "A train toward Far Rockaway, arriving 3 min")
- For subway: show "Approaching" for trains at the station, minutes for upcoming
- Show track info when available (actual vs scheduled track)
- Always mention active service alerts for the line being queried
- For buses: show route + destination + minutes/stops away
- Times in 12-hour format with AM/PM
External Endpoints
| Endpoint | Data Sent | Data Received |
|---|
api-endpoint.mta.info/Dataservice/mtagtfsfeeds/nyct/gtfs* | None (GET only) | Subway positions/arrivals (Protobuf) |
api-endpoint.mta.info/Dataservice/mtagtfsfeeds/camsys/*-alerts | None (GET only) | Service alerts (Protobuf) |
bustime.mta.info/api/siri/* | API key (query param) | Bus arrivals/positions (JSON) |
bustime.mta.info/api/where/* | API key (query param) | Stop/route discovery (JSON) |
web.mta.info/developers/data/nyct/subway/* | None (GET only) | GTFS static data (ZIP) |
Subway and alert endpoints are open access with no authentication. Bus endpoints require a free API key passed as a query parameter.
Security & Privacy
- Subway: No credentials required — subway and alert feeds are open access, no API keys or tokens
- Bus: Free API key required — passed as a URL query parameter to MTA's official BusTime API
- No user data transmitted — requests contain only API keys and route/stop identifiers, no personal information
- Local storage only — GTFS static data is cached locally at
~/.mta/gtfs/; no data is written elsewhere
- No telemetry — this skill does not phone home or collect usage data
- Input handling — stop names and route IDs from user input are used only for local filtering, never interpolated into shell commands
Trust Statement
This skill reads publicly available transit data from MTA's official feeds and APIs. The bus API key is used only for MTA BusTime API authentication. The skill does not access, store, or transmit any personal information beyond the API key configured by the user.
