> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to College Football Data

The College Football Data connector lets your AI agent act in each user's College Football Data account. Each user connects their own College Football Data access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** Bearer Token
**Categories:** Analytics
**Tools:** 60: 60 read, 0 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=COLLEGEFOOTBALLDATA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the College Football Data connection

   In **AgentKit > Connections**, create a College Football Data connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'collegefootballdata'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize College Football Data:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'collegefootballdata_user_info_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "collegefootballdata"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize College Football Data:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="collegefootballdata_user_info_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their College Football Data credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'collegefootballdata_adjusted_team_stats_list',
  toolInput: {},
  connector: 'collegefootballdata',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="collegefootballdata_adjusted_team_stats_list",
    tool_input={},
    connection_name="collegefootballdata",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `collegefootballdata_adjusted_team_stats_list`

List Opponent-Adjusted Team Stats · Read-only

Get opponent-adjusted team statistics by season (WEPA): EPA per play, success rate and rushing and passing splits adjusted for schedule.
Returns a list of records with year, teamId, team, conference, epa, epaAllowed, successRate, successRateAllowed, rushing, rushingAllowed.
Use this to compare teams after accounting for opponent strength. Use collegefootballdata_team_advanced_stats_list for unadjusted metrics.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_betting_lines_list`

List Betting Lines · Read-only

Get betting lines (spread, over/under, moneyline) from sportsbooks for games, with results.
Returns a list of records with id, season, seasonType, week, startDate, homeTeamId, homeTeam, homeConference, homeClassification, homeScore.
Use this for game odds. Pass gameId, or year with week, team or conference. Use collegefootballdata_team_ats_records_list for ATS records.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `away` (`string`, optional): Away team name. Example: Ohio State
- `conference` (`string`, optional): Conference of either team. Example: B1G
- `game_id` (`integer`, optional): Game ID. Example: 401520281
- `home` (`string`, optional): Home team name. Example: Michigan
- `provider` (`string`, optional): Betting line provider. Example: ESPN Bet
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name on either side of the game. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5
- `year` (`integer`, optional): Season year. Required unless gameId is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_calendar_get`

Get Season Calendar · Read-only

Get the week-by-week calendar for a season, with each week's start and end dates.
Returns a list of records with season, week, seasonType, startDate, endDate, firstGameStart, lastGameStart.
Use this to map dates to week numbers before calling week-filtered tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024

Example input: `{"year":2024}`

### `collegefootballdata_cfp_bracket_get`

Get CFP Bracket · Read-only

Get the complete College Football Playoff bracket for a season, with seeds, matchups and results.
Returns season, competition, format, teamCount, status, participants, rounds, champion.
Use this for the playoff bracket. Use collegefootballdata_poll_rankings_list with poll=cfp for CFP rankings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024

Example input: `{"year":2024}`

### `collegefootballdata_coach_profile_get`

Get Coach Profile · Read-only

Get one coach's profile with canonical identity and career totals.
Returns id, firstName, lastName, displayName, currentTeam, career, birthDate, almaMater, graduationYear, wikidataId.
Use this when you have a coach ID. Use collegefootballdata_coaches_list to find coaches by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `coach_id` (`integer`, required): Coach ID. Example: 1234

Example input: `{"coach_id":1234}`

### `collegefootballdata_coaches_list`

List Coaches · Read-only

