MCP.so
Sign In

College Football Data MCP Server

@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

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

9

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.

Where can I get help if issues arise?

Open a GitHub issue, review the API documentation at apinext.collegefootballdata.com, or check the College Football Data Discord server.

Frequently asked questions

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.

Where can I get help if issues arise?

Open a GitHub issue, review the API documentation at apinext.collegefootballdata.com, or check the College Football Data Discord server.

Comments

Basic information

Category

Data & Analytics

License

MIT

Transports

stdio

Author

lenwood

More Data & Analytics MCP servers

PubMed Analysis MCP Server

Darkroaster

A PubMed MCP server.

150

Bright Data MCP

brightdata

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K

Rankbits

rankbits

AI visibility analytics across 15+ providers (ChatGPT, Perplexity, Gemini, AI Overviews, and more). The MCP connector lets assistants run scans, compare competitor mentions, and track your brand's visibility in AI answer

Sugra API MCP

Sugra Systems, Inc.

Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl

1

Salesforce MCP Server

tsmztech

Salesforce MCP Server

161