CFBD API

CFBD API

An MCP server for the College Football Data API.

22
Stars
13
Forks
0
Releases

Overview

The College Football Data MCP Server is an MCP server implementation that exposes data from the College Football Data API v2 through an MCP interface, enabling AI assistants and applications to query comprehensive college football statistics in natural language. It supports access to game information and scores, team season records, detailed team game data, play-by-play data, drive summaries, and individual play statistics, as well as rankings and win-probability metrics. The server exposes endpoints such as schema://games, schema://records, schema://plays, schema://drives, schema://play/stats, schema://rankings, and schema://metrics/wp/pregame, plus schema://game/box/advanced for advanced statistics. It includes resources, tools, and prompts for analysis (e.g., analyze-game, analyze-team, analyze-trends, compare-teams, analyze-rivalry), and is designed to integrate with Claude Desktop via configuration examples showing how to run uv, supply API keys, and connect the server. The README covers installation, updates, troubleshooting, and development structure to support ongoing development and usage.

Details

Owner
lenwood
Language
Python
License
MIT License
Updated
2025-12-07

Features

Schema endpoints documentation

Access schema documentation for endpoints such as games, records, plays, drives, play stats, rankings, and metrics.

Direct query tools

Query endpoints directly (get-games, get-records, get-plays, get-drives, get-play-stats, get-rankings, get-pregame-win-probability, get-advanced-box-score).

Pre-built prompts

Prompts like analyze-game, analyze-team, analyze-trends, compare-teams, and analyze-rivalry for quick analyses.

Pregame win probability and rankings

Access pregame win-probability metrics and team rankings across polls via dedicated schema endpoints.

Advanced statistics and box scores

Retrieve advanced box score statistics and other detailed game analytics via schema endpoints.

Play-by-play and drive data

Get play-by-play information and drive summaries to support in-depth game analysis.

Claude Desktop integration

Provides configuration and workflows to run the MCP server with Claude Desktop, including uv commands and environment setup.

API usage guidance

Includes guidance on API rate limits, Patreon-backed limits, caching considerations, and best practices.

Audience

AI assistantsQuery college football data in natural language within AI assistant conversations.
DevelopersIntegrate CFBD data into apps and workflows via MCP endpoints.
Software teamsEnable data-backed insights and analytics within applications using the MCP server.

Tags

college footballCFBD APIMCPClaude Desktopplay-by-playrankingswin probabilitybox scoregame datadrive summariesteam statisticsAPI integration