{"_id":"@codehawks/agent-battle-arena-mcp","_rev":"2-9634592e4d022538b3cda775b497d467","name":"@codehawks/agent-battle-arena-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@codehawks/agent-battle-arena-mcp","version":"1.0.0","keywords":["mcp","mcp-server","claude","battle","game","ai","agent","creature","pixel-art","turn-based","anthropic"],"license":"MIT","_id":"@codehawks/agent-battle-arena-mcp@1.0.0","maintainers":[{"name":"codehawks","email":"louiswharmby@gmail.com"}],"homepage":"https://github.com/LouisKnworpsworx/agent-battle-arena-mcp#readme","bugs":{"url":"https://github.com/LouisKnworpsworx/agent-battle-arena-mcp/issues"},"bin":{"agent-battle-arena-mcp":"dist/index.js"},"dist":{"shasum":"777c60da17b18385566ecb73f42cd69bf08d6055","tarball":"https://registry.npmjs.org/@codehawks/agent-battle-arena-mcp/-/agent-battle-arena-mcp-1.0.0.tgz","fileCount":74,"integrity":"sha512-S5l9QPUpUBUaQrvjQlqRNrKbSkSIRvZoe8TWUI3g6nw6Pq1kqn1ud6k5aUSXqeSuXKTRr1agoRlU4CiTLcPmsQ==","signatures":[{"sig":"MEUCIQDlqTmSePjdI5UQ06+YMvg5+aSJmpPawIAFzyFifhIAaQIgFNgos7Ts2p6Dquk8V33C9Z+cIVFwJJ67iZpRxXWDBOw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":219711},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","scripts":{"build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"codehawks","email":"louiswharmby@gmail.com"},"repository":{"url":"git+https://github.com/LouisKnworpsworx/agent-battle-arena-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server — a creature battle game where Claude is the player. 50 creatures, 12 types, pixel art sprites, strategic AI opponent.","directories":{},"_nodeVersion":"20.19.6","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"sharp":"^0.34.5","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-battle-arena-mcp_1.0.0_1774624613539_0.5642659806447714","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@codehawks/agent-battle-arena-mcp","version":"1.0.2","description":"MCP server — a creature battle game where Claude is the player. 50 creatures, 12 types, pixel art sprites, strategic AI opponent.","type":"module","main":"dist/index.js","bin":{"agent-battle-arena-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","mcp-server","claude","battle","game","ai","agent","creature","pixel-art","turn-based","anthropic"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/LouisKnworpsworx/agent-battle-arena-mcp.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","sharp":"^0.34.5","typescript":"^5.7.0"},"_id":"@codehawks/agent-battle-arena-mcp@1.0.2","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/LouisKnworpsworx/agent-battle-arena-mcp/issues"},"homepage":"https://github.com/LouisKnworpsworx/agent-battle-arena-mcp#readme","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-SxUv6hU+ZNBXVYL3VWuwAKN2ay6yJTxrXBJyTe0Tru8i8aHJQiCPL1yZ84hSFNakdhcnviBp4EWL12NK+r73vA==","shasum":"55b9240f7278c53878d59f8ee044062c35dabbd4","tarball":"https://registry.npmjs.org/@codehawks/agent-battle-arena-mcp/-/agent-battle-arena-mcp-1.0.2.tgz","fileCount":74,"unpackedSize":430580,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD6lhrkD9cHzevoumcfz619WpbY5oIvdm3d0kk+WLBaxgIhAITti1P7AWOchRSYJq5lJ6p1i4Q5ZVC4HXvNJHV36NZ7"}]},"_npmUser":{"name":"codehawks","email":"louiswharmby@gmail.com"},"directories":{},"maintainers":[{"name":"codehawks","email":"louiswharmby@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-battle-arena-mcp_1.0.2_1774633121438_0.039579841571284025"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-27T15:16:53.366Z","modified":"2026-03-27T17:38:41.726Z","1.0.0":"2026-03-27T15:16:53.732Z","1.0.2":"2026-03-27T17:38:41.608Z"},"bugs":{"url":"https://github.com/LouisKnworpsworx/agent-battle-arena-mcp/issues"},"license":"MIT","homepage":"https://github.com/LouisKnworpsworx/agent-battle-arena-mcp#readme","keywords":["mcp","mcp-server","claude","battle","game","ai","agent","creature","pixel-art","turn-based","anthropic"],"repository":{"type":"git","url":"git+https://github.com/LouisKnworpsworx/agent-battle-arena-mcp.git"},"description":"MCP server — a creature battle game where Claude is the player. 50 creatures, 12 types, pixel art sprites, strategic AI opponent.","maintainers":[{"name":"codehawks","email":"louiswharmby@gmail.com"}],"readme":"# Agent Battle Arena — MCP Server\n\nA 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.\n\n**50 creatures. 12 types. 100+ moves. Pixel art sprites. 3 AI difficulties.**\n\n## Install\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-battle-arena\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codehawks/agent-battle-arena-mcp\"]\n    }\n  }\n}\n```\n\n**Config file location:**\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nRestart Claude Desktop, then say: **\"Let's battle!\"**\n\n### Claude Code\n\n```bash\nclaude mcp add agent-battle-arena -- npx -y @codehawks/agent-battle-arena-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/LouisKnworpsworx/@codehawks/agent-battle-arena-mcp\ncd @codehawks/agent-battle-arena-mcp\nnpm install && npm run build\n```\n\nThen point your MCP config at `dist/index.js`.\n\n## How It Works\n\n```\nYou say \"Let's battle!\" → Claude calls start_battle → gets random creatures\n→ calls get_battle_sprites → gets pixel art images → renders React artifact\n→ You say a move or \"go\" → Claude calls make_move → both sides attack\n→ artifact updates with new HP, damage, effects → repeat until KO\n```\n\nClaude 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.\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `start_battle` | Start a battle — random creature, choose difficulty |\n| `make_move` | Execute a move — resolves both player + opponent turn |\n| `get_battle_sprites` | Fetch pixel art sprites for the React artifact |\n| `get_state` | Re-read battle state for strategy planning |\n| `list_creatures` | Browse all 50 creatures with stats and moves |\n| `get_move_info` | Deep-dive on a specific move |\n\n## Creatures\n\n50 creatures across 12 types, each with unique stats and 4 moves:\n\n| Type | Creatures |\n|------|-----------|\n| Electric | Voltfang, Shockeel, Thundermane, Sparkfly |\n| Earth | Terraclaw, Boulderback, Dustfang, Quakejaw |\n| Water | Aquaveil, Tidalfin, Coralguard, Mistweaver, Depthcrawl |\n| Fire | Pyrothon, Cinderboar, Ashraven, Magmawyrm, Emberfox |\n| Air | Zephyrix, Stormtalon, Breezepaw, Galewing |\n| Plant | Thornvine, Bloomfang, Mossback, Fernstrike |\n| Light | Glimmox, Solarius, Lumidrake, Haloveil |\n| Shadow | Umbrashar, Duskfang, Grimshade, Voidmoth |\n| Metal | Ironhide, Steelstrike, Chromajaw, Cogsworth |\n| Ice | Frostbite, Glacieron, Shiverfin, Rimeclaw |\n| Poison | Toxispore, Venomaw, Blightroot, Miasmatic |\n| Plasma | Novablaze, Ionraptor, Pulsegeist, Arcflare |\n\n## Features\n\n- **3 AI difficulties** — Easy (random), Normal (type-aware), Hard (predictive)\n- **12-type effectiveness chart** — super effective, not very effective, neutral\n- **Status effects** — burn, freeze, poison, paralysis\n- **Stat modifiers** — attack/defense/speed stages (±4)\n- **Critical hits** — 10% base, some moves boost crit rate\n- **Move effects** — buffs, debuffs, healing, recoil, status infliction\n- **Pixel art sprites** — unique AI-generated art for every creature\n- **Arena backgrounds** — type-themed battle environments\n- **Best of 3 mode** — series battles with score tracking\n\n## Type Chart\n\n```\nElectric  → Water, Air          Plant  → Water, Earth\nEarth     → Electric, Fire, Metal   Light  → Shadow, Poison\nWater     → Fire, Earth         Shadow → Light, Plasma\nFire      → Plant, Ice, Metal   Metal  → Ice, Air\nAir       → Plant, Poison       Ice    → Plant, Air, Plasma\nPoison    → Plant, Light        Plasma → Metal, Water\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}