Content
# 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
```bash
# 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:
```bash
export OPENDOTA_API_KEY=your_api_key_here
```
### Running the server directly
```bash
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:
```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
```bash
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
Connection Info
You Might Also Like
MarkItDown MCP
Python tool for converting files and office documents to Markdown.
Fetch
Model Context Protocol Servers
Filesystem
Model Context Protocol Servers
mcp-on-rails
A Rails application template for bootstrapping Rails + MCP applications
mcp-server
MCP server for interaction with Bitwarden.
neurolink
Universal AI Development Platform with MCP server integration,...