List head coaches with their season-by-season records, filtered by name, team or year range.
Returns a list of records with id, firstName, lastName, hireDate, seasons.
Use this to find coaches and their records. Use collegefootballdata_coach_profile_get for one coach's career totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `first_name` (`string`, optional): Coach first name. Example: Kirby
- `last_name` (`string`, optional): Coach last name. Example: Smart
- `max_year` (`integer`, optional): Latest season year to include. Example: 2024
- `min_year` (`integer`, optional): Earliest season year to include. Example: 2010
- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_conferences_list`

List Conferences · Read-only

List conferences with name, abbreviation, classification and member counts.
Returns a list of records with id, name, shortName, abbreviation, classification, memberCount.
Use this to get the conference abbreviations other tools filter on.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Conference classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `year` (`integer`, optional): Season year used to calculate membership. Example: 2024

Example input: `{}`

### `collegefootballdata_draft_picks_list`

List NFL Draft Picks · Read-only

List NFL Draft picks with round, pick, NFL team, college team, position and grades.
Returns a list of records with collegeAthleteId, nflAthleteId, collegeId, collegeTeam, collegeConference, nflTeamId, nflTeam, year, overall, round.
Use this to see which college players were drafted.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): College conference name or abbreviation. Example: B1G
- `position` (`string`, optional): Position category. Example: QB
- `school` (`string`, optional): College team name. Example: Michigan
- `team` (`string`, optional): NFL team name. Example: Michigan
- `year` (`integer`, optional): Draft year. Example: 2024

Example input: `{}`

### `collegefootballdata_drives_list`

List Drives · Read-only

List drives for a season, with start and end field position, plays, yards, time and result.
Returns a list of records with offense, offenseConference, defense, defenseConference, gameId, id, driveNumber, scoring, startPeriod, startYardline.
Use this for drive-level analysis. Use collegefootballdata_plays_list for individual plays.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `classification` (`string`, optional): Division classification of either team. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference of either team. Example: B1G
- `defense` (`string`, optional): Defensive team name. Example: Ohio State
- `defense_conference` (`string`, optional): Defensive team conference. Example: example
- `offense` (`string`, optional): Offensive team name. Example: Michigan
- `offense_conference` (`string`, optional): Offensive team conference. Example: example
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name on either side of the drive. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5

Example input: `{"year":2024}`

### `collegefootballdata_elo_ratings_list`

List Elo Ratings · Read-only

Get Elo team ratings by season, optionally as of a given week.
Returns a list of records with year, team, conference, elo.
Use this for Elo ratings. Use collegefootballdata_sp_ratings_list for SP+.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `preseason` (`boolean`, optional): Return initial ratings from each team's opening regular-season game. Missing opening ratings are omitted. Cannot be combined with week; seasonType must be regular or both when specified. Defaults to false. Example: false
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Example: Michigan
- `week` (`integer`, optional): Week number. Defaults to the latest available week in the season. Example: 5
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_fbs_teams_list`

List FBS Teams · Read-only

List Football Bowl Subdivision (FBS) teams for a season.
Returns a list of records with id, school, mascot, abbreviation, alternateNames, conference, division, classification, color, alternateColor.
Use this when you only need FBS teams. Use collegefootballdata_teams_list for all divisions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_fpi_ratings_list`

List FPI Ratings · Read-only

Get ESPN Football Power Index (FPI) team ratings by season, with efficiency and resume rankings.
Returns a list of records with year, team, conference, fpi, resumeRanks, efficiencies.
Use this for FPI. Use collegefootballdata_sp_ratings_list for SP+.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_game_advanced_box_score_get`

Get Advanced Box Score · Read-only

Get the advanced box score for one game, with efficiency, explosiveness, havoc, field position and player usage.
Returns gameInfo, teams, players.
Use this for deep analysis of one game. Returns 404 for games without play-by-play data. Get the game ID from collegefootballdata_games_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): Game ID. Example: 401520281

Example input: `{"id":401520281}`

### `collegefootballdata_game_advanced_stats_list`

List Game Advanced Stats · Read-only

Get advanced team statistics by game: success rate, explosiveness, PPA and line metrics, for offense and defense.
Returns a list of records with gameId, season, seasonType, week, team, opponent, offense, defense.
Use this for game-level efficiency. Use collegefootballdata_team_advanced_stats_list for season aggregates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Defaults to false. Example: true
- `opponent` (`string`, optional): Opponent team name. Example: Ohio State
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `week` (`number`, optional): Week number. Example: 5
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_game_havoc_stats_list`

List Game Havoc Stats · Read-only

Get team havoc rates by game: tackles for loss, passes defended and forced fumbles as a share of plays.
Returns a list of records with gameId, season, seasonType, week, team, conference, opponent, opponentConference, offense, defense.
Use this to measure defensive disruption per game.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `opponent` (`string`, optional): Opponent team name. Example: Ohio State
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `week` (`number`, optional): Week number. Example: 5
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_game_media_list`

