Skip to main content
Glama
Sign In
ttc-mcp

ttc-mcp

by EmilSoleymani
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

ttc-mcp

A Model Context Protocol server for the Toronto Transit Commission (TTC). Exposes subway, streetcar, and bus schedules, live vehicle positions, real-time arrivals, and service alerts to LLM clients — plus multi-modal trip planning with transfers.

Built entirely on TTC's official open feeds — no API key required:

  • Static GTFS (routes, stops, schedules) from open.toronto.ca

  • GTFS-Realtime (vehicle positions, trip updates, service alerts) from bustime.ttc.ca

TypeScript · stdio + Streamable HTTP transports · self-hostable via Docker or Vercel.

Sibling project to go-planning-mcp (GO Transit / Metrolinx).

Status: in active development. Tracked via a wayfinder map under .wayfinder/ — most of the static-schedule surface (stops, routes, schedules) is implemented; real-time tools and plan_trip are landing incrementally. See the repo's open issues for exact status.

Scope notes

  • Real-time coverage (live positions & arrivals) is bus + streetcar only — TTC does not publish subway real-time. Subway is served from the static schedule plus service alerts.

  • Fares are a flat PRESTO fare with a 2-hour transfer window (no machine-readable fare data in the feed).

Related MCP server: openbusdata

Self-hosting

Quick start (Docker)

docker run -p 3000:3000 ghcr.io/emilsoleymani/ttc-mcp:latest

Or with the provided docker-compose.yml:

docker compose up -d

The image bakes a local libSQL file from TTC's live GTFS feed at build time, so it's self-contained — no external database needed. Once running, connect an MCP client to http://localhost:3000/mcp (Streamable HTTP), or curl http://localhost:3000/health for a liveness check.

Configuration

Var

Purpose

Default

LIBSQL_URL

Schedule DB connection: a file:... path (the Docker image's baked-in local file) or a libsql://...turso.io Turso URL

file:./data/ttc.db

LIBSQL_AUTH_TOKEN

Turso auth token (only needed when LIBSQL_URL points at Turso)

—

GTFS_RT_BASE_URL

Overridable GTFS-Realtime base URL

https://bustime.ttc.ca/gtfsrt

RT_CACHE_TTL_SECONDS

Coalescing cache window for decoded RT feeds

25

CACHE_ENABLED

Set false to disable RT response caching entirely

true

PORT

HTTP transport port

3000

Updating

The Docker image is self-contained, so picking up newer TTC schedule data means pulling a freshly-built image (the upstream GTFS Refresh workflow rebuilds and republishes on a weekly cadence, or trigger your own rebuild):

docker compose pull && docker compose up -d

If you instead point LIBSQL_URL at a shared Turso database, data freshness follows that database directly — no image update needed.

Building from source

git clone https://github.com/EmilSoleymani/ttc-mcp.git
cd ttc-mcp
npm ci
npm run ingest    # downloads the live TTC feed, builds ./data/ttc.db
npm run build
npm run start:http   # or: npm run start:stdio

License

MIT © 2026 Emil Soleymani

Available Tools

1 tool
get_fareGet TTC faresA

The current TTC fare table (adult/senior/youth/child by payment type) plus the 2-hour transfer rule. Fares are a flat, hand-maintained table — TTC publishes no machine-readable fare data. Optionally filter by category and/or fare_type.

Inputs: category, fare_type. Returns: fares, notes, transfer, source_url

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no risk of ambiguity or confusion.

    Naming Consistency5/5

    The single tool follows a clear verb_noun pattern, consistent with common conventions.

    Tool Count2/5

    A single tool for a transit server like TTC is extremely limited; typical servers would include many more tools for routes, schedules, stops, etc.

    Completeness2/5

    Only fare information is provided; there are obvious gaps for routes, schedules, real-time updates, and other transit data.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MVG Störung MCP Server

      rmoriz
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides cached access to Munich Public Transport (MVG) disruption data.
      Creative Commons Zero v1.0 Universal

    • openbusdata

      AndrewAubury
      A
      license
      C
      quality
      C
      maintenance
      MCP server for the UK Bus Open Data Service, enabling timetable queries, stop search, route discovery, journey planning, and real-time bus tracking.
      16
      22 PyPI
      MIT

    • mcp-hsl

      devusvulgaris
      A
      license
      A
      quality
      D
      maintenance
      An MCP server exposing Greater Helsinki public transport data from Digitransit, enabling LLM hosts to answer live transit queries, plan journeys, and fetch stop departures via natural language.
      3
      15 npm
      MIT