College Football Data MCP Server

Name: College Football Data MCP Server
Author: lenwood

@lenwood

Repository

About College Football Data MCP Server

An MCP server enabling CFBD API queries within Claude Desktop.

#mcp #api-client #python3 #college-football #claude-desktop #model-context-protocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cfbd-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "cfbd",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

Retrieve game data

Get team records

Access team game statistics

Query play-by-play data

Analyze drive information

View play statistics

Check team rankings

See win probabilities

Access detailed game statistics and analytics

Overview

What is College Football Data MCP Server?

An MCP server that provides access to college football statistics and data from the College Football Data API V2, enabling AI assistants to query game results, team records, player stats, rankings, and win probabilities using natural language. It is primarily for use within Claude Desktop.

How to use College Football Data MCP Server?

Install via Smithery with npx -y @smithery/cli install cfbd --client claude or clone the repository, create a virtual environment with uv, install dependencies, and set your CFB_API_KEY in a .env file. Start the server with uv run cfbd-mcp-server, then add the server configuration to your Claude Desktop config file and restart Claude Desktop.

Key features of College Football Data MCP Server

Query game results, team records, and player statistics
Access play-by-play data and drive summaries
Retrieve team rankings across multiple polls
Get pregame win probabilities and advanced box scores
Use pre-built analysis templates (analyze-game, compare-teams, etc.)

Use cases of College Football Data MCP Server

Analyze a specific college football game's details and performance
Compare two teams’ season statistics and rankings
Identify the largest upsets in a given season
Track historical rivalry matchups and trends

FAQ from College Football Data MCP Server

What data sources does this server use?

It uses the College Football Data API V2 (collegefootballdata.com).

What are the runtime requirements?

Python 3.11 or higher and the UV package manager are required. A CFB API key is also needed.

How do I handle rate limiting?

The free API tier has limited requests per minute. Use efficient queries, consider caching, or subscribe to CFBD Patreon for higher limits. Handle rate limit errors gracefully.

How do I update the server after installation?

Run git pull in the project directory, uninstall the old package, delete build artifacts, reinstall with uv pip install -e . and uv sync --dev --all-extras, then restart the server and Claude Desktop.