List Game Media · Read-only

List TV, radio and streaming broadcast information for games in a season.
Returns a list of records with id, season, week, seasonType, startTime, isStartTimeTBD, homeTeam, homeConference, awayTeam, awayConference.
Use this to find where a game is broadcast. Use collegefootballdata_games_list for scores.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `classification` (`string`, optional): Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `media_type` (`string`, optional): Media type. One of: tv, radio, web, ppv, mobile. Example: tv. One of: `tv`, `radio`, `web`, `ppv`, `mobile`.
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5

Example input: `{"year":2024}`

### `collegefootballdata_game_player_stats_list`

List Game Player Stats · Read-only

Get player box score statistics for games in a week, for a team, or for one game.
Returns a list of records with id, teams.
Use this for per-player box scores. Pass id, or year with week, team or conference. Use collegefootballdata_player_season_stats_list for season totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category` (`string`, optional): Player statistical category. Example: passing
- `classification` (`string`, optional): Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. One of week, team, or conference is required when filtering by year. Example: B1G
- `id` (`integer`, optional): Game ID. When specified, returns statistics for that game. Example: 401520281
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. One of week, team, or conference is required when filtering by year. Example: Michigan
- `week` (`integer`, optional): Week number. One of week, team, or conference is required when filtering by year. Example: 5
- `year` (`integer`, optional): Season year. Required unless id is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_game_ppa_list`

List Game PPA · Read-only

Get team Predicted Points Added (PPA) per play by game, for offense and defense.
Returns a list of records with gameId, season, week, seasonType, team, conference, opponent, offense, defense.
Use this for game-level team PPA. Use collegefootballdata_team_ppa_list for season aggregates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference abbreviation. Example: B1G
- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Example: true
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5

Example input: `{"year":2024}`

### `collegefootballdata_game_preview_get`

Get Game Preview · Read-only

Get the pregame comparison for one game: team metrics side by side and the key players.
Returns assembledAt, game, availability, reason, analysis.
Use this before a game to compare the two teams. Get the game ID from collegefootballdata_schedule_get or collegefootballdata_games_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `game_id` (`integer`, required): Game ID. Example: 401520281

Example input: `{"game_id":401520281}`

### `collegefootballdata_game_team_stats_list`

List Game Team Stats · Read-only

Get team box score statistics for games in a week, for a team, or for one game.
Returns a list of records with id, teams.
Use this for team box scores. Pass id, or year with week, team or conference. Use collegefootballdata_game_player_stats_list for player box scores.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. One of week, team, or conference is required when filtering by year. Example: B1G
- `id` (`integer`, optional): Game ID. When specified, returns statistics for that game. Example: 401520281
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. One of week, team, or conference is required when filtering by year. Example: Michigan
- `week` (`integer`, optional): Week number. One of week, team, or conference is required when filtering by year. Example: 5
- `year` (`integer`, optional): Season year. Required unless id is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_games_list`

List Games · Read-only

List college football games for a season, week, team or conference, or get one game by ID.
Returns a list of records with id, season, week, seasonType, startDate, startTimeTBD, completed, neutralSite, conferenceGame, attendance.
Use this to find game IDs and final scores. Use collegefootballdata_game_team_stats_list or collegefootballdata_game_player_stats_list for box scores. Pass year unless you pass id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `away` (`string`, optional): Away team name. Example: Ohio State
- `classification` (`string`, optional): Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `competition` (`string`, optional): Playoff competition. One of: cfp. Example: cfp. One of: `cfp`.
- `conference` (`string`, optional): Conference of either team. Example: B1G
- `home` (`string`, optional): Home team name. Example: Michigan
- `id` (`integer`, optional): Game ID. When specified, returns data for that game. Example: 401520281
- `round` (`string`, optional): Playoff round. Requires competition. One of: first_round, quarterfinal, semifinal, championship. Example: first_round. One of: `first_round`, `quarterfinal`, `semifinal`, `championship`.
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name on either side of the game. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5
- `year` (`integer`, optional): Season year. Required unless id is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_play_stat_types_list`

