OpenBusData
MCP server for UK Bus Open Data with timetable parsing, journey planning and live tracking.
Open source Open in the app JSON README (API)
About
MCP server for UK Bus Open Data with timetable parsing, journey planning and live tracking.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- andrewaubury
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Last push
- 2026-06-19T17:07:43Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 03:01:41
- Updated
- 2026-08-29 03:01:41
- Origin id
io.github.AndrewAubury/openbusdata
README
# OpenBusData MCP Server
mcp-name: io.github.AndrewAubury/openbusdata
MCP server for the [UK Bus Open Data Service](https://data.bus-data.dft.gov.uk) 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)
```bash
uvx openbusdata-mcp
```
### Option 2: via `pip`
```bash
pip install openbusdata-mcp
```
## Configuration
Set your Bus Open Data Service API key as an environment variable:
```bash
export OPENBUS_API_KEY="your-api-key-here"
```
Get a free key at [data.bus-data.dft.gov.uk](https://data.bus-data.dft.gov.uk).
## Usage
### With `uvx` (recommended)
Add to your MCP client (Claude Desktop, Cursor, etc.):
```json
{
"mcpServers": {
"openbusdata": {
"command": "uvx",
"args": ["openbusdata-mcp"],
"env": {
"OPENBUS_API_KEY": "your-api-key-here"
}
}
}
}
```
### With `pip` install
```json
{
"mcpServers": {
"openbusdata": {
"command": "openbusdata-mcp",
"env": {
"OPENBUS_API_KEY": "your-api-key-here"
}
}
}
}
```
## Development
```bash
# 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