### Install endzoneapi Python client Source: https://endzoneapi.com/docs Install the official client from PyPI. No required dependencies. Set ENDZONEAPI_API_KEY to your key. ```bash pip install endzoneapi ``` -------------------------------- ### Authentication Header Examples Source: https://endzoneapi.com/docs Shows three ways to pass the API key: via x-api-key header, Authorization Bearer header, or query parameter (MCP only). Requires a verified email and an API key from the dashboard; free accounts get 500 credits monthly. ```bash x-api-key: YOUR_API_KEY # or Authorization: Bearer YOUR_API_KEY # or (MCP only) ?key=YOUR_API_KEY ``` -------------------------------- ### Python client usage with pandas Source: https://endzoneapi.com/docs Call endpoints as methods. Example uses pandas; install with 'pip install "endzoneapi[pandas]"'. ```python from endzoneapi import Client, to_dataframe client = Client() print(client.get_player_props(game_id="2025_01_KC_LAC", estimate_only=True)) props = client.get_player_props( game_id="2025_01_KC_LAC", market="player_pass_yds", bookmaker="draftkings", ) df = to_dataframe(props, key="props") print(df[["player_name", "line", "over_odds", "under_odds"]]) ``` -------------------------------- ### JSON response from get_prop_history Source: https://endzoneapi.com/docs/get-prop-history Example JSON response showing the structure of the returned data. Includes player info, a games array with line and actual values, and a summary with over rate. The note indicates this is an illustrative example with made-up data. ```json { "player_id": "00-0000001", "player_name": "Example Player", "market": "player_reception_yds", "stat": "receiving yards", "bookmaker": null, "games": [ { "game_id": "2024_01_KC_BAL", "game_date": "2024-09-05", "line": 62.5, "open_line": 58.5, "over_odds": -110, "under_odds": -110, "books": 7, "actual": 71, "result": "over", "margin": 8.5 } ], "count": 1, "summary": { "games": 1, "graded": 1, "overs": 1, "unders": 0, "pushes": 0, "over_rate": 1, "avg_line": 62.5, "avg_actual": 71 }, "truncated": false, "next_from_date": null, "note": "Illustrative example: made-up player and numbers, to show the shape of a response." } ``` -------------------------------- ### JSON response for get_game_detail Source: https://endzoneapi.com/docs/get-game-detail Example response containing game details, team info, consensus closing odds, and team stats for both teams. ```json { "game": { "game_id": "2025_01_KC_LAC", "season": 2025, "game_type": "REG", "week": 1, "gameday": "2025-09-05", "weekday": "Friday", "kickoff": "2025-09-06T00:00:00.000Z", "away_team": "KC", "home_team": "LAC", "away_score": 21, "home_score": 27, "result": 6, "total": 48, "overtime": 0, "status": "FINAL", "location": "Neutral", "stadium": "SoFi Stadium", "roof": "dome", "surface": null, "temp": null, "wind": null, "div_game": true, "away_rest": 7, "home_rest": 7, "spread_line": -3, "total_line": 47.5, "away_moneyline": -175, "home_moneyline": 145, "away_qb_name": "Patrick Mahomes", "home_qb_name": "Justin Herbert", "away_qb_id": "00-0033873", "home_qb_id": "00-0036355", "away_coach": "Andy Reid", "home_coach": "Jim Harbaugh", "referee": "Carl Cheffers", "espn_id": "401772714", "pfr_id": "202509050sdg" }, "home_team": { "abbrev": "LAC", "name": "Los Angeles Chargers", "nick": "Chargers", "conference": "AFC", "division": "AFC West", "teamId": "4400", "color": "#007BC7", "color2": "#ffc20e", "color3": "#ffb612", "color4": "#001532", "logoEspn": "https://a.espncdn.com/i/teamlogos/nfl/500/lac.png", "logoWikipedia": "https://upload.wikimedia.org/wikipedia/en/thumb/7/72/NFL_Chargers_logo.svg/100px-NFL_Chargers_logo.svg.png", "logoSquared": "https://github.com/nflverse/nflverse-pbp/raw/master/squared_logos/LAC.png", "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/LAC.png", "active": true, "relocatedTo": null }, "away_team": { "abbrev": "KC", "name": "Kansas City Chiefs", "nick": "Chiefs", "conference": "AFC", "division": "AFC West", "teamId": "2310", "color": "#E31837", "color2": "#FFB612", "color3": "#000000", "color4": "#e31837", "logoEspn": "https://a.espncdn.com/i/teamlogos/nfl/500/kc.png", "logoWikipedia": "https://upload.wikimedia.org/wikipedia/en/thumb/e/e1/Kansas_City_Chiefs_logo.svg/100px-Kansas_City_Chiefs_logo.svg.png", "logoSquared": "https://github.com/nflverse/nflverse-pbp/raw/master/squared_logos/KC.png", "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/KC.png", "active": true, "relocatedTo": null }, "consensus_closing": { "spread_line": -3, "total_line": 47.5, "home_moneyline": 145, "away_moneyline": -175 }, "team_stats": { "home": { "id": 18, "season": 2025, "week": 1, "team": "LAC", "seasonType": "REG", "gameId": "2025_01_KC_LAC", "opponentTeam": "KC", "completions": 25, "attempts": 34, "passingYards": 318, "passingTds": 3, "passingInterceptions": 0, "sacksSuffered": 3, "sackYardsLost": -14, "sackFumbles": 0, "sackFumblesLost": 0, "passingAirYards": 342, "passingYardsAfterCatch": 134, "passingFirstDowns": 16, "passingEpa": 17.567263, "passingCpoe": 5.788768, "passing2ptConversions": 0, "passing10": 12, "passing16": 7, "passing20": 4, "passing40": 0, "carries": 25, "rushingYards": 90, "rushingTds": 0, "rushingFumbles": 0, "rushingFumblesLost": 0, "rushingFirstDowns": 6, "rushingEpa": -0.23139648, "rushing2ptConversions": 0, "rushing10": 2, "rushing12": 1, "rushing20": 0, "rushing40": 0, "receptions": 25, "targets": 34, "receivingYards": 318, "receivingTds": 3, "receivingFumbles": 1, "receivingFumblesLost": 0, "receivingAirYards": 342, "receivingYardsAfterCatch": 134, "receivingFirstDowns": 16, "receivingEpa": 21.656591, "receiving2ptConversions": 0, "receiving10": 12, "receiving16": 7, "receiving20": 4, "receiving40": 0 } } } ``` -------------------------------- ### cURL request to get_player_props Source: https://endzoneapi.com/docs/get-player-props Example cURL command to POST to the get_player_props endpoint with a game_id and market. Requires an API key in the x-api-key header. Each call costs 10 credits. ```bash curl -X POST https://mcp.endzoneapi.com/v1/get_player_props \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "game_id": "2025_01_KC_LAC", "market": "player_pass_yds" }' ``` -------------------------------- ### Response for get_standings Source: https://endzoneapi.com/docs Example JSON response (first 14 lines) for the get_standings call. Full response available at the provided link. ```json { "season": 2025, "standings": [ { "team": "DEN", "name": "Denver Broncos", "conference": "AFC", "division": "AFC West", "division_rank": 1, "conference_rank": 1, "division_tiebreaker": "record", "conference_tiebreaker": "common games", "wins": 14, "losses": 3, ... ``` -------------------------------- ### JSON Response from get_plays Endpoint Source: https://endzoneapi.com/docs/get-plays Example response containing an array of play objects with detailed play-by-play data, a summary with aggregate stats, a count, and a next_offset for pagination. ```json { "plays": [ { "game_id": "2025_01_KC_LAC", "play_id": 40, "season": 2025, "week": 1, "posteam": "KC", "defteam": "LAC", "qtr": 1, "time": "15:00", "down": null, "ydstogo": 0, "yardline_100": 35, "yrdln": "LAC 35", "play_type": "kickoff", "desc": "11-C.Dicker kicks 59 yards from LAC 35 to KC 6. 80-T.Thornton pushed ob at KC 48 for 42 yards (24-B.St-Juste). PENALTY on KC-2-J.Williams, Offensive Holding, 10 yards, enforced at KC 34.", "yards_gained": 0, "epa": -0.24012075, "wpa": 0, "wp": 0.43320796, "vegas_wp": 0.61365855, "success": 0, "first_down": 0, "touchdown": 0, "interception": 0, "fumble_lost": 0, "sack": 0, "penalty": 1, "penalty_type": "Offensive Holding", "shotgun": 0, "no_huddle": 0, "pass_length": null, "pass_location": null, "air_yards": null, "yards_after_catch": null, "run_location": null, "run_gap": null, "cpoe": null, "xpass": null, "passer_player_id": null, "passer_player_name": null, "rusher_player_id": null, "rusher_player_name": null, "receiver_player_id": null, "receiver_player_name": null, "posteam_score": 0, "defteam_score": 0, "score_differential": 0, "drive": 1, "drive_result": "Punt", "series_result": "Punt" }, { "game_id": "2025_01_KC_LAC", "play_id": 79, "season": 2025, "week": 1, "posteam": "KC", "defteam": "LAC", "qtr": 1, "time": "14:52", "down": 1, "ydstogo": 10, "yardline_100": 76, "yrdln": "KC 24", "play_type": "run", "desc": "(14:52) (Shotgun) 10-I.Pacheco right guard to KC 28 for 4 yards (32-A.Gilman; 0-D.Henley).", "yards_gained": 4, "epa": -0.008932982, "wpa": -0.010726303, "wp": 0.43320796, "vegas_wp": 0.6127665, "success": 0, "first_down": 0, "touchdown": 0, "interception": 0, "fumble_lost": 0, "sack": 0, "penalty": 0, "penalty_type": null, "shotgun": 1, "no_huddle": 0, "pass_length": null, "pass_location": null, "air_yards": null, "yards_after_catch": null, "run_location": "right", "run_gap": "guard", "cpoe": null, "xpass": 0.48951253, "passer_player_id": null, "passer_player_name": null, "rusher_player_id": "00-0037197", "rusher_player_name": "I.Pacheco", "receiver_player_id": null, "receiver_player_name": null, "posteam_score": 0, "defteam_score": 0, "score_differential": 0, "drive": 1, "drive_result": "Punt", "series_result": "Punt" }, { "game_id": "2025_01_KC_LAC", "play_id": 101, "season": 2025, "week": 1, "posteam": "KC", "defteam": "LAC", "qtr": 1, "time": "14:21", "down": 2, "ydstogo": 6, "yardline_100": 72, "yrdln": "KC 28", "play_type": "run", "desc": "(14:21) (Shotgun) 1-X.Worthy right end to KC 28 for no gain (52-K.Mack).", "yards_gained": 0, "epa": -0.806627, "wpa": -0.0171507, "wp": 0.42248166, "vegas_wp": 0.6049587, "success": 0, "first_down": 0, "touchdown": 0, "interception": 0, "fumble_lost": 0, "sack": 0, "penalty": 0, "penalty_type": null, "shotgun": 1, "no_huddle": 0, "pass_length": null, "pass_location": null, "air_yards": null, "yards_after_catch": null, "run_location": "right", "run_gap": "end", "cpoe": null, "xpass": 0.6220576, "passer_player_id": null, "passer_player_name": null, "rusher_player_id": "00-0039894", "rusher_player_name": "X.Worthy", "receiver_player_id": null, "receiver_player_name": null, "posteam_score": 0, "defteam_score": 0, "score_differential": 0, "drive": 1, "drive_result": "Punt", "series_result": "Punt" } ], "summary": { "plays": 5, "epa_total": -2.6, "epa_per_play": -0.519, "success_rate": 0.2 }, "count": 5, "next_offset": 5 } ``` -------------------------------- ### get_game_detail Source: https://endzoneapi.com/docs Returns full game detail with team stats, starting QBs, odds, weather, and officials. Costs 10 credits per call. ```APIDOC ## get_game_detail ### Description Returns full game detail with team stats, starting QBs, odds, weather, and officials. ### Credit Cost 10 credits per call ### Documentation Link https://endzoneapi.com/docs/get-game-detail ``` -------------------------------- ### cURL request to get_alt_lines Source: https://endzoneapi.com/docs/get-alt-lines Example cURL command to call the get_alt_lines endpoint. It requires a valid API key and a game_id. The example uses market 'alternate_spreads' and bookmaker 'draftkings'. Each call costs 10 credits, taken before it runs and refunded if the server errors. ```bash curl -X POST https://mcp.endzoneapi.com/v1/get_alt_lines \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "game_id": "2025_01_KC_LAC", "market": "alternate_spreads", "bookmaker": "draftkings" }' ``` -------------------------------- ### JSON response for get_schedule Source: https://endzoneapi.com/docs/get-schedule Example response from the get_schedule endpoint showing a list of upcoming games with details such as teams, kickoff times, lines, and quarterback information. The response includes a count of total games. ```json { "season": 2026, "week": null, "days": 7, "upcoming_games": [ { "game_id": "2026_06_ARI_LA", "season": 2026, "game_type": "REG", "week": 6, "gameday": "2026-10-18", "weekday": "Sunday", "kickoff": "2026-10-18T20:05:00.000Z", "away_team": "ARI", "home_team": "LA", "away_score": null, "home_score": null, "result": null, "total": null, "overtime": null, "status": "FUT", "location": "Home", "stadium": "SoFi Stadium", "roof": "dome", "surface": "matrixturf", "temp": null, "wind": null, "div_game": true, "away_rest": 7, "home_rest": 6, "spread_line": 12.5, "total_line": 51.5, "away_moneyline": 550, "home_moneyline": -800, "away_qb_name": "Jacoby Brissett", "home_qb_name": "Matthew Stafford", "away_qb_id": "00-0033119", "home_qb_id": "00-0026498", "away_coach": "Jonathan Gannon", "home_coach": "Sean McVay", "referee": null, "espn_id": "401873004", "pfr_id": "202610180ram" }, { "game_id": "2026_06_LAC_KC", "season": 2026, "game_type": "REG", "week": 6, "gameday": "2026-10-18", "weekday": "Sunday", "kickoff": "2026-10-18T20:25:00.000Z", "away_team": "LAC", "home_team": "KC", "away_score": null, "home_score": null, "result": null, "total": null, "overtime": null, "status": "FUT", "location": "Home", "stadium": "GEHA Field at Arrowhead Stadium", "roof": "outdoors", "surface": "grass", "temp": null, "wind": null, "div_game": true, "away_rest": 7, "home_rest": 14, "spread_line": 7.5, "total_line": 41.5, "away_moneyline": 330, "home_moneyline": -425, "away_qb_name": "Justin Herbert", "home_qb_name": "Patrick Mahomes", "away_qb_id": "00-0036355", "home_qb_id": "00-0033873", "away_coach": "Jim Harbaugh", "home_coach": "Andy Reid", "referee": null, "espn_id": "401873006", "pfr_id": "202610180kan" }, { "game_id": "2026_06_BUF_LV", "season": 2026, "game_type": "REG", "week": 6, "gameday": "2026-10-18", "weekday": "Sunday", "kickoff": "2026-10-18T20:25:00.000Z", "away_team": "BUF", "home_team": "LV", "away_score": null, "home_score": null, "result": null, "total": null, "overtime": null, "status": "FUT", "location": "Home", "stadium": "Allegiant Stadium", "roof": "dome", "surface": "grass", "temp": null, "wind": null, "div_game": false, "away_rest": 6, "home_rest": 7, "spread_line": -5.5, "total_line": 53.5, "away_moneyline": -258, "home_moneyline": 210, "away_qb_name": "Josh Allen", "home_qb_name": "Kirk Cousins", "away_qb_id": "00-0034857", "home_qb_id": "00-0029604", "away_coach": "Sean McDermott", "home_coach": "Klint Kubliak", "referee": null, "espn_id": "401873005", "pfr_id": "202610180rai" } ], "count": 17 } ``` -------------------------------- ### JSON response for get_snap_counts Source: https://endzoneapi.com/docs/get-snap-counts Example response showing snap counts for players in the specified game. Includes filters, snap counts array, count, and a note about PFR player IDs. ```json { "filters": { "game_id": "2025_01_KC_LAC", "player_id": null, "team": null, "season": null, "week": null }, "snap_counts": [ { "game_id": "2025_01_KC_LAC", "season": 2025, "week": 1, "team": "KC", "opponent": "LAC", "player": "Trey Smith", "pfr_player_id": "SmitTr05", "position": "G", "offense_snaps": 61, "offense_pct": 1, "defense_snaps": 0, "defense_pct": 0, "st_snaps": 4, "st_pct": 0.16 }, { "game_id": "2025_01_KC_LAC", "season": 2025, "week": 1, "team": "KC", "opponent": "LAC", "player": "Creed Humphrey", "pfr_player_id": "HumpCr00", "position": "C", "offense_snaps": 61, "offense_pct": 1, "defense_snaps": 0, "defense_pct": 0, "st_snaps": 4, "st_pct": 0.16 }, { "game_id": "2025_01_KC_LAC", "season": 2025, "week": 1, "team": "KC", "opponent": "LAC", "player": "Patrick Mahomes", "pfr_player_id": "MahoPa00", "position": "QB", "offense_snaps": 61, "offense_pct": 1, "defense_snaps": 0, "defense_pct": 0, "st_snaps": 0, "st_pct": 0 } ], "count": 5, "note": "Snap counts are keyed by PFR player id (see pfr_id on search_players)." } ``` -------------------------------- ### cURL request to get_prop_history Source: https://endzoneapi.com/docs/get-prop-history Example cURL command to call the get_prop_history endpoint. Replace YOUR_API_KEY with your actual key. The request uses POST with a JSON body containing player_id and market. ```bash curl -X POST https://mcp.endzoneapi.com/v1/get_prop_history \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "player_id": "00-0000001", "market": "player_reception_yds" }' ``` -------------------------------- ### JSON response from get_injuries Source: https://endzoneapi.com/docs/get-injuries Example response showing injury report data for team KC, week 9, season 2025. Includes player details, practice status, and game type. ```json { "season": 2025, "week": 9, "injuries": [ { "team": "KC", "player_id": "00-0037197", "name": "Isiah Pacheco", "position": "RB", "report_status": "Out", "report_primary_injury": "Knee", "report_secondary_injury": null, "practice_status": "Did Not Participate In Practice", "practice_primary_injury": "Knee", "game_type": "REG" }, { "team": "KC", "player_id": "00-0040116", "name": "Josh Simmons", "position": "T", "report_status": "Out", "report_primary_injury": "Not injury related - personal matter", "report_secondary_injury": null, "practice_status": "Did Not Participate In Practice", "practice_primary_injury": "Not injury related - personal matter", "game_type": "REG" }, { "team": "KC", "player_id": "00-0036557", "name": "Jaylon Moore", "position": "T", "report_status": "Questionable", "report_primary_injury": "Illness", "report_secondary_injury": null, "practice_status": "Did Not Participate In Practice", "practice_primary_injury": "Illness", "game_type": "REG" } ], "count": 10 } ``` -------------------------------- ### Get Plays Response Fields Source: https://endzoneapi.com/docs/get-plays Describes the structure of the response object returned by the Get Plays endpoint, including all fields in the plays array. ```APIDOC ## Get Plays Response Fields ### Description This endpoint returns a list of plays with detailed play-by-play data. The response contains an array of play objects, each with fields for game context, play outcome, and advanced metrics. ### Response #### Success Response (200) - **plays[]** (array) - List of play objects. - **plays[].game_id** (string) - The unique identifier for the game. - **plays[].play_id** (number) - The unique identifier for the play. - **plays[].season** (number) - The season year. - **plays[].week** (number) - The week number of the season. - **plays[].posteam** (string) - The team with possession. - **plays[].defteam** (string) - The defensive team. - **plays[].qtr** (number) - The quarter of the game. - **plays[].time** (string) - The time remaining in the quarter. - **plays[].down** (null) - The down (always null in this response). - **plays[].ydstogo** (number) - Yards to go for a first down. - **plays[].yardline_100** (number) - Yard line from the opponent's goal (0-100). - **plays[].yrdln** (string) - The yard line description. - **plays[].play_type** (string) - The type of play (e.g., pass, run). - **plays[].desc** (string) - The play description. - **plays[].yards_gained** (number) - Net yards gained on the play. - **plays[].epa** (number) - Expected points added. - **plays[].wpa** (number) - Win probability added. - **plays[].wp** (number) - Win probability before the play. - **plays[].vegas_wp** (number) - Vegas win probability. - **plays[].success** (number) - Whether the play was successful (1 or 0). - **plays[].first_down** (number) - Whether a first down was achieved (1 or 0). - **plays[].touchdown** (number) - Whether a touchdown was scored (1 or 0). - **plays[].interception** (number) - Whether an interception occurred (1 or 0). - **plays[].fumble_lost** (number) - Whether a fumble was lost (1 or 0). - **plays[].sack** (number) - Whether a sack occurred (1 or 0). - **plays[].penalty** (number) - Whether a penalty occurred (1 or 0). - **plays[].penalty_type** (string) - The type of penalty. - **plays[].shotgun** (number) - Whether the play was from shotgun formation (1 or 0). - **plays[].no_huddle** (number) - Whether the play was no-huddle (1 or 0). - **plays[].pass_length** (null) - The length of the pass (always null). - **plays[].pass_location** (null) - The location of the pass (always null). - **plays[].air_yards** (null) - Air yards on the pass (always null). - **plays[].yards_after_catch** (null) - Yards after catch (always null). - **plays[].run_location** (null) - The run location (always null). - **plays[].run_gap** (null) - The run gap (always null). - **plays[].cpoe** (null) - Completion percentage over expected (always null). - **plays[].xpass** (null) - Expected pass probability (always null). - **plays[].passer_player_id** (null) - The passer's player ID (always null). - **plays[].passer_player_name** (null) - The passer's name (always null). #### Response Example ```json { "plays": [ { "game_id": "2023090700", "play_id": 1, "season": 2023, "week": 1, "posteam": "KC", "defteam": "DET", "qtr": 1, "time": "15:00", "down": null, "ydstogo": 10, "yardline_100": 25, "yrdln": "KC 25", "play_type": "run", "desc": "(15:00) P.Mahomes pass short left to I.Pacheco to KC 30 for 5 yards.", "yards_gained": 5, "epa": 0.5, "wpa": 0.01, "wp": 0.5, "vegas_wp": 0.5, "success": 1, "first_down": 0, "touchdown": 0, "interception": 0, "fumble_lost": 0, "sack": 0, "penalty": 0, "penalty_type": null, "shotgun": 0, "no_huddle": 0, "pass_length": null, "pass_location": null, "air_yards": null, "yards_after_catch": null, "run_location": null, "run_gap": null, "cpoe": null, "xpass": null, "passer_player_id": null, "passer_player_name": null } ] } ``` ``` -------------------------------- ### Get Head-to-Head Response Fields Source: https://endzoneapi.com/docs/get-head-to-head Describes the structure of the response returned by the Get Head-to-Head endpoint, including team names, head-to-head record, total games, average margin, and an array of game objects with detailed game information. ```APIDOC ## Get Head-to-Head Response Fields ### Description This endpoint returns head-to-head game records and detailed game information between two teams. ### Response Fields - **team1** (string) - The first team identifier. - **team2** (string) - The second team identifier. - **record** (object) - Head-to-head record. - **record.KC** (number) - Wins for team1 (KC). - **record.BUF** (number) - Wins for team2 (BUF). - **record.ties** (number) - Number of ties. - **total_games** (number) - Total number of games played between the two teams. - **avg_margin_team1** (number) - Average margin of victory for team1. - **games[]** (array) - List of game objects. - **games[].game_id** (string) - Unique identifier for the game. - **games[].season** (number) - Season year. - **games[].game_type** (string) - Type of game (e.g., regular, playoff). - **games[].week** (number) - Week number. - **games[].gameday** (string) - Date of the game. - **games[].weekday** (string) - Day of the week. - **games[].kickoff** (string) - Kickoff time. - **games[].away_team** (string) - Away team identifier. - **games[].home_team** (string) - Home team identifier. - **games[].away_score** (number) - Away team score. - **games[].home_score** (number) - Home team score. - **games[].result** (number) - Result indicator (e.g., 1 for win, 0 for loss). - **games[].total** (number) - Total points scored in the game. - **games[].overtime** (number) - Overtime indicator (1 if overtime, 0 otherwise). - **games[].status** (string) - Game status (e.g., final, scheduled). - **games[].location** (string) - Location of the game. - **games[].stadium** (string) - Stadium name. - **games[].roof** (string) - Roof type (e.g., dome, open). - **games[].surface** (string) - Playing surface. - **games[].temp** (number) - Temperature at game time. - **games[].wind** (number) - Wind speed. - **games[].div_game** (boolean) - Whether the game is a division game. - **games[].away_rest** (number) - Days of rest for away team. - **games[].home_rest** (number) - Days of rest for home team. - **games[].spread_line** (number) - Spread line. - **games[].total_line** (number) - Total line. - **games[].away_moneyline** (number) - Moneyline for away team. - **games[].home_moneyline** (number) - Moneyline for home team. - **games[].away_qb_name** (string) - Away team starting quarterback name. - **games[].home_qb_name** (string) - Home team starting quarterback name. - **games[].away_qb_id** (string) - Away team starting quarterback ID. ### Related Endpoints - [get_game_detail](https://endzoneapi.com/docs/get-game-detail) - Takes the `game_id` this one returns. Full game detail with team stats, starting QBs, odds, weather, and officials. - [get_alt_lines](https://endzoneapi.com/docs/get-alt-lines) - Takes the `game_id` this one returns. Alternate spreads and totals by sportsbook: every point on the ladder, opening and closing, from the 2023 season to the current one. - [get_standings](https://endzoneapi.com/docs/get-standings) - Filters by the same `season`. Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank. - [search_players](https://endzoneapi.com/docs/search-players) - Filters by the same `limit`. Find players by name, team, or position. ``` -------------------------------- ### JSON response from get_player_props Source: https://endzoneapi.com/docs/get-player-props Example JSON response showing player prop lines for a game, including snapshot_type, games, props array, and count. The response includes player names, gsis_id, market, bookmaker, line, over/under odds, captured_at, and source. ```json { "snapshot_type": "closing", "games": 1, "props": [ { "game_id": "2025_01_KC_LAC", "player_name": "Justin Herbert", "gsis_id": "00-0036355", "market": "player_pass_yds", "bookmaker": "betmgm", "line": 236.5, "over_odds": -115, "under_odds": -118, "captured_at": "2025-09-05 21:53:39+00", "source": "the_odds_api" }, { "game_id": "2025_01_KC_LAC", "player_name": "Patrick Mahomes", "gsis_id": "00-0033873", "market": "player_pass_yds", "bookmaker": "betmgm", "line": 245.5, "over_odds": -135, "under_odds": 100, "captured_at": "2025-09-05 21:53:39+00", "source": "the_odds_api" }, { "game_id": "2025_01_KC_LAC", "player_name": "Justin Herbert", "gsis_id": "00-0036355", "market": "player_pass_yds", "bookmaker": "betonlineag", "line": 233.5, "over_odds": -118, "under_odds": -110, "captured_at": "2025-09-05 21:53:39+00", "source": "the_odds_api" } ], "count": 14 } ``` -------------------------------- ### Get Player Stats Source: https://endzoneapi.com/docs/get-player-stats Returns detailed player information and season statistics for a given player. ```APIDOC ## Get Player Stats ### Description Returns detailed player information and season statistics for a given player. ### Response Fields - `player` (object) - Player details - `player.gsisId` (string) - GSIS ID - `player.displayName` (string) - Display name - `player.firstName` (string) - First name - `player.lastName` (string) - Last name - `player.footballName` (string) - Football name - `player.suffix` (null) - Suffix - `player.position` (string) - Position - `player.positionGroup` (string) - Position group - `player.ngsPosition` (string) - NGS position - `player.height` (number) - Height - `player.weight` (number) - Weight - `player.birthDate` (string) - Birth date - `player.college` (string) - College - `player.collegeConference` (string) - College conference - `player.jerseyNumber` (string) - Jersey number - `player.rookieSeason` (number) - Rookie season - `player.lastSeason` (number) - Last season - `player.latestTeam` (string) - Latest team - `player.status` (string) - Status - `player.yearsOfExperience` (number) - Years of experience - `player.draftYear` (number) - Draft year - `player.draftRound` (number) - Draft round - `player.draftPick` (number) - Draft pick - `player.draftTeam` (string) - Draft team - `player.esbId` (string) - ESB ID - `player.nflId` (string) - NFL ID - `player.pfrId` (string) - PFR ID - `player.pffId` (string) - PFF ID - `player.otcId` (string) - OTC ID - `player.espnId` (string) - ESPN ID - `player.smartId` (string) - Smart ID - `player.sleeperId` (null) - Sleeper ID - `player.active` (boolean) - Active flag - `player.team_name` (string) - Team name - `season` (number) - Season year - `season_type` (string) - Season type (e.g., regular, postseason) - `season_totals` (object) - Season totals - `season_totals.games` (number) - Games played - `season_totals.completions` (number) - Completions ### Related Endpoints - [search_players](https://endzoneapi.com/docs/search-players) - Find players by name, team, or position - [get_injuries](https://endzoneapi.com/docs/get-injuries) - Injury report by team and week - [get_standings](https://endzoneapi.com/docs/get-standings) - Standings and playoff seeding - [get_team_stats](https://endzoneapi.com/docs/get-team-stats) - Team totals and per-week lines ``` -------------------------------- ### First call: get_standings with cURL Source: https://endzoneapi.com/docs POST request to the get_standings endpoint. Replace YOUR_API_KEY with your key. Costs 2 credits. ```bash curl -X POST https://mcp.endzoneapi.com/v1/get_standings \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "season": 2025, "division": "AFC West" }' ``` -------------------------------- ### cURL request to search_players Source: https://endzoneapi.com/docs/search-players Sends a POST request to search for a player by name. Requires an API key in the x-api-key header. The example searches for 'Mahomes'. ```bash 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" }' ```