llms.txt Content
# SubwayInfo.nyc
Real-time NYC transit data for subway, bus, ferry, LIRR, Metro-North, and Citibike. SubwayInfo.nyc exposes an MCP server, direct REST APIs, and browser-discoverable tools for agents.
## Agent Discovery
- API catalog: [/.well-known/api-catalog](/.well-known/api-catalog)
- OpenAPI service description: [/openapi.json](/openapi.json)
- API documentation: [/docs](/docs)
- Health status: [/health](/health)
- MCP endpoint: [/mcp](/mcp)
- MCP server card: [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json)
- Agent skills index: [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json)
## Common REST Endpoints
- `GET /api/arrivals?station_id=127`
- `GET /api/alerts?line=A`
- `GET /api/stations?query=Times%20Square`
- `GET /api/trip?origin_station_id=127&destination_station_id=631`
- `GET /api/bus/arrivals?stop_id=401062`
- `GET /api/ferry/arrivals?landing_id=WS`
- `GET /api/rail/departures?station_id=NYK`
## Authentication
Most read-only endpoints can be used anonymously with rate limits. API keys are optional and documented at [/docs#authentication](/docs#authentication).
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"SubwayInfo.nyc API","version":"1.0.0","description":"Real-time NYC transit data for subway, bus, ferry, LIRR, Metro-North, and Citibike. The fastest MCP server for AI assistants."},"servers":[{"url":"https://subwayinfo.nyc"}],"paths":{"/health":{"get":{"summary":"Service and feed health","responses":{"200":{"description":"Current service health","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/mcp":{"post":{"summary