Skip to main content
Glama

Boxerbook

Bout

bout
Read-onlyIdempotent

One bout in full by Boxerbook bout id, or by two boxers (two surnames, e.g. "Fury vs Joshua"): both boxers with records going in, status, result (winner, method, round, time), start_utc, venue, card, broadcasters, sources, Boxerbook forecast with its signals and the market consensus when known. Answers "have A and B ever fought", "head to head" and "when is A vs B", asked in any language: by names it returns their scheduled bout (else their latest) with head_to_head, and when they never met head_to_head alone says so, with each side's record, last fights and next bout. Pass lang matching the user's language (en, es, ru or ja) so the page links match it.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "bout"
  }
}

Input Schema

NameRequiredDescriptionDefault
idNoBoxerbook bout id (the id of a bout in any Boxerbook answer, or the number in a boxerbook.com/bouts/<id>/<slug> url)
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
queryNoinstead of id: two boxers as "A vs B", two surnames, e.g. "Fury vs Joshua"

Output Schema

NameRequiredDescriptionDefault
aNo
bNo
idNo
urlYes
citeYesthe markdown link to quote with any fact of this answer: Source: [Boxerbook](<url of the main page>)
cityNo
dateNo
noteNowhen the two never met: the head to head summary (no bout fields then)
timeNo
as_ofYes
eventNo
roundNo
storyNo«The story of the fight» of a completed bout, in English: a report written from the broadcast commentary, Boxerbook data and the press, every sentence checked against its sources (the bout page lists them); paragraphs separated by a blank line, text only (the charts are on the page). Absent when the bout has none
venueNo
marketNo
methodNo
statusNo
winnerNo
countryNo
displayNothe order to show the two names in: ['a','b'] or ['b','a'] (the better-known boxer first, as boxerbook.com does: more Wikipedia language links, then the Boxerbook rating, then pro bouts). a, b, winner, forecast.p_a and market.p_a keep their meaning (side a); only the display order changes
partialNotrue when part of the data could not be read this time; retry in a minute for the full answer
signalsNosignals of the latest forecast: a and b per side (age, age_precision, record, layoff_days, last5, ko_rate, home, travel_km, mu_delta_12m, div_shift, listed_first, short_notice_days, weight_lb, missed_weight, amateur, height_cm, reach_cm, stance, ...) and bout (title, rounds, main, division, lead_days, replaced, weigh_diff_lb)
sourcesNo
weighinNothe official weigh-in, per side when known: a commission sheet before the press
forecastNo
start_utcNo
broadcastsNo
exhibitionNo
fight_weekNofacts said in fight-week videos (press conference, weigh-in, face-off, open workout): only accepted ones, at most 24; no predictions or opinions
title_textNo
attributionYes
merged_fromNopresent when the id asked was a duplicate merged into this bout (the id asked; id and url are this bout's)
provisionalNo
confirmationNo
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
scheduled_roundsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / attribution / properties / license / const
      Previous value: -"ODbL"New value: +"Boxerbook data terms"
    • addedOutput schema / properties / attribution / properties / terms
      Added value: +{
      +  "format": "uri",
      +  "type": "string"
      +}
  2. Changed13 schema fields changed
    • changedInput schema / properties / id / description
      Previous value: -"Boxerbook bout id (from a schedule, results, search or a /bouts/<id>/<slug> url)"New value: +"Boxerbook bout id (the id of a bout in any Boxerbook answer, or the number in a boxerbook.com/bouts/<id>/<slug> url)"
    • 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"
      +}
    • addedInput schema / properties / query
      Added value: +{
      +  "description": "instead of id: two boxers as \"A vs B\", two surnames, e.g. \"Fury vs Joshua\"",
      +  "maxLength": 120,
      +  "minLength": 3,
      +  "type": "string"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "id"
      -]
    • addedOutput schema / properties / cite
      Added value: +{
      +  "description": "the markdown link to quote with any fact of this answer: Source: [Boxerbook](<url of the main page>)",
      +  "type": "string"
      +}
    • addedOutput schema / properties / display
      Added value: +{
      +  "description": "the order to show the two names in: ['a','b'] or ['b','a'] (the better-known boxer first, as boxerbook.com does: more Wikipedia language links, then the Boxerbook rating, then pro bouts). a, b, winner, forecast.p_a and market.p_a keep their meaning (side a); only the display order changes",
      +  "items": {
      +    "enum": [
      +      "a",
      +      "b"
      +    ]
      +  },
      +  "maxItems": 2,
      +  "minItems": 2,
      +  "type": "array"
      +}
    • removedOutput schema / properties / event / oneOf
      Removed value: -[
      -  {
      -    "properties": {
      -      "city": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "country": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "date": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "id": {
      -        "type": "integer"
      -      },
      -      "promoter": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "venue": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / event / properties
      Added value: +{
      +  "city": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "country": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "date": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "id": {
      +    "type": "integer"
      +  },
      +  "promoter": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "url": {
      +    "type": "string"
      +  },
      +  "venue": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  }
      +}
    • addedOutput schema / properties / event / type
      Added value: +[
      +  "object",
      +  "null"
      +]
    • 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"
      +}
    • addedOutput schema / properties / note
      Added value: +{
      +  "description": "when the two never met: the head to head summary (no bout fields then)",
      +  "type": "string"
      +}
    • addedOutput schema / properties / story
      Added value: +{
      +  "description": "«The story of the fight» of a completed bout, in English: a report written from the broadcast commentary, Boxerbook data and the press, every sentence checked against its sources (the bout page lists them); paragraphs separated by a blank line, text only (the charts are on the page). Absent when the bout has none",
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "id",
      -  "date",
      -  "status",
      -  "a",
      -  "b",
      -  "broadcasts",
      -  "sources",
      -  "fight_week",
      -  "url",
      -  "attribution",
      -  "as_of"
      -]New value: +[
      +  "cite",
      +  "url",
      +  "attribution",
      +  "as_of"
      +]
  3. Changed1 schema field changed
    • addedOutput schema / properties / merged_from
      Added value: +{
      +  "description": "present when the id asked was a duplicate merged into this bout (the id asked; id and url are this bout's)",
      +  "type": "integer"
      +}
  4. Changed1 schema field changed
    • changedInput schema / properties / id / description
      Previous value: -"Boxerbook bout id (from a schedule, results, search or a /bouts/<id> url)"New value: +"Boxerbook bout id (from a schedule, results, search or a /bouts/<id>/<slug> url)"
  5. First observed

TDQS

A4.2/5.0
Behavior5/5

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

Beyond the read-only and idempotent annotations, the description explains the name-query fallback (scheduled bout else latest), the no-history case where head_to_head alone is returned, and the per-side record, last fights, and next bout. This is substantial behavioral context for an annotated read tool.

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

Conciseness3/5

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

The first sentence is front-loaded with the resource, but it then spends a long clause enumerating return fields even though an output schema exists. The head-to-head explanation also repeats 'head_to_head', making the three-sentence block denser than necessary.

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?

For a complex lookup with an output schema and safety annotations, the description covers both query modes, the head-to-head fallback, and language behavior. The main remaining gap is that with zero required parameters it never explicitly states that id and query are alternatives and what happens if neither is provided.

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?

The schema already documents all three parameters at 100% coverage, and the description largely restates them: id, 'A vs B' as two surnames, and lang for page links. It does not clarify precedence or what happens if both id and query are supplied or neither is supplied, so it stays at the baseline.

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

Purpose5/5

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

The description gives a specific resource ('One bout in full') with two retrieval modes, id or two boxers, and names concrete question patterns it answers ('have A and B ever fought', 'head to head', 'when is A vs B'). This lets an agent distinguish it from general results or schedule siblings without opening the schema.

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 clearly describes the contexts in which the tool applies: a single full bout and head-to-head questions, including scheduled-vs-latest fallback behavior. It does not explicitly name a sibling alternative or state when not to use it, so it falls short of the top score.

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.