How do I install the cfbd mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `CFB_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Cfbd MCP Server

This Model Context Protocol (MCP) server enables AI assistants and applications to:

Local serverstdioPython

What is the Cfbd MCP Server?

This Model Context Protocol (MCP) server enables AI assistants and applications to:

Configuration

Python 3.11 or higher - UV package manager (recommended) - A College Football Data API key (get one here)

Recorded tools

get-games — Retrieve game data
get-records — Get team records
get-games-teams — Access team game statistics
get-plays — Query play-by-play data
get-drives — Analyze drive information
get-play-stats — View play statistics
get-rankings — Check team rankings
get-pregame-win-probability — See win probabilities
get-advanced-box-score — Access detailed game statistics and analytics

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get-games	Retrieve game data
get-records	Get team records
get-games-teams	Access team game statistics
get-plays	Query play-by-play data
get-drives	Analyze drive information
get-play-stats	View play statistics
get-rankings	Check team rankings
get-pregame-win-probability	See win probabilities
get-advanced-box-score	Access detailed game statistics and analytics

How to install the Cfbd MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Python 3.11 or higher - UV package manager (recommended) - A College Football Data API key (get one here)

Variable	Description	Required
CFB_API_KEY	Declared in the maintainer’s client configuration.	Check documentation
PATH	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Cfbd to get-games.”
“Use Cfbd to get-records.”
“Use Cfbd to get-games-teams.”

Frequently asked questions

This Model Context Protocol (MCP) server enables AI assistants and applications to: Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.