cfbd-mcp-server

Overview

This MCP server implementation connects to the College Football Data API V2, enabling users to query comprehensive college football statistics and data directly from Claude Desktop. It provides access to game results, team records, player statistics, play-by-play data, drive summaries, rankings, and win probability metrics. The server includes pre-built analysis templates and supports natural language queries for easy data retrieval. It maintains active maintenance with regular updates and includes thorough documentation for installation and usage.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get-games

  Retrieve game data including scores and team information

  Try:What were the scores from last week's games?Try:Get results for Michigan vs Ohio State 2022
• get-records

  Get team season records and statistics

  Try:What's Alabama's record this season?Try:Show me all undefeated teams
• get-games-teams

  Access detailed team game statistics and performance metrics

  Try:How did Georgia perform in road games?Try:Compare team statistics for all SEC teams
• get-plays

  Query play-by-play data for specific games

  Try:Show me the final 2 minutes of the championship gameTry:What plays happened on the fourth quarter
• get-drives

  Analyze drive summaries and results

  Try:How many three-and-outs did each team have?Try:Show me the longest drives of the season
• get-play-stats

  View individual play statistics and metrics

  Try:What were the rushing stats for the running backs?Try:Show me pass completion percentages by quarterback
• get-rankings

  Check team rankings across different polls

  Try:Who is ranked in the top 10?Try:Show me the AP poll rankings this week
• get-pregame-win-probability

  See pre-game win probabilities

  Try:What were the win probabilities for the championship game?Try:Which games had the biggest upsets based on pre-game odds?
• get-advanced-box-score

  Access detailed game statistics and analytics

  Try:Show me the advanced stats for the Notre Dame gameTry:Compare efficiency metrics between both teams

Comparable tools

Installation

npx -y @smithery/cli install cfbd --client claude

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

uv pip install -e .

CFB_API_KEY=your_api_key_here

{
    "mcpServers": {
        "cfbd-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/full/path/to/cfbd-mcp-server",
                "run",
                "cfbd-mcp-server"
            ],
            "env": {
                "CFB_API_KEY": "xxx",
                "PATH": "/full/path/to/python"
            }
        }
    }
}

FAQ

How do I get a College Football Data API key?

You can get a free API key by signing up at https://collegefootballdata.com/key

What are the API rate limits?

The free tier has limited requests per minute. Higher rate limits are available to CFBD Patreon subscribers.

Compare cfbd-mcp-server with