Lviv Public Transport

Get Nearby Vehicles

get_nearby_vehicles

Read-onlyIdempotent

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

Input Schema

Name	Required	Description
`limit`	No	Maximum vehicles to return, nearest first (1–50, default 15). `total` reports how many were in range.
`route`	No	Only vehicles on this route, by short name (e.g. "Т30", "А1"). Omit for all routes.
`latitude`	Yes	Decimal latitude of the centre point, WGS84 (e.g. 49.842 for central Lviv).
`longitude`	Yes	Decimal longitude of the centre point, WGS84 (e.g. 24.031 for central Lviv).
`lowfloor_only`	No	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`	No	Search radius in metres (100–1000, default 500).

Output Schema

Name	Required	Description	Default
`data`	Yes
`view`	Yes
`ui_blocks`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedNov 4, 2026
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / center / additionalItems
```
Removed value: -false
```
- changedOutput schema / properties / ui_blocks / items / properties / data / properties / center / items
```
Previous value: -[
-  {
-    "type": [
-      "number",
-      "null"
-    ]
-  },
-  {
-    "type": [
-      "number",
-      "null"
-    ]
-  }
-]New value: +false
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / center / prefixItems
```
Added value: +[
+  {
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  {
+    "type": [
+      "number",
+      "null"
+    ]
+  }
+]
```
Changed12 schema fields changedNov 2, 2026
- removedInput schema / $schema
```
Removed value: -"http://json-schema.org/draft-07/schema#"
```
- removedOutput schema / $schema
```
Removed value: -"http://json-schema.org/draft-07/schema#"
```
- removedOutput schema / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / data / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / data / properties / total / maximum
```
Removed value: -9007199254740991
```
- removedOutput schema / properties / data / properties / total / minimum
```
Removed value: --9007199254740991
```
- removedOutput schema / properties / data / properties / vehicles / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / direction / anyOf
```
Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / direction / type
```
Added value: +[
+  "integer",
+  "null"
+]
```
- removedOutput schema / properties / ui_blocks / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / ui_blocks / items / properties / data / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / layers / additionalProperties
```
Removed value: -false
```

Changed3 schema fields changedOct 25, 2026

addedInput schema / properties / lowfloor_only

Added value: +{
+  "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.",
+  "type": "boolean"
+}

addedOutput schema / properties / data / properties / lowfloor_only
```
Added value: +{
+  "type": "boolean"
+}
```

changedOutput schema / properties / data / required

Previous value: -[
-  "center_lat",
-  "center_lng",
-  "radius_meters",
-  "total",
-  "vehicles",
-  "updated_at"
-]New value: +[
+  "center_lat",
+  "center_lng",
+  "radius_meters",
+  "lowfloor_only",
+  "total",
+  "vehicles",
+  "updated_at"
+]

Changed16 schema fields changedSep 23, 2026

changedInput schema / properties / latitude / description

Previous value: -"Decimal latitude of the centre point, WGS84 (e.g. 49.842)."New value: +"Decimal latitude of the centre point, WGS84 (e.g. 49.842 for central Lviv)."

addedInput schema / properties / limit

Added value: +{
+  "description": "Maximum vehicles to return, nearest first (1–50, default 15). `total` reports how many were in range.",
+  "maximum": 50,
+  "minimum": 1,
+  "type": "integer"
+}

changedInput schema / properties / longitude / description

Previous value: -"Decimal longitude of the centre point, WGS84 (e.g. 24.031)."New value: +"Decimal longitude of the centre point, WGS84 (e.g. 24.031 for central Lviv)."

addedInput schema / properties / radius_meters

Added value: +{
+  "description": "Search radius in metres (100–1000, default 500).",
+  "maximum": 1000,
+  "minimum": 100,
+  "type": "integer"
+}

addedInput schema / properties / route

Added value: +{
+  "description": "Only vehicles on this route, by short name (e.g. \"Т30\", \"А1\"). Omit for all routes.",
+  "minLength": 1,
+  "type": "string"
+}

addedOutput schema / properties / data / properties / radius_meters
```
Added value: +{
+  "type": "number"
+}
```

addedOutput schema / properties / data / properties / total

Added value: +{
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

addedOutput schema / properties / data / properties / vehicles / items / properties / destination
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

addedOutput schema / properties / data / properties / vehicles / items / properties / direction

Added value: +{
+  "anyOf": [
+    {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / data / properties / vehicles / items / properties / distance_meters
```
Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
```
changedOutput schema / properties / data / properties / vehicles / items / properties / id / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / data / properties / vehicles / items / required

Previous value: -[
-  "id",
-  "route",
-  "vehicle_type",
-  "lat",
-  "lng",
-  "bearing",
-  "lowfloor"
-]New value: +[
+  "id",
+  "route",
+  "vehicle_type",
+  "direction",
+  "destination",
+  "lat",
+  "lng",
+  "bearing",
+  "lowfloor",
+  "distance_meters"
+]

changedOutput schema / properties / data / required

Previous value: -[
-  "center_lat",
-  "center_lng",
-  "vehicles",
-  "updated_at"
-]New value: +[
+  "center_lat",
+  "center_lng",
+  "radius_meters",
+  "total",
+  "vehicles",
+  "updated_at"
+]

addedOutput schema / properties / ui_blocks / items / properties / data / properties / layers

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "polylines": {
+      "type": "string"
+    },
+    "stops": {
+      "type": "string"
+    },
+    "vehicles": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

removedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles

Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "bearing": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "eta_minutes": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "eta_status": {
-        "enum": [
-          "assigned",
-          "unassigned"
-        ],
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "lat": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "lng": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "next_stop_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "route": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "id",
-      "route",
-      "lat",
-      "lng",
-      "bearing",
-      "next_stop_id",
-      "eta_minutes",
-      "eta_status"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

changedOutput schema / properties / ui_blocks / items / properties / data / required

Previous value: -[
-  "center",
-  "zoom",
-  "vehicles"
-]New value: +[
+  "center",
+  "zoom",
+  "layers"
+]

Changed30 schema fields changedSep 6, 2026
- removedOutput schema / properties / data / properties / center_lat / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / center_lat / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / center_lng / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / center_lng / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / bearing / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / bearing / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / lat / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / lat / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / lng / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / lng / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / lowfloor / anyOf
```
Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / lowfloor / type
```
Added value: +[
+  "boolean",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / route / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / route / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / data / properties / vehicles / items / properties / vehicle_type / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / data / properties / vehicles / items / properties / vehicle_type / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / center / additionalItems
```
Added value: +false
```
- changedOutput schema / properties / ui_blocks / items / properties / data / properties / center / items
```
Previous value: -[
-  {
-    "anyOf": [
-      {
-        "type": "number"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  {
-    "anyOf": [
-      {
-        "type": "number"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  }
-]New value: +[
+  {
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  {
+    "type": [
+      "number",
+      "null"
+    ]
+  }
+]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / center / maxItems
```
Added value: +2
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / center / minItems
```
Added value: +2
```
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / bearing / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / bearing / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / lat / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / lat / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / lng / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / lng / type
```
Added value: +[
+  "number",
+  "null"
+]
```
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / next_stop_id / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / next_stop_id / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / route / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- addedOutput schema / properties / ui_blocks / items / properties / data / properties / vehicles / items / properties / route / type
```
Added value: +[
+  "string",
+  "null"
+]
```
AddedMay 29, 2026

TDQS

A4.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, idempotent, and open-world, so the safety profile is covered. The description adds what annotations cannot: results are live rather than scheduled, ordered nearest-first, and coordinate system must be WGS84 decimal degrees. It does not disclose radius behavior defaults or what happens for out-of-range points, but the schema carries the radius bounds.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences, front-loaded with the return shape, then usage, then prerequisites. Every clause carries information the schema does not: ordering, liveness, routing to alternatives, coordinate system.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present the description need not explain return fields, and it doesn't. For a read-only spatial lookup with annotations and full schema coverage, nothing an agent needs to select or invoke this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds cross-parameter meaning: the 'narrow with route for one line' guidance and the explicit WGS84 requirement frame how latitude/longitude and route are meant to be combined. The lowfloor_only and limit subtleties remain schema-only.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (returns live vehicles near a point), the ordering (nearest first), and the payload (route, destination, distance). An agent can distinguish this from get_route_realtime and get_stop_realtime without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit trigger phrasing ('what transport is near me right now?'), a narrowing condition for the route parameter, and names two siblings with the conditions that select them instead. Only the remaining siblings (get_vehicle_info, get_stops_around_location) go unmentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Lviv Public Transport tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.