London Tfl Journey Status MCP Server

🚀 TfL (Transport for London) Status & Journey Planner MCP Server

This Model Context Protocol (MCP) server empowers AI assistants to access real - time Transport for London data via a suite of automated tools.

⚠️ Important Disclaimer: This is not an official Transport for London (TfL) MCP server. It's an independent project leveraging the publicly available TfL Unified API to offer transport data. It has no affiliation, endorsement, or official support from Transport for London.

🎥 Demo Video

🚀 Quick Start

✨ Features

This server equips AI assistants (such as Claude Desktop and VS Code GitHub Copilot) with access to live TfL data through three key capabilities:

🔧 Available Tools

1. get_line_status: Retrieve the current status of any TfL line (e.g., Central, Victoria, Piccadilly).
2. get_line_status_detail: Obtain detailed status information, including disruption details, for a TfL line.
3. plan_journey: Plan journeys between two locations using the TfL Journey Planner.

🎯 Use Cases

Once connected to this MCP server, AI assistants can assist users in the following ways:

• Check if their tube line is operating normally before commuting.
• Get in - depth information about service disruptions.
• Plan optimal routes between London locations.
• Provide real - time transport advice for London travel.

Example interactions:

• "Is the Central line running normally?"
• "Plan a journey from King's Cross to Heathrow Airport"
• "What's causing delays on the Northern line today?"

📦 Installation

Choose your preferred installation method:

📦 Option 1: Quick Install via npm (Recommended)

The simplest way to use this MCP server is via npm:

Installation

npm install -g london-transport-mcp

🔐 Set up your TfL API key

You can obtain a free API key from the TfL API Portal.

Method 1: Environment Variable (Recommended) Set the environment variable in your system:

# Windows (PowerShell)
$env:TFL_API_KEY="your_actual_tfl_api_key_here"

# macOS/Linux
export TFL_API_KEY="your_actual_tfl_api_key_here"

Method 2: MCP Configuration Include the API key directly in your MCP configuration (see examples below).

AI Assistant Configuration

For Claude Desktop (Settings → Developers → Edit Config):

{
  "mcpServers": {
    "london-transport": {
      "command": "npx",
      "args": ["london-transport-mcp"],
      "env": {
        "TFL_API_KEY": "your_actual_tfl_api_key_here"
      }
    }
  }
}

For VS Code GitHub Copilot (Settings → GitHub Copilot › MCP: Servers):

{
  "london-transport": {
    "command": "npx",
    "args": ["london-transport-mcp"],
    "env": {
      "TFL_API_KEY": "your_actual_tfl_api_key_here"
    }
  }
}

No manual installation or path configuration is needed.

🛠️ Option 2: Local Development Setup

For developers aiming to modify the code or contribute:

⚙️ Prerequisites

Before you start, ensure you have:

• Node.js (v18+ required, v20+ recommended)
• npm (included with Node)

Warning: If you use a lower version of Node, fetch won't be available. The tools use fetch for HTTP calls. To work around this, you can modify the tools to use node - fetch instead. Make sure node - fetch is installed as a dependency and then import it as fetch into each tool file.

📥 Installation & Setup

1. Clone the repository

git clone https://github.com/anoopt/london-tfl-journey-status-mcp-server.git
cd london-tfl-journey-status-mcp-server

2. Install dependencies

npm install

🔐 Set up your TfL API key

3. Configure your TfL API key Create a .env file in the project root with your TfL API key:

TFL_API_KEY=your_actual_tfl_api_key_here

You can get a free API key from the TfL API Portal.

🧪 Test the MCP Server with Postman

We highly recommend testing your MCP server with Postman before connecting it to an AI assistant. The Postman Desktop Application offers the easiest way to run and test MCP servers.

Step 1: Download Postman Desktop

Download the latest Postman Desktop Application from postman.com/downloads.

Step 2: Create an MCP Request

1. Open Postman Desktop.
2. Create a new MCP Request (refer to the documentation for detailed steps).
3. Set the type to STDIO.
4. Set the command to the full path to your node executable followed by the full path to mcpServer.js.

To get the required paths, run these commands in your terminal:

# Get the full path to node
which node

# Get the full path to mcpServer.js  
realpath mcpServer.js

