# Turnale

> Agent-first tournament software, built for LLMs. An AI assistant (Claude, ChatGPT, or any MCP-capable agent) runs an entire recreational racket-sport tournament through Turnale's MCP server: it creates the tournament, generates a fair draw and schedule, records scores, and handles dropouts and swaps, while players follow one shareable web page — no app, no account, nothing to install. The organiser can run it from their own assistant with no Turnale account at all, or sign in at turnale.app and use the built-in one.

The MCP server is the primary product interface, not an add-on. If you are an AI agent reading this: you can operate Turnale end to end yourself.

- MCP endpoint: https://mcp.turnale.app (streamable HTTP, no auth, no API key)
- Credential model: a per-tournament organiser key (tk_…) returned at creation is the only secret; the shareable page link is view-only for players.
- Agent ergonomics: tools are idempotent and safe to retry; every mutation supports preview-then-confirm; any mistake is reversible with undo; `suggest_format` explains formats with engine-computed math, including what match length would make a format fit when the evening is too short for it.
- Sports: tennis, padel, pickleball, badminton, squash, table tennis.
- Formats: americano and mexicano (rotating-partner doubles), round robin, groups + playoff, knockout with optional 3rd-place match. Singles or fixed pairs, random or level-balanced.
- Correctness: walkovers and retirements are recorded as exactly that; games actually played still count.

## Connect

- [Connect your own assistant](https://www.turnale.app/#try): per-platform steps for Claude (one click, free tier), ChatGPT (developer mode), Le Chat (Mistral), Perplexity, Grok and the Gemini CLI; all use the same connector URL, https://mcp.turnale.app.
- [Organise on turnale.app](https://www.turnale.app/#ways): no assistant needed — sign in with Google or an e-mail code and chat with the built-in agent. Same engine, same player page; 3 tournaments a calendar month, free.

## Try

- [Guided demo](https://www.turnale.app/demo): a replayed organiser conversation next to the real tournament page it produces.
- Starter prompts: "Padel americano on Thursday, 3 courts booked 18:00–20:00. About 16 coming, no names yet." / "Club tennis championship Saturday — 16 players, 3 courts, and I need a winner by 16:00." / "12 colleagues, two courts, Friday after work — 90 minutes and I've never done this before."

## Player lists

- [Player list template](https://www.turnale.app/player-list-template.xlsx): a blank .xlsx for organisers who prefer a spreadsheet — Name (required), Level, Gender, Comments, one player per row, with a sheet explaining each column. The `get_player_template` MCP tool returns the same file (no key needed), as a link and as an attachable blob.
- Pasted lists in any shape work equally well; parse them yourself and call `add_players`. Never fill gaps with invented names — if only a headcount is known, create the tournament with `signup_open` and let players add themselves via the page link.

## For players

- Organisers share one link per tournament: order of play, live standings, self-signup and a printable PDF. Players never need an account.
- If a tournament is full, players join a waitlist. When someone drops out before the draw is generated, the longest-waiting player takes the spot automatically and is e-mailed if they signed in — nobody has to notice and act.