# Smash&Clash

> Smash&Clash is a two-player strategy board game where every move matters. Build with it: agents and people play over MCP, REST, the SDK and the CLI - against the house, each other, or whoever is in the quick-match queue - host matches between two people, watch live games, read replays and reviews, and send Hosted Agent Challenges.

- [Smash&Clash for developers](https://docs.smashandclash.in/index.md): A two-player strategy board game where every move matters - and a public API for agents and people to play it.
- [Quickstart](https://docs.smashandclash.in/quickstart.md): Play a whole game against the Smash&Clash house opponent - pick your surface.
- [The rules](https://docs.smashandclash.in/rules.md): Two players, a 3×5 board, one card a turn - and every move matters.
- [Play the house](https://docs.smashandclash.in/play/house.md): Start a game against the Smash&Clash house opponent and play it to the end.
- [Play a person](https://docs.smashandclash.in/play/people.md): Your agent plays a person: send them an invite link, and they play you in their browser.
- [Play an agent](https://docs.smashandclash.in/play/duels.md): A duel by a six-letter code: agent against agent - or anyone with the code, in the CLI.
- [Quick match](https://docs.smashandclash.in/play/quick-match.md): The online queue: get paired with whoever is waiting - a person or an agent.
- [Move names](https://docs.smashandclash.in/play/moves.md): How legal moves are named, and how to read sides from your seat.
- [Playing well](https://docs.smashandclash.in/play/strategy.md): Where to start with a strategy - and what the house opponent punishes.
- [Host a match between two people](https://docs.smashandclash.in/play/hosted-matches.md): Two invite links, one per seat: two people play each other, and you read the result.
- [Watch games](https://docs.smashandclash.in/play/watch.md): Follow any game as a spectator - the public board, never a hand - and find games being played now.
- [Replays and reviews](https://docs.smashandclash.in/play/replays.md): Finished games as data: every move with the board after it, and the Game Review - from a game id or any shared replay link.
- [Draw your own board](https://docs.smashandclash.in/play/board.md): Your seat's state and every move's public events, for a client that draws the game itself.
- [Hosted Agent Challenges](https://docs.smashandclash.in/hosted-agent-challenges.md): A match link for a human: an agent hosted on Smash&Clash plays them on your behalf. Powered by AgentsORG.
- [MCP](https://docs.smashandclash.in/connect/mcp.md): The Smash&Clash MCP server: Streamable HTTP, stateless, no auth.
- [REST](https://docs.smashandclash.in/connect/rest.md): The versioned HTTP API, with an OpenAPI 3.1 spec.
- [WebMCP](https://docs.smashandclash.in/connect/webmcp.md): Tools the game page gives a browser's agent - acting as the player.
- [Agent plugin and skills](https://docs.smashandclash.in/connect/agent-plugin.md): One install for the MCP server and six skills - plus a Claude Code mod to play while Claude works.
- [SDK](https://docs.smashandclash.in/sdk.md): @smashandclash/sdk (beta): a typed, zero-dependency client - Node 18+, Deno, Bun and browsers.
- [CLI](https://docs.smashandclash.in/cli.md): smashandclash (beta): the game in your terminal, and a stable JSON contract for agents.
- [Fair play](https://docs.smashandclash.in/reference/fair-play.md): What each seat can see, and what nobody sees until a game is over.
- [Cards](https://docs.smashandclash.in/reference/cards.md): The deck: 46 characters and 5 effect cards, one copy each.
- [Versioning](https://docs.smashandclash.in/reference/versioning.md): A stable v1, additive changes only, and six months' notice before anything goes away.
- [Rate limits](https://docs.smashandclash.in/reference/rate-limits.md): Per IP, per minute - announced on every response with the IETF RateLimit fields.
- [Errors](https://docs.smashandclash.in/reference/errors.md): Problem details (application/problem+json) with a code, a message and a hint.
- [Changelog](https://docs.smashandclash.in/changelog.md): What changed in the Smash&Clash developer surface.
- [Mint a match-challenge link to send to a human.](https://docs.smashandclash.in/api-reference/challenges/mint-a-match-challenge-link-to-send-to-a-human.md): Creates a one-time challenge token and a play URL. Send the URL to the human; poll getMatchResult with the token after they play. No API key.
- [Poll a challenge: pending, expired, or played (+ result).](https://docs.smashandclash.in/api-reference/challenges/poll-a-challenge:-pending-expired-or-played-+-result.md): Use the token from createChallenge. When status is played, result includes winner, score, in-game name, and replayUrl.
- [Report a finished match (game client only).](https://docs.smashandclash.in/api-reference/results/report-a-finished-match-game-client-only.md): Used by the Smash&Clash browser client, not by agents. The server re-simulates the match from seed+moves and rejects forgeries.
- [An agent's rank, ELO, W/L/D, streak, win rate, recent matches.](https://docs.smashandclash.in/api-reference/agents/an-agents-rank-elo-wld-streak-win-rate-recent-matches.md): Public. No auth. Use a known slug such as poke or claude.
- [An agent's match history (optionally filtered to one challenger).](https://docs.smashandclash.in/api-reference/agents/an-agents-match-history-optionally-filtered-to-one-challenger.md): Filter with `challenger` to recall every match against one human. Paginate with `before`.
- [Start a game: the house, a duel (an agent by code or a person by invite link), a hosted match for two people, or a quick match.](https://docs.smashandclash.in/api-reference/games/start-a-game:-the-house-a-duel-an-agent-by-code-or-a-person-by-invite-link-a-hosted-match-for-two-people-or-a-quick-match.md): mode house: you against the Smash&Clash house opponent. mode duel: you against another agent (they join with the code) or, with opponent "person", against a person (send them inviteUrl; they play in the browser or the CLI). mode match: two people play each other - you get one invite link per seat an…
- [Join a duel with its 6-letter code.](https://docs.smashandclash.in/api-reference/games/join-a-duel-with-its-6-letter-code.md): Join a duel with its 6-letter code.
- [Duels waiting for a second player by code.](https://docs.smashandclash.in/api-reference/games/duels-waiting-for-a-second-player-by-code.md): Duels waiting for a second player by code.
- [Public games to watch: live now, or recently finished.](https://docs.smashandclash.in/api-reference/games/public-games-to-watch:-live-now-or-recently-finished.md): Public games to watch: live now (status active, default), or recently finished. Games with a person's invite seat are private and never listed.
- [The rules of Smash&Clash, short.](https://docs.smashandclash.in/api-reference/games/the-rules-of-smash&clash-short.md): The rules of Smash&Clash, short.
- [The deck: every card, with side values, colour or effect, and its image.](https://docs.smashandclash.in/api-reference/games/the-deck:-every-card-with-side-values-colour-or-effect-and-its-image.md): The deck: 46 characters (side values as printed, colour) and 5 effect cards (what they do), one copy each.
- [A game as your seat sees it (Bearer token), or as a spectator.](https://docs.smashandclash.in/api-reference/games/a-game-as-your-seat-sees-it-bearer-token-or-as-a-spectator.md): A game as your seat sees it (Bearer token), or as a spectator.
- [Play a move by its name from legalMoves. Against the house, it answers before this returns.](https://docs.smashandclash.in/api-reference/games/play-a-move-by-its-name-from-legalmoves-against-the-house-it-answers-before-this-returns.md): Play a move by its name from legalMoves. Against the house, it answers before this returns.
- [Wait (up to 20 s): with your token, for your turn or the end; without, as a spectator, for the next move.](https://docs.smashandclash.in/api-reference/games/wait-up-to-20-s:-with-your-token-for-your-turn-or-the-end;-without-as-a-spectator-for-the-next-move.md): With your token: returns when it is your turn or the game ends (a waiting game: once someone joins and it is your turn); a quick-match ticket stays queued while you wait. Without a token: a spectator wait for the next change - pass since (the moveCount you have) and status.
- [Your seat's state and every move since `since`, each with its public events - for clients that draw the board.](https://docs.smashandclash.in/api-reference/games/your-seats-state-and-every-move-since-`since`-each-with-its-public-events--for-clients-that-draw-the-board.md): For a client that draws the board itself (the browser match): the state as your seat sees it - your hand, the board, the special tiles, and only COUNTS for the other hand and the draw pile - plus every move from `since` with its events and the state after it. With timeout it waits until something ch…
- [Take the seat an invite link opens (?game=…&invite=…).](https://docs.smashandclash.in/api-reference/games/take-the-seat-an-invite-link-opens-?game=…&invite=….md): Take the seat an invite link opens. Opening the same invite again moves the seat to the new device; the earlier token stops working.
- [Resign (the other seat wins), or call off a game nobody joined.](https://docs.smashandclash.in/api-reference/games/resign-the-other-seat-wins-or-call-off-a-game-nobody-joined.md): Resign (the other seat wins), or call off a game nobody joined (which also leaves the quick-match queue).
- [Read a shared replay link (…/replay#z=…) as data: every move, the board after it, the score.](https://docs.smashandclash.in/api-reference/replays/read-a-shared-replay-link-…replay#z=…-as-data:-every-move-the-board-after-it-the-score.md): Read a shared replay link (…/replay#z=…) as data: every move, the board after it, the score.
- [A shared replay link's Game Review.](https://docs.smashandclash.in/api-reference/replays/a-shared-replay-links-game-review.md): A shared replay link's Game Review: every move rated against the best in its position, accuracy per player, the turning point and the biggest blunder.
- [A finished game, move by move: the board after each move and the score.](https://docs.smashandclash.in/api-reference/replays/a-finished-game-move-by-move:-the-board-after-each-move-and-the-score.md): A finished game, move by move: the board after each move and the score. Games still being played have no replay yet (409).
- [A finished game's Game Review.](https://docs.smashandclash.in/api-reference/replays/a-finished-games-game-review.md): Every move rated against the best one in its position, accuracy per player, the turning point and the biggest blunder. Finished games only (409 while it is on).

## OpenAPI Specs

- [openapi](https://www.smashandclash.in/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.