Unofficial WCA MCP Server

Instructions

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")