Matchbook MCP Server
An MCP server that provides read-only access to the Matchbook Betting Exchange public API.
Tools
| Tool | Description |
|---|---|
get_sports |
List sports available on Matchbook |
get_navigation |
Full navigation tree (sport → competition → date) |
get_events |
List events / fixtures (filterable by sport, time, state) |
get_event |
Single event details |
get_markets |
List markets for an event |
get_market |
Single market details |
get_runners |
List runners (selections) for a market |
get_runner |
Single runner details |
get_prices |
Current price ladder (back/lay) for a runner |
get_popular_markets |
Most popular markets right now |
get_popular_sports |
Most popular sports right now |
Quick Start
Install
pip install matchbook-mcp
Run
matchbook-mcp
Claude Desktop config
{
"mcpServers": {
"matchbook": {
"command": "matchbook-mcp"
}
}
}
VS Code / Cursor config
{
"mcp": {
"servers": {
"matchbook": {
"command": "matchbook-mcp"
}
}
}
}
Development
git clone git@bitbucket.org:xcl-mb/matchbook-mcp.git
cd matchbook-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
matchbook-mcp
API Reference
All endpoints come from the Matchbook Developer Centre. No authentication is required for the read-only market data endpoints exposed by this server.
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
matchbook_mcp-0.1.0.tar.gz
(4.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file matchbook_mcp-0.1.0.tar.gz.
File metadata
- Download URL: matchbook_mcp-0.1.0.tar.gz
- Upload date:
- Size: 4.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f1dfa573f1585c421d1b128abb6d1bff0ff59255845acb3f6ffe0345c223da4
|
|
| MD5 |
46e716f662ccb138d42d128e3ad57ecd
|
|
| BLAKE2b-256 |
9f81be008246078621cc2255a15fb439ce7e967f122e0a38b41ff0261c43e97f
|
File details
Details for the file matchbook_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: matchbook_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa49b2e94cf750433d2542eb49ea16b2947f22e1d5fe73efa5e3dc775f2b47b8
|
|
| MD5 |
4ae8e04be592d1701b55afb4498c553e
|
|
| BLAKE2b-256 |
b6028f7fdbd61cb07a8efa7b6de34f9807c41511bc4663748de9457e6d2860d1
|