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