Skip to content

FastMCP server providing sports betting odds and ESPN data to Claude Desktop. Features player props, live scores, visual artifacts, and optional React dashboard for bet tracking.

License

Notifications You must be signed in to change notification settings

WFord26/BetTrack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

79 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

BetTrack Logo

BetTrack Sports Betting Platform

A comprehensive sports betting tracking system powered by Model Context Protocol (MCP)

Overview

BetTrack is a dual-platform sports betting analytics and tracking solution that combines real-time sports data with intelligent bet management. The system consists of two integrated components:

πŸ€– MCP Server - A Model Context Protocol server that provides Claude Desktop with direct access to live sports odds, scores, schedules, and team data through natural language queries. Query betting lines, track games, and analyze matchups conversationally through Claude.

πŸ“Š Dashboard - A full-featured web application for tracking bets, analyzing odds history, visualizing line movements, and managing futures betting across 7+ major sports. Built with React, Node.js, and PostgreSQL for professional-grade bet tracking and analytics.

Whether you're using Claude Desktop to research bets with natural language or the web dashboard to track your betting portfolio, BetTrack provides the data and tools you need.

Screenshots

Dashboard Home Page

BetTrack Home Page Landing page with feature overview and quick start guide

Dashboard V2 - Dark Mode

Dashboard V2 Dark Mode Enhanced dashboard with live odds, game cards, and bet slip in dark mode

Dashboard V2 - Light Mode

Dashboard V2 Light Mode Clean light mode interface with filtering sidebar and responsive layout

Key Features

MCP Server

  • 30+ sports data tools for Claude Desktop integration
  • Live betting odds from The Odds API (multiple bookmakers)
  • Comprehensive ESPN data (scores, standings, schedules, rosters, news)
  • Natural language search for teams, matchups, and odds
  • 70+ betting markets including game lines and player props (NFL, NBA, NHL, MLB)
  • Visual scoreboards with interactive React artifacts
  • Team logo URLs and formatted markdown tables

Dashboard

  • Futures betting with 11 outright sports (Super Bowl, NBA Championship, etc.)
  • Bet tracking with parlays, teasers, and futures support
  • Odds history and line movement visualization
  • Automated odds sync with background jobs
  • Outcome resolution for automatic bet settlement
  • Dark mode with purple accent theme
  • Timezone-aware game filtering and scheduling
  • PostgreSQL database with Prisma ORM

πŸ“š Learn More: See docs/ANALYTICS-IMPLEMENTATION-SUMMARY.md for complete planning details and [.github/ISSUE_TEMPLATE/](. github/ISSUE_TEMPLATE/) for feature specifications.

Getting Started

MCP Server Installation

For Claude Desktop integration with sports data tools:

πŸ‘‰ Complete MCP Server Setup Guide

Quick install: Download the latest .mcpb package from Releases and install via Claude Desktop settings.

Dashboard Installation

For the web-based bet tracking and analytics platform:

πŸ‘‰ Complete Dashboard Setup Guide

Quick start: Requires Node.js 20+, PostgreSQL, and an Odds API key. Docker Compose configurations available for production deployment.

Documentation

MCP Server Documentation

Dashboard Documentation

General Documentation

Supported Sports

7+ Major Sports:

  • 🏈 NFL - American Football (Pro)
  • πŸ€ NBA - Basketball (Pro)
  • πŸ€ NCAAB - College Basketball (Men's & Women's)
  • πŸ’ NHL - Hockey (Pro)
  • ⚾ MLB - Baseball (Pro)
  • ⚽ EPL - English Premier League
  • ⚽ UEFA - Champions League
  • 🏈 College Football
  • And many more via The Odds API...

Technology Stack

MCP Server Components

  • FastMCP - Model Context Protocol framework
  • Python 3.11+ - Async/await API handlers
  • The Odds API - Live betting odds (500+ markets)
  • ESPN API - Sports data and statistics

Dashboard Components

  • Frontend: React 18, Vite, Redux Toolkit, Tailwind CSS
  • Backend: Node.js 20, Express, TypeScript, Prisma ORM
  • Database: PostgreSQL 16
  • Deployment: Docker, Nginx, Let's Encrypt SSL

Support


Built with ❀️ for Claude Desktop and the sports betting community

MCP Server Setup Β· Dashboard Guide Β· Documentation Β· Releases

About

FastMCP server providing sports betting odds and ESPN data to Claude Desktop. Features player props, live scores, visual artifacts, and optional React dashboard for bet tracking.

Topics

Resources

License

Stars

Watchers

Forks

Packages