StatsHawk MCP Server for ChatGPT
By StatsHawk
Overview
StatsHawk gives ChatGPT real, current sports data instead of guesses from training data. Ask about any game and get scores, schedules, standings, box scores, rosters, and player lookups across NBA, WNBA, MLB, NFL, NHL, KBO, NCAA basketball and football, and major soccer competitions including the Premier League, all normalized into one consistent shape, with numbers landing within minutes of box scores posting. Beyond the basics: MLB pitch-by-pitch with Statcast detail (pitch type, velocity, launch data, filterable to a batter-pitcher matchup) and pre-computed player prop analysis, season, recent, and home/away averages with hit rates against any line, built for fantasy research, start/sit calls, and matchup prep. Sign in with a free StatsHawk account when you connect; no API key to manage. Free includes 5,000 usage credits monthly and every standard stat tool. Prop analysis comes with paid plans.
How to connect
- ChatGPT: Open the StatsHawk listing in the ChatGPT app directory and choose Connect. ChatGPT listing StatsHawk exposes 15 tools here.
Tools
get_box_score
ChatGPTgame_id is a contest id (cst_...) — chain it from get_mlb_matchups (contest) or search_games (game_id). Each player line carries phases: an array of { phase, measures }, where phase names the stat category (e.g. baseball_batting, baseball_pitching, basketball_player_game) and measures is a flat map of canonical, phase-qualified stat keys to values, passed through unchanged from the server — no client-side renaming or filtering. A two-way player (e.g. a pitcher who also bats) appears once with multiple phase entries. player_name is resolved server-side for every line (including large NFL boxscores); if it is ever null, resolve the person_id via search_player.get_injury_history
ChatGPTvantage and the vantages are NEVER merged: reported_status is the timeline of published injury reports (status and estimated return as listed) and transaction_record is the timeline of official roster transactions (injured-list placements and activations). They describe the same player from two independent vantage points, so render them as separate timelines or pick one, never splice them together. Each vantage reports its own coverage window (covered_from, covered_through); time OUTSIDE that window is UNKNOWN, not healthy, so do not read a gap before a vantage began tracking as the player being fine then. Each interval's edges are qualified. start_kind is one of reported (a dated transaction), listed (first seen on the report), unknown (left-censored: already injured when tracking began, so start is a bound, not the onset), or tolerant_open (a change or transfer arrived with no previously open interval, so the start boundary is inferred and weaker). close_kind:"activated" is an official return, close_kind:"unlisted" only means the player left the report (weaker than recovered), and an end of null (close_kind:"open") is an ongoing stint. Events sit in a SIBLING events array, not nested under intervals, in delivered order (there is no event id to key on): each carries kind, status, observed_at (ingestion time), effective_date (when a transaction actually took effect, which differs from observed_at), changed_fields (which facts moved, e.g. an estimated-return slip), plus return_date, resolution_date, detail, injury_type, and il_tier. unattached_events is a vantage-wide count of events not attached to ANY person (not events that failed to form an interval); it qualifies how confidently an empty history for this player can be read. status is report vocabulary (e.g. Out, Questionable, Day-To-Day, 60-Day-IL, 10-Day-IL, Active), rendered verbatim, not an enum; Active is meaningful (on the report but playing), not an error. Coverage: MLB carries both vantages, with transaction records back to 2024-01-01; NFL, NBA, NHL, and WNBA carry reported_status transitions only, accruing since 2026-08-28, with no deep history; no other league has injury data. A known-healthy player returns 200 with empty interval and event lists (still with coverage blocks); a 404 means the person id is unknown, never that the player is healthy.get_mlb_matchups
ChatGPTcontest id (chains into get_box_score / get_play_by_play / get_odds_spot), home/away teams, probable starting pitchers (including throwing hand R/L), and confirmed batting lineups (player, position, batting order, bat side L/R). Use this for matchup-based projections — pitcher throws + batter bat_side gives you platoon advantage; batting order tells you projected plate appearances. lineups_available is false when lineups have not yet been posted (typically pre-3-hours-before-first-pitch).get_odds_history
ChatGPTget_odds_markets
ChatGPTh2h, spreads, totals, team_total, player_prop, plus measure/period when present). Pregame only — nothing after first pitch. Chain into get_odds_spot for the latest board, then get_odds_history only if the user asks how a line moved. Reference data only: StatsHawk is not a betting service.get_odds_spot
ChatGPTget_play_by_play
ChatGPTgame_id is a contest id, cst_..., from search_games or get_mlb_matchups). SPORT-SHAPED response: MLB serves plate appearances + Statcast pitches (default detail: full); NFL serves drives with nested plays (default detail: standard). Baseball filters: pitcher_id / batter_id (person ids; intersect for H2H) — for pitcher analysis prefer pitcher_id=X&detail=standard (~70% smaller, the right shape for K props). Football filters: quarter (5+ = OT), down (1-4), red_zone, scoring_only, team_id (offense). Filters are sport-checked: a baseball filter on a football contest (or vice versa) returns 400 rather than silently ignoring it.get_player_props
ChatGPTperson_id field (see get_team_roster). Stat keys are canonical short forms (e.g. hr, reb, sog) and are now phase-qualified where ambiguous — e.g. pitching.so for pitcher strikeouts — see the stat parameter description for the per-sport list. Unknown stat keys return a 400 whose structured error data includes valid_stats, aliases, and a capabilities endpoint; call get_stat_capabilities for the same discovery surface directly. The context field, when non-null, carries sport-tagged analysis context — baseball batting props: platoon splits by opposing starter hand; basketball/hockey props: back-to-back vs rested splits. Note: the old sport-specific context block (k_pct, whiff_rate, exit velo, etc.) and the availability/team_context blocks are no longer included in this response.get_standings
ChatGPTseason_year (never an empty upcoming season). Entries carry W/L/T, win_pct, points_for/against, and games_played. points is the ranking dimension where the sport has one: NHL points = 2W + OTL (with `otl` = overtime/shootout losses — worth a point, NOT counted in `losses`) and soccer `points` = 3W + 1*T (tables ranked by points, then goal difference, then goals scored; for soccer read ties as draws and points_for/against as goals). Both are null for pct-ranked leagues. Note: conference/division grouping and streak/games-back are not available in the current API — a missing team_id/team_name on an entry means the standings row has no linked team record.get_stat_capabilities
ChatGPTpitching.so vs batting.so); a bare id works when unambiguous. Feed any returned id straight into get_player_props stat. Omitting season with person_id uses the current edition.get_team_roster
ChatGPTsource: appearance means the player recently played for this team (data-confirmed via a game appearance), while membership means they are named to the squad but have no recent game appearance on record (benched, not yet debuted, or out). Season stats and game logs are not inlined here; use the returned person_id with get_player_props for averages and hit rates. A rostered player who currently has an injury report carries an injury object (status verbatim, plus injury_type, return_date, and vantage: reported_status for a published injury report, transaction_record for an official injured-list transaction). The injury key is ABSENT when there is no current report; absence is NOT a health guarantee, since injury coverage is only MLB, NFL, NBA, NHL, and WNBA (a player on any other league never carries injury). For full injury history and coverage windows, call get_injury_history with the person_id. Baseball players carry handedness: bats (L/R/S for switch) and throws (L/R). Three states: values = known; null = a baseball player whose hand is UNKNOWN, do not infer it from the name, position, or stat line; keys ABSENT = not a baseball player (rosters in other sports carry no handedness keys at all).search_docs
ChatGPTsearch_games
ChatGPTdate is applied server-side; team (name substring match) and status are applied client-side after resolving team names. Returned game_id (a cst_... contest id) chains into get_box_score / get_play_by_play / get_odds_markets / get_odds_spot / get_odds_history. When building a slate or counting games, EXCLUDE status: 'postponed' rows: a postponed game is a real provider record (MLB keeps the original game and issues a NEW id for the makeup), so the same matchup can legitimately appear twice — once postponed, once scheduled. The scheduled/final row is the one that will carry stats. stage filters by season stage server-side (preseason/regular/postseason/exhibition/allstar) and each returned game carries its stage; omit it to get all stages.search_player
ChatGPTname arg is a case-insensitive partial match. Returned person_id chains into get_player_props. This search returns bio only, no injury status; for a player's current injury and full injured-list history, pass the person_id to get_injury_history (rostered players also carry a current injury object in get_team_roster). Each match also includes bio fields dob, birth_country, height_inches, weight_lbs. Baseball players additionally carry handedness: bats (L/R/S for switch) and throws (L/R). Three states: values = known; null = a baseball player whose hand is UNKNOWN — do not guess it from name, position, or stats; keys ABSENT = not a baseball player, the field does not apply (e.g. soccer or NBA players have no bats/throws keys at all). Team affiliation is still not part of the person record: use get_team_roster.Capabilities
Example Prompts
Click any prompt to copy it.
Links
Similar Apps
Listed on MCP App Store
Add this badge to your site or README. It links to this page.
HTML
<a href="https://mcp-app-store.keenethics-labs.com/app/statshawk"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>
Markdown
[](https://mcp-app-store.keenethics-labs.com/app/statshawk)





