Boxerbook MCP / Tools / boxing_schedule
Boxerbook tool · reads data only
boxing_schedule
Boxing schedule: Upcoming professional boxing cards worldwide, grouped by card.
What it answers
Upcoming professional boxing cards worldwide, grouped by card: date, start_utc (card start in UTC), venue, promoter, broadcasters, and each bout with both records going in, division, scheduled rounds, title, Boxerbook forecast and market consensus when known. Use this for "who is fighting tonight / this weekend", "what boxing is on". when=today also keeps last night's cards that started under 6 hours ago. Cite the url of each card or bout.
- “Who is fighting tonight?”
- “What boxing is on this weekend in the UK?”
- “Which heavyweight fights are coming up this month?”
Arguments
| Argument | Type | Description |
|---|---|---|
when | enum: today | tonight | weekend | 30d | today (and cards still running from last night), tonight, weekend (Fri-Sun) or 30d default today |
country | string | ISO 3166-1 alpha-2 country of the bout, e.g. GB, US, MX pattern ^[A-Za-z]{2}$ |
division | string | division code (hea, wel, w_fea) or name (heavyweight, women's featherweight) min length 1 · max length 40 |
Raw input schema
{
"type": "object",
"properties": {
"when": {
"type": "string",
"enum": [
"today",
"tonight",
"weekend",
"30d"
],
"default": "today",
"description": "today (and cards still running from last night), tonight, weekend (Fri-Sun) or 30d"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country of the bout, e.g. GB, US, MX",
"pattern": "^[A-Za-z]{2}$"
},
"division": {
"type": "string",
"description": "division code (hea, wel, w_fea) or name (heavyweight, women's featherweight)",
"minLength": 1,
"maxLength": 40
}
}
}Example request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "boxing_schedule",
"arguments": {
"when": "weekend",
"country": "GB"
}
}
}From a terminal (curl)
curl -s https://mcp.boxerbook.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"boxing_schedule","arguments":{"when":"weekend","country":"GB"}}}'Example answer
Shortened; names and numbers are illustrative, not live data. The result has structuredContent (below) and the same object as compact JSON in content[0].text; every answer also carries attribution and as_of.
{
"when": "weekend",
"from": "2026-10-23",
"to": "2026-10-25",
"country": "GB",
"events": [
{
"id": 9001,
"date": "2026-10-24",
"venue": "York Hall",
"city": "London",
"country": "GB",
"promoter": "Example Promotions",
"start_utc": "2026-10-24T18:00Z",
"broadcasts": [
{
"platform": "DAZN",
"region": "GB"
}
],
"url": "https://boxerbook.com/events/9001",
"bouts": [
{
"id": 70001,
"a": {
"name": "Danny Reyes",
"record": "14-0-0"
},
"b": {
"name": "Tom Hale",
"record": "11-2-0"
},
"division": "wel",
"scheduled_rounds": 10,
"title_text": null,
"forecast": {
"p_a": 0.66
},
"url": "https://boxerbook.com/bouts/70001"
}
]
}
],
"url": "https://boxerbook.com/schedule"
}Fields of the answer: when, from, to, country, division, truncated, events, url.
Annotations: read-only, not destructive, idempotent, closed world. Errors: bad arguments are JSON-RPC -32602; nothing found is a result with isError: true.