List Play Stat Types · Read-only

List the play statistic types (for example Completion, Rush, Sack) with their IDs.
Returns a list of records with id, name.
Use this to get statTypeId values for collegefootballdata_play_stats_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `collegefootballdata_play_stats_list`

List Play Stats · Read-only

List player-to-play statistic associations, such as who made a tackle or reception, limited to 2,000 records.
Returns a list of records with gameId, season, week, team, conference, opponent, teamScore, opponentScore, driveId, playId.
Use this to attribute plays to players. Narrow by gameId, team or athleteId. Use collegefootballdata_play_stat_types_list for stat type IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `athlete_id` (`integer`, optional): Athlete ID. Example: 4432577
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `game_id` (`integer`, optional): Game ID. Example: 401520281
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `stat_type_id` (`integer`, optional): Play stat type ID. Example: 1
- `team` (`string`, optional): Team name. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_play_types_list`

List Play Types · Read-only

List every play type with its ID, text and abbreviation.
Returns a list of records with id, text, abbreviation.
Use this to get the playType ID for collegefootballdata_plays_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `collegefootballdata_player_game_ppa_list`

List Player Game PPA · Read-only

Get player Predicted Points Added (PPA) by game.
Returns a list of records with season, week, seasonType, id, name, position, team, opponent, averagePPA.
Use this for one player's game-by-game value. Use collegefootballdata_player_season_ppa_list for season totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Example: true
- `player_id` (`string`, optional): Player ID. Example: 4432577
- `position` (`string`, optional): Player position abbreviation. Example: QB
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Required unless week is specified. Example: Michigan
- `threshold` (`number`, optional): Minimum number of plays. Example: 0
- `week` (`integer`, optional): Week number. Required unless team is specified. Example: 5

Example input: `{"year":2024}`

### `collegefootballdata_player_passing_season_list`

List Player Passing by Season · Read-only

Get player passing statistics by season, including completion percentage over expected (CPOE).
Returns a list of records with attempts, completions, incompletions, interceptions, completionRate, airYardsAttemptsAvailable, totalAirYards, averageDepthOfTarget, totalYardsAttemptsAvailable, totalYards.
Use this to compare quarterbacks. Use collegefootballdata_player_rushing_season_list for rushing.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `passer_id` (`string`, optional): Passer athlete ID. Required unless year is specified. Example: 4432577
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless passerId is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_player_rushing_season_list`

List Player Rushing by Season · Read-only

Get player rushing statistics by season, with direction and attribution metrics.
Returns a list of records with attempts, rushingYardsAvailable, totalRushingYards, yardsPerCarry, individualAttempts, unattributedAttempts, sacks, kneels, teamRushes, multiCarrierAttempts.
Use this to compare rushers. Use collegefootballdata_player_passing_season_list for passing.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `rusher_id` (`string`, optional): Rusher athlete ID. Required unless year is specified. Example: 4432577
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless rusherId is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_player_season_overview_get`

Get Player Season Overview · Read-only

Get one player's season overview, combining box score stats, usage and predicted points added.
Returns season, id, name, position, team, conference, games, boxScoreStats, usage, ppa.
Use this for a full summary of one player. Get the player ID from collegefootballdata_players_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `player_id` (`integer`, required): Player ID. Example: 4432577
- `year` (`integer`, required): Season year. Example: 2024

Example input: `{"player_id":4432577,"year":2024}`

### `collegefootballdata_player_season_ppa_list`

List Player Season PPA · Read-only

Get player Predicted Points Added (PPA) aggregated by season.
Returns a list of records with season, id, name, position, team, conference, averagePPA, totalPPA.
Use this to rank players by value over a season. Use collegefootballdata_player_game_ppa_list for single games.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference abbreviation. Example: B1G
- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Example: true
- `player_id` (`string`, optional): Player ID. Required unless year is specified. Example: 4432577
- `position` (`string`, optional): Player position abbreviation. Example: QB
- `team` (`string`, optional): Team name. Example: Michigan
- `threshold` (`number`, optional): Minimum number of plays. Example: 0
- `year` (`integer`, optional): Season year. Required unless playerId is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_player_season_stats_list`

