Skip to main content
Glama

Boxerbook

Search Boxerbook

search
Read-onlyIdempotent

Search the whole catalog with one query: boxers by name, bouts and head to head by two surnames, e.g. "Fury vs Joshua" (when they never met, head_to_head says so with both records and last fights), their cards, and divisions ("heavyweight rankings"); an id such as bout:123 is looked up directly. Each hit has a document id, a title and its boxerbook.com url. No match returns an empty list. Pass lang matching the user's language (en, es, ru or ja) so the page links match it.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "query": "<query>"
    },
    "name": "search"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNothe user's language: en (default), es, ru or ja; the boxerbook.com page links of the answer follow it (a page without a translation keeps its English link)en
queryYeswhat to look for: a boxer, two boxers ("Fury vs Joshua"), a division

Output Schema

NameRequiredDescriptionDefault
partialNotrue when part of the data could not be read this time; retry in a minute for the full answer
resultsYes
head_to_headNothe two boxers named in the query: whether and how often they met, the bout between them that is scheduled, and each side's record, last fights and next bout

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changed
    • addedInput schema / properties / lang
      Added value: +{
      +  "default": "en",
      +  "description": "the user's language: en (default), es, ru or ja; the boxerbook.com page links of the answer follow it (a page without a translation keeps its English link)",
      +  "enum": [
      +    "en",
      +    "es",
      +    "ru",
      +    "ja"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / query / description
      Previous value: -"what to look for: a boxer, two boxers, a division"New value: +"what to look for: a boxer, two boxers (\"Fury vs Joshua\"), a division"
    • removedOutput schema / properties / as_of
      Removed value: -{
      -  "description": "ISO UTC time of this answer",
      -  "type": "string"
      -}
    • removedOutput schema / properties / attribution
      Removed value: -{
      -  "properties": {
      -    "license": {
      -      "const": "ODbL"
      -    },
      -    "source": {
      -      "const": "Boxerbook"
      -    },
      -    "url": {
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "source",
      -    "license",
      -    "url"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / properties / head_to_head
      Added value: +{
      +  "description": "the two boxers named in the query: whether and how often they met, the bout between them that is scheduled, and each side's record, last fights and next bout",
      +  "properties": {
      +    "a": {
      +      "properties": {
      +        "id": {
      +          "type": "integer"
      +        },
      +        "last_fights": {
      +          "description": "the last three completed bouts, newest first",
      +          "items": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "id": {
      +                "type": "integer"
      +              },
      +              "method": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "opponent": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "result": {
      +                "description": "W, L, D or NC for this side",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "round": {
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "date",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "next_bout": {
      +          "properties": {
      +            "date": {
      +              "type": "string"
      +            },
      +            "id": {
      +              "type": "integer"
      +            },
      +            "opponent": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "record": {
      +          "description": "W-L-D today",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "name",
      +        "url",
      +        "last_fights"
      +      ],
      +      "type": "object"
      +    },
      +    "b": {
      +      "properties": {
      +        "id": {
      +          "type": "integer"
      +        },
      +        "last_fights": {
      +          "description": "the last three completed bouts, newest first",
      +          "items": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "id": {
      +                "type": "integer"
      +              },
      +              "method": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "opponent": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "result": {
      +                "description": "W, L, D or NC for this side",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "round": {
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "date",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "next_bout": {
      +          "properties": {
      +            "date": {
      +              "type": "string"
      +            },
      +            "id": {
      +              "type": "integer"
      +            },
      +            "opponent": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "record": {
      +          "description": "W-L-D today",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "name",
      +        "url",
      +        "last_fights"
      +      ],
      +      "type": "object"
      +    },
      +    "bouts": {
      +      "description": "the bouts between them, newest first (at most 5)",
      +      "items": {
      +        "properties": {
      +          "date": {
      +            "type": "string"
      +          },
      +          "id": {
      +            "type": "integer"
      +          },
      +          "method": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "round": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          },
      +          "winner": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "date",
      +          "status",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "met": {
      +      "description": "completed bouts between them",
      +      "type": "integer"
      +    },
      +    "scheduled": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "integer"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "summary": {
      +      "description": "one sentence: how often they met and with what result, or that they never fought; the scheduled date; both records",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "summary",
      +    "met",
      +    "bouts",
      +    "a",
      +    "b"
      +  ],
      +  "type": "object"
      +}
    • removedOutput schema / properties / query
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / properties / results / items / properties / id / description
      Previous value: -"pass to fetch: boxer:<id>, bout:<id>, event:<id> or rankings:<DIV>"New value: +"the document id: boxer:<id>, bout:<id>, event:<id> or rankings:<DIV>"
    • addedOutput schema / properties / results / items / properties / title / minLength
      Added value: +1
    • addedOutput schema / properties / results / items / properties / url / minLength
      Added value: +1
    • removedOutput schema / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / required
      Previous value: -[
      -  "results",
      -  "attribution",
      -  "as_of"
      -]New value: +[
      +  "results"
      +]
  2. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so safety is covered. The description adds behavior beyond that: no match returns an empty list, and each hit carries a document id, title and a localized boxerbook.com URL — useful outcome details the annotations do not convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is one front-loaded paragraph that opens with the core action ('Search the whole catalog with one query') before enumerating entity types. The head-to-head parenthetical is dense but earns its place as the non-obvious edge case; a little pruning would still help.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need not be re-explained, yet the description still summarizes the hit shape (document id, title, url) and the empty-result case. Query forms and the lang/link relationship are covered; only ranking or result-ordering behavior is left unstated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so both parameters are already documented, making 3 the baseline. The description does add some meaning beyond the schema by admitting id-style queries ('an id such as bout:123 is looked up directly') and by tying lang to page-link localization, but it does not clarify input syntax for the other query forms beyond the two examples.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource ('Search the whole catalog with one query') and enumerates the entity types covered: boxers, bouts, head-to-head, cards and divisions, plus direct id lookup such as bout:123. It implicitly separates itself from the narrower search_boxers sibling via 'whole catalog', but never names the alternative, so an agent must infer the boundary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete query forms to use ('Fury vs Joshua', 'heavyweight rankings', bouts, divisions) and explains the head_to_head edge case when the two boxers never met. There is no explicit when-not guidance or named alternative versus siblings like search_boxers, bout or rankings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.