get_competition_results
Retrieve comprehensive competition results from the World Cube Association, including event outcomes, competitor performances, rankings, and solve details for any WCA competition.
Instructions
Get all results for a WCA competition.
Returns comprehensive results data for all events in a competition, including competitor performances, solve breakdowns, round information, and final rankings. This provides complete competition outcome data.
Args: competition_id: WCA competition ID (e.g., "WC2023", "CubingUSANationals2024")
Returns: Complete results data for all events in the competition including: - Individual solve times and averages - Round-by-round progression - Final rankings and positions - DNF/DNS information - Competitor details
Example: get_competition_results("WC2023") - All results from World Championship 2023
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| competition_id | Yes |
Implementation Reference
- src/wca_mcp_server/main.py:400-430 (handler)MCP tool handler for get_competition_results: decorated with @mcp.tool(), uses WCAAPIClient to fetch results from WCA API.@mcp.tool() async def get_competition_results(competition_id: str) -> Dict[str, Any]: """Get all results for a WCA competition. Returns comprehensive results data for all events in a competition, including competitor performances, solve breakdowns, round information, and final rankings. This provides complete competition outcome data. Args: competition_id: WCA competition ID (e.g., "WC2023", "CubingUSANationals2024") Returns: Complete results data for all events in the competition including: - Individual solve times and averages - Round-by-round progression - Final rankings and positions - DNF/DNS information - Competitor details Example: get_competition_results("WC2023") - All results from World Championship 2023 """ try: async with WCAAPIClient() as client: results_data = await client.get_competition_results(competition_id) return results_data except APIError as e: raise Exception(f"Failed to get results for competition {competition_id}: {e}") except Exception as e: raise Exception(f"Unexpected error getting results for competition {competition_id}: {e}")
- src/wca_mcp_server/client.py:212-225 (helper)WCAAPIClient helper method that performs the HTTP request to fetch competition results from the static WCA API endpoint.async def get_competition_results( self, competition_id: str ) -> Dict[str, Any]: """Get all results for a competition. Args: competition_id: Competition ID Returns: All result data for the competition """ return await self._make_request(f"results/{competition_id}.json")