Serveur MCP

EndzoneAPI

io.github.noahowsh/endzoneapi
Données et analytique Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Provides professional football schedules, play-by-play, player and team statistics, injuries, depth charts, standings, and betting odds.

get_advanced_stats
Use for tracking and charting metrics the box score does not carry. Next Gen Stats (2016+): time to throw, air yards, completion percentage above expectation, separation, cushion, rush yards over expected. Pro Football Reference advanced (2018+): pressures, hurries, blitzes, drops, bad throws, missed tackles, coverage yards allowed. Pick a source, then filter by season, week, player or team. Costs 5 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source'], 'properties': {'team': {'type': 'string', 'description': 'Team code'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 0, 'description': 'Week. NGS also publishes week 0 as the season aggregate.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows (default 50)'}, 'season': {'type': ['string', 'number'], 'description': 'Season year. Defaults to current. NGS from 2016, PFR from 2018.'}, 'source': {'enum': ['ngs_passing', 'ngs_rushing', 'ngs_receiving', 'pfr_passing', 'pfr_rushing', 'pfr_receiving', 'pfr_defense'], 'type': 'string', 'description': 'Which dataset: ngs_passing, ngs_rushing, ngs_receiving, pfr_passing, pfr_rushing, pfr_receiving, pfr_defense'}, 'player_id': {'type': 'string', 'description': 'GSIS id for an ngs_* source, PFR id for a pfr_* source; both are on search_players'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'season', 'player_id_kind', 'metric_keys', 'stats', 'count'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'stats': {'type': 'array', 'items': {'type': 'object', 'required': ['metrics'], 'properties': {'name': {'type': ['string', 'null']}, 'team': {'type': ['string', 'null']}, 'week': {'type': ['number', 'null']}, 'season': {'type': ['number', 'null']}, 'metrics': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'player_id': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'season': {'type': 'number'}, 'source': {'type': 'string'}, 'metric_keys': {'type': 'array', 'items': {'type': 'string'}}, 'player_id_kind': {'type': 'string'}}, 'additionalProperties': False}
get_depth_chart
Use for a team's depth chart by week: formation, position, depth rank, player. Defaults to the latest week available. Costs 2 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['team'], 'properties': {'team': {'type': 'string', 'description': 'Team code'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 1, 'description': 'Week. Defaults to latest.'}, 'season': {'type': ['string', 'number'], 'description': 'Season year. Defaults to current.'}, 'formation': {'type': 'string', 'description': 'Filter by formation/unit, e.g. Offense, Defense, Special Teams'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['team', 'season', 'week', 'depth_chart', 'count'], 'properties': {'team': {'type': 'string'}, 'week': {'type': 'number'}, 'count': {'type': 'number'}, 'season': {'type': 'number'}, 'depth_chart': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'position': {'type': ['string', 'null']}, 'formation': {'type': ['string', 'null']}, 'player_id': {'type': ['string', 'null']}, 'depth_rank': {'type': ['number', 'null']}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
get_game_detail
Use when you need everything about one game: both teams, full team box-score stats (EPA, success, drives), consensus closing line, per-bookmaker opening/closing/latest odds, weather, surface, and officials. Requires a game id from get_games or get_schedule. Costs 10 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id'], 'properties': {'game_id': {'type': 'string', 'description': 'Game id, e.g. 2025_01_KC_BUF'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game', 'home_team', 'away_team', 'consensus_closing', 'team_stats', 'odds', 'officials'], 'properties': {'game': {'type': 'object', 'required': ['game_id', 'season', 'week', 'game_type', 'home_team', 'away_team', 'home_score', 'away_score', 'status', 'kickoff'], 'properties': {'roof': {'type': ['string', 'null']}, 'week': {'type': 'number'}, 'season': {'type': 'number'}, 'status': {'type': 'string'}, 'game_id': {'type': 'string'}, 'gameday': {'type': ['string', 'null']}, 'kickoff': {'type': ['string', 'null']}, 'stadium': {'type': ['string', 'null']}, 'surface': {'type': ['string', 'null']}, 'away_team': {'type': 'string'}, 'game_type': {'type': 'string'}, 'home_team': {'type': 'string'}, 'away_score': {'type': ['number', 'null']}, 'home_score': {'type': ['number', 'null']}, 'total_line': {'type': ['number', 'null']}, 'spread_line': {'type': ['number', 'null']}, 'away_qb_name': {'type': ['string', 'null']}, 'home_qb_name': {'type': ['string', 'null']}, 'away_moneyline': {'type': ['number', 'null']}, 'home_moneyline': {'type': ['number', 'null']}}, 'additionalProperties': {}}, 'odds': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'away_team': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'home_team': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'officials': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'team_stats': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'consensus_closing': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
get_games
Use when querying past or future games with filters: season, week, team, date range, game type, status. Returns scores, kickoff (UTC), venue, rest days, starting QBs, coaches, referee, and the consensus closing spread, total, and moneylines. For upcoming-only games prefer get_schedule (2 cr). Costs 5 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'team': {'type': 'string', 'description': 'Team code (home or away)'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 1, 'description': 'Week number (1-18 regular season; 19+ postseason)'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Max results (default 100)'}, 'season': {'type': ['string', 'number'], 'description': 'Season year (e.g. 2025)'}, 'status': {'enum': ['FUT', 'LIVE', 'FINAL'], 'type': 'string', 'description': 'Game status'}, 'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD'}, 'game_type': {'enum': ['REG', 'WC', 'DIV', 'CON', 'SB', 'POST'], 'type': 'string', 'description': 'REG, WC, DIV, CON, SB, or POST for any playoff game'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['games', 'count', 'filters'], 'properties': {'count': {'type': 'number'}, 'games': {'type': 'array', 'items': {'type': 'object', 'required': ['game_id', 'season', 'week', 'game_type', 'home_team', 'away_team', 'home_score', 'away_score', 'status', 'kickoff'], 'properties': {'roof': {'type': ['string', 'null']}, 'week': {'type': 'number'}, 'season': {'type': 'number'}, 'status': {'type': 'string'}, 'game_id': {'type': 'string'}, 'gameday': {'type': ['string', 'null']}, 'kickoff': {'type': ['string', 'null']}, 'stadium': {'type': ['string', 'null']}, 'surface': {'type': ['string', 'null']}, 'away_team': {'type': 'string'}, 'game_type': {'type': 'string'}, 'home_team': {'type': 'string'}, 'away_score': {'type': ['number', 'null']}, 'home_score': {'type': ['number', 'null']}, 'total_line': {'type': ['number', 'null']}, 'spread_line': {'type': ['number', 'null']}, 'away_qb_name': {'type': ['string', 'null']}, 'home_qb_name': {'type': ['string', 'null']}, 'away_moneyline': {'type': ['number', 'null']}, 'home_moneyline': {'type': ['number', 'null']}}, 'additionalProperties': {}}}, 'filters': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
get_head_to_head
Use to compare two teams' history: recent meetings with scores, the win/loss record between them, and average margin. Filter by season or get all-time. Costs 10 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['team1', 'team2'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max games (default 20)'}, 'team1': {'type': 'string', 'description': 'First team code'}, 'team2': {'type': 'string', 'description': 'Second team code'}, 'season': {'type': ['string', 'number'], 'description': 'Season year. Omit for all-time.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['team1', 'team2', 'record', 'total_games', 'avg_margin_team1', 'games', 'count'], 'properties': {'count': {'type': 'number'}, 'games': {'type': 'array', 'items': {'type': 'object', 'required': ['game_id', 'season', 'week', 'game_type', 'home_team', 'away_team', 'home_score', 'away_score', 'status', 'kickoff'], 'properties': {'roof': {'type': ['string', 'null']}, 'week': {'type': 'number'}, 'season': {'type': 'number'}, 'status': {'type': 'string'}, 'game_id': {'type': 'string'}, 'gameday': {'type': ['string', 'null']}, 'kickoff': {'type': ['string', 'null']}, 'stadium': {'type': ['string', 'null']}, 'surface': {'type': ['string', 'null']}, 'away_team': {'type': 'string'}, 'game_type': {'type': 'string'}, 'home_team': {'type': 'string'}, 'away_score': {'type': ['number', 'null']}, 'home_score': {'type': ['number', 'null']}, 'total_line': {'type': ['number', 'null']}, 'spread_line': {'type': ['number', 'null']}, 'away_qb_name': {'type': ['string', 'null']}, 'home_qb_name': {'type': ['string', 'null']}, 'away_moneyline': {'type': ['number', 'null']}, 'home_moneyline': {'type': ['number', 'null']}}, 'additionalProperties': {}}}, 'team1': {'type': 'string'}, 'team2': {'type': 'string'}, 'record': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}, 'total_games': {'type': 'number'}, 'avg_margin_team1': {'type': ['number', 'null']}}, 'additionalProperties': False}
get_injuries
Use for the official injury report: game status (Out, Doubtful, Questionable) and practice participation with the injury named, by team and week. Defaults to the latest reported week of the current season. Costs 2 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'team': {'type': 'string', 'description': 'Team code'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 1, 'description': 'Week. Defaults to the latest week with a report.'}, 'season': {'type': ['string', 'number'], 'description': 'Season year. Defaults to current.'}, 'status': {'type': 'string', 'description': 'Filter by game status: Out, Doubtful, Questionable'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['season', 'week', 'injuries', 'count'], 'properties': {'week': {'type': 'number'}, 'count': {'type': 'number'}, 'season': {'type': 'number'}, 'injuries': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'team': {'type': ['string', 'null']}, 'position': {'type': ['string', 'null']}, 'player_id': {'type': ['string', 'null']}, 'report_status': {'type': ['string', 'null']}, 'practice_status': {'type': ['string', 'null']}, 'report_primary_injury': {'type': ['string', 'null']}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
get_line_movement
Use to see how a game's lines moved: the full time series of hourly snapshots grouped by bookmaker. Most expensive tool (25 cr); use get_odds (10 cr) if you only need opening, closing, or current lines.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id'], 'properties': {'game_id': {'type': 'string', 'description': 'Game id'}, 'bookmaker': {'type': 'string', 'description': 'Bookmaker key filter'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['game_id', 'home_team', 'away_team', 'kickoff', 'movement', 'snapshots'], 'properties': {'game_id': {'type': 'string'}, 'kickoff': {'type': ['string', 'null']}, 'movement': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'object', 'required': ['bookmaker', 'snapshot_type'], 'properties': {'total': {'type': ['number', 'null']}, 'ml_away': {'type': ['number', 'null']}, 'ml_home': {'type': ['number', 'null']}, 'bookmaker': {'type': 'string'}, 'captured_at': {'type': ['string', 'null']}, 'spread_away': {'type': ['number', 'null']}, 'spread_home': {'type': ['number', 'null']}, 'snapshot_type': {'type': 'string'}}, 'additionalProperties': {}}}}, 'away_team': {'type': 'string'}, 'home_team': {'type': 'string'}, 'snapshots': {'type': 'number'}}, 'additionalProperties': False}
get_odds
Use for betting lines. Pass game_id for one game (10 credits): the consensus closing spread/total/moneyline (every game since 1999) plus per-bookmaker opening, closing and latest lines (DraftKings, FanDuel, BetMGM, ESPN BET) from September 2026. Or pass season (optionally team) for a season of per-book closing lines in one call, with final scores and the consensus close, at 10 credits per game returned, 100 games a page by default (up to 500); each book's line is an array in the order given by columns. For consensus closing lines only, get_games returns a whole season for 5 credits. Set estimate_only to get the price without being charged.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'team': {'type': 'string', 'description': "With season: only this team's games (e.g. KC)."}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'With season: games per page (default 100, max 500).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'With season: page offset; use next_offset from the previous page.'}, 'season': {'type': ['string', 'number'], 'description': 'Season year for a whole season of per-book lines, e.g. 2026. Used when game_id is not set.'}, 'game_id': {'type': 'string', 'description': 'Game id, e.g. 2026_01_KC_BUF. Omit and pass season for a whole season.'}, 'bookmaker': {'type': 'string', 'description': 'Bookmaker key (draftkings, fanduel, betmgm, espnbet)'}, 'estimate_only': {'type': 'boolean', 'description': 'Return what this call would cost, without charging or running it.'}, 'snapshot_type': {'enum': ['opening', 'closing', 'latest'], 'type': 'string', 'description': 'Single game: one snapshot type (default all). Season: opening or closing (default closing).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'tool': {'type': 'string'}, 'books': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'count': {'type': 'number'}, 'games': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'season': {'type': 'string'}, 'columns': {'type': 'array', 'items': {'type': 'string'}}, 'credits': {'type': 'number'}, 'game_id': {'type': 'string'}, 'kickoff': {'type': ['string', 'null']}, 'away_team': {'type': 'string'}, 'home_team': {'type': 'string'}, 'next_offset': {'type': ['number', 'null']}, 'total_games': {'type': 'number'}, 'estimate_only': {'type': 'boolean'}, 'snapshot_type': {'type': 'string'}, 'bookmaker_count': {'type': 'number'}, 'credits_per_game': {'type': 'number'}, 'consensus_closing': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
get_player_leaders
Use to rank players on any weekly stat over a season: passing_yards, passing_tds, rushing_yards, receiving_yards, receptions, targets, def_sacks, def_interceptions, fantasy_points_ppr, passing_epa, rushing_epa, receiving_epa, and ~130 more. Counting stats are summed, rate stats averaged. Filter by position, team, minimum games. Costs 5 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stat'], 'properties': {'stat': {'type': 'string', 'description': 'Weekly stat column to rank by (e.g. passing_yards, receiving_epa, def_sacks)'}, 'team': {'type': 'string', 'description': 'Team code filter'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max results (default 20)'}, 'season': {'type': ['string', 'number'], 'description': 'Season year. Defaults to current.'}, 'position': {'type': 'string', 'description': 'Position filter, e.g. QB, RB, WR, TE'}, 'min_games': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Minimum games with a stat line (default 1)'}, 'season_type': {'enum': ['REG', 'POST'], 'type': 'string', 'description': 'Regular season (default) or postseason'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stat', 'aggregation', 'season', 'season_type', 'leaders', 'count'], 'properties': {'stat': {'type': 'string'}, 'count': {'type': 'number'}, 'season': {'type': 'number'}, 'leaders': {'type': 'array', 'items': {'type': 'object', 'required': ['rank'], 'properties': {'name': {'type': ['string', 'null']}, 'rank': {'type': 'number'}, 'team': {'type': ['string', 'null']}, 'games': {'type': ['number', 'null']}, 'value': {'type': ['number', 'null']}, 'position': {'type': ['string', 'null']}, 'player_id': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'aggregation': {'type': 'string'}, 'season_type': {'type': 'string'}}, 'additionalProperties': False}
get_player_stats
Use for one player: bio, draft, physicals, headshot, id crosswalk (PFR, ESPN), summed season totals across passing, rushing, receiving, defense, kicking, returns, and fantasy points, every weekly stat line for the season, and games played per season. Defaults to the player's latest season. Costs 5 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['player_id'], 'properties': {'season': {'type': ['string', 'number'], 'description': "Season year. Defaults to the player's latest season."}, 'player_id': {'type': 'string', 'description': 'GSIS player id from search_players (e.g. 00-0033873)'}, 'season_type': {'enum': ['REG', 'POST'], 'type': 'string', 'description': 'Regular season (default) or postseason'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['player', 'season', 'season_type', 'season_totals', 'weeks', 'seasons', 'count'], 'properties': {'count': {'type': 'number'}, 'weeks': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'player': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'season': {'type': 'number'}, 'seasons': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'season_type': {'type': 'string'}, 'season_totals': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
get_plays
Use for play-by-play with nflfastR metrics: EPA, WPA, win probability, success, CPOE, air yards, formation flags, and the players involved. Filter by game, or by season plus week/team/player, plus play type, down, quarter, win-probability band, red zone, third down. Set include_charting for FTN manual charting from 2022 on -- alignment, pre-snap motion, play action, screens, run-pass options, blitzer counts, drops -- or filter directly on those flags. Returns a per-query EPA and success-rate summary. Paginate with offset. Costs 10 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'down': {'type': 'integer', 'maximum': 4, 'minimum': 1, 'description': 'Down'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 1, 'description': 'Week'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max plays (default 200)'}, 'is_rpo': {'type': 'boolean', 'description': 'Charting filter: run-pass option (2022+)'}, 'max_wp': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Maximum pre-play win probability'}, 'min_wp': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Minimum pre-play win probability for the offense'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset'}, 'season': {'type': ['string', 'number'], 'description': 'Season year (required when game_id is not set)'}, 'defteam': {'type': 'string', 'description': 'Defense team code'}, 'game_id': {'type': 'string', 'description': 'Game id, e.g. 2025_01_KC_BUF'}, 'is_drop': {'type': 'boolean', 'description': 'Charting filter: charted drop (2022+)'}, 'posteam': {'type': 'string', 'description': 'Offense team code'}, 'quarter': {'type': 'integer', 'maximum': 6, 'minimum': 1, 'description': 'Quarter (5+ = overtime)'}, 'red_zone': {'type': 'boolean', 'description': 'Only plays inside the 20'}, 'is_motion': {'type': 'boolean', 'description': 'Charting filter: pre-snap motion (2022+)'}, 'passer_id': {'type': 'string', 'description': 'GSIS id of the passer'}, 'play_type': {'enum': ['pass', 'run', 'punt', 'kickoff', 'field_goal', 'extra_point', 'qb_kneel', 'qb_spike', 'no_play'], 'type': 'string', 'description': 'Play type'}, 'rusher_id': {'type': 'string', 'description': 'GSIS id of the rusher'}, 'third_down': {'type': 'boolean', 'description': 'Only third downs'}, 'receiver_id': {'type': 'string', 'description': 'GSIS id of the receiver'}, 'is_no_huddle': {'type': 'boolean', 'description': 'Charting filter: no huddle (2022+)'}, 'min_blitzers': {'type': 'integer', 'maximum': 11, 'minimum': 0, 'description': 'Charting filter: at least this many blitzers (2022+). FTN counts rushers beyond the base rush, so this is typically 0-3; 5+ is almost never charted.'}, 'is_trick_play': {'type': 'boolean', 'description': 'Charting filter: trick play (2022+)'}, 'is_play_action': {'type': 'boolean', 'description': 'Charting filter: play action (2022+)'}, 'is_screen_pass': {'type': 'boolean', 'description': 'Charting filter: screen pass (2022+)'}, 'include_charting': {'type': 'boolean', 'description': 'Attach FTN manual charting to each play (2022+): alignment, motion, play action, screens, RPO, blitzers, drops'}, 'is_qb_out_of_pocket': {'type': 'boolean', 'description': 'Charting filter: quarterback out of the pocket (2022+)'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['plays', 'summary', 'count', 'next_offset'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'plays': {'type': 'array', 'items': {'type': 'object', 'required': ['game_id', 'play_id'], 'properties': {'wp': {'type': ['number', 'null']}, 'epa': {'type': ['number', 'null']}, 'qtr': {'type': ['number', 'null']}, 'wpa': {'type': ['number', 'null']}, 'desc': {'type': ['string', 'null']}, 'down': {'type': ['number', 'null']}, 'week': {'type': ['number', 'null']}, 'season': {'type': ['number', 'null']}, 'defteam': {'type': ['string', 'null']}, 'game_id': {'type': 'string'}, 'play_id': {'type': 'number'}, 'posteam': {'type': ['string', 'null']}, 'success': {'type': ['number', 'null']}, 'ydstogo': {'type': ['number', 'null']}, 'charting': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'play_type': {'type': ['string', 'null']}, 'touchdown': {'type': ['number', 'null']}, 'yardline_100': {'type': ['number', 'null']}, 'yards_gained': {'type': ['number', 'null']}, 'passer_player_name': {'type': ['string', 'null']}, 'rusher_player_name': {'type': ['string', 'null']}, 'receiver_player_name': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'summary': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'next_offset': {'type': ['number', 'null']}, 'charted_plays': {'type': 'number'}}, 'additionalProperties': False}
get_schedule
Use to see what is coming up: unplayed games in the next N days (default 7), or a specific week of the current season. Includes consensus lines where posted. Costs 2 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Days ahead to look when week is not set (default 7)'}, 'team': {'type': 'string', 'description': 'Team code to filter'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 1, 'description': 'A specific week of the current season (returns all games that week, played or not)'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['season', 'week', 'days', 'upcoming_games', 'count'], 'properties': {'days': {'type': ['number', 'null']}, 'week': {'type': ['number', 'null']}, 'count': {'type': 'number'}, 'season': {'type': 'number'}, 'upcoming_games': {'type': 'array', 'items': {'type': 'object', 'required': ['game_id', 'season', 'week', 'game_type', 'home_team', 'away_team', 'home_score', 'away_score', 'status', 'kickoff'], 'properties': {'roof': {'type': ['string', 'null']}, 'week': {'type': 'number'}, 'season': {'type': 'number'}, 'status': {'type': 'string'}, 'game_id': {'type': 'string'}, 'gameday': {'type': ['string', 'null']}, 'kickoff': {'type': ['string', 'null']}, 'stadium': {'type': ['string', 'null']}, 'surface': {'type': ['string', 'null']}, 'away_team': {'type': 'string'}, 'game_type': {'type': 'string'}, 'home_team': {'type': 'string'}, 'away_score': {'type': ['number', 'null']}, 'home_score': {'type': ['number', 'null']}, 'total_line': {'type': ['number', 'null']}, 'spread_line': {'type': ['number', 'null']}, 'away_qb_name': {'type': ['string', 'null']}, 'home_qb_name': {'type': ['string', 'null']}, 'away_moneyline': {'type': ['number', 'null']}, 'home_moneyline': {'type': ['number', 'null']}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
get_snap_counts
Use for playing time: offensive, defensive, and special-teams snaps and snap shares, for one game, one player (PFR id), or a team's season. Costs 5 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'team': {'type': 'string', 'description': 'Team code'}, 'week': {'type': 'integer', 'maximum': 22, 'minimum': 1, 'description': 'Week filter'}, 'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Max rows (default 200)'}, 'season': {'type': ['string', 'number'], 'description': 'Season year (with team or player)'}, 'game_id': {'type': 'string', 'description': 'Game id, e.g. 2025_01_KC_BUF'}, 'player_id': {'type': 'string', 'description': 'PFR player id (from search_players pfr_id)'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['filters', 'snap_counts', 'count'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'filters': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'snap_counts': {'type': 'array', 'items': {'type': 'object', 'properties': {'team': {'type': ['string', 'null']}, 'week': {'type': ['number', 'null']}, 'player': {'type': ['string', 'null']}, 'season': {'type': ['number', 'null']}, 'st_pct': {'type': ['number', 'null']}, 'game_id': {'type': ['string', 'null']}, 'position': {'type': ['string', 'null']}, 'st_snaps': {'type': ['number', 'null']}, 'defense_pct': {'type': ['number', 'null']}, 'offense_pct': {'type': ['number', 'null']}, 'defense_snaps': {'type': ['number', 'null']}, 'offense_snaps': {'type': ['number', 'null']}, 'pfr_player_id': {'type': ['string', 'null']}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
get_standings
Use for regular-season standings and playoff seeding: record, win%, points for/against, home/away/division/conference records, streak, division rank, and conference seed. Ranks apply the real NFL tiebreaking procedure and report which step decided each one. Computed from final scores. Defaults to the current season. Costs 2 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'season': {'type': ['string', 'number'], 'description': 'Season year the regular season starts (e.g. 2025). Defaults to current.'}, 'division': {'type': 'string', 'description': "Filter by division, e.g. 'NFC North'"}, 'conference': {'enum': ['AFC', 'NFC'], 'type': 'string', 'description': 'Filter by conference'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['season', 'standings', 'count'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'season': {'type': 'number'}, 'standings': {'type': 'array', 'items': {'type': 'object', 'required': ['team', 'wins', 'losses', 'ties'], 'properties': {'name': {'type': ['string', 'null']}, 'team': {'type': 'string'}, 'ties': {'type': 'number'}, 'wins': {'type': 'number'}, 'losses': {'type': 'number'}, 'streak': {'type': ['string', 'null']}, 'win_pct': {'type': ['number', 'null']}, 'division': {'type': ['string', 'null']}, 'conference': {'type': ['string', 'null']}, 'point_diff': {'type': ['number', 'null']}, 'points_for': {'type': ['number', 'null']}, 'division_rank': {'type': ['number', 'null']}, 'points_against': {'type': ['number', 'null']}, 'conference_rank': {'type': ['number', 'null']}, 'division_tiebreaker': {'type': ['string', 'null']}, 'conference_tiebreaker': {'type': ['string', 'null']}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
get_team_stats
Use for one team's season: totals (passing, rushing, receiving, defense, kicking, penalties), EPA per play, yards per attempt/carry, the standings row, and every weekly stat line. Costs 5 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['team'], 'properties': {'team': {'type': 'string', 'description': 'Team code (e.g. KC, BUF, PHI)'}, 'season': {'type': ['string', 'number'], 'description': 'Season year (e.g. 2025). Defaults to current.'}, 'season_type': {'enum': ['REG', 'POST'], 'type': 'string', 'description': 'Regular season (default) or postseason'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['team', 'season', 'season_type', 'record', 'totals', 'weeks', 'count'], 'properties': {'team': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'count': {'type': 'number'}, 'weeks': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'record': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'season': {'type': 'number'}, 'totals': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'season_type': {'type': 'string'}}, 'additionalProperties': False}
list_teams
Use when you need team codes, or all 32 current teams with conference, division, colours, and logo URLs. Team codes are nflverse spelling (LA for the Rams, WAS for Washington). Cheapest tool at 1 credit.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'division': {'type': 'string', 'description': "Filter by division, e.g. 'AFC East' or 'NFC West'"}, 'conference': {'enum': ['AFC', 'NFC'], 'type': 'string', 'description': 'Filter by conference'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['teams', 'count'], 'properties': {'count': {'type': 'number'}, 'teams': {'type': 'array', 'items': {'type': 'object', 'required': ['abbrev'], 'properties': {'logo': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}, 'abbrev': {'type': 'string'}, 'division': {'type': ['string', 'null']}, 'conference': {'type': ['string', 'null']}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
search_players
Use to find a player by name (partial match). Searches ~25,000 players back to 1999; returns current-season players by default, falling back to all players back to 1999 when none match. Returns the GSIS player id needed by get_player_stats. Costs 2 credits.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'team': {'type': 'string', 'description': 'Filter by current team code'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results (default 10)'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Player name or part of it'}, 'active': {'type': 'boolean', 'description': '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.'}, 'position': {'type': 'string', 'description': 'Filter by position (e.g. QB, RB, WR, TE, OL, DL, LB, DB)'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['players', 'count', 'included_inactive'], 'properties': {'note': {'type': 'string'}, 'count': {'type': 'number'}, 'players': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'team': {'type': ['string', 'null']}, 'active': {'type': ['boolean', 'null']}, 'pfr_id': {'type': ['string', 'null']}, 'espn_id': {'type': ['string', 'null']}, 'position': {'type': ['string', 'null']}, 'player_id': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'included_inactive': {'type': 'boolean'}}, 'additionalProperties': False}
Ajouté
get_line_movement
28 September 2026 02:40
Ajouté
get_odds
28 September 2026 02:40
Ajouté
get_advanced_stats
28 September 2026 02:40
Ajouté
get_plays
28 September 2026 02:40
Ajouté
get_snap_counts
28 September 2026 02:40
Ajouté
get_depth_chart
28 September 2026 02:40
Ajouté
get_injuries
28 September 2026 02:40
Ajouté
get_player_leaders
28 September 2026 02:40
Ajouté
get_player_stats
28 September 2026 02:40
Ajouté
search_players
28 September 2026 02:40
Ajouté
get_head_to_head
28 September 2026 02:40
Ajouté
get_game_detail
28 September 2026 02:40
Ajouté
get_schedule
28 September 2026 02:40
Ajouté
get_games
28 September 2026 02:40
Ajouté
get_team_stats
28 September 2026 02:40
Ajouté
get_standings
28 September 2026 02:40
Ajouté
list_teams
28 September 2026 02:40