# TrainTrack

> Live Hungarian railway map, train and station pages, bilingual search, delay information, and agent tools.

TrainTrack exposes observed live railway data. Timestamps and stale indicators are authoritative; results are not ticket inventory or guaranteed journey plans.

## Public pages

- [Live map](https://traintrack.hu/): Current train positions and map controls.
- [Train service directory](https://traintrack.hu/train): Search active trains and browse permanent train-number service pages.
- [Example permanent train page](https://traintrack.hu/train/904-bakony-intercity): Route facts and live status for the 904 BAKONY InterCity, retained between journeys.
- [First-class services](https://traintrack.hu/train?class=first_class): Active trains whose metadata explicitly advertises first class.
- [Delay leaderboard](https://traintrack.hu/delays): Largest currently observed delays.
- [Network statistics](https://traintrack.hu/stats): Current aggregate railway statistics.
- [Example station board](https://traintrack.hu/allomas/budapest-nyugati): Canonical station arrivals and departures.
- [English live map](https://traintrack.hu/?lang=en): Add `?lang=en` to any public canonical URL for English.

## Agent and developer entry points

- [Full agent reference](https://traintrack.hu/llms-full.txt): Data semantics, filters, browser tools, and crawlable resources.
- [Remote MCP setup](https://traintrack.hu/agent-setup/prompt.md): OAuth-first setup instructions for agents.
- [Streamable HTTP MCP endpoint](https://api.traintrack.hu/mcp): Remote Model Context Protocol endpoint.
- [REST OpenAPI contract](https://api.traintrack.hu/openapi.json): Authoritative REST schemas.
- [Interactive API documentation](https://api.traintrack.hu/docs): Human-readable developer documentation.
- [WebMCP discovery metadata](https://traintrack.hu/.well-known/mcp.json): Browser and remote-agent discovery summary.

## Important semantics

- Live results are observations and may become stale; inspect returned timestamps and stale indicators.
- Public train URLs use passenger-facing train numbers and names. Daily GTFS trip IDs are aliases for live lookup, not durable page identifiers.
- Class and amenity filters use explicit live service metadata. Missing metadata is not treated as availability.
- Train discovery is not ticket inventory and does not guarantee a complete connection.
- The browser exposes stable WebMCP tools when the browser implements the current Community Group draft.

## Optional

- [Sitemap index](https://traintrack.hu/sitemap.xml): Core/station and permanent train-service sitemaps.
- [Permanent train sitemap](https://traintrack.hu/sitemap-trains.xml): Canonical Hungarian and English train-number pages.
- [Robots policy](https://traintrack.hu/robots.txt): Public crawler policy.