An unofficial MCP server for STPT public transport in Timișoara
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"stpt-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# STPT MCP [](https://github.com/vladirocox/stpt-mcp/actions/workflows/ci.yml) An unofficial, standalone [Model Context Protocol](https://modelcontextprotocol.io/) server for **STPT public transport in Timișoara**, Romania. It exposes live arrivals, date-aware schedule fallback, service alerts, vehicle positions, and an offline stop/route index to MCP clients over **stdio** or **Streamable HTTP**. > This project is not affiliated with, endorsed by, or operated by STPT or the > Timișoara municipality. Upstream data is used with caching and conservative > request limits. Do not use it for safety-critical decisions. ## In action  Ask in plain language. The assistant calls `search_stops` to resolve the stop, then `get_arrivals` for the departures, and answers with the next bus. The same tools work from any MCP client — Claude, Hermes, Cursor, or an agent of your own. ## Highlights - Seven read-only MCP tools with typed output schemas. - Live-first arrivals with **date- and shape-aware schedule fallback**, explicit provenance, and last-known-good stale data. - Bounded TTL caches with **single-flight** refresh. Fifty concurrent calls to one stop produce one live upstream request, not fifty. - Bounded upstream concurrency, timeouts, retries with jitter, `Retry-After` support, and response-size limits. - Bundled GTFS-derived network snapshot, so stop/route discovery works offline. - stdio and Streamable HTTP through the official MCP Python SDK. - Secure HTTP defaults: loopback bind, DNS-rebinding protection, Host/Origin validation, body limits, bounded sessions/concurrency, optional bearer auth, and built-in OAuth 2.1 sign-in for hosted clients. - Deterministic test suite with real MCP client tests for st…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.