Unofficial WCA MCP Server

An unofficial Model Context Protocol (MCP) server that provides AI assistants with access to World Cube Association (WCA) speedcubing data.

Overview

This unofficial WCA MCP Server enables AI assistants to answer questions about speedcubing, including:

🏆 Current world records and rankings
👤 Competitor profiles and achievements
🏁 Competition information and results
🏅 Championship results and details

Note: This is an unofficial project and is not affiliated with the World Cube Association.

Installation

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

Configuration

Add to your MCP client configuration:

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

Use Cases & Examples / 使用案例和示例

🏆 Query World Records and Rankings

User (English): "What's the current 3x3x3 world record?" AI Response: The current 3x3x3 world record is 3.05 seconds, held by Xuanyi Geng (耿暄一) from China, set at the Shenzhen Cubing 10th Anniversary 2024 competition.

👤 Get Competitor Profiles

User (中文): "告诉我世界纪录保持者的信息" AI Response: 耿暄一（WCA ID: 2023GENG02）来自中国，保持多项纪录。他参加了48场比赛，在三阶、二阶和金字塔等项目中获得15枚金牌、8枚银牌和4枚铜牌。

🗓️ Find Competitions by Date

User (Español): "¿Qué competencias hay el 18 de enero de 2025?" AI Response: Hay 31 competencias programadas para el 18 de enero de 2025, incluyendo eventos en Australia (Geelong Summer 2025), Brasil (Cubo Carioca 2025), Alemania (Franconia Winter 2025), Corea del Sur (Sejong Winter 2025), y muchos otros países.

🎯 Search by Event Type

User (English): "Find competitions with 3x3x3 Blindfolded events" AI Response: Here are upcoming competitions featuring 3x3x3 Blindfolded, including competition dates, locations, and registration details.

🏅 Championship Information

User (中文): "上一届世界锦标赛是什么时候？" AI Response: 最近一届世界锦标赛的详细信息，包括地点、日期、获奖者和破纪录表现。

Available Tools

get_wca_events: Get all official WCA events
get_wca_countries: Get all WCA countries
get_wca_continents: Get all continents
get_person_by_wca_id: Get competitor profile by WCA ID
get_rankings: Get world/regional rankings by event
search_competitions_by_date: Find competitions on a specific date
search_competitions_by_event: Find competitions with a specific event
get_competition_by_id: Get competition details
get_competition_results: Get all results for a competition
get_competition_event_results: Get event-specific results with filtering
search_championships: Search championship competitions
get_championship_details: Get championship details

License

MIT License - see LICENSE file for details.

Unofficial WCA MCP Server