List Player Season Stats · Read-only

Get player statistics aggregated by season, optionally for a team, conference, category or week range.
Returns a list of records with season, playerId, player, position, team, conference, category, statType, stat.
Use this for season totals per player. Use collegefootballdata_game_player_stats_list for single games.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `category` (`string`, optional): Statistical category. Example: passing
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `end_week` (`integer`, optional): Latest week to include. Example: 12
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `start_week` (`integer`, optional): Earliest week to include. Example: 1
- `team` (`string`, optional): Team name. Example: Michigan

Example input: `{"year":2024}`

### `collegefootballdata_player_usage_list`

List Player Usage · Read-only

Get player usage rates for a season, overall and by down and play type.
Returns a list of records with season, id, name, position, team, conference, usage.
Use this to see how much each player is involved in the offense. Use collegefootballdata_player_season_overview_get for one player's full season.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `conference` (`string`, optional): Conference abbreviation. Example: B1G
- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Defaults to false. Example: true
- `player_id` (`integer`, optional): Player ID. Example: 4432577
- `position` (`string`, optional): Player position abbreviation. Example: QB
- `team` (`string`, optional): Team name. Example: Michigan

Example input: `{"year":2024}`

### `collegefootballdata_players_search`

Search Players · Read-only

Search players by name, returning up to 100 matches.
Returns a list of records with id, team, name, firstName, lastName, weight, height, jersey, position, hometown.
Use this to find a player ID by name. Narrow with year, team or position.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `search_term` (`string`, required): Full or partial player name. Example: Jalen Milroe
- `position` (`string`, optional): Player position abbreviation. Example: QB
- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{"search_term":"<search_term>"}`

### `collegefootballdata_plays_list`

List Plays · Read-only

List play-by-play data for a season week, optionally for a team, offense, defense or play type.
Returns a list of records with id, driveId, gameId, driveNumber, playNumber, offense, offenseConference, offenseScore, defense, home.
Use this for play-level analysis. Year and week are required. Use collegefootballdata_play_types_list to get play type IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `week` (`integer`, required): Week number. Example: 5
- `year` (`integer`, required): Season year. Example: 2024
- `classification` (`string`, optional): Division classification of either team. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference of either team. Example: B1G
- `defense` (`string`, optional): Defensive team name. Example: Ohio State
- `defense_conference` (`string`, optional): Defensive team conference. Example: example
- `offense` (`string`, optional): Offensive team name. Example: Michigan
- `offense_conference` (`string`, optional): Offensive team conference. Example: example
- `play_type` (`string`, optional): Play type abbreviation. Example: 5
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name on either side of the play. Example: Michigan

Example input: `{"week":5,"year":2024}`

### `collegefootballdata_poll_rankings_list`

List Poll Rankings · Read-only

Get poll rankings (AP, Coaches, CFP and others) for a season, by week.
Returns a list of records with season, seasonType, week, polls.
Use this for Top 25 polls. Pass poll=cfp with latest or final for the College Football Playoff rankings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `final` (`boolean`, optional): Returns the CFP snapshot marked as final when true. Requires poll=cfp and cannot be combined with latest. Example: false
- `latest` (`boolean`, optional): Returns the latest CFP snapshot when true, preferring the snapshot marked as final. Requires poll=cfp and cannot be combined with final. Example: false
- `poll` (`string`, optional): Poll name. One of: cfp. Example: cfp. One of: `cfp`.
- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `week` (`number`, optional): Poll week. Example: 5

Example input: `{"year":2024}`

### `collegefootballdata_predicted_points_get`

Get Predicted Points · Read-only

Get expected points for each yard line at a given down and distance.
Returns a list of records with yardLine, predictedPoints.
Use this to value a game situation. Down and distance are required.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `distance` (`integer`, required): Distance to gain, in yards. Example: 10
- `down` (`integer`, required): Down number. Example: 1

Example input: `{"distance":10,"down":1}`

### `collegefootballdata_pregame_win_probabilities_list`

List Pregame Win Probabilities · Read-only

Get pregame win probabilities for games, with the spread they are based on.
Returns a list of records with season, seasonType, week, gameId, homeTeam, awayTeam, spread, homeWinProbability.
Use this before games. Use collegefootballdata_win_probability_get for in-game probabilities.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `season_type` (`string`, optional): Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regular. One of: `regular`, `postseason`, `both`, `allstar`, `spring_regular`, `spring_postseason`.
- `team` (`string`, optional): Team name. Example: Michigan
- `week` (`integer`, optional): Week number. Example: 5
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_records_list`

