How to connect
Turnale is an MCP server your AI assistant connects to. One connector URL works everywhere; connecting your own assistant needs no Turnale account and no API key. Connect once, then run tournaments by talking.
Not sure how? Share that URL with your assistant and ask: “How can I connect turnale.app here?” It will figure out the rest.
Per-platform steps
- Hit “Add to Claude”: the connector arrives pre-filled, nothing to type.
- Approve it once in the dialog. Web, desktop and mobile all pick it up.
- Open a new chat and say what you’re organising.
Once we’re listed in the Claude connector directory this becomes a single search-and-enable.
- Settings → Connectors → Advanced → enable Developer mode.
- Open Plugins, hit the + next to “Search plugins”, paste the connector URL, name it Turnale, no auth. Tick the acknowledgement and Create.
- In a chat, turn Turnale on under the + menu.
- Le Chat → Connectors → Add connector → Custom MCP.
- Paste the connector URL and save.
- Pick Turnale from the connector list in a new conversation.
Mistral requires a paid plan for custom connectors.
- Settings → Connectors → Add connector.
- Choose “Custom (MCP)” and paste the URL.
- Ask in Comet or the app: “run an americano…”.
Custom MCP connectors are a Max-plan feature today.
- Grok → Settings → Connectors → Add MCP server.
- Paste the connector URL, leave auth empty.
- Enable it in the tool tray before you start.
Available on paid Grok plans; behaviour still changes fast on this one.
- Install the Gemini CLI, then: gemini extensions install https://github.com/turnale-app/turnale.
- Or add the URL to your settings.json mcpServers block.
- Run gemini and describe your tournament.
A one-click Gemini app link lands when Google opens custom connectors to the consumer app.
Say this to start
- “Run an americano for 12 players on 3 courts, 2 hours.”
- “Here’s my player list from Excel, levels in the second column.”
- “Jonas can’t come, replace him with Emil from round 3.”
Handing over your players
Paste the names in any shape and your assistant will sort them out — a group-chat dump, numbered, comma-separated. If a spreadsheet suits you better, fill in the player list template (.xlsx) and hand your assistant the file. One player per row: name (the only required column), an optional level on any scale you already use — higher means stronger, and only the order and the gaps within this one tournament matter — an optional gender, which an americano uses to keep both teams in a match the same make-up where the field allows it, and comments in your own words — arrival times, pairing wishes, who is new — which your assistant takes into account when it builds the draw and the schedule. Your assistant can send you the template itself if you ask it for one.
The organiser key
Creating a tournament returns two things: a shareable page link for players and an organiser key (tk_…). The key is the only credential on this route — nothing to register, nothing to remember but the key itself. It cannot be recovered, so keep the message your assistant sent. Anyone with the key can manage the tournament through chat; the page link on its own is safe to share.
Would rather not hold a key? Sign in at turnale.app and use the built-in agent instead — same engine, same player page, and the tournament stays in your account rather than in a message you have to keep.
What your assistant can do
Create a tournament (americano, mexicano, round robin, groups + playoff, or knockout, for tennis, padel, pickleball, badminton, squash and table tennis) · suggest and explain formats with the schedule math done for you · manage the roster or open self-signup with a cap and waitlist · generate a fair draw and schedule · record scores, walkovers and retirements · handle dropouts and substitutions mid-event · undo any mistake · print the tournament PDF · end the evening early with honest final standings.
See it first
The guided demo replays a real organiser’s evening next to the live tournament page it produces. For agents and crawlers, a machine-readable overview lives at /llms.txt.