Skip to main content

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

Metadata

Release files for matchbook-mcp 0.1.0

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

Source distribution (sdist)

Source distribution for matchbook-mcp 0.1.0
File Size Uploaded Provenance Actions
matchbook_mcp-0.1.0.tar.gz 4.0 kB Without provenance Details for matchbook_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for matchbook-mcp 0.1.0
File Interpreter ABI Platform Actions
matchbook_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for matchbook_mcp-0.1.0-py3-none-any.whl

Total release size: 9.4 kB

Release files / matchbook_mcp-0.1.0.tar.gz

Download URL matchbook_mcp-0.1.0.tar.gz
Size 4.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1f1dfa573f1585c421d1b128abb6d1bff0ff59255845acb3f6ffe0345c223da4
BLAKE2b-256 checksum
How to use checksums
9f81be008246078621cc2255a15fb439ce7e967f122e0a38b41ff0261c43e97f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / matchbook_mcp-0.1.0-py3-none-any.whl

Download URL matchbook_mcp-0.1.0-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fa49b2e94cf750433d2542eb49ea16b2947f22e1d5fe73efa5e3dc775f2b47b8
BLAKE2b-256 checksum
How to use checksums
b6028f7fdbd61cb07a8efa7b6de34f9807c41511bc4663748de9457e6d2860d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for matchbook-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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