CATA Bus MCP Server

Instructions

Implementation Reference

• src/catabus_mcp/server.py:87-97 (handler)

  The MCP tool handler for list_routes_tool, decorated with @mcp.tool for registration and execution. Ensures data initialization and delegates to the list_routes helper.

  @mcp.tool
  async def list_routes_tool() -> list[dict[str, Any]]:
      """List all available bus routes.
  
      Returns a list of routes with their ID, short name, long name, and color.
      """
      await ensure_initialized()
      if not gtfs_data or not gtfs_data.routes:
          return []
      return await list_routes(gtfs_data)

• src/catabus_mcp/tools/list_routes.py:8-28 (helper)

  Core helper function that extracts and formats route data from GTFSData, including sorting by short name.

  async def list_routes(gtfs_data: GTFSData) -> list[dict[str, Any]]:
      """
      List all available bus routes.
  
      Returns:
          List of route information with id, short name, long name, and color.
      """
      routes = []
      for route_id, route in gtfs_data.routes.items():
          routes.append(
              {
                  "route_id": route.route_id,
                  "short_name": route.route_short_name,
                  "long_name": route.route_long_name,
                  "color": f"#{route.route_color}" if route.route_color else None,
              }
          )
  
      # Sort by short name for consistency (use empty string for None)
      routes.sort(key=lambda x: x.get("short_name") or "")
      return routes