home / mcp / wagyu sports mcp server

Wagyu Sports MCP Server

Provides access to sports data and odds via The Odds API for Claude and other MCP assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hrgarber-wagyu_mcp_hackathon": {
      "command": "python",
      "args": [
        "/absolute/path/to/wagyu_mcp_hackathon/wagyu_sports/mcp_server/test_server.py",
        "--test-mode"
      ],
      "env": {
        "ODDS_API_KEY": "your_api_key_here"
      }
    }
  }
}

You run a dedicated MCP server that exposes sports betting data through The Odds API to Claude and other MCP-compatible assistants. It provides a simple way to fetch available sports and odds, with an easy test mode for learning and demos.

How to use

Connect to Wagyu Sports MCP Server from your MCP client (for example Claude or a local client). Use test mode during initial exploration so you work with mock data and avoid API limits. In test mode, you do not need an API key and you’ll receive consistent responses to understand how to request sport lists, odds, and quota information.

How to install

Prerequisites you need before installation are Python 3.8+ and a working Python environment with access to install packages.

Step 1: Clone the project repository.

Step 2: Install in development mode.

# Clone the repository
git clone https://github.com/your-username/wagyu_mcp_hackathon.git
cd wagyu_mcp_hackathon

# Install in development mode
pip install -e .

# Alternatively, install with uv if you prefer
uv install -e .

Step 3: Add the MCP configuration for your MCP client. You will add two stdio configurations so you can run the server from Claude or from a local client.

{
  "mcpServers": {
    "wagyu_sports_cline": {
      "type": "stdio",
      "name": "wagyu_sports_cline",
      "command": "python",
      "args": ["/absolute/path/to/wagyu_mcp_hackathon/wagyu_sports/mcp_server/test_server.py", "--test-mode"],
      "env": {
        "ODDS_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    },
    "wagyu_sports_claude": {
      "type": "stdio",
      "name": "wagyu_sports_claude",
      "command": "python",
      "args": ["/absolute/path/to/wagyu_mcp_hackathon/wagyu_sports/mcp_server/test_server.py", "--test-mode"],
      "env": {
        "ODDS_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Additional notes

Test mode uses mock data suitable for development, demos, and getting familiar with the server’s endpoints (get_sports, get_odds, get_quota_info). Real mode switches to live data by removing the --test-mode flag and providing a valid API key.

To run in real mode from the command line, use the same server script without the test flag and supply your Odds API key via the environment variable ODDS_API_KEY.

Available tools

get_sports

Returns a list of available sports for which odds can be retrieved.

get_odds

Fetches odds for a specific sport, including market types and outcomes.

get_quota_info

Provides current API quota information and usage.