List Team Records · Read-only

Get team win-loss records by season, split into total, conference, home, away and postseason.
Returns a list of records with year, teamId, team, classification, conference, division, expectedWins, total, conferenceGames, homeGames.
Use this for standings and records. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_recruiting_position_groups_list`

List Recruiting Position Groups · Read-only

Get recruiting ratings aggregated by team and position group over a year range.
Returns a list of records with team, conference, positionGroup, averageRating, totalRating, commits, averageStars.
Use this to see where a team recruits best.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `end_year` (`integer`, optional): Latest recruiting class year. Defaults to the current year. Example: 2024
- `recruit_type` (`string`, optional): Recruit classification. Defaults to HighSchool. One of: JUCO, PrepSchool, HighSchool. Example: HighSchool. One of: `JUCO`, `PrepSchool`, `HighSchool`.
- `start_year` (`integer`, optional): Earliest recruiting class year. Defaults to 2000. Example: 2018
- `team` (`string`, optional): Team name. Example: Michigan

Example input: `{}`

### `collegefootballdata_recruiting_team_rankings_list`

List Recruiting Team Rankings · Read-only

Get team recruiting class rankings and points by year.
Returns a list of records with year, rank, team, points.
Use this to compare recruiting classes. Use collegefootballdata_recruits_list for individual players.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Recruiting class year. Example: 2024

Example input: `{}`

### `collegefootballdata_recruits_list`

List Recruits · Read-only

List player recruiting rankings with stars, rating, position, school and hometown.
Returns a list of records with id, athleteId, recruitType, year, ranking, name, school, committedTo, position, height.
Use this for individual recruits. Use collegefootballdata_recruiting_team_rankings_list for class rankings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Recruit classification. Defaults to HighSchool. One of: JUCO, PrepSchool, HighSchool. Example: JUCO. One of: `JUCO`, `PrepSchool`, `HighSchool`.
- `position` (`string`, optional): Position category. Example: QB
- `state` (`string`, optional): State or province abbreviation. Example: TX
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Recruiting class year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_returning_production_list`

List Returning Production · Read-only

