E220

README excerpt

# Clash Royale MCP — Mistral AI Hackathon 2025

An agent plays against you via MCP in split-screen: the UI on the left, a chat with the MCP agent on the right, and the whole match is driven in natural language.

![Game Arena](imgs/Screenshot%202025-09-14%20at%2012.06.22.png)
![Main Menu](imgs/Screenshot%202025-09-14%20at%2012.06.44.png)

Built September 13–14, 2025 at La Maison, Paris.

## Idea

Enable anyone to play live against an agent without pre-training. The LLM reasons over a structured game state, calls bounded tools, and acts in real time. Many concurrent matches run independently, each with its own room.

## User Flow

Open the UI (Vercel) and Le Chat connected to the MCP. Ask to create or join a match to obtain a `game_id`, then say “GO”. The agent reads the state, deploys troops, sends emotes, and explains its moves in short, dry comments. You keep playing in the UI while chatting. Say “STOP” to halt or “RESET” to start fresh. The exact loop and guardrails are documented in Prompt.md.

## What the Agent Can Do

The MCP server exposes tools for match lifecycle and gameplay. Core ones:

* `create_game`, `join_game`
* `get_game_status`
* `spawn_troop`
* `trigger_emote`
* `list_games`

## Example Dialogue (condensed)

**You :**
Hey Le Chat, Let's play Clash Royale together!


**Agent:**
Hey, with pleasure, I started a game, go on *mcp-hackthon.vercel.app* and connect to the game with the game_id:
game_id = c084e558-202c-4a37-9524-b8155798d8b2
When you are ready, say "