WCS Points · documentation

Using WCS Points with your AI assistant

Setup, what to ask, tools, and troubleshooting

WCS Points is a free, read-only MCP server for the West Coast Swing WSDC Points Registry. Once connected, your AI assistant can look up any dancer's points and divisions per role, results, finals partners, event history, recent level-ups and the official rules. No account, no sign-up, no authentication.

1. Connect

Server URL (Streamable HTTP, no authentication):

https://wcspoints.com/mcp?via=docs

Claude (web, desktop, mobile)

Settings → Connectors → Add custom connector. Name: WCS Points, URL: the one above. In a chat, make sure the connector is switched on (the “+” / tools menu).

ChatGPT

Settings → Apps & Connectors → Advanced → enable developer mode, then create a connector with the URL above and no authentication.

Claude Code

claude mcp add --transport http wsdc-points https://wcspoints.com/mcp?via=docs

Cursor · VS Code

Add to Cursor Install in VS Code

2. Ask in plain words

Names can be typed in any order, partially, misspelled or in Cyrillic; a WSDC ID is always exact.

Dancers and divisions

“What divisions can Kyle Redd dance as a leader?”
“How many points does WSDC #12345 need for the next level?”
“Show my results from 2025. My name is <your name>.”

Partners and events

“Who did Tatiana Mollmann make Jack & Jill finals with most often?”
“Who won the Champions Jack & Jill at the US Open each year?”
“Show the All-Stars results of the latest Swing Diego.”

News and statistics

“What's new in the WSDC registry this week?”
“Who moved up to Advanced in Germany in the last 3 months?”
“How many active Intermediate followers are there in France?”

Rules

“How many points does 1st place earn in a Tier 3 Novice contest?”
“Can I dance Advanced as a follower if I am All-Stars as a leader?”

3. Tools, prompts and the dancer card

All tools are read-only and return structured data.

`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_jj_partners`	Who a dancer was placed with in Jack & Jill finals: each placement (1st to 5th) with the partner, most recent first, and the partners they placed with most often. The registry does not record couples; a final places couples, so the partner is the dancer of the other role who took the same place in the same division.
`get_event_history`	Every edition of a WSDC event series in the registry (for example each year's US Open), most recent first, with the winners (or the top placements) of each division or of one division. Also lists other event series that matched the query.
`get_registry_updates`	Events whose results were published in the WSDC registry in the last days, most recent first: event, when the results appeared, divisions held, and the winners of the highest division. Pair with get_recent_levelups for dancers who moved up.
`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.

Prompts

Ready-made requests, shown as slash commands or a prompt menu in clients that support them; their dancer, event, country and division fields autocomplete from the registry.

`divisions_check`	Which divisions can I dance? — Which Jack & Jill divisions a dancer may enter in each role, and what is missing for the next level.
`dancer_story`	A dancer's competition story — First points, level-ups, best results, favourite events and most frequent finals partners.
`event_story`	History of an event — Winners of an event year by year, and who won it more than once.
`registry_news`	What's new in the registry — Results published in the last two weeks and the dancers who moved up.
`rules_question`	Ask about the WSDC rules — Answer a question from the official WSDC Registry rulebook.

Interactive dancer card

In apps that support MCP Apps (for example Claude and ChatGPT), a dancer's profile is shown as a card with the divisions they may enter, points per division and level-ups for each role, plus buttons for their results, finals partners and this website's page.

4. Troubleshooting

The assistant answers without using WCS Points

Check that the connector is enabled in this chat, and mention WSDC or WCS Points in the question (“Using WCS Points, …”). Start a new chat after adding the connector.

The connector cannot connect

The URL must be exactly https://wcspoints.com/mcp (an optional ?via=… is fine), with no authentication and the Streamable HTTP transport. Some company networks block new domains; try another network. Opening the URL in a browser redirects here, which is expected.

A dancer is not found

Only dancers with at least one WSDC point are in the registry. Try the WSDC ID, the last name alone, or another spelling; the server also suggests close matches.

Divisions or points look different from what I expected

Divisions are computed from the registry with the WSDC rules (including primary and secondary roles). Ask “quote the WSDC rule” to see the rulebook text. The official record is the WSDC Points Registry; corrections must be requested from the WSDC.

Support

Questions, bugs and data issues: info@wcspoints.com or an issue on GitHub. See also the privacy policy and the terms of use.