# Lviv Public Transport

> Lviv Public Transport is a free MCP server for maps and travel. Keyless MCP endpoint for Lviv public transport: stops, timetables and live vehicles. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web, self-hosted
- **Website:** https://lad.lviv.ua
- **Repository:** https://github.com/vbhjckfd/timetable-api-node
- **MCP Registry name:** io.github.vbhjckfd/timetable-api-node
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

Built for Lviv's city transit, this read-only endpoint serves stops, routes, schedules and live vehicle positions at api.lad.lviv.ua/mcp, with no API key. The data comes from a static GTFS feed plus GTFS-RT vehicle position and trip update feeds, and the same codebase powers the lad.lviv.ua timetable and map site for buses, trams and trolleybuses.

The repository is a Node.js 26 Express app written in TypeScript with no build step for the server. You can run your own copy: import the GTFS feed with make import, then start it. Static data sits in LokiJS and SQLite stores. A stdio proxy package, timetable-mcp, forwards to the remote endpoint for clients that need it.

It is a niche, single-city server.

## Features

- **Stops and routes:** Look up Lviv stops and route data.
- **Timetables:** Scheduled departures from GTFS data.
- **Live vehicles:** Real-time positions from a GTFS-RT feed.
- **No API key:** Remote endpoint is open.
- **Self-hostable:** Import the GTFS feed and run your own server.

## Good for

- Ask when the next tram reaches a stop
- See where a route's vehicles are now
- Plan a Lviv trip in a chat assistant
- Build a local transit bot

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http timetable-api-node https://api.lad.lviv.ua/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.lad.lviv.ua/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "timetable-api-node": {
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "timetable-api-node": {
      "type": "http",
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "timetable-api-node": {
      "serverUrl": "https://api.lad.lviv.ua/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "timetable-api-node": {
      "type": "http",
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}
```

## Tools

- `get_stop_realtime`: Returns live arrivals at a stop: route, destination, vehicle type, minutes until arrival, and each vehicle's position. Use this as the **default tool** when the user asks about arrivals, departures, or the next bus/tram at a specific stop. Requires a numeric stop ID (shown on stop signage); use `search_stops` when you have a stop name, or `get_stops_around_location` when you have coordinates.
- `search_stops`: Finds stops by name (Ukrainian or English transliteration, case-insensitive, partial match) and returns each stop's numeric ID, coordinates, and the routes serving it. Use this as the **first step** when the user names a stop or landmark stop (e.g. "Опера", "Rynok", "Головний вокзал") and you need a stop ID for `get_stop_realtime` or `find_routes_between`. One name usually covers both sides of the
- `find_routes_between`: Lists the routes from one place to another: which stop to board, where to get off, the direction's destination, stops in between, and the walk at each end — best first, walking counted. Each end is a stop ID (`from_stop_id`) or coordinates (`from_lat` + `from_lng`), e.g. an address the user gave; a point covers every stop within a 600 m walk of it. `options` are direct routes. `transfer_options` h
- `get_route_static`: Returns static route data: name, long name, vehicle type, colour, the ordered stop list for both directions, and the timetable of departures from the first stop (workday, Saturday and Sunday). Use when the user asks which stops a route serves, where it goes, or its scheduled departure times. Set `include_shapes` only when you will draw the route on a map — the polylines are large and carry nothing
- `get_route_realtime`: Returns every vehicle currently running on a route: position, the destination it is heading to, and its next stop with estimated arrival. `headways` sums up each direction: how many vehicles run, the live gaps between consecutive vehicles in minutes (front to back), and how often the timetable says it should run right now. Use when the user asks "where is my tram/bus right now?", how many vehicles
- `get_disruptions`: Lists closures, detours and moved stops the city announced that are in force today: affected routes, the streets a detour uses, routes to take instead of a suspended one, reason, dates and source. The GTFS stop lists and timetables do not reflect any of this. Use when the user asks about road works, closures, detours, or why a route is not running or a vehicle is off its usual path. Pass `route` a
- `get_stops_around_location`: Finds stops near a geographic point, returning each stop's numeric ID, name, coordinates, walking distance, and the routes serving it. Use this as the **first step** when the user gives an address or coordinates and you need stop IDs for `get_stop_realtime` or `find_routes_between`. Use `search_stops` instead when the user gives a stop name. Default radius is 500 m (about a 6-minute walk), enough 
- `get_nearby_vehicles`: Returns live vehicles near a point, nearest first, each with its route, destination, and distance. Use when the user asks "what transport is near me right now?" or wants a live map around a location. Narrow with `route` when the user cares about one line; prefer `get_route_realtime` for a whole route and `get_stop_realtime` for arrival times at a stop. Requires decimal latitude and longitude (WGS8
- `get_vehicle_info`: Returns details for one vehicle by ID: position, route, destination, license plate, and its upcoming stops with names and estimated arrival times. Use when the user wants to follow a particular vehicle, e.g. "where does this tram go next?" or "when will it reach X?". Vehicle IDs come from `get_route_realtime`, `get_nearby_vehicles`, or `get_stop_realtime` results. Do NOT use this to get all vehicl

## FAQ

### Does it need a key?

No.

### Where does the data come from?

A GTFS feed plus GTFS-RT vehicle position and trip update feeds.

### Can I self-host?

Yes, with Node.js 26 after importing the GTFS feed.

### Is Lviv Public Transport free?

Yes. Lviv Public Transport is free to use.

### How do I add Lviv Public Transport to Claude Code?

Run this command in your terminal: claude mcp add --transport http timetable-api-node https://api.lad.lviv.ua/mcp

### What are the best alternatives to Lviv Public Transport?

The closest alternatives to Lviv Public Transport are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/lviv-public-transport
