# WSDC Points MCP Server

> Free, public, read-only Model Context Protocol (MCP) server for the West Coast Swing WSDC Points Registry: look up any dancer's WSDC points, current division per role (leader/follower), allowed Jack & Jill divisions, level-up history, event results and the official WSDC rules from Claude, ChatGPT, Cursor or any MCP client.

- MCP endpoint (Streamable HTTP, no authentication): https://wcspoints.com/mcp
- Server card: https://wcspoints.com/mcp/server-card
- Website: https://wcspoints.com/
- Source code: https://github.com/akarakotov/wsdc-mcp
- Unofficial; not affiliated with the World Swing Dance Council. Official registry: https://worldsdc.com/registry/

## Connect

- Claude Code: `claude mcp add --transport http wsdc-points https://wcspoints.com/mcp`
- Claude (web/desktop): add a custom connector with the URL https://wcspoints.com/mcp
- Cursor / Windsurf / other clients: `{"mcpServers": {"wsdc-points": {"url": "https://wcspoints.com/mcp"}}}`
- VS Code: `{"servers": {"wsdc-points": {"type": "http", "url": "https://wcspoints.com/mcp"}}}`

## Tools

- `search_dancers`: Find West Coast Swing dancers in the WSDC Points Registry by name or WSDC ID.
- `get_dancer_profile`: Get a dancer's WSDC profile: current division and points per role (Leader/Follower), the Jack & Jill divisions they are allowed to enter in each role, points per division, level-up timeline, and first/last competition dates.
- `get_dancer_results`: List a dancer's WSDC Jack & Jill placements (event, date, division, role, placement, points), most recent first. Totals are computed over all results matching the filters.
- `search_events`: Find WSDC registry events (West Coast Swing conventions with points-awarding Jack & Jill contests) by name, city, year and/or country. Most recent first. Use the event_id with get_event_results.
- `get_event_results`: Get the Jack & Jill placements recorded in the WSDC registry for one event, grouped by division (highest first): placement, role, points awarded, dancer name and WSDC ID.
- `get_recent_levelups`: List dancers who recently moved up to a higher WSDC division (in either role), most recent first, optionally filtered by country and target division.
- `get_division_stats`: Count dancers by current division and role (Leader/Follower), worldwide or for one country, optionally only recently active dancers.
- `search_wsdc_rules`: Search the official WSDC Registry Event Rules (current rulebook) and return the most relevant sections verbatim: division move-up thresholds, points per placement and tier, primary/secondary role rules, contest requirements, age divisions, judging.
- `get_registry_info`: Data coverage and freshness: number of dancers and events, date of the most recent event in the mirror, the rulebook version, and links to the official sources.

## FAQ

### What is the WSDC Points Registry?
The World Swing Dance Council (WSDC) records the results of West Coast Swing Jack & Jill contests held at WSDC Registry Events. Points earned for placements determine which skill division (Newcomer, Novice, Intermediate, Advanced, All-Stars, Champions) a dancer may compete in, separately for the Leader and Follower roles.

### How are WSDC points earned?
By placing in a WSDC Jack & Jill contest. Points depend on the placement and on the contest tier, which is set by the number of competitors in your role: under the 2026.1B rulebook, 1st place earns 3 points in a Tier 1 contest (5–10 competitors) and up to 25 points in a Tier 6 contest (130+ competitors). Larger contests also give points to other finalists.

### How many points do I need to move up a division?
Per the WSDC advancement chart (rulebook 2026.1B, Chart 3): Novice dancers may move up with 16 Novice points and must move up with 30; Intermediate 30 / 45; Advanced 60 / 90; All-Stars 150 / 225. A single point in the next division up also requires moving up. Champions are allowed with 1 Champions point and required with 10. A secondary role has its own chart. Ask the server's search_wsdc_rules tool for the exact wording.

### How do I find my WSDC ID?
Ask your AI assistant to search for your name: the search_dancers tool accepts names in any order, partial names, misspellings and Cyrillic. A WSDC ID is assigned once you earn your first point.

### Is this the official WSDC registry?
No. It is an independent, unofficial mirror of the public WSDC Points Registry, not affiliated with the World Swing Dance Council. The official source is worldsdc.com.

### How up to date is the data?
The mirror is synchronised from the public registry continuously; new results usually appear within about an hour of being published officially.

### Is it free? Do I need an API key?
Free, no sign-up and no API key. The server is read-only and rate-limited for fair use.

### Which AI assistants can use it?
Any client that supports remote MCP servers over Streamable HTTP: Claude (web, desktop and Claude Code), ChatGPT (custom connectors / developer mode), Cursor, VS Code with GitHub Copilot, Windsurf, Zed and others.