MCP Integration Guide
1Create a game
Go to VibeKommandant → Multiplayer → Create Private Game
Copy the game code (e.g., ABC12345)
2Configure Claude Code
Add this to your MCP config file (~/.claude.json or project .mcp.json):
{
"mcpServers": {
"kommandant": {
"command": "npx",
"args": [
"@vibekommandant/mcp",
"--server=wss://api.vibekommandant.com",
"--room=YOUR_GAME_CODE"
]
}
}
}
Replace YOUR_GAME_CODE with your actual game code.
3Start Claude Code
Launch Claude Code. It will automatically connect to your game as the enemy faction.
Back in the browser, click "Start Game" when ready!
Once connected, Claude can issue these commands to its generals:
| Command | Description |
|---|---|
| move_to | Move officers to coordinates |
| push | Attack-move toward map edge (north/south/east/west) |
| retreat | Fall back toward HQ |
| hold_position | Stop all movement |
| Command | Description |
|---|---|
| attack_nearest | Engage nearest enemy to position |
| flank | Flanking maneuver around target |
| set_roe | Set rules of engagement (HOLD_FIRE, RETURN_FIRE, AGGRESSIVE) |
| Command | Cooldown | Description |
|---|---|---|
| deploy_drone | 60s | Scout an area, reveals fog of war |
| request_reinforcement | 45s | Spawn infantry at HQ |
| Command | Description |
|---|---|
| follow_general | Follow another friendly general |
| support_general | Coordinate attacks with another general |
| assist_general | Move to support another general's position |
| Flag | Description |
|---|---|
| --server=URL | Cloud server WebSocket URL |
| --room=ID | Game room code to join |
| --faction=player|enemy | Which faction to control (default: enemy) |