Get returning production by team for a season: the share of last season's production that returns.
Returns a list of records with season, team, conference, totalPPA, totalPassingPPA, totalReceivingPPA, totalRushingPPA, percentPPA, percentPassingPPA, percentReceivingPPA.
Use this for offseason outlooks. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_roster_get`

Get Team Roster · Read-only

Get a team's roster for a season, with each player's ID, name, position, jersey, height, weight, year and hometown.
Returns a list of records with id, firstName, lastName, team, height, weight, jersey, year, position, homeCity.
Use this to get player IDs and roster details. Use collegefootballdata_players_search to find a player by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification: fbs or fcs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `team` (`string`, optional): Team name. Example: Michigan
- `year` (`integer`, optional): Season year. Defaults to 2025. Example: 2024

Example input: `{}`

### `collegefootballdata_schedule_get`

Get Game Schedule · Read-only

Get the games for the current or next week, or for a requested season and week.
Returns assembledAt, selection, filters, window, followingWindow, games.
Use this for upcoming or this week's games. Use collegefootballdata_games_list for historical games with filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division of either participant. Defaults to fbs. One of: fbs, fcs. Example: fbs. One of: `fbs`, `fcs`.
- `conference` (`string`, optional): Conference abbreviation of either participant. Example: B1G
- `season_type` (`string`, optional): Season type. Requires year and week. One of: regular, postseason. Example: regular. One of: `regular`, `postseason`.
- `week` (`integer`, optional): Week number. Requires year and seasonType. Example: 5
- `year` (`integer`, optional): Season year. Requires seasonType and week. Example: 2024

Example input: `{}`

### `collegefootballdata_scoreboard_get`

Get Scoreboard · Read-only

Get the current scoreboard: live and recent games with scores, status, betting lines and weather.
Returns a list of records with id, startDate, startTimeTBD, tv, neutralSite, conferenceGame, status, period, clock, situation.
Use this for what is happening now. Use collegefootballdata_games_list for past seasons.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G

Example input: `{}`

### `collegefootballdata_sp_conference_ratings_list`

List Conference SP+ Ratings · Read-only

Get conference-level SP+ ratings by season.
Returns a list of records with year, conference, rating, secondOrderWins, sos, offense, defense, specialTeams.
Use this to compare conferences. Use collegefootballdata_sp_ratings_list for teams.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `year` (`integer`, optional): Season year. Example: 2024

Example input: `{}`

### `collegefootballdata_sp_ratings_list`

List SP+ Ratings · Read-only

Get SP+ team ratings by season, with offense, defense and special teams components.
Returns a list of records with year, team, conference, rating, ranking, secondOrderWins, sos, offense, defense, specialTeams.
Use this for SP+ ratings. Use collegefootballdata_srs_ratings_list, collegefootballdata_elo_ratings_list or collegefootballdata_fpi_ratings_list for other systems.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_srs_ratings_list`

List SRS Ratings · Read-only

Get Simple Rating System (SRS) team ratings by season.
Returns a list of records with year, team, conference, division, rating, ranking.
Use this for SRS. Use collegefootballdata_sp_ratings_list for SP+.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_stat_categories_list`

List Stat Categories · Read-only

List the team statistical categories.
Returns a list.
Use this to see which categories collegefootballdata_team_season_stats_list returns.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `collegefootballdata_team_advanced_stats_list`

List Team Advanced Season Stats · Read-only

Get advanced team statistics by season: success rate, explosiveness, PPA, havoc and field position, for offense and defense.
Returns a list of records with season, team, conference, offense, defense.
Use this for efficiency analysis over a season. Use collegefootballdata_game_advanced_stats_list for single games.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `end_week` (`integer`, optional): Latest week to include. Example: 12
- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Defaults to false. Example: true
- `start_week` (`integer`, optional): Earliest week to include. Example: 1
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_team_ats_records_list`

List ATS Records · Read-only

Get each team's record against the betting spread (ATS) for a season.
Returns a list of records with year, teamId, team, conference, games, atsWins, atsLosses, atsPushes, avgCoverMargin.
Use this for betting performance. Use collegefootballdata_betting_lines_list for individual game lines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `team` (`string`, optional): Team name. Example: Michigan

Example input: `{"year":2024}`

### `collegefootballdata_team_matchup_get`

Get Team Matchup · Read-only

Get the head-to-head history between two teams: each team's wins, ties and every game played.
Returns team1, team2, startYear, endYear, team1Wins, team2Wins, ties, games.
Use this for rivalry history. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team1` (`string`, required): First team name. Example: Michigan
- `team2` (`string`, required): Second team name. Example: Ohio State
- `max_year` (`integer`, optional): Latest season year to include. Example: 2024
- `min_year` (`integer`, optional): Earliest season year to include. Example: 2010

Example input: `{"team1":"<team1>","team2":"<team2>"}`

### `collegefootballdata_team_ppa_list`

List Team PPA · Read-only

Get team Predicted Points Added (PPA) per play by season, for offense and defense.
Returns a list of records with season, conference, team, offense, defense.
Use this for season-level PPA. Use collegefootballdata_game_ppa_list for single games.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference abbreviation. Example: B1G
- `exclude_garbage_time` (`boolean`, optional): Excludes garbage-time plays when true. Example: true
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_team_season_overview_get`

