Documentation menu

nfl_contract_value

Pro tier

Contract value

PREFERRED for contract value / cost-efficiency questions. Returns fantasy points per $M of average per year (APY) using each player's active contract joined to seasonal fantasy production. Use for 'best fantasy value per dollar' or 'is player X worth his contract'. apy and cap_pct reflect the current active contract. Default sort is best value first (fp_per_million DESC).

Minimum tier: Pro
Data coverage: 2013 onwards seasons

Parameters

Name	Type	Required	Description
`player`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted.
`position`	string	Optional	Position filter (e.g. RB, WR).
`team`	string	Optional	Team abbreviation.
`season`	integer	Optional	Exact season year.
`min_apy`	number	Optional	Minimum APY in $millions.
`max_apy`	number	Optional	Maximum APY in $millions.
`limit`	integer	Optional	Max rows (default 50, max 500).

Example request

A Model Context Protocol tools/call over Streamable HTTP. Replace YOUR_API_KEY with a key from your dashboard.

curl -X POST https://mcp.nflmcp.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nfl_contract_value",
    "arguments": {
      "position": "WR",
      "season": 2024,
      "limit": 10
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "contract_value": [
    {
      "player_id": "00-0039075",
      "full_name": "Puka Nacua",
      "position": "WR",
      "team": "LA",
      "season": 2024,
      "apy": 1.0212,
      "cap_pct": 0,
      "total_fp": 232.4,
      "total_fp_exp": 229.97,
      "fp_per_million": 227.57
    },
    {
      "player_id": "00-0038621",
      "full_name": "Demario Douglas",
      "position": "WR",
      "team": "NE",
      "season": 2024,
      "apy": 0.9933,
      "cap_pct": 0,
      "total_fp": 147.7,
      "total_fp_exp": 126.17,
      "fp_per_million": 148.69
    },
    {
      "player_id": "00-0038997",
      "full_name": "Josh Downs",
      "position": "WR",
      "team": "IND",
      "season": 2024,
      "apy": 1.3801,
      "cap_pct": 0,
      "total_fp": 182.2,
      "total_fp_exp": 170.31,
      "fp_per_million": 132.02
    }
  ],
  "count": 10
}

All tools