uk_live_departures
Retrieve real-time train departure information for UK stations using CRS codes to plan journeys and check schedules.
Instructions
Get live departure information for a UK train station using its CRS code (e.g., 'PAD' for London Paddington, 'MAN' for Manchester Piccadilly). Uses the TransportAPI station timetables endpoint with live data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| station_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- tools/uk.py:26-66 (handler)The main handler function implementing the tool logic: validates CRS station code, loads API credentials, constructs TransportAPI request for live departures, and returns the JSON response.
async def uk_live_departures(station_code: str) -> Dict[str, Any]: """ Retrieve live departures for a UK train station. Args: station_code (str): 3-letter CRS code (e.g., 'PAD', 'MAN', 'EDI'). Returns: Dict[str, Any]: JSON response containing departure details. """ # Validate station code code = station_code.strip().upper() if station_code else "" if len(code) != 3: raise ValueError("Station code must be exactly 3 characters (CRS code).") # Load credentials from environment variables app_id = os.getenv("UK_TRANSPORT_APP_ID") api_key = os.getenv("UK_TRANSPORT_API_KEY") if not app_id or not api_key: raise TransportAPIError( "UK Transport API credentials are not configured. " "Set both UK_TRANSPORT_APP_ID and UK_TRANSPORT_API_KEY." ) # Prepare API request url = f"{UK_BASE_URL}/train/station_timetables/{code}.json" params = { "app_id": app_id, "app_key": api_key, "live": "true" } # Execute API request try: logger.info(f"🇬🇧 Fetching live departures for UK station: {code}") response = await fetch_json(url, params) return response except TransportAPIError as e: logger.error(f"UK live departures fetch failed: {e}", exc_info=True) raise - tools/uk.py:18-25 (schema)Tool schema definition via @mcp.tool decorator, specifying name, description, and input parameter (station_code: str).
@mcp.tool( name="uk_live_departures", description=( "Get live departure information for a UK train station using its CRS code " "(e.g., 'PAD' for London Paddington, 'MAN' for Manchester Piccadilly). " "Uses the TransportAPI station timetables endpoint with live data." ), ) - tools/uk.py:67-67 (registration)Local registration: register_uk_tools function returns a list containing the uk_live_departures tool for further registration.
return [uk_live_departures] - server.py:57-57 (registration)Global registration: Calls register_uk_tools(mcp) in the MCP server initialization to register the UK tools with the FastMCP server instance.
uk_tools = register_uk_tools(mcp)