Chess.com MCP Server

Instructions

Implementation Reference

• src/chess_mcp/server.py:185-207 (handler)

  The MCP tool handler for get_titled_players. Validates the chess title input and makes an API request to Chess.com's titled players endpoint.

  @mcp.tool(description="Get a list of titled players from Chess.com")
  async def get_titled_players(title: str) -> Dict[str, Any]:
      """
      Get a list of titled players from Chess.com.
  
      Args:
          title: Chess title (GM, WGM, IM, WIM, FM, WFM, NM, WNM, CM, WCM)
  
      Returns:
          List of titled players
  
      Raises:
          ValueError: If the title is not valid
      """
      valid_titles = ["GM", "WGM", "IM", "WIM", "FM", "WFM", "NM", "WNM", "CM", "WCM"]
      if title not in valid_titles:
          error_msg = f"Invalid title. Must be one of: {', '.join(valid_titles)}"
          logger.error("Invalid title provided", title=title, valid_titles=valid_titles)
          raise ValueError(error_msg)
  
      logger.info("Fetching titled players", title=title)
      return await make_api_request(f"titled/{title}")