alisonborba/mcp-tfl-journey

TFL Journey MCP Server

🚇 A Model Context Protocol (MCP) server for Transport for London journey data. Get real-time routes, alerts, and disruptions via AI assistants like Claude.

Quick Start

# Demo mode (limited requests)
TFL_API_KEY="6674e72d9f3d4678a3539ffbb24d5c92" npx mcp-tfl-journey

# With your own API key
TFL_API_KEY="your-api-key" npx mcp-tfl-journey

Get your free API key: https://api-portal.tfl.gov.uk/signup

Claude Configuration

Add to your Claude MCP config:

{
  "mcpServers": {
    "tfl-journey": {
      "command": "npx",
      "args": ["mcp-tfl-journey"],
      "env": {
        "TFL_API_KEY": "6674e72d9f3d4678a3539ffbb24d5c92"
      }
    }
  }
}

Features

• 🔍 Journey Search: Find routes between TFL stations
• 🚨 Real-time Alerts: Get service alerts and disruptions
• 📍 Stop Points: Detailed station information
• 📊 Journey Summaries: Duration, timing, and statistics

Usage

The search_journey tool accepts:

• from: Source station code (e.g., "9400ZZLUKSX" for Kings Cross)
• to: Destination station code (e.g., "9400ZZLULVT" for Liverpool Street)

Local Development

npm install
export TFL_API_KEY="your-api-key"
npm start

Station Codes