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 OpenAI Agents SDK 18 tools — connect in under 2 minutes

Name: OpenDota
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 18 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect OpenDota through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

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 agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="OpenDota Assistant",
            instructions=(
                "You help users interact with OpenDota. "
                "You have access to 18 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from OpenDota"
        )
        print(result.final_output)

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.

The OpenAI Agents SDK auto-discovers all 18 tools from OpenDota through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries OpenDota, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

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 OpenAI Agents SDK 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 OpenAI Agents SDK via MCP

Follow these steps to integrate the OpenDota MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 18 tools from OpenDota

Why Use OpenAI Agents SDK with the OpenDota MCP Server

OpenAI Agents SDK provides unique advantages when paired with OpenDota through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

OpenDota + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the OpenDota MCP Server delivers measurable value.

Automated workflows: build agents that query OpenDota, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries OpenDota, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through OpenDota tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query OpenDota to resolve tickets, look up records, and update statuses without human intervention

OpenDota MCP Tools for OpenAI Agents SDK (18)

These 18 tools become available when you connect OpenDota to OpenAI Agents SDK 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 OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK 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 OpenAI Agents SDK

Common issues when connecting OpenDota to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

OpenDota + OpenAI Agents SDK FAQ

Common questions about integrating OpenDota MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.