search_players

2 creditsBasic lookupPOST /v1/search_players

Data refreshed Nov 6, 2026 · changelog

Find players by name, team, or position

Use it when you have a name and need the GSIS id (and the pfr_id and espn_id crosswalk) to call the stat endpoints.

Parameters

querystringrequired: Player name or part of it
teamstringoptional: Filter by current team code
positionstringoptional: Filter by position (e.g. QB, RB, WR, TE, OL, DL, LB, DB)
activebooleanoptional: Default true, but an active-only search that finds nobody automatically falls back to all players and says so. Set false to search everyone outright.
limitintegeroptional: Max results (default 10)

Notes

Over MCP, ask for it in plain English and the client calls search_players itself. Point any MCP client at https://mcp.endzoneapi.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.endzoneapi.com/v1/search_players \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Mahomes"
}'

Response

json

{
  "players": [
    {
      "player_id": "00-0033873",
      "name": "Patrick Mahomes",
      "position": "QB",
      "position_group": "QB",
      "team": "KC",
      "jersey_number": "15",
      "status": "ACT",
      "active": true,
      "rookie_season": 2017,
      "last_season": 2026,
      "college": "Texas Tech",
      "pfr_id": "MahoPa00",
      "espn_id": "3139477"
    }
  ],
  "count": 1,
  "included_inactive": false
}