get_competition_results
Retrieve comprehensive speedcubing competition results including solve times, rankings, and round-by-round data from World Cube Association events.
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 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/wca_mcp_server/main.py:400-429 (handler)MCP tool handler function for 'get_competition_results' decorated with @mcp.tool(). It creates a WCAAPIClient instance and calls its get_competition_results method to fetch and return the competition results data.
@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-224 (helper)Core helper method in the WCAAPIClient class that performs the HTTP GET request to the WCA static API endpoint for competition results (results/{competition_id}.json).
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")