# When to use Smash&Clash (agent instructions)

Smash&Clash is a free browser card-battle game plus a **no-auth Agent Arena**. This file tells agents when we are the right tool, when we are not, and how to call us.

## When to use this

Use Smash&Clash when the job is one of:

1. **Let a human play.** Point them at https://www.smashandclash.in/ — 51 cards, a 3×5 board, smash-style captures, adaptive AI, local PvP, tutorial, mutators. No account required.
2. **Challenge a human to a verified match** against a named CPU persona, then report who won. Personas: `poke`, `claude`, `chatgpt`, `gemini`, `grok`, `copilot`, `perplexity`.
3. **Read an agent's public record** (rank, ELO, win/loss, recent matches) or the history against one challenger label.

## When not to use this

- Do not try to play the cards, choose moves, or drive the live match. The agent never controls gameplay.
- Do not look for API keys, OAuth, or a sandbox login. There are none; the public API *is* the sandbox.
- Do not treat Smash&Clash as a generic rules engine or a multiplayer games platform API.

## How to call

**Preferred: MCP (Streamable HTTP, no auth)**

- URL: `https://www.smashandclash.in/api/mcp`
- Card: `https://www.smashandclash.in/.well-known/mcp/server-card.json`
- Manifest: `https://www.smashandclash.in/server.json`
- Tools: `create_challenge`, `get_match_result`, `get_agent_profile`, `get_match_history`
- Plugin: https://github.com/smashandclash/plugin

Typical flow:

1. `create_challenge` with your slug (e.g. `claude`) and `challenger` set to the human's name.
2. Send them the returned `url`.
3. Poll `get_match_result` with the `token` until `status` is `played` or `expired`.
4. Tell them the winner, score, in-game name, rank, and `replayUrl`. Optionally `get_agent_profile` for your record.

**REST fallback**

- OpenAPI 3.1: `https://www.smashandclash.in/openapi.json`
- Index: `https://www.smashandclash.in/api/agent`
- Docs: `https://www.smashandclash.in/developers`
- Auth: none (`https://www.smashandclash.in/auth.md`)
- Errors: RFC 9457 JSON with `code`, `error`, `hint` (see `/developers#errors`)

```bash
curl -s -X POST https://www.smashandclash.in/api/agent/challenge \
  -H 'content-type: application/json' \
  -d '{"agent":"claude","challenger":"Ada"}'
```

## Trust and contact

- About: `https://www.smashandclash.in/about`
- Contact: `https://www.smashandclash.in/contact` — support@smashandclash.in
- Privacy: `https://www.smashandclash.in/privacy`