sportsdata-mcp

Active promotions with metadata (title, end date, linked master events). Returns: {MetaData:[{PromotionId, Title, PromotionEndDate, MasterEventId:[...]}]} Auth: none needed.

Full racecard for one race: runners, prices, allowed bet types, results once run. Returns: {EventId, EventName, AllowedWinBetTypes:[{MarketTypeCode, DividendTypeCode}], ...runners + prices} Auth: none needed.

Price fluctuation history per runner for one race (fixed-odds movements). Returns: {Items:[{OutcomeId, Flucs:[{Offset, Price}]}]} Auth: none needed.

Detailed form guide for one race (runner history, comments, ratings). Returns: {RaceFormV2:{RaceNo, RaceName, NumberOfRunners, Distance, Course, RaceComment, Runners:[...]}} Auth: none needed.

Events + markets for one sport category (competition). Returns: {EventTypeDesc, EventTypeId, MasterCategories:[{Categories:[{CategoryId, CategoryName, Events:[...]}]}]} Auth: none needed.

Statwars master events (head-to-head stats promo events). Returns: {Items:[{EventTypeId, EventTypeDesc, MasterEventId, MasterEventName, MinAdvertisedStart}]} Auth: none needed.

Today's races grouped by code (Thoroughbred / Greyhound / Harness), for the homepage. Returns: {Throughbred:[{VenueId, Venue, Race1:{EventId, RaceNumber, AdvertisedStartTime, SecondsToJump}}], Greyhound:[...], Harness:[...]} Auth: none needed.

Advanced box score for one game: success rate, explosiveness, PPA and field position. Returns: {gameId, teams:{ppa:[…], cumulativePpa:[…], successRates:[…], explosiveness:[…], rushing:[…], havoc:[…], scoringOpportunities:[…], fieldPosition:[…]}} — SHAPE FROM VENDOR DOCS. PPA is CFBD's expected-points-added metric. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One game's advanced box {"id": 401520165} Auth: needs your own key in CFBD_API_KEY.

Historical betting lines per game from multiple books — spread, over/under and moneyline. The college-football backtesting dataset. Returns: [{id, season, week, homeTeam, homeScore, awayTeam, awayScore, lines:[{provider:'consensus'|'Bovada'|…, spread, formattedSpread, spreadOpen, overUnder, overUnderOpen, homeMoneyline, awayMoneyline}]}] — SHAPE FROM VENDOR DOCS. `lines` is per BOOK; `*Open` vs the closing value is what a CLV comparison uses. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 week 1 lines {"year": 2024, "week": 1} Auth: needs your own key in CFBD_API_KEY.

Games for a season with scores, venue and attendance. `year` is required. Returns: [{id, season, week, season_type, start_date, neutral_site, conference_game, venue, home_team, home_points, home_line_scores:[…], away_team, away_points, excitement_index, home_post_win_prob}] — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 week 1 {"year": 2024, "week": 1} Auth: needs your own key in CFBD_API_KEY.

Transfer-portal moves for a season — origin, destination and rating. Returns: [{season, firstName, lastName, position, origin, destination, transferDate, rating, stars, eligibility}] — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 portal {"year": 2024} Auth: needs your own key in CFBD_API_KEY.

Weekly poll rankings (AP, Coaches, Playoff Committee). Returns: [{season, seasonType, week, polls:[{poll:'AP Top 25', ranks:[{rank, school, conference, firstPlaceVotes, points}]}]}] — SHAPE FROM VENDOR DOCS. Note polls are NESTED inside each week entry. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 week 10 polls {"year": 2024, "week": 10} Auth: needs your own key in CFBD_API_KEY.

Elo ratings by team and week. Returns: [{year, team, conference, elo}] — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 Elo {"year": 2024} Auth: needs your own key in CFBD_API_KEY.

SP+ ratings — the headline predictive rating for college football, split by offence and defence. Returns: [{year, team, conference, rating, ranking, offense:{ranking, rating, success, explosiveness}, defense:{…}, specialTeams:{rating}}] — SHAPE FROM VENDOR DOCS. Defensive ratings are better when LOWER. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 SP+ {"year": 2024} Auth: needs your own key in CFBD_API_KEY.

Recruiting classes: individual commits with stars, ratings and positions. Returns: [{id, athleteId, recruitType, year, ranking, name, school, committedTo, position, height, weight, stars, rating, city, stateProvince, hometownInfo}] — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 recruits {"year": 2024} Auth: needs your own key in CFBD_API_KEY.

