# lad-lviv-ua

Lviv (Ukraine) public transport MCP server — live arrivals, vehicle positions, stop discovery, route shapes, and static timetables. No API key required.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add vbhjckfd/lad-lviv-ua

# Browse available tools
npx -y smithery tool list vbhjckfd/lad-lviv-ua

# Get full schema for a tool
npx -y smithery tool get vbhjckfd/lad-lviv-ua get_stop_realtime

# Call a tool
npx -y smithery tool call vbhjckfd/lad-lviv-ua get_stop_realtime '{}'
```

## Direct MCP Connection

Endpoint: `https://lad-lviv-ua--vbhjckfd.run.tools`

## Tools (5)

- `get_stop_realtime` — Returns live arrivals and vehicle positions for a stop, producing both a map UI block and a structured arrival list. Us…
- `get_route_static` — Returns static route metadata: short and long name, vehicle type, brand colour, ordered stop lists for both directions,…
- `get_route_realtime` — Returns live positions for all vehicles currently running on a route, optimised for map rendering. Use when the user as…
- `get_stop_geometry` — Returns static map context for a stop: its marker and polylines for every route that serves it. No live data is fetched…
- `get_stops_around_location` — Discovers transit stops near a geographic point, returning each stop's numeric code, name, coordinates, and walking dis…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get vbhjckfd/lad-lviv-ua <tool-name>
```

## Resources

- `timetable://about` — Scope, usage, and data caveats for this server.
- `timetable://reference/tools` — What each MCP tool returns and when to use it.
- `timetable://reference/prompts` — Catalog of prompt templates (EN/UA) and their arguments.

## Prompts (3)

- `transit-map-view` (stop_id) — Render live vehicles on map for a stop.
- `transit-arrival-list` (stop_id) — Render upcoming arrivals list for a stop.
- `transit-hybrid-view` (stop_id) — Render map and arrival list together with synchronized ETA values.