Access College Football Data via API
An MCP server for querying college football stats - game results, team records, play-by-play data, and rankings.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Leverage the College Football Data API V2 to query game results, team records, player statistics, and rankings. This MCP server provides access to comprehensive sports data for analysis and insights.
Outcomes
What it gets done
Query game results and team records
Access player statistics and play-by-play data
Retrieve team rankings and win probability forecasts
Analyze historical game performance and rivalries
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-cfbd-api | bash Capabilities
Tools your agent gets
Retrieve game data from college football statistics
Get team records and historical performance data
Access game team statistics and performance metrics
Request play-by-play data for college football games
Analyze drive information and scoring sequences
View detailed play statistics and analytics
Check team rankings and standings
View win probability forecasts for upcoming games
Access detailed game statistics and advanced analytics
Overview
CFBD API MCP Server
An MCP server that provides natural-language access to college football statistics via the College Football Data API - game results, team records, play-by-play data, and rankings. Use it to explore college football data conversationally instead of writing raw API calls - be aware the free API tier has request-per-minute rate limits.
What it does
This is an MCP server implementation that provides access to college football statistics through the College Football Data API V2. It lets you query game results, team records, player stats, play-by-play data, and rankings using natural language.
When to use - and when NOT to
Use it when you want to explore college football data conversationally - comparing team performances across seasons, analyzing historical rivalry matchups, or getting a detailed breakdown of a specific game - instead of writing raw API calls. The College Football Data API has rate limits: the free tier caps requests per minute, and Patreon subscribers get higher limits, so heavy analytical workloads may need a paid API tier.
Capabilities
It exposes nine tools: get-games (game data), get-records (team records), get-games-teams (team game statistics), get-plays (play-by-play data), get-drives (drive-level analysis), get-play-stats (play statistics), get-rankings (team rankings), get-pregame-win-probability (win probability), and get-advanced-box-score (detailed game statistics and analytics).
On top of raw data access it supports comprehensive statistics and data queries, comparing team performance and generating insights, and ready-made analysis templates for games, teams, trends, and rivalries - for example, asking for the largest upset among FCS games in a given season, or a historical rivalry analysis.
How to install
The quickest path is via Smithery:
npx -y @smithery/cli install cfbd --client claude
To build from source instead: clone the cfbd-mcp-server repository, create a uv virtual environment, activate it, and install with uv pip install -e ., then run the server with uv run cfbd-mcp-server. Configuration in Claude Desktop points the uv command at the server directory and sets the required CFB_API_KEY environment variable. It requires Python 3.11+ and the uv package manager, and ships with comprehensive schema documentation and ready-made analysis prompts.
Who it's for
College football analysts, sports data enthusiasts, and fans who want to query game results, team records, and advanced stats conversationally instead of building raw API queries.
Source README
An MCP server implementation that provides access to college football statistics through the College Football Data API V2. Enables querying game results, team records, player statistics, play-by-play data, and rankings.
Installation
Smithery
npx -y @smithery/cli install cfbd --client claude
From Source
git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server
uv venv
source .venv/bin/activate
uv pip install -e .
Running the Server
uv run cfbd-mcp-server
Configuration
Claude Desktop
{
"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"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
get-games |
Retrieve game data |
get-records |
Get team records |
get-games-teams |
Access team game statistics |
get-plays |
Request play-by-play data |
get-drives |
Analyze drive information |
get-play-stats |
View play statistics |
get-rankings |
Check team rankings |
get-pregame-win-probability |
View win probability forecasts |
get-advanced-box-score |
Access detailed game statistics and analytics |
Features
- Query comprehensive college football statistics and data
- Access game results, team records, and player statistics
- Analyze play-by-play data and drive summaries
- View rankings and win probability metrics
- Compare team performances and generate insights
- Pre-built analysis templates for games, teams, trends, and rivalries
- Support for natural language queries
Environment Variables
Required
CFB_API_KEY- College Football Data API key
Usage Examples
What was the largest upset among FCS games during the 2014 season?
Analyze game performance between two specific teams
Compare team performances across seasons
Analyze historical rivalry matchups
Get detailed analysis of a specific game
Resources
Notes
Requires Python 3.11+ and the UV package manager. The College Football Data API has rate limiting restrictions - the free tier limits requests per minute, while Patreon subscribers receive higher limits. Includes comprehensive schema documentation and ready-to-use analysis prompts.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.