Koskamo

Lviv Public Transport MCP

Provides an MCP server for LLM tool use to access real-time and static public transport data for Lviv, Ukraine. It supports querying live arrivals, stop details, route information, vehicle positions, and disruptions without requiring an API key.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Lviv Public Transport MCP logo, by Lviv Public TransportCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Lviv Public Transport
MCP endpoint (Streamable HTTP)
https://api.lad.lviv.ua/mcp
Vendor documentation

What its tools do

9 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

9 of 9 have a description · 9 of 9 declare behavior hints · 9 of 9 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Get live arrivals at a specific stop
  • Find stops within a radius of coordinates
  • Track live vehicle positions on a route
  • Check announced closures and detours

Source and maintenance

Community listingRegistry 1.8.13
Maintenance checked

Protocol and capabilities

Server
io.github.vbhjckfd/timetable-api-node 1.8.13
MCP protocol negotiated in check
2025-11-25
Tools
9 advertised
Resources
4 advertised
Resource templates
2 advertised
Prompts
5 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "listChanged": false
  },
  "completions": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Lviv, Ukraine public transport assistant. Read-only. No authentication required. ## Tool selection - User names a stop ("Опера", "Rynok", "Головний вокзал") → `search_stops` to get its stop ID - User gives an address or coordinates → `get_stops_around_location` to get nearby stop IDs - User asks about arrivals or "when is the next bus/tram at stop X" → `get_stop_realtime` - User asks how to get from A to B, how long it takes, or when to leave → `find_routes_between` with stop IDs or coordinates for each end (direct routes, or one interchange). Each option already carries live next departures and a timetable estimate; pass `depart_at` or `arrive_by` for another time - User asks "where is route X right now", how many vehicles run on it, or how often it runs → `get_route_realtime` (`headways` per direction) - User asks which stops a route serves, where it goes, or its timetable → `get_route_static` (`include_shapes: true` only for drawing a map) - User asks "what vehicles are near me" → `get_nearby_vehicles` (filter with `route` when relevant) - User needs step-free access (wheelchair, pram) → pass `lowfloor_only: true` to `get_stop_realtime` or `get_nearby_vehicles` - User wants to follow one vehicle by ID → `get_vehicle_info` - User asks about closures, road works, detours or why a route is not running → `get_disruptions` (optionally filtered by `route` or `stop_id`) ## Input conventions - Stop IDs are **numeric codes** printed on physical stop signage (e.g. 707). Accept both integer and digits-only string. - Route names are **short names** as shown on vehicles and stops (e.g. "Т30", "А1"); Latin letters ("T30", "A01") work too. Numeric external IDs are also accepted, so a bare number is not a route name. - Never guess a stop ID from a place name — resolve it with `search_stops` or `get_stops_around_location` first. `find_routes_between` also takes coordinates directly. - Times (`depart_at`, `arrive_by`, `schedule`) are Lviv local time, "HH:MM". - One stop name usually covers both sides of the street under different IDs; each direction stops on one of them. The `routes` list on each stop tells them apart. ## UI contract Every tool response is a JSON object with three top-level keys: - `view` — always `"transit_realtime"` - `data` — the structured payload; answer from this - `ui_blocks` — ordered rendering hints for map-capable clients; process in array order. Blocks point into `data` rather than repeating it. Block types: - `map` — render a map centred on `center [lat, lng]` at `zoom`. `layers` maps `stops`, `vehicles` and `polylines` to a dot path in the result (e.g. `"data.arrivals"`); plot what each path holds. Every stop and vehicle there has `lat`/`lng`; vehicles also have `bearing`. - `arrival_list` — render the arrivals at `source`, already sorted by `arrival_minutes`. Show `route`, `direction` (destination), `vehicle_type`, and ETA; a `null` `arrival_minutes` means no ETA. ## Data caveats - Live positions and ETAs come from upstream GTFS-RT feeds; occasional gaps or stale positions are expected. An arrival with `scheduled: true` is a timetable entry, not a tracked vehicle. - `find_routes_between` `schedule` times are estimates from per-stop timetables: ride times are inferred, not read off one trip, and public holidays run as their weekday. - `get_route_static` departure times (`departures` and `schedule.workday`/`saturday`/`sunday`) are only populated for the first stop of each direction. Saturday and Sunday timetables can differ; `schedule.weekend` merges both days and is kept only for backward compatibility. - `direction` is the index into `get_route_static`'s `stops` array (0 = outbound, 1 = return); `destination` is the name of that direction's last stop. - Detours, suspended routes and moved stops are not in the GTFS feed. `get_stop_realtime`, `get_route_static`, `get_route_realtime` and `find_routes_between` add a `disruptions` array when an announced one touches their routes or stops; always tell the user about it, since stop lists and timetables do not reflect it. - `find_routes_between` allows at most one interchange, made within a walkable stop cluster (≤ 300 m). Suspended routes and stops a detour skips are left out. `walk_meters` means the two stops are a short walk apart and no ride is needed; otherwise empty `options` and `transfer_options` mean the trip needs two or more transfers.

