Boxerbook MCP / Tools / search
Boxerbook tool · reads data only
search
Search Boxerbook: Search the whole catalog with one query.
What it answers
Search the whole catalog with one query: boxers by name, bouts by two surnames ("Inoue vs Nakatani"), their cards, and divisions ("heavyweight rankings"); an id such as bout:123 is looked up directly. Each hit has an id for fetch, a title and its boxerbook.com url; ChatGPT connectors and deep research, which call nothing but search and fetch, start here. No match returns an empty list. Cite the url.
- “Reyes vs Hale”
- “heavyweight rankings”
- “Kenji Morita”
Arguments
| Argument | Type | Description |
|---|---|---|
query required | string | what to look for: a boxer, two boxers, a division min length 1 · max length 200 |
Raw input schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "what to look for: a boxer, two boxers, a division",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"query"
]
}Example request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"query": "Reyes vs Hale"
}
}
}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":"search","arguments":{"query":"Reyes vs Hale"}}}'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.
{
"query": "Reyes vs Hale",
"results": [
{
"id": "bout:70001",
"title": "Danny Reyes vs Tom Hale, 2026-10-24 (scheduled)",
"url": "https://boxerbook.com/bouts/70001"
},
{
"id": "event:9001",
"title": "Card of 2026-10-24, York Hall, London, GB",
"url": "https://boxerbook.com/events/9001"
},
{
"id": "boxer:2345",
"title": "Danny Reyes (US, Welterweight, 14-0-0)",
"url": "https://boxerbook.com/boxers/danny-reyes"
}
],
"url": "https://boxerbook.com/search?q=Reyes%20vs%20Hale"
}Fields of the answer: query, results, url.
Annotations: read-only, not destructive, idempotent, closed world. Errors: bad arguments are JSON-RPC -32602; nothing found is a result with isError: true.