Boxerbook

npx add-mcp 'https://mcp.boxerbook.com/mcp'

Boxerbook for developers and AI agents

Free, read-only boxing data with no key: the schedule with start times (UTC) and broadcasters, results with sources, boxer cards with the record going into each bout, the Boxerbook rating, forecasts and market consensus. Two doors to the same data: an MCP server for AI assistants and an open JSON API.

MCP server

Endpoint: https://mcp.boxerbook.com/mcp (Streamable HTTP, stateless, no sign-in).

Claude Code:

claude mcp add --transport http boxerbook https://mcp.boxerbook.com/mcp

Claude Desktop and claude.ai: Settings → Connectors → Add custom connector, URL https://mcp.boxerbook.com/mcp, no key.

ChatGPT: Settings → Connectors → Create with the same URL (the server has the search and fetch tools connectors need), or a GPT Action from /v1/openapi.json.

Cursor, VS Code and other clients:

{ "mcpServers": { "boxerbook": { "url": "https://mcp.boxerbook.com/mcp" } } }

Tools:

• boxing_schedule: Boxing schedule
• boxing_results: Boxing results
• boxer: Boxer card
• next_fight: Next fight of a boxer
• bout: Bout
• where_to_watch: Where to watch
• rankings: Division rankings
• search_boxers: Search boxers
• search: Search Boxerbook
• fetch: Fetch a Boxerbook document

Step-by-step guides for each client, one page per tool and the server card: mcp.boxerbook.com.

JSON API

Base URL https://boxerbook.com/v1. The full description is /v1/openapi.json (OpenAPI 3.1).

curl 'https://boxerbook.com/v1/schedule?when=weekend'
curl 'https://boxerbook.com/v1/results?days=2&country=GB'
curl 'https://boxerbook.com/v1/boxers/search?q=inoue'
curl 'https://boxerbook.com/v1/rankings/hea?publisher=wbc'

Every answer is JSON with attribution and as_of (UTC), Cache-Control: public, max-age=60, an ETag and CORS *.

Limits

Per IP: 60 requests per minute for the JSON API, 300 tool calls per minute for MCP (initialize, listing tools and prompts are not counted; a batch holds at most 5 messages). Point lookups only: limit up to 50, offset up to 1000, search up to 20 matches, results up to 14 days, schedule up to 30 days. Need more? Write to info@boxerbook.com.

Attribution

The data is open under the ODbL. Credit Boxerbook and link the url of each answer: Contains data from Boxerbook (https://boxerbook.com), © QuadroM LLC, licensed under ODbL.

Terms of the API and MCP server: /terms#api.

Errors

API errors are application/problem+json (RFC 9457) with type, title, status and detail; type links here.

A parameter is out of range or malformed (when, days, country, division, limit, publisher, q). The detail says which; fix the request, do not retry it as is.

No such endpoint, boxer, bout, event or division. Find ids with /v1/boxers/search or the MCP search tool.

The API is read only: use GET (MCP: POST to /mcp).

Over 60 API requests (or 300 MCP tool calls) per minute from your IP. Wait for Retry-After (60 s); MCP answers HTTP 429 with JSON-RPC error -32000.

A bug on our side; it is logged. Retry later or write to us.

The database is busy; retry after Retry-After (60 s).

MCP uses JSON-RPC codes: -32700 invalid JSON, -32600 invalid request, -32601 unknown method, -32602 invalid arguments, -32000 rate limit or wrong HTTP method. A tool that finds nothing answers a result with isError: true.