Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to College Football Data

Scalekit connector
Open markdown

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.

Tools
60
What they doRead · write · destructive
60 · 0 · 060 read0 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .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.

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their College Football Data credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • collegefootballdata_adjusted_team_stats_listGet opponent-adjusted team statistics by season (WEPA): EPA per play, success rate and rushing and passing splits adjusted for schedule.Read-only

    List Opponent-Adjusted Team Stats

    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.

    Inputs

    conferencestring
    Conference name or abbreviation. Example: B1G
    teamstring
    Team name. Example: Michigan
    yearinteger
    Season year. Example: 2024
  • collegefootballdata_betting_lines_listGet betting lines (spread, over/under, moneyline) from sportsbooks for games, with results.Read-only

    List Betting Lines

    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.

    Inputs

    awaystring
    Away team name. Example: Ohio State
    conferencestring
    Conference of either team. Example: B1G
    game_idinteger
    Game ID. Example: 401520281
    homestring
    Home team name. Example: Michigan
    providerstring
    Betting line provider. Example: ESPN Bet
    season_typestring
    Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of regularpostseasonbothallstarspring_regularspring_postseason
    teamstring
    Team name on either side of the game. Example: Michigan
    weekinteger
    Week number. Example: 5
    yearinteger
    Season year. Required unless gameId is specified. Example: 2024
  • collegefootballdata_calendar_getGet the week-by-week calendar for a season, with each week's start and end dates.Read-only

    Get Season Calendar

    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.

    Inputs

    yearintegerrequired
    Season year. Example: 2024
  • collegefootballdata_cfp_bracket_getGet the complete College Football Playoff bracket for a season, with seeds, matchups and results.Read-only

    Get CFP Bracket

    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.

    Inputs

    yearintegerrequired
    Season year. Example: 2024
  • collegefootballdata_coach_profile_getGet one coach's profile with canonical identity and career totals.Read-only

    Get Coach Profile

    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.

    Inputs

    coach_idintegerrequired
    Coach ID. Example: 1234
  • collegefootballdata_coaches_listList head coaches with their season-by-season records, filtered by name, team or year range.Read-only

    List Coaches

    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.

    Inputs

    first_namestring
    Coach first name. Example: Kirby
    last_namestring
    Coach last name. Example: Smart
    max_yearinteger
    Latest season year to include. Example: 2024
    min_yearinteger
    Earliest season year to include. Example: 2010
    teamstring
    Team name. Example: Michigan
    yearinteger
    Season year. Example: 2024
  • collegefootballdata_conferences_listList conferences with name, abbreviation, classification and member counts.Read-only

    List Conferences

    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.

    Inputs

    classificationstring
    Conference classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of fbsfcsiiii/iiiiii
    yearinteger
    Season year used to calculate membership. Example: 2024
  • collegefootballdata_draft_picks_listList NFL Draft picks with round, pick, NFL team, college team, position and grades.Read-only

    List NFL Draft Picks

    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.

    Inputs

    conferencestring
    College conference name or abbreviation. Example: B1G
    positionstring
    Position category. Example: QB
    schoolstring
    College team name. Example: Michigan
    teamstring
    NFL team name. Example: Michigan
    yearinteger
    Draft year. Example: 2024