Transit MCP

Find transit entities

find_transit

Read-onlyIdempotent

Call with no arguments (or only coverage) to list the regions served and what each supports. Without a coverage, a name is searched in every region. If nothing matches, suggestions lists the closest names (not matches). Resolve a coverage, agency, route, station, stop, or a currently observed train number (where vehicle data exists); inspect an exact reference or nearby coordinates. Context ranks candidates without selecting identity. Candidates come best first (exact names and well-known place names such as SFO, then stations, then rail before bus), and each stop says what it is: stopType (station, platform or street stop), modes and the lines serving it, so you can pick the one the rider means. No general address geocoding. Use plan_trip for journeys.

Input Schema

Name	Required	Description
`ref`	No	Exact reference to inspect.
`limit`	No
`query`	No	A name to search: station, stop, line, agency or train number.
`context`	No
`coverage`	No	Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.
`latitude`	No	With longitude: stops near this point.
`longitude`	No

Output Schema

Name	Required	Description
`asOf`	Yes
`status`	Yes
`reasons`	Yes
`sources`	Yes
`entities`	Yes
`coverages`	Yes
`candidates`	Yes
`attribution`	Yes
`suggestions`	No	When no name matches: the closest stop names, not matches. Confirm one with the rider, or retry with the official station name.
`clientCoordinates`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 23, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

removedInput schema / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-            "enum": [
-              "sfbay",
-              "SF",
-              "San Francisco",
-              "Bay Area",
-              "dc",
-              "DC",
-              "Washington DC",
-              "Washington, DC",
-              "WMATA",
-              "DC Metro",
-              "Metrobus",
-              "nyc",
-              "NYC",
-              "New York",
-              "New York City",
-              "NYC Subway",
-              "MTA Subway",
-              "MTA",
-              "LIRR",
-              "Long Island Rail Road",
-              "Metro-North",
-              "Metro-North Railroad"
-            ],
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-        "enum": [
-          "sfbay",
-          "SF",
-          "San Francisco",
-          "Bay Area",
-          "dc",
-          "DC",
-          "Washington DC",
-          "Washington, DC",
-          "WMATA",
-          "DC Metro",
-          "Metrobus",
-          "nyc",
-          "NYC",
-          "New York",
-          "New York City",
-          "NYC Subway",
-          "MTA Subway",
-          "MTA",
-          "LIRR",
-          "Long Island Rail Road",
-          "Metro-North",
-          "Metro-North Railroad"
-        ],
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "ref"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-            "enum": [
-              "sfbay",
-              "SF",
-              "San Francisco",
-              "Bay Area",
-              "dc",
-              "DC",
-              "Washington DC",
-              "Washington, DC",
-              "WMATA",
-              "DC Metro",
-              "Metrobus",
-              "nyc",
-              "NYC",
-              "New York",
-              "New York City",
-              "NYC Subway",
-              "MTA Subway",
-              "MTA",
-              "LIRR",
-              "Long Island Rail Road",
-              "Metro-North",
-              "Metro-North Railroad"
-            ],
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-        "enum": [
-          "sfbay",
-          "SF",
-          "San Francisco",
-          "Bay Area",
-          "dc",
-          "DC",
-          "Washington DC",
-          "Washington, DC",
-          "WMATA",
-          "DC Metro",
-          "Metrobus",
-          "nyc",
-          "NYC",
-          "New York",
-          "New York City",
-          "NYC Subway",
-          "MTA Subway",
-          "MTA",
-          "LIRR",
-          "Long Island Rail Road",
-          "Metro-North",
-          "Metro-North Railroad"
-        ],
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "required": [
-      "query"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-            "enum": [
-              "sfbay",
-              "SF",
-              "San Francisco",
-              "Bay Area",
-              "dc",
-              "DC",
-              "Washington DC",
-              "Washington, DC",
-              "WMATA",
-              "DC Metro",
-              "Metrobus",
-              "nyc",
-              "NYC",
-              "New York",
-              "New York City",
-              "NYC Subway",
-              "MTA Subway",
-              "MTA",
-              "LIRR",
-              "Long Island Rail Road",
-              "Metro-North",
-              "Metro-North Railroad"
-            ],
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-        "enum": [
-          "sfbay",
-          "SF",
-          "San Francisco",
-          "Bay Area",
-          "dc",
-          "DC",
-          "Washington DC",
-          "Washington, DC",
-          "WMATA",
-          "DC Metro",
-          "Metrobus",
-          "nyc",
-          "NYC",
-          "New York",
-          "New York City",
-          "NYC Subway",
-          "MTA Subway",
-          "MTA",
-          "LIRR",
-          "Long Island Rail Road",
-          "Metro-North",
-          "Metro-North Railroad"
-        ],
-        "type": "string"
-      },
-      "latitude": {
-        "maximum": 90,
-        "minimum": -90,
-        "type": "number"
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "maximum": 180,
-        "minimum": -180,
-        "type": "number"
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "required": [
-      "latitude",
-      "longitude"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-            "enum": [
-              "sfbay",
-              "SF",
-              "San Francisco",
-              "Bay Area",
-              "dc",
-              "DC",
-              "Washington DC",
-              "Washington, DC",
-              "WMATA",
-              "DC Metro",
-              "Metrobus",
-              "nyc",
-              "NYC",
-              "New York",
-              "New York City",
-              "NYC Subway",
-              "MTA Subway",
-              "MTA",
-              "LIRR",
-              "Long Island Rail Road",
-              "Metro-North",
-              "Metro-North Railroad"
-            ],
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
-        "enum": [
-          "sfbay",
-          "SF",
-          "San Francisco",
-          "Bay Area",
-          "dc",
-          "DC",
-          "Washington DC",
-          "Washington, DC",
-          "WMATA",
-          "DC Metro",
-          "Metrobus",
-          "nyc",
-          "NYC",
-          "New York",
-          "New York City",
-          "NYC Subway",
-          "MTA Subway",
-          "MTA",
-          "LIRR",
-          "Long Island Rail Road",
-          "Metro-North",
-          "Metro-North Railroad"
-        ],
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "type": "object"
-  }
-]

