College Football Data integration
College Football Data (CFBD) serves historical and current US college football data: games, scores and box scores, play-by-play and drives, team and player statistics, rosters, recruiting and the transfer portal, poll rankings, team ratings (SP+, SRS, Elo, FPI), betting lines, win probabilities, Predicted Points Added and NFL Draft picks. Most list tools filter by season year, week, team and conference. Authentication is a free CFBD API key sent as a Bearer token in the Authorization header; a few tools (game weather, adjusted game previews) need a CFBD Patreon tier.
Say what should happen.
The workflow builds itself.
What you can do with College Football Data
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Game, 11 operations
list_cfp_gamesList cfp gamesGETReturns College Football Playoff matchups for a season.list_gamesList gamesGETReturns historical game data.list_player_game_success_ratesList player game success ratesGETReturns player passing and rushing success rates by game.list_player_passing_by_gameList player passing by gameGETReturns passer production, CPOE, advanced metrics, and pass-location breakdowns by game.list_player_ppa_by_gameList player ppa by gameGETReturns player Predicted Points Added (PPA) metrics by game.list_player_punting_by_gameList player punting by gameGETReturns individually attributed punting and punt return production by game.list_player_rushing_by_gameList player rushing by gameGETReturns individually attributed rusher production by game. Player totals include only guarded rusher attribution, including individually attributed sacks.list_team_passing_by_gameList team passing by gameGETReturns team passing production, CPOE, advanced metrics, and pass-location breakdowns by game for offense and defense.list_team_ppa_by_gameList team ppa by gameGETReturns team Predicted Points Added (PPA) metrics by game.list_team_punting_by_gameList team punting by gameGETReturns team punting and punt return production by game. Punting describes the team's punts. Returning describes opponent punts and the team's returns.list_team_rushing_by_gameList team rushing by gameGETReturns team rushing production by game. Team totals include sacks, kneels, team-only attempts, and unresolved attribution. Defense contains rushing production allowed.
Season, 11 operations
list_adjusted_team_season_statsList adjusted team season statsGETReturns opponent-adjusted team statistics by season.list_coach_seasonsList coach seasonsGETReturns coach-season records with attributed results and team context.list_player_passing_by_seasonList player passing by seasonGETReturns passer production, CPOE, advanced metrics, and pass-location breakdowns by season.list_player_ppa_by_seasonList player ppa by seasonGETReturns player Predicted Points Added (PPA) metrics by season.list_player_punting_by_seasonList player punting by seasonGETReturns individually attributed punting and punt return production by season.list_player_rushing_by_seasonList player rushing by seasonGETReturns individually attributed rusher production by season. Player totals include only guarded rusher attribution, including individually attributed sacks.list_player_season_statsList player season statsGETReturns player statistics aggregated by season.list_team_passing_by_seasonList team passing by seasonGETReturns team passing production, CPOE, advanced metrics, and pass-location breakdowns by season for offense and defense.list_team_punting_by_seasonList team punting by seasonGETReturns team punting and punt return production by season. Punting describes the team's punts. Returning describes opponent punts and the team's returns.list_team_rushing_by_seasonList team rushing by seasonGETReturns team rushing production by season. Team totals include sacks, kneels, team-only attempts, and unresolved attribution. Defense contains rushing production allowed.list_team_season_statsList team season statsGETReturns team statistics aggregated by season.
Play, 5 operations
get_live_game_playsGet live game playsGETReturns live play-by-play data and advanced metrics for a game. Results may be cached for up to five seconds after calculation.list_passing_playsList passing playsGETReturns enriched pass attempts with PPA, success, completion probability, and CPOE.list_playsList playsGETReturns historical play-by-play data.list_punting_playsList punting playsGETReturns enriched punt plays with gross, return, and net yardage, field position, and punt outcomes.list_rushing_playsList rushing playsGETReturns enriched rushing attempts. Team results include sacks, kneels, team-only attempts, and unresolved attribution.
Team, 5 operations
list_draft_teamsList draft teamsGETReturns the NFL teams represented in draft data.list_game_team_statsList game team statsGETReturns team box score statistics by game.list_team_ppa_by_seasonList team ppa by seasonGETReturns team Predicted Points Added (PPA) metrics by season.list_team_recruiting_rankingsList team recruiting rankingsGETReturns team recruiting rankings.list_teamsList teamsGETReturns team information and conference affiliations.
Advanced, 3 operations
get_advanced_box_scoreGet advanced box scoreGETReturns an advanced box score for a game.list_advanced_team_game_statsList advanced team game statsGETReturns advanced team statistics aggregated by game.list_advanced_team_season_statsList advanced team season statsGETReturns advanced team statistics aggregated by season.
Conference, 2 operations
list_conferencesList conferencesGETReturns conferences and member counts.list_conference_sp_ratingsList conference sp ratingsGETReturns conference-level SP+ ratings by season.
Overview, 2 operations
get_player_season_overviewGet player season overviewGETReturns a player season overview with box score, usage, and Predicted Points Added (PPA) data.get_team_season_overviewGet team season overviewGETReturns a stored full-season team overview, including postseason and garbage time.
Player, 2 operations
list_game_player_statsList game player statsGETReturns player box score statistics by game.list_recruitsList recruitsGETReturns player recruiting rankings.
Type, 2 operations
list_play_stat_typesList play stat typesGETReturns the available play stat types.list_play_typesList play typesGETReturns the available play types.
Usage, 2 operations
get_account_usageGet account usageGETReturns recent usage for the authenticated user's shared CFB and CBB call pool. Returns `null` when the request is not authenticated.list_player_usageList player usageGETReturns player usage metrics for a season.
Adjusted, 1 operation
get_adjusted_game_previewGet adjusted game previewGETReturns stored adjusted team and player metrics until game completion. Requires Patreon Tier 1. Team metrics may use the previous season; players remain current-season.
Affiliation, 1 operation
list_team_conference_affiliationsList team conference affiliationsGETReturns historical team conference affiliations.
At, 1 operation
list_team_ats_recordsList team ats recordsGETReturns against-the-spread (ATS) records by team.
Calendar, 1 operation
list_calendar_weeksList calendar weeksGETReturns the week-by-week season calendar.
Categorie, 1 operation
list_team_stat_categoriesList team stat categoriesGETReturns the available team statistical categories.
Cfp, 1 operation
get_cfp_bracketGet cfp bracketGETReturns the complete College Football Playoff bracket for a season.
Change, 1 operation
list_team_conference_changesList team conference changesGETReturns team conference changes by season.
Coache, 1 operation
list_coachesList coachesGETReturns historical head coach records.
Core, 1 operation
list_core_ratingsList core ratingsGETReturns Context & Opponent-Relative Efficiency (CORE) ratings. At least one of `year` or `team` is required.
Drive, 1 operation
list_drivesList drivesGETReturns historical drive data.
Elo, 1 operation
list_elo_ratingsList elo ratingsGETReturns historical Elo ratings.
Ep, 1 operation
list_field_goal_expected_pointsList field goal expected pointsGETReturns expected points values for field goal attempts.
Expanded, 1 operation
list_expanded_srs_ratingsList expanded srs ratingsGETReturns expanded Simple Rating System (SRS) ratings, including FCS teams.
Fb, 1 operation
list_fbs_teamsList fbs teamsGETReturns Football Bowl Subdivision (FBS) teams for a season.
Fpi, 1 operation
list_fpi_ratingsList fpi ratingsGETReturns historical Football Power Index (FPI) ratings.
Group, 1 operation
list_recruiting_position_group_ratingsList recruiting position group ratingsGETReturns recruiting ratings aggregated by team and position group.
Havoc, 1 operation
list_team_game_havoc_statsList team game havoc statsGETReturns team havoc statistics aggregated by game.
Info, 1 operation
get_account_infoGet account infoGETReturns the authenticated user's Patreon level and remaining API calls. Returns `null` when the request is not authenticated.
Kicking, 1 operation
list_kicker_paar_ratingsList kicker paar ratingsGETReturns Points Added Above Replacement (PAAR) ratings for kickers.
Line, 1 operation
list_betting_linesList betting linesGETReturns historical betting lines and results.
Matchup, 1 operation
get_team_matchupGet team matchupGETReturns historical matchup results between two teams.
Media, 1 operation
list_game_mediaList game mediaGETReturns broadcast and media information for games.
Participant, 1 operation
list_cfp_participantsList cfp participantsGETReturns College Football Playoff participants for a season.
Passing, 1 operation
list_adjusted_player_passing_statsList adjusted player passing statsGETReturns opponent-adjusted player passing metrics.
Pick, 1 operation
list_draft_picksList draft picksGETReturns historical NFL Draft picks.
Portal, 1 operation
list_transfer_portal_entriesList transfer portal entriesGETReturns transfer portal entries for a season.
Position, 1 operation
list_draft_positionsList draft positionsGETReturns the player position categories used in NFL Draft data.
Predicted, 1 operation
list_predicted_pointsList predicted pointsGETReturns predicted points values by down and distance.
Pregame, 1 operation
list_pregame_win_probabilitiesList pregame win probabilitiesGETReturns pregame win probabilities.
Preview, 1 operation
get_game_previewGet game previewGETReturns pregame team comparisons and key players. Analysis remains available until the game is completed.
Profile, 1 operation
get_coach_profileGet coach profileGETReturns a coach profile with canonical identity and career totals.
Ranking, 1 operation
list_poll_rankingsList poll rankingsGETReturns historical poll rankings.
Record, 1 operation
list_team_recordsList team recordsGETReturns historical team records by season.
Returning, 1 operation
list_returning_productionList returning productionGETReturns returning production metrics by team and season.
Roster, 1 operation
list_rosterList rosterGETReturns historical roster data.
Rushing, 1 operation
list_adjusted_player_rushing_statsList adjusted player rushing statsGETReturns opponent-adjusted player rushing metrics.
Schedule, 1 operation
get_game_scheduleGet game scheduleGETReturns the active or next calendar slate, including completed games. Explicit windows require year, seasonType, and week together.
Scoreboard, 1 operation
get_scoreboardGet scoreboardGETReturns current scoreboard data.
Search, 1 operation
search_playersSearch playersGETReturns up to 100 players whose names match the search term.
Sp, 1 operation
list_sp_ratingsList sp ratingsGETReturns SP+ ratings by team and season.
Sr, 1 operation
list_srs_ratingsList srs ratingsGETReturns Simple Rating System (SRS) ratings by team and season.
Stat, 1 operation
list_play_statsList play statsGETReturns player and play-stat associations, limited to 2,000 records.
Succes, 1 operation
list_player_season_success_ratesList player season success ratesGETReturns player passing and rushing success rates by season.
Talent, 1 operation
list_team_talentList team talentGETReturns 247Sports Team Talent Composite ratings for a season.
Tenure, 1 operation
list_coach_tenuresList coach tenuresGETReturns continuous head-coaching tenures and their attributed records. Requires coachId or team; year and active only filter the results.
Venue, 1 operation
list_venuesList venuesGETReturns college football venues.
Weather, 1 operation
list_game_weatherList game weatherGETReturns historical and forecast weather data for games. Requires Patreon.
Wp, 1 operation
list_game_win_probabilitiesList game win probabilitiesGETReturns play-by-play win probabilities for a game.
Use College Football Data from Claude Code, Cursor or Codex
Connect College Football Data in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its College Football Data operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect College Football Data
- Create your workspace
Sign up free. Nothing to install.
- Connect College Football Data once
Add your College Football Data connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
College Football Data integration FAQ
What can you do with the College Football Data integration?
LiveContext exposes 93 operations on College Football Data, covering game, season, play and team.