Tools

9 advertised

get_stop_realtime — Get Stop Realtime
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_stop_realtime input schema
{
  "type": "object",
  "required": [
    "stop_id"
  ],
  "properties": {
    "stop_id": {
      "type": "integer",
      "description": "Municipal stop code shown on stop signage (e.g. 707). Accepts a positive integer or an equivalent digit-only string.",
      "exclusiveMinimum": 0
    },
    "lowfloor_only": {
      "type": "boolean",
      "description": "Only low-floor arrivals (step-free: wheelchairs, prams). Timetable entries without a tracked vehicle are left out, since their floor is unknown. Default false."
    }
  }
}
get_stop_realtime output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "stop",
        "arrivals",
        "lowfloor_only",
        "updated_at"
      ],
      "properties": {
        "stop": {
          "type": "object",
          "required": [
            "id",
            "name",
            "lat",
            "lng"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "lat": {
              "type": [
                "number",
                "null"
              ]
            },
            "lng": {
              "type": [
                "number",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "arrivals": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "route",
              "direction",
              "vehicle_type",
              "arrival_minutes",
              "vehicle_id",
              "lat",
              "lng",
              "bearing",
              "lowfloor",
              "scheduled"
            ],
            "properties": {
              "lat": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lng": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "route": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "bearing": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lowfloor": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "direction": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "scheduled": {
                "type": "boolean"
              },
              "vehicle_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "vehicle_type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "arrival_minutes": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          }
        },
        "updated_at": {
          "type": "string"
        },
        "disruptions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "kind",
              "reason",
              "since",
              "until",
              "until_text",
              "routes",
              "stops",
              "alternatives",
              "detour",
              "area",
              "note",
              "source",
              "url"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "area": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "lat",
                  "lng",
                  "radius_meters"
                ],
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  },
                  "radius_meters": {
                    "type": "number"
                  }
                }
              },
              "kind": {
                "enum": [
                  "suspended",
                  "detour",
                  "stop_moved",
                  "stop_closed"
                ],
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "since": {
                "type": "string"
              },
              "stops": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "until": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "detour": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "via",
                  "skipped_stops"
                ],
                "properties": {
                  "via": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "skipped_stops": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  }
                }
              },
              "reason": {
                "type": "string"
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "until_text": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "lowfloor_only": {
          "type": "boolean"
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "type",
              "data"
            ],
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "center",
                  "zoom",
                  "layers"
                ],
                "properties": {
                  "zoom": {
                    "type": "number"
                  },
                  "center": {
                    "type": "array",
                    "items": false,
                    "maxItems": 2,
                    "minItems": 2,
                    "prefixItems": [
                      {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    ]
                  },
                  "layers": {
                    "type": "object",
                    "properties": {
                      "stops": {
                        "type": "string"
                      },
                      "vehicles": {
                        "type": "string"
                      },
                      "polylines": {
                        "type": "string"
                      }
                    }
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "map"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "type",
              "data"
            ],
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "source"
                ],
                "properties": {
                  "source": {
                    "type": "string"
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "arrival_list"
              }
            }
          }
        ]
      }
    }
  }
}
get_stop_realtime annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
search_stops — Search Stops
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 street under different IDs; each is returned, and the `routes` list tells them apart. Use `get_stops_around_location` instead when you have coordinates rather than a name.

