Metadata-Version: 2.4
Name: matchbook-mcp
Version: 0.1.0
Summary: MCP server for the Matchbook Betting Exchange public API
Author-email: Matchbook <api@matchbook.com>
License-Expression: MIT
Keywords: api,betting,exchange,matchbook,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx<1.0,>=0.27.0
Requires-Dist: mcp<2.0,>=1.24.0
Description-Content-Type: text/markdown

# Matchbook MCP Server

An [MCP](https://modelcontextprotocol.io) server that provides read-only access to the [Matchbook Betting Exchange](https://www.matchbook.com) 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

```bash
pip install matchbook-mcp
```

### Run

```bash
matchbook-mcp
```

### Claude Desktop config

```json
{
  "mcpServers": {
    "matchbook": {
      "command": "matchbook-mcp"
    }
  }
}
```

### VS Code / Cursor config

```json
{
  "mcp": {
    "servers": {
      "matchbook": {
        "command": "matchbook-mcp"
      }
    }
  }
}
```

## Development

```bash
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](https://developers.matchbook.com).
No authentication is required for the read-only market data endpoints exposed by this server.

## License

MIT
