cfb-stats-mcp

MCP server for college football statistics -- scores, rankings, advanced analytics, and historical data from the CFBD API.

Installation

Run directly with npx:

npx cfb-stats-mcp

Or install globally:

npm install -g cfb-stats-mcp
cfb-stats-mcp

Configuration

Requires a CFBD API key. Get one (free tier available) at collegefootballdata.com.

Set the CFBD_API_KEY environment variable:

CFBD_API_KEY=your-key-here npx cfb-stats-mcp

MCP Client Setup

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "cfb-stats": {
      "command": "npx",
      "args": ["-y", "cfb-stats-mcp"],
      "env": {
        "CFBD_API_KEY": "your-key-here"
      }
    }
  }
}

Available Tools

Tool	Description
cfbd_status	Check CFBD API connectivity and authentication status
cfbd_games	Look up college football game results by team and season. Returns scores, dates, venues, and Elo ratings.
cfbd_box_score	Get traditional box score stats (yards, 3rd down efficiency, turnovers, time of possession) for a team's games
cfbd_advanced_stats	Get advanced analytics (PPA, success rate, explosiveness, havoc) for a team's games. Combines efficiency metrics with defensive disruption rates.
cfbd_records	Get a team's season record with overall, conference, home/away, and postseason splits plus expected wins
cfbd_ratings	Get multi-system ratings (SP+, SRS, Elo, FPI) for a team. Shows headline numbers: overall rating and ranking, offense/defense breakdowns where available.
cfbd_conference_ratings	Get SP+ ratings for a conference. 'teams' view ranks all conference teams by SP+ overall. 'conference' view shows aggregate conference-level rating.
cfbd_head_to_head	Get historical head-to-head series data between two teams. Shows all-time series record, last 10 and last 5 results, and venue breakdowns.
cfbd_season_stats	Get season-wide traditional stat aggregates (yards, turnovers, 3rd down, completions, etc.) for a team. Returns totals/averages organized by category.
cfbd_season_advanced	Get season-wide advanced analytics for a team: EPA (opponent-adjusted efficiency), PPA (raw predicted points), success rate, havoc, explosiveness, and PPA by down.
build_glossary	Assemble a proper noun correction glossary from the static football glossary and CFBD roster data for specified teams. Returns formatted correction pairs for transcript correction.

Resources

The server exposes a Workflow Guide resource (resource:///workflow) that describes the full tool inventory, parameter details, chaining patterns, and recommended workflows. Load this resource to understand how tools work together for analysis tasks.

License

MIT