get_all_routes_at_stop
Find all bus routes that serve a specific bus stop. Provide the stop name to see which routes pass through that location.
Instructions
Get all bus routes that pass through a specified bus stop.
Args:
stop_name: Name of the bus stopInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stop_name | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- kmb_mcp.py:311-370 (handler)The @mcp.tool() decorated handler function implementing get_all_routes_at_stop, which finds stops by name, retrieves route-stop mappings, groups routes by stop, fetches route details, and formats the list of routes serving the stop.
@mcp.tool() async def get_all_routes_at_stop(stop_name: str) -> str: """Get all bus routes that pass through a specified bus stop. Args: stop_name: Name of the bus stop """ # Find stops matching the name stops = await find_stops_by_name(stop_name) if not stops: return f"Could not find any stops matching '{stop_name}'" results = [] for stop in stops: stop_id = stop["stop"] stop_name_en = stop["name_en"] # Get all route-stop combinations route_stops = await get_route_stop_list() # Filter for this stop stop_routes = [rs for rs in route_stops if rs["stop"] == stop_id] if not stop_routes: results.append(f"No routes found for stop '{stop_name_en}' ({stop_id})") continue # Group by route for better readability routes_info = {} for rs in stop_routes: route = rs["route"] bound = rs["bound"] service_type = rs["service_type"] key = f"{route}:{service_type}" if key not in routes_info: routes_info[key] = [] routes_info[key].append(bound) # Format results stop_results = [f"Routes serving '{stop_name_en}' ({stop_id}):"] # Get full route information for each route for key, bounds in routes_info.items(): route, service_type = key.split(":") route_data = await get_route_details(route) for r in route_data: if r["service_type"] == service_type and r["bound"] in bounds: origin = r.get("orig_en", "Unknown") dest = r.get("dest_en", "Unknown") direction = "→" if r["bound"] == "O" else "←" stop_results.append(f"- Route {route}: {origin} {direction} {dest}") results.append("\n".join(stop_results)) return "\n\n".join(results) - kmb_mcp.py:311-311 (registration)Registration of the get_all_routes_at_stop tool via @mcp.tool() decorator.
@mcp.tool() - kmb_mcp.py:312-317 (schema)Type hints and docstring defining input (stop_name: str) and output (str) schema for the tool.
async def get_all_routes_at_stop(stop_name: str) -> str: """Get all bus routes that pass through a specified bus stop. Args: stop_name: Name of the bus stop """