College Football MCP (cfb-mcp)

A Python-based Model Context Protocol (MCP) server that provides real-time college football game information, betting odds, and historical performance data for teams and players.

Features

• Live Game Scores & Odds: Get real-time scores and betting odds for NCAA college football games

• Player Statistics: Retrieve last 5 games' stats for any player

• Team Performance: Get recent game results and team information

• Next Game Odds: Find upcoming games and their betting lines

Quick Start

Prerequisites

• Python 3.11+

• Docker (optional, for containerized deployment)

• API Keys:

  • The Odds API - for live scores and betting odds

  • CollegeFootballData API - for team and player statistics

Installation

1. Clone the repository:

2. Create a virtual environment:

3. Install dependencies:

4. Set up environment variables:

Running the Server

Docker Deployment

Build the Docker image:

Run the container:

For VPS deployment, pull and run:

API Endpoints

The MCP server exposes the following functions:

1. get_game_odds_and_score - Get live game scores and betting odds

2. get_recent_player_stats - Get player's last 5 games statistics

3. get_team_recent_results - Get team's last 5 game results

4. get_team_info - Get team's current season overview

5. get_next_game_odds - Get next game and odds for a team

Development

This project follows the Model Context Protocol standard for AI agent integration.

License

MIT