Agent Battle Arena — MCP Server

A turn-based creature battle game where Claude is the player. Claude strategises, picks moves, and renders each turn as a visual React artifact — while the MCP server runs the game engine and opponent AI.

50 creatures. 12 types. 100+ moves. Pixel art sprites. 3 AI difficulties.

Install

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "agent-battle-arena": {
      "command": "npx",
      "args": ["-y", "@codehawks/agent-battle-arena-mcp"]
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop, then say: "Let's battle!"

Claude Code

claude mcp add agent-battle-arena -- npx -y @codehawks/agent-battle-arena-mcp

From source

git clone https://github.com/LouisKnworpsworx/@codehawks/agent-battle-arena-mcp
cd @codehawks/agent-battle-arena-mcp
npm install && npm run build

Then point your MCP config at dist/index.js.

How It Works

You say "Let's battle!" → Claude calls start_battle → gets random creatures
→ calls get_battle_sprites → gets pixel art images → renders React artifact
→ You say a move or "go" → Claude calls make_move → both sides attack
→ artifact updates with new HP, damage, effects → repeat until KO

Claude acts as your champion — reasoning about type matchups, move selection, and strategy. You can coach it ("buff your defense"), override it ("use Overcharge, full send"), or just say "go" and watch it play.

MCP Tools

| Tool | Description | |------|-------------| | start_battle | Start a battle — random creature, choose difficulty | | make_move | Execute a move — resolves both player + opponent turn | | get_battle_sprites | Fetch pixel art sprites for the React artifact | | get_state | Re-read battle state for strategy planning | | list_creatures | Browse all 50 creatures with stats and moves | | get_move_info | Deep-dive on a specific move |

Creatures

50 creatures across 12 types, each with unique stats and 4 moves:

| Type | Creatures | |------|-----------| | Electric | Voltfang, Shockeel, Thundermane, Sparkfly | | Earth | Terraclaw, Boulderback, Dustfang, Quakejaw | | Water | Aquaveil, Tidalfin, Coralguard, Mistweaver, Depthcrawl | | Fire | Pyrothon, Cinderboar, Ashraven, Magmawyrm, Emberfox | | Air | Zephyrix, Stormtalon, Breezepaw, Galewing | | Plant | Thornvine, Bloomfang, Mossback, Fernstrike | | Light | Glimmox, Solarius, Lumidrake, Haloveil | | Shadow | Umbrashar, Duskfang, Grimshade, Voidmoth | | Metal | Ironhide, Steelstrike, Chromajaw, Cogsworth | | Ice | Frostbite, Glacieron, Shiverfin, Rimeclaw | | Poison | Toxispore, Venomaw, Blightroot, Miasmatic | | Plasma | Novablaze, Ionraptor, Pulsegeist, Arcflare |

Features

• 3 AI difficulties — Easy (random), Normal (type-aware), Hard (predictive)
• 12-type effectiveness chart — super effective, not very effective, neutral
• Status effects — burn, freeze, poison, paralysis
• Stat modifiers — attack/defense/speed stages (±4)
• Critical hits — 10% base, some moves boost crit rate
• Move effects — buffs, debuffs, healing, recoil, status infliction
• Pixel art sprites — unique AI-generated art for every creature
• Arena backgrounds — type-themed battle environments
• Best of 3 mode — series battles with score tracking

Type Chart

Electric  → Water, Air          Plant  → Water, Earth
Earth     → Electric, Fire, Metal   Light  → Shadow, Poison
Water     → Fire, Earth         Shadow → Light, Plasma
Fire      → Plant, Ice, Metal   Metal  → Ice, Air
Air       → Plant, Poison       Ice    → Plant, Air, Plasma
Poison    → Plant, Light        Plasma → Metal, Water

License

MIT