Retrieve college football game data including scores, teams, venues, and game dates
Get team season records including wins, losses, and conference standings
Access detailed team statistics for specific games
Query play-by-play data for detailed game analysis
Analyze drive information including results, field position, and time of possession
View detailed statistics for individual plays
Check team rankings across different polls and ranking systems
Access pregame win probability predictions
View detailed game statistics and advanced analytics
Get detailed analysis of a specific college football game
Generate comprehensive analysis of a single team's performance
Analyze trends over a college football season
Compare performance metrics between two college football teams
Analyze historical rivalry matchups between college football teams
College Football Data provides access to a wealth of college football statistics and analytics through the College Football Data API V2. This integration enables AI assistants to query game results, team records, player statistics, play-by-play data, rankings, and win probability metrics. With this tool, users can analyze historical college football data, compare team performances, and generate insights using natural language queries. The server connects to the official CFBD API, providing up-to-date and accurate information for both casual fans and serious analysts.
College Football Data MCP Server provides access to comprehensive college football statistics and data through the College Football Data API V2. This integration allows you to query game results, team records, player statistics, analyze play-by-play data, view rankings, and much more using natural language.
Before installing the College Football Data MCP Server, ensure you have:
The easiest way to install College Football Data for Claude Desktop is via Smithery:
npx -y @smithery/cli install cfbd --client claude
git clone https://github.com/lenwood/cfbd-mcp-server
cd cfbd-mcp-server
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .
.env file in the project root and add your API key:CFB_API_KEY=your_api_key_here
To connect with Claude Desktop:
Open your Claude Desktop configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd the server configuration as shown in the installation section below.
Close and restart Claude Desktop.
Verify installation by clicking the plus sign in the lower left corner of the text box. You should see "Add from cfbd-mcp-server" as one of the menu options.
Once installed, you can ask questions about college football data using natural language. For example:
To update the College Football Data MCP Server:
cd cfbd-mcp-server
git pull
uv pip uninstall cfbd-mcp-server
Delete existing build artifacts and metadata:
rmdir /s /q build dist and del /s /q *.egg-inform -rf build dist *.egg-infoInstall the revised package and its dependencies:
uv pip install -e .
uv sync --dev --all-extras
uv run cfbd-mcp-server
Be aware that the College Football Data API has rate limits. Excessive queries may result in temporary restrictions on your API key.