What is Opendota Mcp Server

OpenDota MCP Server is an implementation of the Model Context Protocol (MCP) that allows access to OpenDota API data. It enables LLMs and AI assistants to retrieve real-time Dota 2 statistics, match data, player information, and more through a standardized interface.

Use cases

Use cases for OpenDota MCP Server include developing AI assistants that provide Dota 2 insights, creating applications that analyze player performance, and building tools for professional players to track their statistics and matches.

How to use

To use OpenDota MCP Server, first clone the repository and set up your environment. Optionally, create an OpenDota API key and set it as an environment variable. You can run the server directly using Python or configure it with Claude Desktop. Additionally, an example client is provided for testing various functionalities.

Key features

Key features include access to player profiles, statistics, and match history; retrieval of detailed match information; lookup of professional players and teams; hero statistics and rankings; and searching for players by name.

Where to use

undefined

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