Season totals per team across every tracked stat category. Returns: [{season, team, conference, statName, statValue}] — SHAPE FROM VENDOR DOCS. NOTE this is LONG format: one row PER STAT per team, not one row per team. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: 2024 team stats {"year": 2024} Auth: needs your own key in CFBD_API_KEY.

FBS/FCS programmes with conference, venue and colours. Returns: [{id, school, mascot, abbreviation, conference, division, color, alt_color, logos:[url], location:{venue_id, name, city, state, capacity, grass, dome}}] — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: SEC programmes {"conference": "SEC"} Auth: needs your own key in CFBD_API_KEY.

The list of monthly game archives available for a player — call this before asking for a month's games. Returns: {archives:[url]} — URLs ending /games/YYYY/MM; take the year and month from the last entry to fetch the most recent games Example: Which months a player has games for {"username": "hikaru"} Auth: none needed.

A Chess.com club: description, membership count, admins and average rating. Returns: {'@id', name, club_id, country, average_daily_rating, members_count, created, last_activity, admin:[url], description, url} Example: The developer community club {"club_id": "chess-com-developer-community"} Auth: none needed.

Chess.com's leaderboards for every category — live blitz/bullet/rapid, daily, variants and tactics. LARGE (~290 KB). Returns: {live_blitz:[{player_id, username, score, rank, title, country}], live_bullet:[…], live_rapid:[…], daily:[…], daily960:[…], tactics:[…], battle:[…]} — one array per category Example: All leaderboards Auth: none needed.

Every game a player finished in one month, with PGN, result, ratings and opening ECO. Returns: {games:[{url, pgn, time_control, time_class, rules, end_time, rated, eco, white:{username, rating, result}, black:{…}}]} — `end_time` is UNIX SECONDS; a prolific player's month can be several MB Example: One player-month {"username": "hikaru", "year": "2025", "month": "01"} Auth: none needed.

A Chess.com player's profile: name, title, country, league, followers and status. Returns: {player_id, '@id', url, username, name, title, followers, country, location, joined, last_online, status, league, avatar} — `joined`/`last_online` are UNIX SECONDS; `country` is a URL, not a code Example: One player's profile {"username": "hikaru"} Auth: none needed.

A player's ratings and records per game type — blitz, bullet, rapid, daily, plus tactics and puzzle rush. Returns: {chess_blitz:{last:{rating, date, rd}, best:{rating, date, game}, record:{win, loss, draw}}, chess_bullet:{…}, chess_rapid:{…}, chess_daily:{…}, tactics:{highest, lowest}, puzzle_rush:{best}, fide} — a key is ABSENT if the player has never played that format Example: Ratings across formats {"username": "hikaru"} Auth: none needed.

Every player holding a given FIDE title — usernames only. Returns: {players:[username]} — a flat list of USERNAME STRINGS, not objects; feed one to chesscom_player for detail Example: All grandmasters {"title": "GM"} Auth: none needed.

Competition catalogue — series / tournaments with id, name, dates and artwork. Returns: {competitions:[{id, name, url, imageUrl, startDateTime, endDateTime, order}], responseError} Auth: none needed.

Pulselive CMS content list by type — VIDEO (highlights/replays), TEXT (articles), AUDIO, or PLAYLIST (curated collections). Paginated. Returns: {pageInfo:{page, pageSize, numPages, numEntries}, content:[{id, type, title, description, date, ...}]} Auth: none needed.

Match list (the /matches feed) — fixtures with teams, venue, competition, status, toss and result. Filter by competition, completed/live, etc. Returns: {fixtures:[{id, name, startDateTime, gameType, isLive, isCompleted, resultText, competitionId, venueId, homeTeamId, awayTeamId, tossResult, tossDecision}], responseError} Auth: none needed.

Player profiles for a batch of player ids — name, DOB, birthplace, batting/bowling hand + type, height, image. Pass a list of playerIds. Returns: {players:[{id, displayName, firstName, lastName, dob, birthPlace, battingHand, bowlingHand, bowlingType, height, imageUrl}], responseError} Auth: none needed.