search_stops input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum stops to return (1–25, default 10)."
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Stop name or part of it, e.g. \"Ринок\", \"opera\", \"Стрийська\"."
    }
  }
}
search_stops output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "query",
        "stops",
        "updated_at"
      ],
      "properties": {
        "query": {
          "type": "string"
        },
        "stops": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "name",
              "lat",
              "lng",
              "routes",
              "eng_name"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "lat": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lng": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "eng_name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "updated_at": {
          "type": "string"
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
search_stops annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
find_routes_between — Find Routes Between Stops
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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` have exactly one interchange (never more): ride `legs[0]`, walk `transfer_walk_meters` (within a 300 m stop cluster, 0 when it is the same stop) to `legs[1].board_stop`, ride `legs[1]`. They are listed when there is no direct route or when they beat the best direct one. Every option carries `schedule`: by the timetable, when to leave, when each leg boards and alights, when you arrive, and `total_minutes` door to door. Plan for now by default, or pass `depart_at` or `arrive_by` ("HH:MM" Lviv time today, or ISO 8601). When planning for now, options also carry `next_departures`: the live next departures of the first leg from its boarding stop, so no separate `get_stop_realtime` call is needed. `map_stops` holds the best trip's stops in riding order, each with a `role` (board, transfer — or transfer_alight + transfer_board when the interchange is a walk — and alight). Use when the user asks how to get from A to B, which bus/tram goes from one place to another, how long it takes, or when to leave to be somewhere on time. A stop end covers every stop within a 300 m walk of it, since a line's two directions often stop on opposite sides of a street under different names; `board_stop` says where to actually wait. Routes the city has suspended, and stops a detour skips, are left out. `walk_meters` is set when the two ends are within a 300 m walk of each other: no ride is searched then, so tell the user to walk. Otherwise both lists empty means the trip needs two or more transfers. Get stop IDs with `search_stops` or `get_stops_around_location`.

find_routes_between input schema
{
  "type": "object",
  "properties": {
    "to_lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Decimal latitude of the destination, WGS84 (e.g. 49.842 for central Lviv)."
    },
    "to_lng": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Decimal longitude of the destination, WGS84 (e.g. 24.031 for central Lviv)."
    },
    "from_lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Decimal latitude of the start point, WGS84 (e.g. 49.842 for central Lviv)."
    },
    "from_lng": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Decimal longitude of the start point, WGS84 (e.g. 24.031 for central Lviv)."
    },
    "arrive_by": {
      "type": "string",
      "description": "Arrive by this time: \"HH:MM\" Lviv time today, or ISO 8601. Not together with `depart_at`."
    },
    "depart_at": {
      "type": "string",
      "description": "Leave at this time: \"HH:MM\" Lviv time today, or ISO 8601. Default now. Not together with `arrive_by`."
    },
    "to_stop_id": {
      "type": "integer",
      "description": "Stop ID where the trip ends. Give this or `to_lat` + `to_lng`.",
      "exclusiveMinimum": 0
    },
    "from_stop_id": {
      "type": "integer",
      "description": "Stop ID where the trip starts. Give this or `from_lat` + `from_lng`.",
      "exclusiveMinimum": 0
    }
  }
}
find_routes_between output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "from",
        "to",
        "timing",
        "options",
        "transfer_options",
        "map_stops",
        "updated_at"
      ],
      "properties": {
        "to": {
          "type": "object",
          "required": [
            "id",
            "name",
            "stop_ids"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "point": {
              "type": "object",
              "required": [
                "lat",
                "lng"
              ],
              "properties": {
                "lat": {
                  "type": "number"
                },
                "lng": {
                  "type": "number"
                }
              }
            },
            "stop_ids": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "from": {
          "type": "object",
          "required": [
            "id",
            "name",
            "stop_ids"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "point": {
              "type": "object",
              "required": [
                "lat",
                "lng"
              ],
              "properties": {
                "lat": {
                  "type": "number"
                },
                "lng": {
                  "type": "number"
                }
              }
            },
            "stop_ids": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "timing": {
          "type": "object",
          "required": [
            "mode",
            "at"
          ],
          "properties": {
            "at": {
              "type": "string"
            },
            "mode": {
              "enum": [
                "depart_at",
                "arrive_by"
              ],
              "type": "string"
            }
          }
        },
        "options": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "route",
              "vehicle_type",
              "direction",
              "destination",
              "board_stop",
              "alight_stop",
              "stops_count",
              "walk_to_board_meters",
              "walk_from_alight_meters",
              "schedule"
            ],
            "properties": {
              "route": {
                "type": "string"
              },
              "schedule": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "leave_at",
                  "arrive_at",
                  "total_minutes",
                  "legs"
                ],
                "properties": {
                  "legs": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "board_at",
                        "alight_at"
                      ],
                      "properties": {
                        "board_at": {
                          "type": "string"
                        },
                        "alight_at": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "leave_at": {
                    "type": "string"
                  },
                  "arrive_at": {
                    "type": "string"
                  },
                  "total_minutes": {
                    "type": "integer"
                  }
                }
              },
              "direction": {
                "type": "integer"
              },
              "board_stop": {
                "type": "object",
                "required": [
                  "id",
                  "name",
                  "lat",
                  "lng"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "lat": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "lng": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "alight_stop": {
                "type": "object",
                "required": [
                  "id",
                  "name",
                  "lat",
                  "lng"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "lat": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "lng": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "destination": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "stops_count": {
                "type": "integer"
              },
              "vehicle_type": {
                "type": "string"
              },
              "next_departures": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "arrival_minutes",
                    "scheduled",
                    "vehicle_id",
                    "lowfloor"
                  ],
                  "properties": {
                    "lowfloor": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "scheduled": {
                      "type": "boolean"
                    },
                    "vehicle_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "arrival_minutes": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  }
                }
              },
              "walk_to_board_meters": {
                "type": "integer"
              },
              "walk_from_alight_meters": {
                "type": "integer"
              }
            }
          }
        },
        "map_stops": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "name",
              "lat",
              "lng",
              "role"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "lat": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lng": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "role": {
                "enum": [
                  "board",
                  "transfer",
                  "transfer_alight",
                  "transfer_board",
                  "alight"
                ],
                "type": "string"
              }
            }
          }
        },
        "updated_at": {
          "type": "string"
        },
        "disruptions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "kind",
              "reason",
              "since",
              "until",
              "until_text",
              "routes",
              "stops",
              "alternatives",
              "detour",
              "area",
              "note",
              "source",
              "url"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "area": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "lat",
                  "lng",
                  "radius_meters"
                ],
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  },
                  "radius_meters": {
                    "type": "number"
                  }
                }
              },
              "kind": {
                "enum": [
                  "suspended",
                  "detour",
                  "stop_moved",
                  "stop_closed"
                ],
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "since": {
                "type": "string"
              },
              "stops": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "until": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "detour": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "via",
                  "skipped_stops"
                ],
                "properties": {
                  "via": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "skipped_stops": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  }
                }
              },
              "reason": {
                "type": "string"
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "until_text": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "walk_meters": {
          "type": "integer"
        },
        "transfer_options": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "legs",
              "transfer_walk_meters",
              "stops_count",
              "walk_to_board_meters",
              "walk_from_alight_meters",
              "schedule"
            ],
            "properties": {
              "legs": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "route",
                    "vehicle_type",
                    "direction",
                    "destination",
                    "board_stop",
                    "alight_stop",
                    "stops_count"
                  ],
                  "properties": {
                    "route": {
                      "type": "string"
                    },
                    "direction": {
                      "type": "integer"
                    },
                    "board_stop": {
                      "type": "object",
                      "required": [
                        "id",
                        "name",
                        "lat",
                        "lng"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "lat": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "lng": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    },
                    "alight_stop": {
                      "type": "object",
                      "required": [
                        "id",
                        "name",
                        "lat",
                        "lng"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "lat": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "lng": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    },
                    "destination": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "stops_count": {
                      "type": "integer"
                    },
                    "vehicle_type": {
                      "type": "string"
                    }
                  }
                }
              },
              "schedule": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "leave_at",
                  "arrive_at",
                  "total_minutes",
                  "legs"
                ],
                "properties": {
                  "legs": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "board_at",
                        "alight_at"
                      ],
                      "properties": {
                        "board_at": {
                          "type": "string"
                        },
                        "alight_at": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "leave_at": {
                    "type": "string"
                  },
                  "arrive_at": {
                    "type": "string"
                  },
                  "total_minutes": {
                    "type": "integer"
                  }
                }
              },
              "stops_count": {
                "type": "integer"
              },
              "next_departures": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "arrival_minutes",
                    "scheduled",
                    "vehicle_id",
                    "lowfloor"
                  ],
                  "properties": {
                    "lowfloor": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "scheduled": {
                      "type": "boolean"
                    },
                    "vehicle_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "arrival_minutes": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  }
                }
              },
              "transfer_walk_meters": {
                "type": "integer"
              },
              "walk_to_board_meters": {
                "type": "integer"
              },
              "walk_from_alight_meters": {
                "type": "integer"
              }
            }
          }
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
find_routes_between annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
get_route_static — Get Route Static
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 a text answer needs. Do NOT use this for live vehicle positions — use `get_route_realtime` instead. Requires a route short name (e.g. "T30", "32A") or numeric external ID.

get_route_static input schema
{
  "type": "object",
  "required": [
    "route_name"
  ],
  "properties": {
    "route_name": {
      "type": "string",
      "minLength": 1,
      "description": "Route short name (e.g. \"T30\", \"32A\") or numeric external ID."
    },
    "include_shapes": {
      "type": "boolean",
      "description": "Include route polylines ([lat, lng] points per direction) for map drawing. Default false."
    }
  }
}
get_route_static output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "route",
        "stops",
        "updated_at"
      ],
      "properties": {
        "route": {
          "type": "object",
          "required": [
            "name",
            "long_name",
            "color",
            "type"
          ],
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "type": [
                "string",
                "null"
              ]
            },
            "color": {
              "type": [
                "string",
                "null"
              ]
            },
            "long_name": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "stops": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "lat",
                "lng",
                "departures"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "lat": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "lng": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "schedule": {
                  "type": "object",
                  "required": [
                    "workday",
                    "saturday",
                    "sunday",
                    "weekend"
                  ],
                  "properties": {
                    "sunday": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "weekend": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "workday": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "saturday": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                },
                "departures": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "shapes": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          }
        },
        "updated_at": {
          "type": "string"
        },
        "disruptions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "kind",
              "reason",
              "since",
              "until",
              "until_text",
              "routes",
              "stops",
              "alternatives",
              "detour",
              "area",
              "note",
              "source",
              "url"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "area": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "lat",
                  "lng",
                  "radius_meters"
                ],
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  },
                  "radius_meters": {
                    "type": "number"
                  }
                }
              },
              "kind": {
                "enum": [
                  "suspended",
                  "detour",
                  "stop_moved",
                  "stop_closed"
                ],
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "since": {
                "type": "string"
              },
              "stops": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "until": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "detour": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "via",
                  "skipped_stops"
                ],
                "properties": {
                  "via": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "skipped_stops": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  }
                }
              },
              "reason": {
                "type": "string"
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "until_text": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
get_route_static annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
get_route_realtime — Get Route Realtime
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 are running, how far the next one is, or how often a route runs. Pass `direction` (0 or 1, as in `get_route_static`'s `stops`) to get only one way. Prefer `get_stop_realtime` when the user is at a stop and wants arrival times there. Requires a route short name (e.g. "T30", "32A") or numeric external ID.

get_route_realtime input schema
{
  "type": "object",
  "required": [
    "route_name"
  ],
  "properties": {
    "direction": {
      "type": "integer",
      "maximum": 1,
      "minimum": 0,
      "description": "Only vehicles heading this way: 0 or 1, the index into get_route_static's `stops`. Omit for both."
    },
    "route_name": {
      "type": "string",
      "minLength": 1,
      "description": "Route short name (e.g. \"T30\", \"32A\") or numeric external ID."
    }
  }
}
get_route_realtime output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "route_name",
        "destinations",
        "direction",
        "vehicles",
        "headways",
        "updated_at"
      ],
      "properties": {
        "headways": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "direction",
              "destination",
              "vehicles",
              "gaps_minutes",
              "scheduled_headway_minutes"
            ],
            "properties": {
              "vehicles": {
                "type": "integer"
              },
              "direction": {
                "type": "integer"
              },
              "destination": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "gaps_minutes": {
                "type": "array",
                "items": {
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "scheduled_headway_minutes": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          }
        },
        "vehicles": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "direction",
              "destination",
              "next_stop",
              "lat",
              "lng",
              "bearing",
              "lowfloor"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "lat": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lng": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "bearing": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lowfloor": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "direction": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "next_stop": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "id",
                  "name",
                  "arrival"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "arrival": {
                    "type": "string"
                  }
                }
              },
              "destination": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "direction": {
          "type": [
            "integer",
            "null"
          ]
        },
        "route_name": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        },
        "disruptions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "kind",
              "reason",
              "since",
              "until",
              "until_text",
              "routes",
              "stops",
              "alternatives",
              "detour",
              "area",
              "note",
              "source",
              "url"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "area": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "lat",
                  "lng",
                  "radius_meters"
                ],
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  },
                  "radius_meters": {
                    "type": "number"
                  }
                }
              },
              "kind": {
                "enum": [
                  "suspended",
                  "detour",
                  "stop_moved",
                  "stop_closed"
                ],
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "since": {
                "type": "string"
              },
              "stops": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "until": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "detour": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "via",
                  "skipped_stops"
                ],
                "properties": {
                  "via": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "skipped_stops": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  }
                }
              },
              "reason": {
                "type": "string"
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "until_text": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "destinations": {
          "type": "array",
          "items": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
get_route_realtime annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
get_disruptions — Get Disruptions
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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` and/or `stop_id` to get only the entries touching them; omit both for the whole city.

get_disruptions input schema
{
  "type": "object",
  "properties": {
    "route": {
      "type": "string",
      "minLength": 1,
      "description": "Only disruptions on this route, by short name (e.g. \"Т30\", \"А34\"). Omit for all routes."
    },
    "stop_id": {
      "type": "integer",
      "description": "Only disruptions at this stop. Omit for all stops.",
      "exclusiveMinimum": 0
    }
  }
}
get_disruptions output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "route",
        "stop_id",
        "disruptions",
        "updated_at"
      ],
      "properties": {
        "route": {
          "type": [
            "string",
            "null"
          ]
        },
        "stop_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "updated_at": {
          "type": "string"
        },
        "disruptions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "kind",
              "reason",
              "since",
              "until",
              "until_text",
              "routes",
              "stops",
              "alternatives",
              "detour",
              "area",
              "note",
              "source",
              "url"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "area": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "lat",
                  "lng",
                  "radius_meters"
                ],
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  },
                  "radius_meters": {
                    "type": "number"
                  }
                }
              },
              "kind": {
                "enum": [
                  "suspended",
                  "detour",
                  "stop_moved",
                  "stop_closed"
                ],
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "since": {
                "type": "string"
              },
              "stops": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "until": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "detour": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "via",
                  "skipped_stops"
                ],
                "properties": {
                  "via": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "skipped_stops": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  }
                }
              },
              "reason": {
                "type": "string"
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "until_text": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
get_disruptions annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
get_stops_around_location — Get Stops Around Location
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 1 000 m; narrow it (e.g. 300 m) for dense urban areas or widen it (up to 3 000 m) for rural locations.

get_stops_around_location input schema
{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Decimal latitude of the search centre, WGS84 (e.g. 49.842 for central Lviv)."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Decimal longitude of the search centre, WGS84 (e.g. 24.031 for central Lviv)."
    },
    "radius_meters": {
      "type": "integer",
      "maximum": 3000,
      "minimum": 50,
      "description": "Search radius in metres (50–3000, default 1000). Use ~300 for dense urban intersections, up to 3000 for suburban or rural areas."
    }
  }
}
get_stops_around_location output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "center_lat",
        "center_lng",
        "radius_meters",
        "stops",
        "updated_at"
      ],
      "properties": {
        "stops": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "name",
              "lat",
              "lng",
              "routes",
              "distance_meters"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "lat": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lng": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "routes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "distance_meters": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        },
        "center_lat": {
          "type": [
            "number",
            "null"
          ]
        },
        "center_lng": {
          "type": [
            "number",
            "null"
          ]
        },
        "updated_at": {
          "type": "string"
        },
        "radius_meters": {
          "type": "number"
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
get_stops_around_location annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
get_nearby_vehicles — Get Nearby Vehicles
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 (WGS84).

get_nearby_vehicles input schema
{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum vehicles to return, nearest first (1–50, default 15). `total` reports how many were in range."
    },
    "route": {
      "type": "string",
      "minLength": 1,
      "description": "Only vehicles on this route, by short name (e.g. \"Т30\", \"А1\"). Omit for all routes."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Decimal latitude of the centre point, WGS84 (e.g. 49.842 for central Lviv)."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Decimal longitude of the centre point, WGS84 (e.g. 24.031 for central Lviv)."
    },
    "lowfloor_only": {
      "type": "boolean",
      "description": "Only low-floor vehicles (step-free: wheelchairs, prams). Timetable entries without a tracked vehicle are left out, since their floor is unknown. Default false."
    },
    "radius_meters": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 100,
      "description": "Search radius in metres (100–1000, default 500)."
    }
  }
}
get_nearby_vehicles output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "center_lat",
        "center_lng",
        "radius_meters",
        "lowfloor_only",
        "total",
        "vehicles",
        "updated_at"
      ],
      "properties": {
        "total": {
          "type": "integer"
        },
        "vehicles": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "route",
              "vehicle_type",
              "direction",
              "destination",
              "lat",
              "lng",
              "bearing",
              "lowfloor",
              "distance_meters"
            ],
            "properties": {
              "id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "lat": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lng": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "route": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "bearing": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lowfloor": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "direction": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "destination": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "vehicle_type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_meters": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        },
        "center_lat": {
          "type": [
            "number",
            "null"
          ]
        },
        "center_lng": {
          "type": [
            "number",
            "null"
          ]
        },
        "updated_at": {
          "type": "string"
        },
        "lowfloor_only": {
          "type": "boolean"
        },
        "radius_meters": {
          "type": "number"
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
get_nearby_vehicles annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}
get_vehicle_info — Get Vehicle Info
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 vehicles on a route — use `get_route_realtime` instead.

get_vehicle_info input schema
{
  "type": "object",
  "required": [
    "vehicle_id"
  ],
  "properties": {
    "vehicle_id": {
      "type": "string",
      "minLength": 1,
      "description": "Vehicle ID as returned by get_route_realtime, get_nearby_vehicles, or get_stop_realtime."
    }
  }
}
get_vehicle_info output schema
{
  "type": "object",
  "required": [
    "view",
    "data",
    "ui_blocks"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "vehicle_id",
        "route",
        "license_plate",
        "lat",
        "lng",
        "bearing",
        "direction",
        "destination",
        "upcoming_stops",
        "updated_at"
      ],
      "properties": {
        "lat": {
          "type": [
            "number",
            "null"
          ]
        },
        "lng": {
          "type": [
            "number",
            "null"
          ]
        },
        "route": {
          "type": [
            "string",
            "null"
          ]
        },
        "bearing": {
          "type": [
            "number",
            "null"
          ]
        },
        "direction": {
          "type": [
            "integer",
            "null"
          ]
        },
        "updated_at": {
          "type": "string"
        },
        "vehicle_id": {
          "type": "string"
        },
        "destination": {
          "type": [
            "string",
            "null"
          ]
        },
        "license_plate": {
          "type": [
            "string",
            "null"
          ]
        },
        "upcoming_stops": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id",
              "name",
              "arrival",
              "departure"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "arrival": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "departure": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "view": {
      "type": "string",
      "const": "transit_realtime"
    },
    "ui_blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "center",
              "zoom",
              "layers"
            ],
            "properties": {
              "zoom": {
                "type": "number"
              },
              "center": {
                "type": "array",
                "items": false,
                "maxItems": 2,
                "minItems": 2,
                "prefixItems": [
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                ]
              },
              "layers": {
                "type": "object",
                "properties": {
                  "stops": {
                    "type": "string"
                  },
                  "vehicles": {
                    "type": "string"
                  },
                  "polylines": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "type": {
            "type": "string",
            "const": "map"
          }
        }
      }
    }
  }
}
get_vehicle_info annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

