Get a stat leaderboard
get_leaderboardOne statistical leaderboard for one promotion from UFCalendar's Record Book rollup — career, single-fight, single-round, division or event boards across 57 metrics (wins, finishes, significant strikes, takedowns, control time, finish rate and more; the 9 discipline boards on fouls and stoppages need a Pro plan), optionally narrowed to a division, a country or active fighters. Ranked, with the sample size behind each value.
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": {
"org": "<org>",
"metric": "<metric>"
},
"name": "get_leaderboard"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | Yes | Promotion slug (required — boards are per promotion). | |
| limit | No | Rows, default 25. | |
| metric | Yes | Board metric, e.g. "wins", "finishes", "sig_strikes_landed", "fastest_knockout", "most_finishes_event", "finish_rate". | |
| country | No | ISO-3166 alpha-2 nationality, e.g. "BR" — fighters from that country. Not with population=active. | |
| division | No | One weight class, e.g. "lightweight", "womens-strawweight". | |
| population | No | all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months. |