Get Team Season Overview · Read-only

Get a full-season overview of one team, including postseason games and garbage-time splits.
Returns advanced, players, passing, rushing, statRankings, record, ratings, season, teamId, team.
Use this for a one-call summary of a team's season. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team` (`string`, required): Team name. Example: Michigan
- `year` (`integer`, required): Season year. Example: 2024

Example input: `{"team":"<team>","year":2024}`

### `collegefootballdata_team_season_stats_list`

List Team Season Stats · Read-only

Get team statistics aggregated by season, optionally for a team, conference or week range.
Returns a list of records with season, team, conference, statName, statValue.
Use this for team season totals. Use collegefootballdata_team_advanced_stats_list for efficiency metrics.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `classification` (`string`, optional): Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbs. One of: `fbs`, `fcs`, `ii`, `ii/iii`, `iii`.
- `conference` (`string`, optional): Conference name or abbreviation. Example: B1G
- `end_week` (`integer`, optional): Latest week to include. Example: 12
- `start_week` (`integer`, optional): Earliest week to include. Example: 1
- `team` (`string`, optional): Team name. Required unless year is specified. Example: Michigan
- `year` (`integer`, optional): Season year. Required unless team is specified. Example: 2024

Example input: `{}`

### `collegefootballdata_team_talent_list`

List Team Talent · Read-only

Get the 247Sports Team Talent Composite rating of every team for a season.
Returns a list of records with year, team, talent.
Use this to compare roster talent. Use collegefootballdata_recruiting_team_rankings_list for recruiting classes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024

Example input: `{"year":2024}`

### `collegefootballdata_teams_list`

List Teams · Read-only

List college football teams with school name, mascot, abbreviation, conference, colors, logos and venue.
Returns a list of records with id, school, mascot, abbreviation, alternateNames, conference, division, classification, color, alternateColor.
Use this to get exact team names for other tools. Use collegefootballdata_fbs_teams_list for FBS teams only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conference` (`string`, optional): Conference abbreviation. Example: B1G
- `year` (`integer`, optional): Season year for historical conference affiliations. Example: 2024

Example input: `{}`

### `collegefootballdata_transfer_portal_list`

List Transfer Portal · Read-only

List transfer portal entries for a season, with origin, destination, position, rating and eligibility.
Returns a list of records with season, firstName, lastName, position, origin, destination, transferDate, rating, stars, eligibility.
Use this to track transfers. The year is the season the transfer takes effect.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `year` (`integer`, required): Season year. Example: 2024

Example input: `{"year":2024}`

### `collegefootballdata_user_info_get`

Get API Key Info · Read-only

Get the authenticated user's Patreon level and remaining monthly API calls.
Returns patronLevel, tierName, monthlyLimit, remainingCalls, usedCalls, resetAt, sharedPool, products, features.
Use this to check how many calls the key has left. Each tool call uses one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `collegefootballdata_venues_list`

List Venues · Read-only

List college football stadiums with capacity, surface, location, elevation and dome status.
Returns a list of records with id, name, city, state, zip, countryCode, timezone, latitude, longitude, elevation.
Use this for venue details. Takes no filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `collegefootballdata_win_probability_get`

Get Win Probability · Read-only

Get the play-by-play win probability chart for one game.
Returns a list of records with gameId, playId, playText, homeId, home, awayId, away, spread, homeBall, homeScore.
Use this to see how a game swung. Get the game ID from collegefootballdata_games_list. Use collegefootballdata_pregame_win_probabilities_list for pregame odds.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `game_id` (`integer`, required): Game ID. Example: 401520281

Example input: `{"game_id":401520281}`

## Related

Other Analytics connectors ([all 177](/agentkit/connectors/?category=analytics)):

- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [AWS Redshift](/agentkit/connectors/redshift/): Scalekit connector, Trusted identity provider, 10 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