# Check your node version (should be 18+)
node --version

Example command format:

/usr/local/bin/node /full/path/to/TfL-Status-MCP-Server/mcpServer.js

Step 3: Test Your Tools

1. Click Connect in your Postman MCP Request.
2. You should see the three TfL tools listed.
3. Test each tool:
   • Try get_line_status with lineId: "central".
   • Try plan_journey with fromLocation: "King's Cross" and toLocation: "Westminster".
   • Try get_line_status_detail with lineId: "piccadilly".

If all tools work correctly in Postman, you're ready to connect to an AI assistant!

🤖 Connect to AI Assistants

After testing with Postman, you can connect your MCP server to AI assistants:

For Local Development Setup (Option 2)

If you're using the local development setup, you'll need to specify full paths:

Claude Desktop

Step 1: Use the same node and mcpServer.js paths from the Postman testing step.

Step 2: Open Claude Desktop → Settings → Developers → Edit Config and add:

{
  "mcpServers": {
    "london-transport": {
      "command": "node",
      "args": ["/full/path/to/mcpServer.js"]
    }
  }
}

Step 3: Restart Claude Desktop and verify the MCP server shows with a green circle.

VS Code GitHub Copilot

Step 1: Install the GitHub Copilot extension in VS Code if you haven't already.

Step 2: Open VS Code → Settings (Ctrl+,) → Search for "MCP" → GitHub Copilot › MCP: Servers

Step 3: Add your TfL MCP server configuration:

{
  "london-transport": {
    "command": "node",
    "args": ["/full/path/to/mcpServer.js"]
  }
}

Step 4: Restart VS Code and the MCP server will be available to GitHub Copilot.

Now you can ask your AI assistant questions like:

• "Check the status of the Central line"
• "Plan a journey from London Bridge to Camden Town"

Additional Options

🛠️ List Available Tools

View all available tools and their parameters:

npm run list-tools

🚀 Quick Postman Integration

Open Postman with the correct MCP configuration automatically:

npm run postman

🐳 Docker Deployment (Production)

For production deployments, you can use Docker:

1. Build Docker image

docker build -t <your_server_name> .

2. AI Assistant Integration Add Docker server configuration to your AI assistant:

For Claude Desktop (Settings → Developers → Edit Config):

{
  "mcpServers": {
    "tfl-status": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file=.env", "tfl-mcp-server"]
    }
  }
}

For VS Code GitHub Copilot (Settings → GitHub Copilot › MCP: Servers):

{
  "tfl-status": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "--env-file=.env", "tfl-mcp-server"]
  }
}

Add your environment variables (API keys, etc.) inside the .env file.

The project comes with the following minimal Docker setup:

FROM node:22.12-alpine AS builder

WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install

COPY . .

ENTRYPOINT ["node", "mcpServer.js"]

🌐 Streamable HTTP

To run the server with Streamable HTTP support, use the --streamable-http flag. This enables the /mcp endpoint:

node mcpServer.js --streamable-http

🌐 Server - Sent Events (SSE)

To run the server with Server - Sent Events (SSE) support, use the --sse flag. This enables the /sse and /messages endpoints:

node mcpServer.js --sse

🖥️ Stdio (Standard Input/Output)

To run the server using standard input/output (stdio), simply run the script without any flags. This mode is ideal for CLI tools or programmatic integration via stdin and stdout.

node mcpServer.js

🛠️ Extending the Server

To add more TfL API endpoints or other transport APIs:

1. Create new tool files in the directory.
2. Follow the pattern in existing tools like .
3. Add your new tool file to .
4. Test with Postman before deploying.

📚 Documentation

This server utilizes the Transport for London Unified API. All tools automatically include your API key from the .env file.

➕ Adding New Tools

Easily expand your MCP server with more tools:

1. Visit Postman MCP Generator.
2. Select new API request(s), generate a new MCP server, and download it.
3. Copy the new generated tool(s) into your existing project's tools/ folder.
4. Update your tools/paths.js file to include new tool references.

💬 Questions & Support

Visit the Postman MCP Generator page for updates and new capabilities.

Join the #mcp-lab channel in the Postman Discord to share your creations and get assistance.