addedInput schema / properties

Added value: +{
+  "context": {
+    "additionalProperties": false,
+    "properties": {
+      "coverage": {
+        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+        "enum": [
+          "sfbay",
+          "SF",
+          "San Francisco",
+          "Bay Area",
+          "dc",
+          "DC",
+          "Washington DC",
+          "Washington, DC",
+          "WMATA",
+          "DC Metro",
+          "Metrobus",
+          "nyc",
+          "NYC",
+          "New York",
+          "New York City",
+          "NYC Subway",
+          "MTA Subway",
+          "MTA",
+          "LIRR",
+          "Long Island Rail Road",
+          "Metro-North",
+          "Metro-North Railroad"
+        ],
+        "type": "string"
+      },
+      "feed": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "serviceDate": {
+        "pattern": "^\\d{8}$",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "coverage": {
+    "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+    "enum": [
+      "sfbay",
+      "SF",
+      "San Francisco",
+      "Bay Area",
+      "dc",
+      "DC",
+      "Washington DC",
+      "Washington, DC",
+      "WMATA",
+      "DC Metro",
+      "Metrobus",
+      "nyc",
+      "NYC",
+      "New York",
+      "New York City",
+      "NYC Subway",
+      "MTA Subway",
+      "MTA",
+      "LIRR",
+      "Long Island Rail Road",
+      "Metro-North",
+      "Metro-North Railroad"
+    ],
+    "type": "string"
+  },
+  "latitude": {
+    "description": "With longitude: stops near this point.",
+    "maximum": 90,
+    "minimum": -90,
+    "type": "number"
+  },
+  "limit": {
+    "default": 20,
+    "maximum": 50,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "longitude": {
+    "maximum": 180,
+    "minimum": -180,
+    "type": "number"
+  },
+  "query": {
+    "description": "A name to search: station, stop, line, agency or train number.",
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  },
+  "ref": {
+    "description": "Exact reference to inspect.",
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  }
+}

Changed2 schema fields changedOct 22, 2026

changedInput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "ref"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "required": [
-      "query"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "maximum": 90,
-        "minimum": -90,
-        "type": "number"
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "maximum": 180,
-        "minimum": -180,
-        "type": "number"
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "required": [
-      "latitude",
-      "longitude"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+            "enum": [
+              "sfbay",
+              "SF",
+              "San Francisco",
+              "Bay Area",
+              "dc",
+              "DC",
+              "Washington DC",
+              "Washington, DC",
+              "WMATA",
+              "DC Metro",
+              "Metrobus",
+              "nyc",
+              "NYC",
+              "New York",
+              "New York City",
+              "NYC Subway",
+              "MTA Subway",
+              "MTA",
+              "LIRR",
+              "Long Island Rail Road",
+              "Metro-North",
+              "Metro-North Railroad"
+            ],
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+        "enum": [
+          "sfbay",
+          "SF",
+          "San Francisco",
+          "Bay Area",
+          "dc",
+          "DC",
+          "Washington DC",
+          "Washington, DC",
+          "WMATA",
+          "DC Metro",
+          "Metrobus",
+          "nyc",
+          "NYC",
+          "New York",
+          "New York City",
+          "NYC Subway",
+          "MTA Subway",
+          "MTA",
+          "LIRR",
+          "Long Island Rail Road",
+          "Metro-North",
+          "Metro-North Railroad"
+        ],
+        "type": "string"
+      },
+      "latitude": {
+        "not": {}
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "not": {}
+      },
+      "query": {
+        "not": {}
+      },
+      "ref": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "ref"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+            "enum": [
+              "sfbay",
+              "SF",
+              "San Francisco",
+              "Bay Area",
+              "dc",
+              "DC",
+              "Washington DC",
+              "Washington, DC",
+              "WMATA",
+              "DC Metro",
+              "Metrobus",
+              "nyc",
+              "NYC",
+              "New York",
+              "New York City",
+              "NYC Subway",
+              "MTA Subway",
+              "MTA",
+              "LIRR",
+              "Long Island Rail Road",
+              "Metro-North",
+              "Metro-North Railroad"
+            ],
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+        "enum": [
+          "sfbay",
+          "SF",
+          "San Francisco",
+          "Bay Area",
+          "dc",
+          "DC",
+          "Washington DC",
+          "Washington, DC",
+          "WMATA",
+          "DC Metro",
+          "Metrobus",
+          "nyc",
+          "NYC",
+          "New York",
+          "New York City",
+          "NYC Subway",
+          "MTA Subway",
+          "MTA",
+          "LIRR",
+          "Long Island Rail Road",
+          "Metro-North",
+          "Metro-North Railroad"
+        ],
+        "type": "string"
+      },
+      "latitude": {
+        "not": {}
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "not": {}
+      },
+      "query": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "ref": {
+        "not": {}
+      }
+    },
+    "required": [
+      "query"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+            "enum": [
+              "sfbay",
+              "SF",
+              "San Francisco",
+              "Bay Area",
+              "dc",
+              "DC",
+              "Washington DC",
+              "Washington, DC",
+              "WMATA",
+              "DC Metro",
+              "Metrobus",
+              "nyc",
+              "NYC",
+              "New York",
+              "New York City",
+              "NYC Subway",
+              "MTA Subway",
+              "MTA",
+              "LIRR",
+              "Long Island Rail Road",
+              "Metro-North",
+              "Metro-North Railroad"
+            ],
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+        "enum": [
+          "sfbay",
+          "SF",
+          "San Francisco",
+          "Bay Area",
+          "dc",
+          "DC",
+          "Washington DC",
+          "Washington, DC",
+          "WMATA",
+          "DC Metro",
+          "Metrobus",
+          "nyc",
+          "NYC",
+          "New York",
+          "New York City",
+          "NYC Subway",
+          "MTA Subway",
+          "MTA",
+          "LIRR",
+          "Long Island Rail Road",
+          "Metro-North",
+          "Metro-North Railroad"
+        ],
+        "type": "string"
+      },
+      "latitude": {
+        "maximum": 90,
+        "minimum": -90,
+        "type": "number"
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "maximum": 180,
+        "minimum": -180,
+        "type": "number"
+      },
+      "query": {
+        "not": {}
+      },
+      "ref": {
+        "not": {}
+      }
+    },
+    "required": [
+      "latitude",
+      "longitude"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+            "enum": [
+              "sfbay",
+              "SF",
+              "San Francisco",
+              "Bay Area",
+              "dc",
+              "DC",
+              "Washington DC",
+              "Washington, DC",
+              "WMATA",
+              "DC Metro",
+              "Metrobus",
+              "nyc",
+              "NYC",
+              "New York",
+              "New York City",
+              "NYC Subway",
+              "MTA Subway",
+              "MTA",
+              "LIRR",
+              "Long Island Rail Road",
+              "Metro-North",
+              "Metro-North Railroad"
+            ],
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Region: sfbay (San Francisco Bay Area), dc (Washington DC Metro and Metrobus), nyc (New York City Subway, LIRR and Metro-North). Region names such as SF or Washington DC also work. Pick the region the place is in; where optional, leave it out only if the place could be in several.",
+        "enum": [
+          "sfbay",
+          "SF",
+          "San Francisco",
+          "Bay Area",
+          "dc",
+          "DC",
+          "Washington DC",
+          "Washington, DC",
+          "WMATA",
+          "DC Metro",
+          "Metrobus",
+          "nyc",
+          "NYC",
+          "New York",
+          "New York City",
+          "NYC Subway",
+          "MTA Subway",
+          "MTA",
+          "LIRR",
+          "Long Island Rail Road",
+          "Metro-North",
+          "Metro-North Railroad"
+        ],
+        "type": "string"
+      },
+      "latitude": {
+        "not": {}
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "not": {}
+      },
+      "query": {
+        "not": {}
+      },
+      "ref": {
+        "not": {}
+      }
+    },
+    "type": "object"
+  }
+]

addedOutput schema / properties / suggestions

Added value: +{
+  "description": "When no name matches: the closest stop names, not matches. Confirm one with the rider, or retry with the official station name.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "coordinates": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "latitude": {
+                "maximum": 90,
+                "minimum": -90,
+                "type": "number"
+              },
+              "longitude": {
+                "maximum": 180,
+                "minimum": -180,
+                "type": "number"
+              }
+            },
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "coverage": {
+        "type": "string"
+      },
+      "endpoint": {
+        "enum": [
+          "origin",
+          "destination"
+        ],
+        "type": "string"
+      },
+      "feed": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "agency",
+          "route",
+          "stop",
+          "trip"
+        ],
+        "type": "string"
+      },
+      "modes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "name": {
+        "type": "string"
+      },
+      "providerId": {
+        "type": "string"
+      },
+      "ref": {
+        "type": "string"
+      },
+      "routeCount": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "routeNames": {
+        "description": "Lines serving it, up to ten.",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 10,
+        "type": "array"
+      },
+      "stationRef": {
+        "type": "string"
+      },
+      "stopType": {
+        "description": "station: groups platforms; platform: part of stationRef; stop: a standalone stop such as a street corner.",
+        "enum": [
+          "station",
+          "platform",
+          "stop",
+          "entrance",
+          "other"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "ref",
+      "kind",
+      "name",
+      "coverage",
+      "feed",
+      "providerId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed1 schema field changedOct 21, 2026

changedInput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "ref"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "not": {}
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "not": {}
-      },
-      "query": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "required": [
-      "query"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "coverage": {
-            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "feed": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "serviceDate": {
-            "pattern": "^\\d{8}$",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "coverage": {
-        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "latitude": {
-        "maximum": 90,
-        "minimum": -90,
-        "type": "number"
-      },
-      "limit": {
-        "default": 20,
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "longitude": {
-        "maximum": 180,
-        "minimum": -180,
-        "type": "number"
-      },
-      "query": {
-        "not": {}
-      },
-      "ref": {
-        "not": {}
-      }
-    },
-    "required": [
-      "latitude",
-      "longitude"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "latitude": {
+        "not": {}
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "not": {}
+      },
+      "query": {
+        "not": {}
+      },
+      "ref": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "ref"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "latitude": {
+        "not": {}
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "not": {}
+      },
+      "query": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "ref": {
+        "not": {}
+      }
+    },
+    "required": [
+      "query"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "latitude": {
+        "maximum": 90,
+        "minimum": -90,
+        "type": "number"
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "maximum": 180,
+        "minimum": -180,
+        "type": "number"
+      },
+      "query": {
+        "not": {}
+      },
+      "ref": {
+        "not": {}
+      }
+    },
+    "required": [
+      "latitude",
+      "longitude"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "coverage": {
+            "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "feed": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "serviceDate": {
+            "pattern": "^\\d{8}$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "coverage": {
+        "description": "Runtime coverage name or identifier; use find_transit to inspect availability.",
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "latitude": {
+        "not": {}
+      },
+      "limit": {
+        "default": 20,
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "longitude": {
+        "not": {}
+      },
+      "query": {
+        "not": {}
+      },
+      "ref": {
+        "not": {}
+      }
+    },
+    "type": "object"
+  }
+]

Changed12 schema fields changedOct 20, 2026

addedOutput schema / properties / candidates / items / properties / coordinates

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "latitude": {
+          "maximum": 90,
+          "minimum": -90,
+          "type": "number"
+        },
+        "longitude": {
+          "maximum": 180,
+          "minimum": -180,
+          "type": "number"
+        }
+      },
+      "required": [
+        "latitude",
+        "longitude"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / candidates / items / properties / modes

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / candidates / items / properties / routeCount

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

addedOutput schema / properties / candidates / items / properties / routeNames

Added value: +{
+  "description": "Lines serving it, up to ten.",
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 10,
+  "type": "array"
+}

addedOutput schema / properties / candidates / items / properties / stationRef
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / candidates / items / properties / stopType

Added value: +{
+  "description": "station: groups platforms; platform: part of stationRef; stop: a standalone stop such as a street corner.",
+  "enum": [
+    "station",
+    "platform",
+    "stop",
+    "entrance",
+    "other"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / entities / items / properties / modes

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / entities / items / properties / routeCount

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

addedOutput schema / properties / entities / items / properties / routeNames

Added value: +{
+  "description": "Lines serving it, up to ten.",
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 10,
+  "type": "array"
+}

addedOutput schema / properties / entities / items / properties / stationRef
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / entities / items / properties / stopType

Added value: +{
+  "description": "station: groups platforms; platform: part of stationRef; stop: a standalone stop such as a street corner.",
+  "enum": [
+    "station",
+    "platform",
+    "stop",
+    "entrance",
+    "other"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / entities / items / required

Previous value: -[
-  "ref",
-  "kind",
-  "name",
-  "coverage",
-  "feed",
-  "providerId",
-  "scheduleVersion",
-  "resourceUri",
-  "coordinates",
-  "routeRefs",
-  "agencyRef",
-  "mode",
-  "patterns",
-  "calls",
-  "stepFree"
-]New value: +[
+  "ref",
+  "kind",
+  "name",
+  "coverage",
+  "feed",
+  "providerId",
+  "coordinates",
+  "scheduleVersion",
+  "resourceUri",
+  "routeRefs",
+  "agencyRef",
+  "mode",
+  "patterns",
+  "calls",
+  "stepFree"
+]

Changed1 schema field changedOct 20, 2026

changedOutput schema / properties / reasons / items / enum

Previous value: -[
-  "REALTIME_STALE",
-  "REALTIME_UNAVAILABLE",
-  "SCHEDULE_EXPIRED",
-  "SCHEDULE_APPROXIMATE",
-  "SCHEDULE_REALTIME_MISMATCH",
-  "TRIP_CANCELED",
-  "STOP_SKIPPED",
-  "VALIDATOR_REJECTED",
-  "COVERAGE_UNAVAILABLE",
-  "SCOPE_LIMIT_EXCEEDED",
-  "ACCESSIBILITY_UNAVAILABLE",
-  "ENDPOINT_NOT_STEP_FREE"
-]New value: +[
+  "REALTIME_STALE",
+  "REALTIME_UNAVAILABLE",
+  "SCHEDULE_EXPIRED",
+  "SCHEDULE_APPROXIMATE",
+  "SCHEDULE_REALTIME_MISMATCH",
+  "TRIP_CANCELED",
+  "STOP_SKIPPED",
+  "VALIDATOR_REJECTED",
+  "COVERAGE_UNAVAILABLE",
+  "SCOPE_LIMIT_EXCEEDED",
+  "ACCESSIBILITY_UNAVAILABLE",
+  "ENDPOINT_NOT_STEP_FREE",
+  "PLANNING_UNAVAILABLE"
+]

Changed4 schema fields changedOct 20, 2026

addedOutput schema / properties / entities / items / properties / stepFree

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "accessible",
+        "partial",
+        "not_accessible",
+        "unknown"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Step-free access from the street per the agency's station data (stops only; partial = some platforms, e.g. one direction). Live elevator outages are in get_service_status."
+}

changedOutput schema / properties / entities / items / required

Previous value: -[
-  "ref",
-  "kind",
-  "name",
-  "coverage",
-  "feed",
-  "providerId",
-  "scheduleVersion",
-  "resourceUri",
-  "coordinates",
-  "routeRefs",
-  "agencyRef",
-  "mode",
-  "patterns",
-  "calls"
-]New value: +[
+  "ref",
+  "kind",
+  "name",
+  "coverage",
+  "feed",
+  "providerId",
+  "scheduleVersion",
+  "resourceUri",
+  "coordinates",
+  "routeRefs",
+  "agencyRef",
+  "mode",
+  "patterns",
+  "calls",
+  "stepFree"
+]

changedOutput schema / properties / reasons / items / enum

Previous value: -[
-  "REALTIME_STALE",
-  "REALTIME_UNAVAILABLE",
-  "SCHEDULE_EXPIRED",
-  "SCHEDULE_APPROXIMATE",
-  "SCHEDULE_REALTIME_MISMATCH",
-  "TRIP_CANCELED",
-  "STOP_SKIPPED",
-  "VALIDATOR_REJECTED",
-  "COVERAGE_UNAVAILABLE",
-  "SCOPE_LIMIT_EXCEEDED"
-]New value: +[
+  "REALTIME_STALE",
+  "REALTIME_UNAVAILABLE",
+  "SCHEDULE_EXPIRED",
+  "SCHEDULE_APPROXIMATE",
+  "SCHEDULE_REALTIME_MISMATCH",
+  "TRIP_CANCELED",
+  "STOP_SKIPPED",
+  "VALIDATOR_REJECTED",
+  "COVERAGE_UNAVAILABLE",
+  "SCOPE_LIMIT_EXCEEDED",
+  "ACCESSIBILITY_UNAVAILABLE",
+  "ENDPOINT_NOT_STEP_FREE"
+]

changedOutput schema / properties / sources / items / properties / kind / enum

Previous value: -[
-  "gtfs_schedule",
-  "trip_updates",
-  "vehicle_positions",
-  "alerts",
-  "native_api"
-]New value: +[
+  "gtfs_schedule",
+  "trip_updates",
+  "vehicle_positions",
+  "alerts",
+  "equipment_outages",
+  "native_api"
+]

AddedOct 19, 2026

TDQS

A4.2/5.0

Behavior5/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive), and the description adds substantial behavior beyond them: result ordering (exact names and well-known place names first, then stations, then rail before bus), the fact that suggestions are closest names rather than matches, that context only ranks without selecting identity, and what each stop result carries (stopType, modes, lines). That is exactly the disambiguation an agent needs for a search tool.

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

Conciseness4/5

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

It front-loads the no-argument listing behavior before the search semantics, which is the right order. Sentences are dense and a few constructions are awkward ('Context ranks candidates without selecting identity', 'Candidates come best first'), but nearly every clause adds usable information rather than restating the schema.

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

Completeness4/5

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

For a 7-parameter, nested, open-world search tool with an output schema, this covers the hard parts: coverage selection, cross-region fallback, suggestion semantics, ranking, and result fields. Only pagination/limit behavior and the serviceDate concept are left uncovered, which are minor relative to what is explained.

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 57%, so several parameters (limit, longitude, context.feed, context.serviceDate) carry no description. The prose compensates well for the important ones: it explains the coverage enum semantics, what ref and query each mean behaviorally, how context ranks, and that lat/long must be paired. `limit` and the sorting implications remain unexplained in both places.

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

Purpose4/5

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

The description names a specific verb and resource family: resolve/search coverage, agency, route, station, stop, or train number, plus inspect by exact ref or coordinates. It distinguishes itself from plan_trip and explicitly excludes address geocoding, so an agent can tell it apart from search_stations and the get_* siblings. The opening sentence is somewhat dense, but the scope is unambiguous.

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

Usage Guidelines4/5

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

It gives concrete when-to-use guidance: call with no arguments to list regions, omit coverage to search all regions, use ref for exact inspection, use lat/long for nearby stops, and use plan_trip for journeys. It does not hand off to search_stations or get_stations_by_line explicitly, so routing against the closest siblings is left to inference.

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

All Transit MCP 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.