Transport for London MCP Server

⚠️ Important Disclaimer: This is not an official Transport for London (TfL) MCP server. This is an independent project that uses the publicly available TfL Unified API to provide transport data. It is not affiliated with, endorsed by, or officially supported by Transport for London.

A Model Context Protocol (MCP) server providing real-time Transport for London data, including line status, journey planning, and disruption information. This server is deployed on Cloudflare Workers and can be used with any MCP-compatible client like Claude Desktop.

Features

This MCP server provides the following tools:

🚇 get_line_status

Get the current status of a specific TfL transport line.

• Parameters:
  • lineId: The line ID to query (e.g., 'central', 'piccadilly', 'northern', 'victoria')

🗺️ plan_journey

Plan journeys between two locations in London.

• Parameters:
  • from: Starting location (postcode, address, or station name)
  • to: Destination location (postcode, address, or station name)
  • modes (optional): Transport modes to use (e.g., 'tube,bus,walking')
  • time (optional): Journey time in HH:MM format or 'now'
  • timeIs (optional): 'Departing' or 'Arriving'
  • date (optional): Journey date in YYYYMMDD format
  • walkingSpeed (optional): 'Slow', 'Average', or 'Fast'
  • cyclePreference (optional): Cycling preference options
  • optimize (optional): 'Time', 'LeastInterchange', or 'LeastWalking'
  • maxTransferMinutes (optional): Maximum transfer time in minutes
  • maxWalkingMinutes (optional): Maximum walking time in minutes

Getting Started

Try It Now (No Deployment Required)

Want to test the server before deploying your own? You can use the public demo instance!

For Claude Desktop:

1. Open Claude Desktop Settings > Developer > Edit Config
2. Add this configuration:

{
  "mcpServers": {
    "tfl": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://london-transport-mcp.anoopt.workers.dev/mcp"
      ]
    }
  }
}

3. Restart Claude Desktop
4. Start asking questions about London transport!

For VS Code (GitHub Copilot):

1. Open VS Code Settings > Extensions > GitHub Copilot > MCP Servers
2. Add this configuration:

{
  "servers": {
    "tfl": {
      "type": "http",
      "url": "https://london-transport-mcp.anoopt.workers.dev/mcp"
    }
  }
}

3. Start the MCP server
4. Start using TfL tools in Copilot Chat!

Quick Deploy

Click the button above to deploy this MCP server to your Cloudflare Workers account with one click!

Manual Deployment

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Deploy to Cloudflare Workers:

   npm run deploy
   

Your MCP server will be deployed to a URL like: london-transport-mcp.<your-account>.workers.dev

Authentication (Optional)

This server supports optional TfL API key authentication. While the TfL API works without authentication, using an API key provides higher rate limits and better performance.

Without API Key: The server will work with TfL's public API limits (subject to rate limiting).

With API Key (Recommended):

1. Get a free API key from TfL API Portal
2. Pass the API key in the X-API-Key header when connecting to the server

Connect to Claude Desktop

To connect to your MCP server from Claude Desktop, update your Claude Desktop configuration:

1. Go to Claude Desktop Settings > Developer > Edit Config
2. Add one of the following configurations:

Using mcp-remote

With API Key:

{
  "mcpServers": {
    "tfl": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://london-transport-mcp.<your-account>.workers.dev/mcp",
        "--header",
        "X-API-Key: YOUR_TFL_API_KEY"
      ]
    }
  }
}

Without API Key:

{
  "mcpServers": {
    "tfl": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://london-transport-mcp.<your-account>.workers.dev/mcp"
      ]
    }
  }
}

Note: For local development, replace the URL with http://localhost:8787/mcp

Connect to Cloudflare AI Playground

You can also connect to your MCP server from the Cloudflare AI Playground:

1. Go to https://playground.ai.cloudflare.com/
2. Enter your deployed MCP server URL with the /mcp endpoint
3. Add the X-API-Key header with your TfL API key
4. Start using the TfL tools directly from the playground!

Local Development

For local development:

npm run dev

This will start the server locally at http://localhost:8787

API Key (Optional)

This server supports optional TfL API key authentication for higher rate limits. The API key is not required but recommended for production use.

To use without an API Key: Simply omit the X-API-Key header when connecting. The TfL API will apply standard rate limits.

To use with an API Key:

1. Visit the TfL API Portal
2. Register for a free account
3. Create a new application to get your API key
4. Pass the key in the X-API-Key header when connecting

Examples

Once connected, you can ask Claude things like:

• "Is the Northern line running ok?"
• "What's the status of the Victoria line?"
• "Plan a journey from King's Cross to Heathrow Airport"
• "How do I get from Oxford Circus to Canary Wharf?"
• "What's the fastest route from Wimbledon to Liverpool Street?"

Tech Stack

• Runtime: Cloudflare Workers
• Framework: Hono.js
• MCP SDK: @modelcontextprotocol/sdk
• Language: TypeScript
• API: Transport for London Unified API

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.