Prompts

5 advertised

transit-map-view — Transit Map View

Advertised by the server during the last successful anonymous check.

Render live vehicles on map for a stop.

stop_id
Municipal stop code shown on stop signage (e.g. 707). Accepts a positive integer or an equivalent digit-only string. (required)
transit-arrival-list — Transit Arrival List

Advertised by the server during the last successful anonymous check.

Render upcoming arrivals list for a stop.

stop_id
Municipal stop code shown on stop signage (e.g. 707). Accepts a positive integer or an equivalent digit-only string. (required)
transit-hybrid-view — Transit Hybrid View

Advertised by the server during the last successful anonymous check.

Render map and arrival list together with synchronized ETA values.

stop_id
Municipal stop code shown on stop signage (e.g. 707). Accepts a positive integer or an equivalent digit-only string. (required)
plan-trip — Plan a Trip

Advertised by the server during the last successful anonymous check.

Find routes (direct or with one transfer) between two places in Lviv, the next live departures and when to leave.

from
Where the trip starts: stop name, landmark, numeric stop ID, or "lat,lng". (required)
to
Where the trip ends: stop name, landmark, numeric stop ID, or "lat,lng". (required)
arrive_by
Optional: "HH:MM" (Lviv time) the rider has to be there by.
route-status — Route Status

