home

BetTrack - Documentation Wiki

Welcome to the BetTrack documentation! Complete sports betting data platform combining MCP server for Claude Desktop with optional web dashboard for bet tracking and line movement analysis.

🚀 Quick Links

• Quick Start Guide - Get up and running in 5 minutes
• Getting API Key - Obtain your free Odds API key
• Installation Guide - Detailed installation instructions
• API Documentation - Complete API reference

� Screenshots

Dashboard Home Page

Landing page with feature overview and quick start guide

Dashboard V2 - Dark Mode

Enhanced dashboard with live odds, game cards, and bet slip in dark mode

Dashboard V2 - Light Mode

Clean light mode interface with filtering sidebar and responsive layout

�📚 Component Guides

• MCP Server Guide - Architecture, tools, and development
• Dashboard Guide - Full-stack React app for bet tracking
• Database Guide - Schema, migrations, and queries
• Developer Guide - Contributing workflow and standards

📊 What is BetTrack?

BetTrack is a dual-platform sports betting data system:

🤖 MCP Server (Claude Desktop)

Natural language queries for sports data:

• Live betting odds from 10+ bookmakers
• Real-time scores and game results
• Team stats and standings
• Player props (70+ markets)
• Line movement tracking
• ESPN integration (schedules, news, rosters)

🌐 Web Dashboard (Optional)

Full-featured bet tracking platform:

• Bet slip management with Redux state
• Line movement charts with Recharts
• Bet history and performance tracking
• Automated outcomes resolution
• Multi-sport support (NFL, NBA, NHL, MLB, Soccer)
• Background jobs for odds syncing

🔌 Data Sources

The Odds API

• Current and upcoming game odds
• Multiple betting markets (moneyline, spreads, totals)
• Live score tracking
• Natural language team/matchup search
• Free tier available at the-odds-api.com

ESPN API

• Live scoreboards with real-time updates
• Team details, rosters, and logos
• League standings and rankings
• Game schedules and results
• Sports news and articles
• Player information
• No API key required

🏆 Supported Sports

Sport	Odds API	ESPN API	Team Logos
NFL - American Football	✅	✅	✅
NBA - Basketball	✅	✅	✅
NHL - Hockey	✅	✅	✅
MLB - Baseball	✅	✅	⚠️
College Football	✅	✅	⚠️
College Basketball	✅	✅	⚠️
Soccer (Multiple leagues)	✅	✅	⚠️

✅ Full support | ⚠️ Partial support

🚀 Getting Started

1. Installation

# Download the latest .mcpb package from Releases
# Install via Claude Desktop: Settings → Developer → Install MCP Package

2. Configuration

# Create .env file with your Odds API key
ODDS_API_KEY=your_api_key_here

3. Start Using

Ask Claude natural language questions:

• "What are the current odds for Lakers vs Warriors?"
• "Show me today's NFL schedule"
• "Get the NBA standings"

📚 Documentation Sections

For New Users

• Installation Guide - Step-by-step setup instructions
• Configuration Guide - Environment variables and settings
• Usage Examples - Common queries and use cases

For Developers

• API Tools Reference - Complete tool documentation
• Building from Source - Development setup
• Contributing Guide - How to contribute

Reference

• Supported Sports List - All available sports and leagues
• Team Reference Tables - NFL/NBA/NHL team IDs and abbreviations
• FAQ - Frequently asked questions
• Troubleshooting - Common issues and solutions

🎨 Output Formats

Sports Data MCP provides multiple output formats:

ASCII Art Cards

Beautiful, instant-display matchup cards with team info, odds, and broadcast details:

┌────────────────────────────────────────────────────────────────┐
│                                                                │
│                            MATCHUP                             │
│                                                                │
├────────────────────────────────────────────────────────────────┤
│                                                                │
│              Los Angeles Lakers  vs  Boston Celtics            │
│                                                                │
│                          110  -  105                           │
│                                                                │
│                   Wed, Jan 08 @ 07:30 PM                       │
│                                                                │
│                         📺 ESPN, TNT                           │
│                                                                │
└────────────────────────────────────────────────────────────────┘

Formatted Tables

Clean, structured data in table format for easy reading:

• Scoreboards with live scores
• League standings
• Odds comparison across bookmakers

Structured JSON

Complete data for integration with other tools and services.

🔧 Key Features

Natural Language Search

No need to know sport keys or team IDs - just ask:

• "Find odds for the next Patriots game"
• "Lakers game today"
• "NFL scores"

Multiple Bookmakers

Compare odds from:

• DraftKings
• FanDuel
• BetMGM
• Bovada
• BetOnline
• And more...

Real-Time Data

• Live game scores
• Up-to-date betting lines
• Current standings
• Latest news

Team Logos

High-resolution team logos from ESPN CDN (500px PNGs) for all NFL, NBA, and NHL teams.

📖 Tool Categories

Odds & Betting Tools (6 tools)

• Get available sports
• Get odds for games
• Get live scores
• Search by team name
• Compare bookmaker odds
• Get event-specific odds

ESPN Tools (8+ tools)

• Scoreboards
• Team information
• League standings
• Game schedules
• News and articles
• Player data
• Game summaries

Formatted Output Tools (7 tools)

• Matchup cards with ASCII art
• Formatted scoreboards
• Standings tables
• Odds comparison tables
• Team reference lookup

🆘 Need Help?

• Issues? Check the Troubleshooting guide
• Questions? See the FAQ
• Bugs? Report on GitHub Issues

License

This project is licensed under the MIT License. See the LICENSE file for details.

🤝 Contributing

Contributions are welcome! See the Contributing Guide for details.

---

Version: 0.1.10
Author: William Ford
Repository: github.com/WFord26/BetTrack