get_ratings

2 creditsBasic lookupPOST /v1/get_ratings

Our fighter ratings (Elo from every UFC result since 2000)

Use it when you want our Elo ratings, best first, for active fighters, overall or by weight class.

Parameters

weight_classstringoptional: e.g. Welterweight.
active_sincestring | numberoptional: Only fighters whose last fight was in this year or later.
limitintegeroptional: Max fighters (default 25).

Notes

Over MCP, ask for it in plain English and the client calls get_ratings itself. Point any MCP client at https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 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_ratings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "weight_class": "Featherweight",
  "limit": 3
}'

Response

json

{
  "active_since": 2025,
  "ratings": [
    {
      "rank": 1,
      "fighter_id": "3949584",
      "name": "Alexander Volkanovski",
      "weight_class": "Featherweight",
      "rating": 1677,
      "last_fight": "2026-02-01T02:00:00.000Z",
      "fights": 18,
      "ufc_fights": 18
    },
    {
      "rank": 2,
      "fighter_id": "3031559",
      "name": "Aljamain Sterling",
      "weight_class": "Featherweight",
      "rating": 1673,
      "last_fight": "2026-04-26T00:00:00.000Z",
      "fights": 23,
      "ufc_fights": 23
    },
    {
      "rank": 3,
      "fighter_id": "4029275",
      "name": "Movsar Evloev",
      "weight_class": "Featherweight",
      "rating": 1658,
      "last_fight": "2026-03-21T20:00:00.000Z",
      "fights": 10,
      "ufc_fights": 10
    }
  ],
  "count": 3,
  "method": "Elo from UFC results alone: start 1500, K 40 for a fighter's first five bouts then 24, finishes weighted 1.15, draws 0.5, no contests unrated."
}