Documentation menu

nfl_player_id_map

Free tier

Player ID map

Cross-platform player ID resolution. Given exactly one identifier (name or a platform ID), returns all known IDs (Sleeper, ESPN, Yahoo, FantasyPros, GSIS, PFR, and more) plus bio and draft info. Use to bridge fantasy-platform rosters to analytics tools.

Minimum tier: Free
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`name`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted.
`gsis_id`	string	Optional	GSIS ID (e.g. 00-0036322).
`sleeper_id`	string	Optional	Sleeper platform ID.
`sleeper_ids`	array	Optional	Up to 500 Sleeper IDs; preserves input order and reports unresolved IDs.
`espn_id`	string	Optional	ESPN platform ID.
`yahoo_id`	string	Optional	Yahoo platform ID.
`fantasypros_id`	string	Optional	FantasyPros platform ID.
`fields`	array	Optional	Optional subset of fields to return.

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_player_id_map",
    "arguments": {
      "sleeper_ids": [
        "6794",
        "4046"
      ]
    }
  }
}'

Example response

{
  "players": [
    {
      "player": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "birthdate": "1999-06-16",
      "age": 26.6,
      "draft_year": 2020,
      "draft_round": 1,
      "draft_pick": 22,
      "draft_ovr": 22,
      "college": "LSU",
      "gsis_id": "00-0036322",
      "sleeper_id": 6794,
      "espn_id": 4262921,
      "yahoo_id": "32692",
      "fantasypros_id": 19236,
      "mfl_id": 14836,
      "sportradar_id": "4131d4ee-0318-4bb5-832a-4dec80668a4f",
      "pff_id": 61398,
      "pfr_id": "JeffJu00",
      "cbs_id": 2871343,
      "rotowire_id": 14509,
      "rotoworld_id": null,
      "ktc_id": 542,
      "fantasy_data_id": 21685,
      "cfbref_id": "justin-jefferson-1",
      "stats_id": 32692,
      "nfl_id": 52430,
      "fleaflicker_id": null,
      "swish_id": "1069535",
      "stats_global_id": 0
    },
    {
      "player": "Patrick Mahomes",
      "position": "QB",
      "team": "KCC",
      "birthdate": "1995-09-17",
      "age": 30.4,
      "draft_year": 2017,
      "draft_round": 1,
      "draft_pick": 10,
      "draft_ovr": 10,
      "college": "Texas Tech",
      "gsis_id": "00-0033873",
      "sleeper_id": 4046,
      "espn_id": 3139477,
      "yahoo_id": "30123",
      "fantasypros_id": 16413,
      "mfl_id": 13116,
      "sportradar_id": "11cad59d-90dd-449c-a839-dddaba4fe16c",
      "pff_id": 11765,
      "pfr_id": "MahoPa00",
      "cbs_id": 2142052,
      "rotowire_id": 11839,
      "rotoworld_id": "12142",
      "ktc_id": 272,
      "fantasy_data_id": 18890,
      "cfbref_id": "patrick-mahomes-1",
      "stats_id": 30123,
      "nfl_id": 44822,
      "fleaflicker_id": null,
      "swish_id": "839031",
      "stats_global_id": 839031
    }
  ],
  "unresolved": [],
  "requested_count": 2,
  "count": 2
}

All tools