Skip to content

πŸš‡ MCP server for Transport for London journey data. AI-powered route planning with real-time alerts, disruptions & stop points. Built with Model Context Protocol for seamless AI integration.

Notifications You must be signed in to change notification settings

alisonborba/mcp-tfl-journey

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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

Code Station
9400ZZLUKSX Kings Cross
9400ZZLULVT Liverpool Street
9400ZZLUPAD Paddington
9400ZZLUVIC Victoria

About

πŸš‡ MCP server for Transport for London journey data. AI-powered route planning with real-time alerts, disruptions & stop points. Built with Model Context Protocol for seamless AI integration.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •