Do I need an API key?

No! OpenDota provides free access with 60,000 requests/hour without any API key. An optional free API key is available from opendota.com for higher rate limits, but it's not required.

How do I find a player's account ID?

Use the search tool with the player's name (e.g. 'Arteezy', 'SumaiL', 'Topson'). The results include their Steam account ID which you can then use with player-specific tools. You can also find account IDs on sites like dotabuff.com or stratz.com.

What data is available for matches?

Match data includes: all 10 players' heroes, items, KDA, GPM, XPM, hero damage, tower damage, healing, lane positions, draft picks, chat logs, team objectives, ability builds and more. Professional matches have even more detailed data including observer ward placements and rune pickups.

How many heroes are in Dota 2?

Dota 2 currently has 124 heroes, each with unique abilities and roles. Use list_heroes to see the complete list with their IDs, names, primary attributes (Strength, Agility, Intelligence, Universal) and roles (carry, support, offlane, mid).

OpenDota MCP Server for AutoGen 18 tools — connect in under 2 minutes

Name: OpenDota
Availability: InStock
Author: Vinkius

microsoft.github.io/autogen/docs/tools/mcp-tools

Built by Vinkius GDPR 18 Tools Framework

Microsoft AutoGen enables multi-agent conversations where agents negotiate, delegate, and execute tasks collaboratively. Add OpenDota as an MCP tool provider through Vinkius and every agent in the group can access live data and take action.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.tools.mcp import McpWorkbench

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with McpWorkbench(
        server_params={"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"},
        transport="streamable_http",
    ) as workbench:
        tools = await workbench.list_tools()
        agent = AssistantAgent(
            name="opendota_agent",
            tools=tools,
            system_message=(
                "You help users with OpenDota. "
                "18 tools available."
            ),
        )
        print(f"Agent ready with {len(tools)} tools")

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About OpenDota MCP Server

Connect to OpenDota and explore the world's most comprehensive Dota 2 match database through natural conversation.

AutoGen enables multi-agent conversations where agents negotiate, delegate, and collaboratively use OpenDota tools. Connect 18 tools through Vinkius and assign role-based access. a data analyst queries while a reviewer validates, with optional human-in-the-loop approval for sensitive operations.

What you can do

Player Profiles — Get player stats, rank tier, MMR estimate, winrate and most played heroes
Match History — Browse a player's full match history with hero, result, KDA and duration
Match Details — Get complete match info including all 10 players, items, builds, damage and objectives
Heroes — List all 124 Dota 2 heroes with their roles, attributes and performance benchmarks
Teams — Discover professional teams with their ratings, rosters and win/loss records
Leagues — Browse all pro leagues and tournaments with tiers and dates
Records — See all-time records for kills, GPM, XPM, hero damage and more
MMR Distribution — View rank tier distribution across the entire Dota 2 player base
Search — Find players, teams and leagues by name

The OpenDota MCP Server exposes 18 tools through the Vinkius. Connect it to AutoGen in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect OpenDota to AutoGen via MCP

Follow these steps to integrate the OpenDota MCP Server with AutoGen.

Install AutoGen

Run pip install "autogen-ext[mcp]"

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Integrate into workflow

Use the agent in your AutoGen multi-agent orchestration

Explore tools

The workbench discovers 18 tools from OpenDota automatically

Why Use AutoGen with the OpenDota MCP Server

AutoGen provides unique advantages when paired with OpenDota through the Model Context Protocol.

Multi-agent conversations: multiple AutoGen agents discuss, delegate, and collaboratively use OpenDota tools to solve complex tasks

Role-based architecture lets you assign OpenDota tool access to specific agents. a data analyst queries while a reviewer validates

Human-in-the-loop support: agents can pause for human approval before executing sensitive OpenDota tool calls

Code execution sandbox: AutoGen agents can write and run code that processes OpenDota tool responses in an isolated environment

OpenDota + AutoGen Use Cases

Practical scenarios where AutoGen combined with the OpenDota MCP Server delivers measurable value.

Collaborative analysis: one agent queries OpenDota while another validates results and a third generates the final report

Automated review pipelines: a researcher agent fetches data from OpenDota, a critic agent evaluates quality, and a writer produces the output

Interactive planning: agents negotiate task allocation using OpenDota data to make informed decisions about resource distribution

Code generation with live data: an AutoGen coder agent writes scripts that process OpenDota responses in a sandboxed execution environment

OpenDota MCP Tools for AutoGen (18)

These 18 tools become available when you connect OpenDota to AutoGen via MCP:

get_benchmarks

Compare any player's stats against the broader player base. Requires a hero ID (from list_heroes). Get hero performance benchmarks

get_constants

Optionally specify a resource name (e.g. "game_mode", "lobby_type", "lane_role", "patch", "cluster") to get a specific constant set. Get OpenDota constant data

get_distributions

Shows how many players are in each bracket (Herald, Guardian, Crusader, Archon, Legend, Ancient, Divine, Immortal). Useful for understanding where a player stands in the overall population. Get MMR and rank distributions

get_match

Returns the match duration, game mode, lobby type, league, radiant/dire team compositions, all 10 players' heroes, items, KDA, GPM, XPM, hero damage, tower damage and healing. Also includes draft picks, chat logs and team objectives for professional matches. Get detailed match info

get_player

Returns the player's profile picture, rank tier, MMR estimate, total matches, winrate and country. Account IDs are numeric Steam IDs (e.g. 87276347 for Arteezy, 19672354 for SumaiL). Use search to find a player by name first. Get player profile and stats

get_player_heroes

Useful for analyzing a player's hero pool and identifying their best heroes. Get a player's performance stats by hero

get_player_matches

Each match includes the match ID, hero played, result (win/loss), kills, deaths, assists, duration, game mode, lobby type, league and start time. Sorted by most recent first. Returns thousands of matches for active players. Get a player's match history

get_player_recent_matches

Each match includes the match ID, hero played, result, KDA, duration and game mode. Useful for checking a player's current form and recent hero pool. Get a player's recent matches (last 20)

get_player_records

Shows the match ID, hero and value for each record. Get a player's personal records

get_player_wl

Shows wins and losses for each hero, revealing their strongest and weakest picks. Useful for understanding a player's hero preferences and strengths. Get a player's win/loss record by hero

get_records

Supported fields: "kills", "deaths", "assists", "last_hits", "denies", "gold_per_min", "xp_per_min", "hero_damage", "tower_damage", "hero_healing", "level", "duration", "longest_word". Returns the top record holders with match IDs and hero info. Get all-time game records

get_team

Returns the team name, tag, logo, rating, win/loss record, player roster, matches played and recent results. Get detailed info for a professional team

list_heroes

Returns approximately 124 heroes. Useful for discovering hero IDs to use with other tools. Get the list of all Dota 2 heroes

list_leagues

Each league includes its ID, name, tier (premium, professional, amateur), region, start/end dates and logo URL. Useful for discovering tournaments and filtering matches by league. Get the list of professional leagues

list_recent_matches

Each match includes the match ID, start time, duration, radiant/dire team average MMR and winner. Returns up to 500 matches. Useful for browsing recent games and finding match IDs to explore. Get recent public matches

list_teams

Each team includes its ID, name, tag, logo URL, rating, number of wins/losses and last match time. Sorted by team rating. Useful for discovering pro teams and their IDs. Get the list of professional teams

run_explorer_query

Requires a valid SQL query string. Returns query results as an array. Advanced feature for deep data analysis. Example: "SELECT hero_id, count(*) matches FROM player_matches GROUP BY hero_id ORDER BY matches DESC LIMIT 10" Run a custom SQL query via OpenDota Explorer

search

Returns matching results with their types and IDs. Useful for finding a player's account ID or a team's ID when you only know their name. Search for players, teams, leagues and heroes

Example Prompts for OpenDota in AutoGen

Ready-to-use prompts you can give your AutoGen agent to start working with OpenDota immediately.

"Search for the player 'Arteezy'."

"Show me all Dota 2 heroes."

"What are the all-time records for most kills in a single match?"

Troubleshooting OpenDota MCP Server with AutoGen

Common issues when connecting OpenDota to AutoGen through the Vinkius, and how to resolve them.

McpWorkbench not found

Install: pip install "autogen-ext[mcp]"

OpenDota + AutoGen FAQ

Common questions about integrating OpenDota MCP Server with AutoGen.

How does AutoGen connect to MCP servers?

Create an MCP tool adapter and assign it to one or more agents in the group chat. AutoGen agents can then call OpenDota tools during their conversation turns.

Can different agents have different MCP tool access?

Yes. AutoGen's role-based architecture lets you assign specific MCP tools to specific agents, so a querying agent has different capabilities than a reviewing agent.