mta

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

### B...

# :metro: NYC MTA Transit — OpenClaw Skill

> **Real-time New York City transit data for your OpenClaw agent.** Get subway arrivals, bus predictions, service alerts, and route info for all MTA subway lines and bus routes.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node.js 18+](https://img.shields.io/badge/node-18%2B-green.svg)](https://nodejs.org)
[![ClawHub](https://img.shields.io/badge/ClawdHub-Skill-green.svg)](https://clawhub.ai)

---

## Why This Skill?

**For anyone who rides the NYC subway or bus and wants:**
- Real-time subway arrivals — know exactly when the next train comes, with track info
- Bus predictions — see when your bus will arrive at your stop
- Service alerts — know about delays, planned work, and weekend changes before you leave
- Stop and route lookup — find the nearest subway station or bus stop
- Subway works with zero setup — no API keys, no accounts, no environment variables

**How it works:**
Subway data comes from MTA's [GTFS-RT protobuf feeds](https://api.mta.info/) (open access, no key). Bus data comes from the [SIRI/OneBusAway API](https://bustime.mta.info/) (free key required). Alerts use GTFS-RT protobuf (open access).

---

## Quick Start

### Subway (zero config)

Subway and alert commands work immediately with no setup:

```bash
# Install dependencies
cd mta-skill && npm install

# Download subway stop data (one-time)
node scripts/mta.mjs refresh-gtfs

# Check subway arrivals
node scripts/mta.mjs arrivals --stop-search "times square"
```

### Bus (free API key)

Bus commands require a free MTA BusTime API key:

1. **Get a key:** https://register.developer.obanyc.com/ (delivered within 30 min)
2. **Set environment variable:**
```bash
export MTA_BUS_API_KEY=your-key-here
# Or add to .env file in the skill directory
```

---

## What You Can Do

### :clock3: Real-Time Subway Arrivals
- See when the next train arrives at any subway station
- Search stations by name — "penn station", "times square...