Server definition
- Hash
- sha256:bf2b15d87fac83dc6998f1269dbb63fce0143e36656fdc326a30ae34c2d5d30f
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": "Lviv, Ukraine public transport assistant. Read-only. No authentication required.\n\n## Tool selection\n\n- User names a stop (\"Опера\", \"Rynok\", \"Головний вокзал\") → `search_stops` to get its stop ID\n- User gives an address or coordinates → `get_stops_around_location` to get nearby stop IDs\n- User asks about arrivals or \"when is the next bus/tram at stop X\" → `get_stop_realtime`\n- User asks how to get from A to B → resolve both stops, then `find_routes_between`; then `get_stop_realtime` on the boarding stop for live times\n- User asks \"where is route X right now\" or how many vehicles run on it → `get_route_realtime`\n- User asks which stops a route serves, where it goes, or its timetable → `get_route_static` (`include_shapes: true` only for drawing a map)\n- User asks \"what vehicles are near me\" → `get_nearby_vehicles` (filter with `route` when relevant)\n- User wants to follow one vehicle by ID → `get_vehicle_info`\n\n## Input conventions\n\n- Stop IDs are **numeric codes** printed on physical stop signage (e.g. 707). Accept both integer and digits-only string.\n- 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.\n- Never guess a stop ID from a place name — resolve it with `search_stops` or `get_stops_around_location` first.\n- 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.\n\n## UI contract\n\nEvery tool response is a JSON object with three top-level keys:\n- `view` — always `\"transit_realtime\"`\n- `data` — the structured payload; answer from this\n- `ui_blocks` — ordered rendering hints for map-capable clients; process in array order. Blocks point into `data` rather than repeating it.\n\nBlock types:\n- `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`.\n- `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.\n\n## Data caveats\n\n- Live positions and ETAs come from upstream GTFS-RT feeds; occasional gaps or stale positions are expected.\n- `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.\n- `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.\n- `find_routes_between` covers direct routes only; an empty result means a transfer is needed.\n",
"tools": [
{
"description": "Lists the direct routes (no transfer) 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. Use when the user asks how to get from A to B, or which bus/tram goes from one place to another. Each end covers every stop within a 300 m walk of the one given, since a line's two directions often stop on opposite sides of a street under different names; `board_stop` says where to actually wait. An empty `options` list means no direct route: a transfer is needed. Requires numeric stop IDs; get them with `search_stops` or `get_stops_around_location` first. Follow up with `get_stop_realtime` on `board_stop` for live departures.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from_stop_id": {
"description": "Stop ID where the trip starts.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"to_stop_id": {
"description": "Stop ID where the trip ends.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"from_stop_id",
"to_stop_id"
],
"type": "object"
},
"name": "find_routes_between",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"from": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"stop_ids": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"stop_ids"
],
"type": "object"
},
"options": {
"items": {
"additionalProperties": false,
"properties": {
"alight_stop": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"lat",
"lng"
],
"type": "object"
},
"board_stop": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"lat",
"lng"
],
"type": "object"
},
"destination": {
"type": [
"string",
"null"
]
},
"direction": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"route": {
"type": "string"
},
"stops_count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"vehicle_type": {
"type": "string"
},
"walk_from_alight_meters": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"walk_to_board_meters": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"route",
"vehicle_type",
"direction",
"destination",
"board_stop",
"alight_stop",
"stops_count",
"walk_to_board_meters",
"walk_from_alight_meters"
],
"type": "object"
},
"type": "array"
},
"to": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"stop_ids": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"stop_ids"
],
"type": "object"
},
"updated_at": {
"type": "string"
}
},
"required": [
"from",
"to",
"options",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"latitude": {
"description": "Decimal latitude of the centre point, WGS84 (e.g. 49.842 for central Lviv).",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"limit": {
"description": "Maximum vehicles to return, nearest first (1–50, default 15). `total` reports how many were in range.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"longitude": {
"description": "Decimal longitude of the centre point, WGS84 (e.g. 24.031 for central Lviv).",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"radius_meters": {
"description": "Search radius in metres (100–1000, default 500).",
"maximum": 1000,
"minimum": 100,
"type": "integer"
},
"route": {
"description": "Only vehicles on this route, by short name (e.g. \"Т30\", \"А1\"). Omit for all routes.",
"minLength": 1,
"type": "string"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"name": "get_nearby_vehicles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center_lat": {
"type": [
"number",
"null"
]
},
"center_lng": {
"type": [
"number",
"null"
]
},
"radius_meters": {
"type": "number"
},
"total": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"updated_at": {
"type": "string"
},
"vehicles": {
"items": {
"additionalProperties": false,
"properties": {
"bearing": {
"type": [
"number",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"direction": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"distance_meters": {
"type": [
"number",
"null"
]
},
"id": {
"type": [
"string",
"null"
]
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"lowfloor": {
"type": [
"boolean",
"null"
]
},
"route": {
"type": [
"string",
"null"
]
},
"vehicle_type": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"route",
"vehicle_type",
"direction",
"destination",
"lat",
"lng",
"bearing",
"lowfloor",
"distance_meters"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"center_lat",
"center_lng",
"radius_meters",
"total",
"vehicles",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "Returns every vehicle currently running on a route: position, the destination it is heading to, and its next stop with estimated arrival. Use when the user asks \"where is my tram/bus right now?\", how many vehicles are running, or how far the next one is. 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"route_name": {
"description": "Route short name (e.g. \"T30\", \"32A\") or numeric external ID.",
"minLength": 1,
"type": "string"
}
},
"required": [
"route_name"
],
"type": "object"
},
"name": "get_route_realtime",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"destinations": {
"items": {
"type": [
"string",
"null"
]
},
"type": "array"
},
"route_name": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"vehicles": {
"items": {
"additionalProperties": false,
"properties": {
"bearing": {
"type": [
"number",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"direction": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"lowfloor": {
"type": [
"boolean",
"null"
]
},
"next_stop": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arrival": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"arrival"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"direction",
"destination",
"next_stop",
"lat",
"lng",
"bearing",
"lowfloor"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"route_name",
"destinations",
"vehicles",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"include_shapes": {
"description": "Include route polylines ([lat, lng] points per direction) for map drawing. Default false.",
"type": "boolean"
},
"route_name": {
"description": "Route short name (e.g. \"T30\", \"32A\") or numeric external ID.",
"minLength": 1,
"type": "string"
}
},
"required": [
"route_name"
],
"type": "object"
},
"name": "get_route_static",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"route": {
"additionalProperties": false,
"properties": {
"color": {
"type": [
"string",
"null"
]
},
"long_name": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"long_name",
"color",
"type"
],
"type": "object"
},
"shapes": {
"items": {
"items": {
"items": {
"type": "number"
},
"type": "array"
},
"type": "array"
},
"type": "array"
},
"stops": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"departures": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"schedule": {
"additionalProperties": false,
"properties": {
"saturday": {
"items": {
"type": "string"
},
"type": "array"
},
"sunday": {
"items": {
"type": "string"
},
"type": "array"
},
"weekend": {
"items": {
"type": "string"
},
"type": "array"
},
"workday": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"workday",
"saturday",
"sunday",
"weekend"
],
"type": "object"
}
},
"required": [
"id",
"name",
"lat",
"lng",
"departures"
],
"type": "object"
},
"type": "array"
},
"type": "array"
},
"updated_at": {
"type": "string"
}
},
"required": [
"route",
"stops",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"stop_id": {
"description": "Municipal stop code shown on stop signage (e.g. 707). Accepts a positive integer or an equivalent digit-only string.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"stop_id"
],
"type": "object"
},
"name": "get_stop_realtime",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"arrivals": {
"items": {
"additionalProperties": false,
"properties": {
"arrival_minutes": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"bearing": {
"type": [
"number",
"null"
]
},
"direction": {
"type": [
"string",
"null"
]
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"route": {
"type": [
"string",
"null"
]
},
"vehicle_id": {
"type": [
"string",
"null"
]
},
"vehicle_type": {
"type": [
"string",
"null"
]
}
},
"required": [
"route",
"direction",
"vehicle_type",
"arrival_minutes",
"vehicle_id",
"lat",
"lng",
"bearing"
],
"type": "object"
},
"type": "array"
},
"stop": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"lat",
"lng"
],
"type": "object"
},
"updated_at": {
"type": "string"
}
},
"required": [
"stop",
"arrivals",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"source": {
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"type": {
"const": "arrival_list",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
}
]
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"latitude": {
"description": "Decimal latitude of the search centre, WGS84 (e.g. 49.842 for central Lviv).",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Decimal longitude of the search centre, WGS84 (e.g. 24.031 for central Lviv).",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"radius_meters": {
"description": "Search radius in metres (50–3000, default 1000). Use ~300 for dense urban intersections, up to 3000 for suburban or rural areas.",
"maximum": 3000,
"minimum": 50,
"type": "integer"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"name": "get_stops_around_location",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center_lat": {
"type": [
"number",
"null"
]
},
"center_lng": {
"type": [
"number",
"null"
]
},
"radius_meters": {
"type": "number"
},
"stops": {
"items": {
"additionalProperties": false,
"properties": {
"distance_meters": {
"type": [
"number",
"null"
]
},
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"routes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"lat",
"lng",
"routes",
"distance_meters"
],
"type": "object"
},
"type": "array"
},
"updated_at": {
"type": "string"
}
},
"required": [
"center_lat",
"center_lng",
"radius_meters",
"stops",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"vehicle_id": {
"description": "Vehicle ID as returned by get_route_realtime, get_nearby_vehicles, or get_stop_realtime.",
"minLength": 1,
"type": "string"
}
},
"required": [
"vehicle_id"
],
"type": "object"
},
"name": "get_vehicle_info",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"bearing": {
"type": [
"number",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"direction": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"lat": {
"type": [
"number",
"null"
]
},
"license_plate": {
"type": [
"string",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"route": {
"type": [
"string",
"null"
]
},
"upcoming_stops": {
"items": {
"additionalProperties": false,
"properties": {
"arrival": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"arrival",
"departure"
],
"type": "object"
},
"type": "array"
},
"updated_at": {
"type": "string"
},
"vehicle_id": {
"type": "string"
}
},
"required": [
"vehicle_id",
"route",
"license_plate",
"lat",
"lng",
"bearing",
"direction",
"destination",
"upcoming_stops",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"description": "Maximum stops to return (1–25, default 10).",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Stop name or part of it, e.g. \"Ринок\", \"opera\", \"Стрийська\".",
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_stops",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"query": {
"type": "string"
},
"stops": {
"items": {
"additionalProperties": false,
"properties": {
"eng_name": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"lat": {
"type": [
"number",
"null"
]
},
"lng": {
"type": [
"number",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"routes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"lat",
"lng",
"routes",
"eng_name"
],
"type": "object"
},
"type": "array"
},
"updated_at": {
"type": "string"
}
},
"required": [
"query",
"stops",
"updated_at"
],
"type": "object"
},
"ui_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"center": {
"additionalItems": false,
"items": [
{
"type": [
"number",
"null"
]
},
{
"type": [
"number",
"null"
]
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"layers": {
"additionalProperties": false,
"properties": {
"polylines": {
"type": "string"
},
"stops": {
"type": "string"
},
"vehicles": {
"type": "string"
}
},
"type": "object"
},
"zoom": {
"type": "number"
}
},
"required": [
"center",
"zoom",
"layers"
],
"type": "object"
},
"type": {
"const": "map",
"type": "string"
}
},
"required": [
"type",
"data"
],
"type": "object"
},
"type": "array"
},
"view": {
"const": "transit_realtime",
"type": "string"
}
},
"required": [
"view",
"data",
"ui_blocks"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:bf2b15d87fac83dc6998f1269dbb63fce0143e36656fdc326a30ae34c2d5d30f | sha256sum