A single Pulselive playlist by id — a curated collection of videos (e.g. a match's highlights playlist). Returns: {id, type, title, description, date, content:[{id, type, title, ...}]} Auth: none needed.

Run-progression (worm/manhattan) data per innings for a fixture — the series behind cricket.com.au's run graphs. Returns: {innings:[{inningNumber, battingTeamId, bowlingTeamId, overs, overnightRuns, overnightWickets, byesRuns, legByesRuns, noBalls}]} Auth: none needed.

Full match scorecard — per-innings batting, bowling and fall-of-wickets, plus the players[] lookup for the fixture. Returns: {fixture:{id, name, innings:[{inningNumber, battingTeamId, bowlingTeamId, batsmen:[...], bowlers:[...], wickets:[...]}]}, fixtureTitle, players:[{id, displayName}], dataSupport, responseError} Auth: none needed.

Competition ladder — per-team played/won/lost/drawn/tied/no-result, points, net run rate. Needs competitionId (empty for competitions without a points table). Returns: {standings:[{competitionId, teamId, groupName, played, won, lost, drawn, matchTied, noResult, points, netRunRate, deductions}], responseError} Auth: none needed.

Live video stream entries for a fixture (populated during live matches; empty array otherwise). Returns: {streams:[{...stream urls/metadata}], responseError} (streams empty when the match isn't live) Auth: none needed.

Team catalogue — id, name, short name, colours, logo/badge URLs across all CA competitions. Returns: {teams:[{id, name, shortName, teamColor, logoUrl, teambadgeImageUrl, isActive}], responseError} Auth: none needed.

Tours / series with status flags — each tour groups its competitions and is flagged upcoming / in-progress / completed. The feed behind the site's series navigation. Returns: {tours:[{competitionId, name, startDateTime, endDateTime, isUpComing, isInProgress, isCompleted, competitions:[...], bannerUrl, logoUrl}]} Auth: none needed.

Venue detail for one venueId — name, city, country, state, coordinates. Resolve a fixture's venueId (one venue per call). Returns: {venue:{id, name, city, state, countryName, latitude, longitude}, responseError} Auth: none needed.

Matches in progress or starting soon, with live scores. Returns: {status:'success', data:[{id, name, matchType:'t20'|'odi'|'test', status, venue, date, dateTimeGMT, teams:[str], teamInfo:[{name, shortname, img}], score:[{r, w, o, inning}], series_id, matchStarted, matchEnded}], info:{hitsToday, hitsLimit}} — SHAPE FROM VENDOR DOCS. Score fields are terse: r runs, w wickets, o overs. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Live and upcoming matches Auth: needs your own key in CRICKETDATA_API_KEY.

One match: toss, venue, teams and result. Returns: {status, data:{id, name, matchType, status, venue, date, dateTimeGMT, teams, teamInfo, score:[{r, w, o, inning}], tossWinner, tossChoice, matchWinner, matchStarted, matchEnded}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One match {"id": "<match id>"} Auth: needs your own key in CRICKETDATA_API_KEY.

All matches, paginated — recent and upcoming across every series. Returns: {status, data:[{id, name, matchType, status, venue, date, teams, teamInfo, series_id, matchStarted, matchEnded}], info:{hitsToday, hitsLimit}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Recent matches Auth: needs your own key in CRICKETDATA_API_KEY.

One player's profile and career batting/bowling statistics. Returns: {status, data:{id, name, dateOfBirth, role, battingStyle, bowlingStyle, placeOfBirth, country, playerImg, stats:[{fn:'batting'|'bowling', matchtype:'test'|'odi'|'t20i', stat:'m'|'runs'|'avg', value}]}} — SHAPE FROM VENDOR DOCS. NOTE `stats` is LONG format: one row per (function, format, statistic), not a nested object. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One player's career {"id": "<player id>"} Auth: needs your own key in CRICKETDATA_API_KEY.

Search the player catalogue by name. Returns: {status, data:[{id, name, country}], info:{hitsToday, hitsLimit}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: Search players {"search": "Kohli"} Auth: needs your own key in CRICKETDATA_API_KEY.

Full scorecard: batting and bowling figures per innings. Returns: {status, data:{id, name, scorecard:[{inning, batting:[{batsman:{id, name}, r, b, '4s', '6s', sr, 'dismissal-text'}], bowling:[{bowler:{id, name}, o, m, r, w, eco}], extras, totals}]}} — SHAPE FROM VENDOR DOCS. Cricket abbreviations: r runs, b balls, sr strike rate, o overs, m maidens, w wickets, eco economy. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One match's scorecard {"id": "<match id>"} Auth: needs your own key in CRICKETDATA_API_KEY.

Series (tours and tournaments) with their match counts and dates. Returns: {status, data:[{id, name, startDate, endDate, odi, t20, test, squads, matches}], info:{hitsToday, hitsLimit}} — SHAPE FROM VENDOR DOCS. The format counts (odi/t20/test) are how many matches of each type the series holds. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: All series Auth: needs your own key in CRICKETDATA_API_KEY.

One series with its full match list. Returns: {status, data:{info:{id, name, startdate, enddate, odi, t20, test, squads, matches}, matchList:[{id, name, matchType, status, venue, date, teams}]}} — SHAPE FROM VENDOR DOCS. NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name. Example: One series {"id": "<series id>"} Auth: needs your own key in CRICKETDATA_API_KEY.

Every currently-bettable competition across all sports (~318) — the discovery entry point. Pick any one's `id` and pass it to dabble_competition_fixtures. Each carries name, sportName, country and a featured flag. Pass `sportId` to filter to one sport's active competitions. Returns: {status, data:{activeCompetitions:[{id, name, sportName, country, featured, location, sportId}]}} Auth: none needed.

All fixtures for ONE competition, each embedding its markets + prices (decimal odds) + selections + teams. Get the competitionId from dabble_active_competitions / dabble_competitions (AFL Matches = ad4c78ec-e39d-45ee-8cec-ff5d485a3205, NRL = c709772d-d5d0-4252-af89-be8a163706dc). For the FULL book of one fixture use dabble_fixture_details. Returns: {data:[{id, name, displayName, competitionId, competitionName, advertisedStart, status, inplayAvailable, teams:[{id, name, abbreviation}], markets:[{id, name, resultingType, product, isHandicap, isTotal, isSgmAllowed, status}], selections:[{id, name, marketId, isScratched}], prices:[{marketId, selectionId, price}]}]} (`product` is engine-derived from resultingType — see dabble_fixture_details.) Example: AFL fixtures with markets + odds {"competitionId": "ad4c78ec-e39d-45ee-8cec-ff5d485a3205"} Auth: none needed.

Look up competitions by EXACT name (`name`, case-sensitive; e.g. 'NRL', 'Premier League', 'AFL Matches' — note 'AFL' alone returns nothing) OR list EVERY competition for a sport (`sportId`, including ones not currently active — ~20 for AFL). Pass at least one filter: bare /competitions is the ~38 MB / 142k-row firehose (deliberately avoid). For browsing currently-bettable comps, prefer dabble_active_competitions. Returns: {status, data:[{id, name, sportId, country}]} (filtered by name or sportId — empty if the exact name isn't found) Auth: none needed.

The FULL book for one fixture — every market (hundreds), all selections + prices, the marketGroups (SGM grouping) and the Pick'em playerProps product. LARGE (~1 MB+ for a major match); fetch one fixture at a time. fixtureId comes from dabble_competition_fixtures. Each market gets an engine-derived `product`: SGM legs by Dabble's capability flags (isSgmAllowed && !isSingleAllowed) so it's robust to the SGM vendor (SportCast today) changing; Pick'em by the `pickem` token (e.g. odds_on_pickem_goals) and racing by the `Racing*` resultingType — both first-party naming. RACING resultingTypes: RacingFixed*/RacingSP*=win/place, RacingDD*=exotics, `RacingSrm*`=Same-Race-Multi (no Pick'em in racing). Returns: {sportFixtureDetail:{id, name, competitionName, sportName, status, teams, markets:[{id, name, resultingType, product, isSgmAllowed, isSingleAllowed}], selections:[{id, name, marketId}], prices:[{marketId, selectionId, price}], marketGroups, marketGroupMappings, playerProps:[{playerName, stats, value, lineType}]}} (LARGE — markets/selections/prices number in the hundreds-to-thousands. Each market carries an engine-derived `product` ∈ {single, sgm, pickem, srm, racing}: RacingSrm*→srm, Racing*→racing, resultingType-contains-pickem→pickem, else isSingleAllowed→single, else isSgmAllowed→sgm, else→single. Use `product` ∈ {single, sgm} for like-for-like price comparison; NEVER blend `pickem` multipliers into fixed-odds value/arb.) Auth: none needed.

The 24 sports Dabble offers (Rugby League, Australian Rules, Football, Basketball, Cricket, Tennis, Horse Racing, …), each with id + name. Join sportId from a competition back to its sport here. Returns: {status, data:[{id, name, isRacing, isHidden}]} Auth: none needed.

Detailed approach-play skill per player across yardage/lie buckets — SG per shot, proximity, GIR, good-shot and poor-shot-avoidance rates. Returns: {last_updated, time_period, data:[{dg_id, player_name, ...per-bucket sg/proximity/gir fields}]} Auth: needs your own key in DATAGOLF_KEY.