Advertised by the server during the last successful anonymous check.

Where the vehicles of one route are right now.

route_name
Route short name (e.g. "T30", "32A") or numeric external ID. (required)

Resources

4 advertised

about — About Lviv Public Transport MCP

Advertised by the server during the last successful anonymous check.

Scope, usage, and data caveats for this server.

about URI
timetable://about

MIME type: text/markdown

tools-reference — Tools reference

Advertised by the server during the last successful anonymous check.

What each MCP tool returns and when to use it.

tools-reference URI
timetable://reference/tools

MIME type: text/markdown

prompts-reference — Prompts reference

Advertised by the server during the last successful anonymous check.

Catalog of prompt templates and their arguments.

prompts-reference URI
timetable://reference/prompts

MIME type: text/markdown

routes — All routes

Advertised by the server during the last successful anonymous check.

Every route's short name, long name, vehicle type and the terminus of each direction. Names here are what the route tools take.

routes URI
timetable://routes

MIME type: application/json

stop-template — Stop static info

Advertised by the server during the last successful anonymous check.

Static info for a stop by numeric code (name, routes served). Use timetable://stop/707 for stop 707.

stop-template URI template
timetable://stop/{code}

MIME type: application/json

route-template — Route static info

Advertised by the server during the last successful anonymous check.

Static metadata for a route by short name (e.g. timetable://route/T30). Returns stop counts and color.

route-template URI template
timetable://route/{name}

MIME type: application/json

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
2499 ms
95th percentile latency
2499 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 2499 ms · metadata changed · 9 tool(s), 4 resource(s), 2 resource template(s), 5 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http lviv-public-transport-mcp https://api.lad.lviv.ua/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add lviv-public-transport-mcp --url https://api.lad.lviv.ua/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable lviv-public-transport-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "lviv-public-transport-mcp": {
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "lviv-public-transport-mcp": {
      "type": "streamableHttp",
      "url": "https://api.lad.lviv.ua/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start lviv-public-transport-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "lviv-public-transport-mcp": {
      "type": "http",
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http lviv-public-transport-mcp https://api.lad.lviv.ua/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.lad.lviv.ua/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "lviv-public-transport-mcp": {
      "serverUrl": "https://api.lad.lviv.ua/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Lviv Public Transport MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.