# TransCAPI

> TransCAPI is a freemium MCP server for maps and travel. Live UK and Ireland buses, trains, disruptions and journey planning for assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://www.transcapi.com
- **Repository:** https://github.com/tcdataconsultants/transcapi-mcp
- **MCP Registry name:** com.transcapi/mcp
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

This stdio server wraps the TransCAPI API, which draws on official open data such as the Bus Open Data Service, NaPTAN, Network Rail and TfL. It needs a TransCAPI API key and, per the README, is read-only. Rail times come from National Rail's Darwin feed with platforms, cancellations and delay reasons, and live buses are matched to their exact trips.

The tools cover place and stop search, nearby stops and stations, bus and rail departures, the full calling pattern of one train or bus journey, live bus positions, disruptions by area, line or route, and journey planning. The README notes that journey planning currently covers only South and West Yorkshire and West Sussex. The wider API also offers measured bus punctuality, connection reliability for changes, reachability maps and webhook alerts, which the server tools do not list.

The README says the API also covers the Netherlands and Belgium. The free tier is quoted as 100 requests a day on the site and 200 in the README. If you display the data, the project asks you to credit its sources.

## Features

- **Live train times:** Platforms, expected times, cancellations and delay reasons.
- **Live bus positions:** Buses near a point with delays where tracked.
- **Calling patterns:** Every stop one bus or train journey calls at.
- **Disruption lookup:** Works, incidents and line status by area, line or route.
- **Journey planning:** Plans routes in the covered regions.
- **Read-only:** None of the tools change anything.

## Good for

- Ask when the next train from Leeds to York leaves and if it is late
- Find where the 52 bus is now
- Check disruptions on the way home
- Find stops near a postcode

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env TRANSCAPI_API_KEY='<TRANSCAPI_API_KEY>' -- uvx transcapi-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "transcapi-mcp"
      ],
      "env": {
        "TRANSCAPI_API_KEY": "<TRANSCAPI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "transcapi-mcp"
      ],
      "env": {
        "TRANSCAPI_API_KEY": "<TRANSCAPI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "transcapi-mcp"
      ],
      "env": {
        "TRANSCAPI_API_KEY": "<TRANSCAPI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "transcapi-mcp"
      ],
      "env": {
        "TRANSCAPI_API_KEY": "<TRANSCAPI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "transcapi-mcp"
      ],
      "env": {
        "TRANSCAPI_API_KEY": "<TRANSCAPI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_places`: Finds a town, village, postcode or stop by name.
- `nearby_stops`: Bus, tram and rail stops near a point.
- `nearby_stations`: Rail stations near a point.
- `bus_departures`: What is leaving or arriving at a bus stop with live times.
- `rail_departures`: Live trains at a station.
- `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.
- `disruptions`: Planned works, incidents and line status.
- `plan_journey`: Public transport journeys between two points.

## FAQ

### Do I need a key?

Yes, a free TransCAPI key.

### Where does journey planning work?

Currently South and West Yorkshire and West Sussex.

### What is the licence?

MIT.

### How do I run it?

Use uvx transcapi-mcp or pip install transcapi-mcp.

### Is TransCAPI free?

TransCAPI has a free plan, with paid plans for more usage or features.

### How do I add TransCAPI to Claude Code?

Run this command in your terminal: claude mcp add mcp --env TRANSCAPI_API_KEY='<TRANSCAPI_API_KEY>' -- uvx transcapi-mcp

### What are the best alternatives to TransCAPI?

The closest alternatives to TransCAPI are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/transcapi
