Boxerbook MCP / Tools / search_boxers
Boxerbook tool · reads data only
search_boxers
Search boxers: Find boxers by name (at most 20), best match first.
What it answers
Find boxers by name (at most 20), best match first: id, slug, name, country, division, record. Use this when a name is ambiguous or its spelling unsure, then call boxer or next_fight with the id. Cite the url.
- “Which boxers are called Rodriguez?”
- “How is that name spelled?”
Arguments
| Argument | Type | Description |
|---|---|---|
q required | string | a name or part of it min length 2 · max length 80 |
Raw input schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "a name or part of it",
"minLength": 2,
"maxLength": 80
}
},
"required": [
"q"
]
}Example request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_boxers",
"arguments": {
"q": "morita"
}
}
}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_boxers","arguments":{"q":"morita"}}}'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": "morita",
"results": [
{
"id": 1234,
"slug": "kenji-morita",
"name": "Kenji Morita",
"country": "JP",
"division": "fea",
"record": "21-1-0",
"url": "https://boxerbook.com/boxers/kenji-morita"
}
],
"url": "https://boxerbook.com/search?q=morita"
}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.