Unconfirmed World Cube Association

You run an MCP server that gives AI assistants access to World Cube Association data. This server makes it possible to answer questions about world records, competitors, competitions, and championship results by querying WCA data through a simple, locally hosted Python service.

How to use

You use the server by connecting your MCP client to the local MCP endpoint you start with Python. Once running, you can ask the AI to fetch current world records, retrieve competitor profiles, look up competition details, or query championship results. The server exposes a set of tools that your AI can call to pull up-to-date speedcubing information and return concise, structured answers back to you.

Practical usage patterns include asking for the latest world records, requesting a specific competitor’s achievements, or finding events on a given date. The AI can combine data from multiple endpoints to present a clear answer, such as “Show me the current 3x3x3 world record and its holder,” or “List the results of the upcoming Geelong Summer 2025 competition.”

How to install

Prerequisites: You need Python installed on your system. You will use pip to install the MCP package in editable mode.

Step 1: Clone the project repository.

git clone https://github.com/YuchengMaUTK/unofficial-wca-mcp-server.git
cd unofficial-wca-mcp-server
pip install -e .

Step 2: Start the MCP server. The project runs as a local Python module.

python -m wca_mcp_server

Step 3: Configure your MCP client to connect to this local server. Use the following configuration snippet in your MCP client setup.

{
  "mcpServers": {
    "wca": {
      "command": "python",
      "args": ["-m", "wca_mcp_server"]
    }
  }
}

Notes on configuration and environment

The MCP server is designed to run locally using Python. The configuration snippet shown above demonstrates how to initialize the server from your MCP client by launching the Python module wca_mcp_server.

Additional notes

This is an unofficial project. It provides access to WCA data through an MCP-compliant interface but is not affiliated with the World Cube Association.

Available tools

get_wca_events

Fetches all official WCA events available in the dataset.

get_wca_countries

Retrieves the complete list of countries represented in WCA competitions.

get_wca_continents

Returns the list of continents used for regional classifications.

get_person_by_wca_id

Retrieves a competitor's profile and achievements by their WCA ID.

get_rankings

Gets world or regional rankings for a given event.

search_competitions_by_date

Finds competitions happening on a specific date.

search_competitions_by_event

Finds competitions that feature a specified event.

get_competition_by_id

Retrieves detailed information about a single competition.

get_competition_results

Gets all results for a competition.

get_competition_event_results

Gets event-specific results with optional filtering.

search_championships

Searches championship-level competitions.

get_championship_details

Retrieves detailed information about a championship.