Stats + aggregation5 credits

get_player_leaders

Leaderboard for any stat, filtered by position, team, and season

When to use it

You want a leaderboard on any stat, including EPA and fantasy points, with position and games filters.

Parameters

Name	Type	Required	Description
stat	string	yes	Weekly stat column to rank by (e.g. passing_yards, receiving_epa, def_sacks)
season	string \| number	no	Season year. Defaults to current.
season_type	enum: REG \| POST	no	Regular season (default) or postseason
position	string	no	Position filter, e.g. QB, RB, WR, TE
team	string	no	Team code filter
min_games	integer	no	Minimum games with a stat line (default 1)
limit	integer	no	Max results (default 20)

Request

bash

curl -X POST https://football-mcp-production.up.railway.app/v1/get_player_leaders \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "stat": "passing_epa",
  "season": 2025,
  "position": "QB",
  "limit": 5
}'

Over MCP, ask for it in plain English and the client calls get_player_leaders itself. Point any MCP client at https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY.

Response

json

{
  "stat": "passing_epa",
  "aggregation": "sum",
  "season": 2025,
  "season_type": "REG",
  "leaders": [
    {
      "rank": 1,
      "player_id": "00-0039851",
      "name": "Drake Maye",
      "position": "QB",
      "team": "NE",
      "games": 17,
      "value": 166.215
    },
    {
      "rank": 2,
      "player_id": "00-0026498",
      "name": "Matthew Stafford",
      "position": "QB",
      "team": "LA",
      "games": 17,
      "value": 150.454
    },
    {
      "rank": 3,
      "player_id": "00-0033077",
      "name": "Dak Prescott",
      "position": "QB",
      "team": "DAL",
      "games": 17,
      "value": 114.349
    }
  ],
  "count": 5
}

Response fields

Field	Type	Description
stat	string
aggregation	string
season	number
season_type	string
leaders[]	array	List of objects
leaders[].rank	number
leaders[].player_id	string
leaders[].name	string
leaders[].position	string
leaders[].team	string
leaders[].games	number
leaders[].value	number
count	number