OpenDota MCP Server

What is OpenDota MCP Server about?

OpenDota MCP Server implements a Model Context Protocol (MCP) service that exposes the OpenDota REST API as a set of standardized tools. It enables language models and AI assistants to fetch up‑to‑date Dota 2 data—including player stats, match details, hero rankings, and professional match information—through simple function calls.

How to use OpenDota MCP Server?

1. Clone the repository

   git clone https://github.com/asusevski/opendota-mcp-server.git
   cd opendota-mcp-server
   

2. Set up the environment (choose one)
   • Automated script: ./scripts/setup_env.sh
   • Manual with uv: uv add pyproject.toml && uv pip install -e ".[dev]"
3. Provide an OpenDota API key (optional but recommended)

   export OPENDOTA_API_KEY=your_api_key_here
   

4. Run the server

   python -m src.opendota_server.server
   

5. Consume the tools either via the built‑in example client (python -m src.client) or by integrating the MCP endpoint into your own LLM workflow.

Key features of OpenDota MCP Server

• Retrieve player profiles, recent matches, win/loss records, hero usage and rankings.
• Access detailed match data, including hero line‑ups and in‑game statistics.
• Query professional players, teams, and recent pro matches.
• Search players by name and obtain peer connections.
• Get static hero list and aggregated hero statistics.
• Expose all functionality as MCP tools (e.g., get_player_by_id, get_match_data, search_player).

Use cases of OpenDota MCP Server

• AI‑powered game assistants that can answer player‑specific questions during a match.
• Chatbot integrations for Dota 2 communities to provide on‑the‑fly stats.
• Data‑driven analytics dashboards that pull live data through a uniform MCP interface.
• Research projects analyzing hero meta‑trends or player performance over time.
• Automated reporting for esports teams and tournament organizers.

FAQ from the OpenDota MCP Server

Q: Do I need an OpenDota API key?

• No, the server works without a key but is rate‑limited. Providing a key removes limits and ensures reliable access.

Q: Which Python version is required?

• The project targets Python 3.10+ (as defined in pyproject.toml).

Q: How do I run the server on WSL for Claude Desktop?

• Create a claude_desktop_config.json that launches the server via wsl.exe as shown in the README.

Q: Can I develop or extend the server?

• Yes. Install development dependencies (uv pip install -e ".[dev]") and modify the tools in src/opendota_server.

Q: Where are the MCP tool definitions?

• They reside in src/opendota_server/tools.py and are automatically loaded by the MCP framework when the server starts.

OpenDota MCP Server

A Model Context Protocol (MCP) server implementation for accessing OpenDota API data. This server enables LLMs and AI assistants to retrieve real-time Dota 2 statistics, match data, player information, and more through a standard interface.

Features

• Access player profiles, statistics, and match history
• Retrieve detailed match information
• Look up professional players and teams
• Get hero statistics and rankings
• Search for players by name
• And more!

Installation

# Clone the repository
git clone https://github.com/asusevski/opendota-mcp-server.git
cd opendota-mcp-server

# Option 1: Automated setup (works with bash, zsh, and other shells)
./scripts/setup_env.sh

# Option 2: Manual installation with uv
uv add pyproject.toml

# For development dependencies
uv pip install -e ".[dev]"

Usage

Setting up your environment

1. (Optional but recommended) Create an OpenDota API key at https://www.opendota.com/api-keys
2. Set your API key as an environment variable:

export OPENDOTA_API_KEY=your_api_key_here

Running the server directly

python -m src.opendota_server.server

Running the server with Claude Desktop

Follow this: https://modelcontextprotocol.io/quickstart/user

If you use WSL, assuming you have cloned the repo and set up the python environment, this is how I wrote the claude_desktop_config.json:

{
  "mcpServers": {
    "opendota": {
      "command": "wsl.exe",
      "args": [
        "--",
        "bash",
        "-c",
        "cd ~/opendota-mcp-server && source .venv/bin/activate && python src/opendota_server/server.py"
      ]
    }
  }
}

Using the example client

python -m src.client

Specific tools included:

• get_player_by_id - Retrieve player information by account ID
• get_player_recent_matches - Get recent matches for a player
• get_match_data - Get detailed data for a specific match
• get_player_win_loss - Get win/loss statistics for a player
• get_player_heroes - Get a player's most played heroes
• get_hero_stats - Get statistics for heroes
• search_player - Search for players by name
• get_pro_players - Get list of professional players
• get_pro_matches - Get recent professional matches
• get_player_peers - Get players who have played with a specified player
• get_heroes - Get list of all Dota 2 heroes
• get_player_totals - Get player's overall stats totals
• get_player_rankings - Get player hero rankings
• get_player_wordcloud - Get most common words used by player in chat
• get_team_info - Get information about a team
• get_public_matches - Get recent public matches
• get_match_heroes - Get heroes played in a specific match

License

MIT