WSDC Points MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Unofficial, read-only access to the World Swing Dance Council (WSDC) Points Registry for West Coast Swing (WCS) Jack & Jill competitions: ~27,000 dancers and ~8,000 events since the 1990s.
How to use:
Dancers are identified by their WSDC ID. If the user gives a name, call search_dancers first, then get_dancer_profile / get_dancer_results with the ID. Names may be typed in any order ("First Last" or "Last, First"); Cyrillic is transliterated; misspellings fall back to fuzzy matching.
"What division can X dance?" -> get_dancer_profile:
allowed_divisionsper role already applies WSDC rules (primary/secondary role rules, move-up thresholds). Do not recompute them.Skill divisions, low to high: Newcomer, Novice, Intermediate, Advanced, All-Stars, Champions. Points also exist in age/other divisions (Masters, Sophisticated, Juniors, ...).
Registry dates have month precision: the day of month is always 01.
Rules questions (points per placement, move-up thresholds, tiers, dancing in a secondary role) -> search_wsdc_rules, and quote the rulebook version in the answer.
Data mirrors the public registry and is refreshed regularly, but the official source is worldsdc.com; mention that for anything consequential (e.g. contest registration disputes).
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_dancersA | Find West Coast Swing dancers in the WSDC Points Registry by name or WSDC ID. Returns WSDC ID, country, primary role and current division for each match, most recently active dancers first. Use the WSDC ID with the other dancer tools. |
| get_dancer_profileB | 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_resultsA | 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_eventsA | 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_resultsA | 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_levelupsA | 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_statsA | Count dancers by current division and role (Leader/Follower), worldwide or for one country, optionally only recently active dancers. |
| search_wsdc_rulesA | 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_infoA | 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
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| wsdc-rules | Full text of the current WSDC Registry Event Rules (plain text extracted from the PDF). |
TDQS
Scored across 9 tools
Each tool targets a clearly distinct entity/action pair: dancer search vs. dancer profile vs. dancer results, and event search vs. event results. The descriptions explicitly cross-reference which tool to use next (e.g., 'Use the WSDC ID with the other dancer tools'), leaving no realistic chance of misselection.
All nine tools follow a strict snake_case verb_noun pattern using only two verbs (search_/get_) matched to the correct semantics. No camelCase, no vague verbs like 'process' or 'handle'.
Nine tools is well within the ideal 3-15 range and each maps to a distinct query type (search, profile, results, stats, level-ups, rules, metadata). No filler or redundant tools are present.
The read-only registry domain is well covered: entity search, detail views, results, aggregate stats, level-up tracking, rules lookup, and data freshness metadata. Minor gaps exist (e.g., no cross-dancer comparison or points-to-next-division projection), but agents can work around them by combining existing tools.