get_leaders

5 creditsStats + aggregationPOST /v1/get_leaders

Career leaderboards from every fight's stat sheet

Use it when you want who leads a stat across the roster, filtered by weight class or era, with a minimum number of fights.

Parameters

statenum: sig_landed_per_15 | sig_absorbed_per_15 | sig_accuracy | sig_defense | td_per_15 | td_accuracy | td_defense | knockdowns | sub_attempts_per_15 | control_share | finish_raterequired: Which leaderboard.
weight_classstringoptional: Only fights in this weight class, e.g. Lightweight.
sincestring | numberoptional: Only fights from this year on, e.g. 2020.
min_fightsintegeroptional: Minimum fights to qualify (default 5).
limitintegeroptional: Max fighters (default 20).

Notes

Over MCP, ask for it in plain English and the client calls get_leaders itself. Point any MCP client at https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.fighterapi.com/v1/get_leaders \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "stat": "sig_landed_per_15",
  "since": 2020,
  "min_fights": 8,
  "limit": 3
}'

Response

json

{
  "stat": "sig_landed_per_15",
  "label": "significant strikes landed per 15 min",
  "min_fights": 8,
  "leaders": [
    {
      "rank": 1,
      "fighter_id": "5120301",
      "name": "Joshua Van",
      "weight_class": "Flyweight",
      "fights": 12,
      "value": 123.893
    },
    {
      "rank": 2,
      "fighter_id": "4425604",
      "name": "Terrance McKinney",
      "weight_class": "Lightweight",
      "fights": 14,
      "value": 119.303
    },
    {
      "rank": 3,
      "fighter_id": "2502364",
      "name": "King Green",
      "weight_class": "Lightweight",
      "fights": 21,
      "value": 117.571
    }
  ],
  "count": 3
}