OpenDota MCP Server for Windsurf 18 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect OpenDota through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install OpenDota and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"opendota": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* 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.
Windsurf's Cascade agent chains multiple OpenDota tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 18 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
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 Windsurf 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 Windsurf via MCP
Follow these steps to integrate the OpenDota MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using OpenDota
Open Cascade and ask: "Using OpenDota, help me...". 18 tools available
Why Use Windsurf with the OpenDota MCP Server
Windsurf provides unique advantages when paired with OpenDota through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 18 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
OpenDota + Windsurf Use Cases
Practical scenarios where Windsurf combined with the OpenDota MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from OpenDota and generate models, types, or handlers based on real API responses
Live debugging: query OpenDota tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from OpenDota and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine OpenDota data with Cascade's code generation to scaffold entire features in minutes
OpenDota MCP Tools for Windsurf (18)
These 18 tools become available when you connect OpenDota to Windsurf 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 Windsurf
Ready-to-use prompts you can give your Windsurf 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 Windsurf
Common issues when connecting OpenDota to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
OpenDota + Windsurf FAQ
Common questions about integrating OpenDota MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Connect OpenDota with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect OpenDota to Windsurf
Get your token, paste the configuration, and start using 18 tools in under 2 minutes. No API key management needed.