Skip to main content

TransCAPI MCP server

Lets AI assistants such as Claude answer questions about public transport in Great Britain with live data: "When's the next train from Leeds to York, and is it on time?", "Where's the 52 bus?", "Is anything disrupting my route home?"

It connects an assistant to TransCAPI, which covers England, Scotland and Wales: stops and places, bus and rail departures with live running, live bus positions, disruptions and journey planning.

Setup

  1. Get a free API key at https://www.transcapi.com/signup (1,000 requests a day, every endpoint).

  2. Add the server to your MCP client. For Claude Desktop, in claude_desktop_config.json:

    {
      "mcpServers": {
        "transcapi": {
          "command": "uvx",
          "args": ["transcapi-mcp"],
          "env": { "TRANSCAPI_API_KEY": "your-key" }
        }
      }
    }
    

    For Claude Code:

    claude mcp add transcapi --env TRANSCAPI_API_KEY=your-key -- uvx transcapi-mcp
    

    Or install it yourself with pip install transcapi-mcp and run transcapi-mcp.

Tools

Tool What it answers
search_places Find a town, village, postcode or stop by name
nearby_stops Bus, tram and rail stops near a point, with which way the buses go
nearby_stations Rail stations near a point
bus_departures What's leaving (or arriving at) a bus stop, with live times for tracked buses
rail_departures Live trains at a station: expected times, platforms, cancellations, delay reasons
train_service Every station one train calls at, live for today
bus_service Every stop one bus journey calls at, and where the bus is now
live_buses Buses on the road near a point, with delays where tracked
disruptions Planned works, incidents and line status, by area, line or a journey's route
plan_journey Public transport journeys between two points (South and West Yorkshire and West Sussex for now)

All tools are read-only.

Configuration

Variable
TRANSCAPI_API_KEY Required. Your TransCAPI key.
TRANSCAPI_BASE_URL Optional. Defaults to https://api.transcapi.com.

Attribution

TransCAPI is built on official open data. If you show its data to other people, credit the sources as described at https://www.transcapi.com/docs/data-sources.

Licence

MIT.

Release files for transcapi-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for transcapi-mcp 0.1.1
File Size Uploaded
transcapi_mcp-0.1.1.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for transcapi-mcp 0.1.1
File Interpreter ABI Platform
transcapi_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.9 kB

Release files / transcapi_mcp-0.1.1.tar.gz

Download URL transcapi_mcp-0.1.1.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
543da22bcf7921fe7fab78abf4810064a2fb4976b8c52a0546b8e645070c3746
BLAKE2b-256 checksum
How to use checksums
0db78067a55a4d0951ea3e51357ada607cb5409cab8f365ac02134c159e75f03
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / transcapi_mcp-0.1.1-py3-none-any.whl

Download URL transcapi_mcp-0.1.1-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f288520692fc5179292f801a2a0e60210081919c791379f3b1935323160b85d
BLAKE2b-256 checksum
How to use checksums
8aeabb5ea781e1a96e3becd61b2632f626f19d08658f9e43c82f72bb285f6e81
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page