Opendota MCP Server

🚀 OpenDota MCP Server

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

🚀 Quick Start

The OpenDota MCP Server allows seamless access to Dota 2 data for LLMs and AI assistants. Below are the installation and usage guides.

✨ Features

• Access player profiles, statistics, and match histories.
• Retrieve detailed match information.
• Find professional players and teams.
• Obtain hero statistics and rankings.
• Search for players by name.
• And many more features!

📦 Installation

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

# Option 1: Automatic setup (for bash, zsh, etc. shells)
./scripts/setup_env.sh

# Option 2: Manual installation using uv tool
uv add pyproject.toml

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

💻 Usage Examples

Configure the 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

Run the Server Directly

python -m src.opendota_server.server

Run the Server with Claude Desktop

Refer to this link: https://modelcontextprotocol.io/quickstart/user

If you are using WSL, assuming you have cloned the repository and set up the Python environment, you can write the claude_desktop_config.json like this:

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

Use the Example Client

python -m src.client

Specific Tools Included:

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

📄 License

MIT