mcpField
O
OpenBusData

OpenBusData

Local
github.com/AndrewAuburyMaps & Travel0Updated 19w ago
Repository

About OpenBusData

OpenBusData is an MCP server for querying the UK Bus Open Data Service, for people planning bus journeys or checking current service information. It combines stop and route discovery with timetable, fare, disruption, and live-location data.

Key features

  1. 01Search UK bus stops
  2. 02Find routes between stops
  3. 03Plan direct and multi-leg journeys
  4. 04Query timetables, fares, and disruptions
  5. 05Track live bus locations

Use cases

  1. 01Find stops matching a place or name
  2. 02Plan a trip arriving by a set time
  3. 03Check fares, cancellations, or disruptions
  4. 04Locate a bus in real time

MCP support

Exposes UK bus data tools to MCP clients, including stop search, route discovery, journey planning, and real-time tracking. Requires a Bus Open Data Service API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "andrewaubury-openbusdata": {
      "command": "uvx",
      "args": [
        "openbusdata-mcp"
      ],
      "env": {
        "OPENBUS_API_KEY": "<OPENBUS_API_KEY>"
      }
    }
  }
}
Run commanduvx openbusdata-mcp
Environment variables to set
OPENBUS_API_KEYSecretYour UK Bus Open Data Service API key from https://data.bus-data.dft.gov.uk

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiopenbusdata-mcp1.0.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

OpenBusData MCP Server

mcp-name: io.github.AndrewAubury/openbusdata

MCP server for the UK Bus Open Data Service with rich timetable parsing, stop search, route discovery, journey planning and real-time bus tracking.

Features

  • Live API tools — query timetables, fares, disruptions, cancellations and real-time bus locations
  • Stop search — fuzzy text search across every bus stop in the UK
  • Route finder — discover all routes serving a pair of stops
  • Journey planner — "get to X by Y o'clock" with support for direct and chained multi-leg journeys
  • Live tracking — see exactly where buses are right now

Installation

Option 1: via uvx (recommended — no install needed)
uvx openbusdata-mcp
Option 2: via pip
pip install openbusdata-mcp

Configuration

Set your Bus Open Data Service API key as an environment variable:

export OPENBUS_API_KEY="your-api-key-here"

Get a free key at data.bus-data.dft.gov.uk.

Usage

With uvx (recommended)

Add to your MCP client (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "openbusdata": {
      "command": "uvx",
      "args": ["openbusdata-mcp"],
      "env": {
        "OPENBUS_API_KEY": "your-api-key-here"
      }
    }
  }
}
With pip install
{
  "mcpServers": {
    "openbusdata": {
      "command": "openbusdata-mcp",
      "env": {
        "OPENBUS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Development

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows

# Install dependencies
pip install -e ".[dev]"

# Run server
python -m openbusdata_mcp.server

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.