get_heroes
Retrieve a complete list of Dota 2 heroes with basic information for game analysis and strategy planning.
Instructions
Get list of all Dota 2 heroes.
Returns:
List of all heroes with basic informationInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/opendota_server/server.py:904-938 (handler)The main handler function for the 'get_heroes' tool. It fetches heroes data from OpenDota API, formats it with details like ID, name, primary attribute, attack type, and roles, and returns a formatted string. Registered via @mcp.tool() decorator.
@mcp.tool() async def get_heroes() -> str: """Get list of all Dota 2 heroes. Returns: List of all heroes with basic information """ heroes_data = await make_opendota_request("heroes") if "error" in heroes_data: return f"Error retrieving heroes data: {heroes_data['error']}" if not heroes_data or not isinstance(heroes_data, list) or len(heroes_data) == 0: return "No heroes data found." # Sort by hero ID sorted_heroes = sorted(heroes_data, key=lambda x: x.get("id", 0)) formatted_heroes = [] for hero in sorted_heroes: hero_id = hero.get("id", 0) name = hero.get("localized_name", f"Hero {hero_id}") primary_attr = hero.get("primary_attr", "Unknown") attack_type = hero.get("attack_type", "Unknown") roles = ", ".join(hero.get("roles", [])) formatted_heroes.append( f"{name} (ID: {hero_id})\n" f"Primary Attribute: {primary_attr}\n" f"Attack Type: {attack_type}\n" f"Roles: {roles}" ) return "Dota 2 Heroes:\n\n" + "\n\n".join(formatted_heroes) - src/opendota_server/server.py:904-904 (registration)The @mcp.tool() decorator registers the get_heroes function as an MCP tool.
@mcp.tool()