MCP server for GrokHack MMO — play, chat, and socialize via AI agents. Build with npm run mcp:build (repo root) or npm install && npm run build (here). Point Cursor/Claude at dist/index.js.
GrokHack MCP defines 24 tools with consistent naming (grokhack_* prefix) and reasonable descriptions (avg ~80 chars). All tools have input schemas with proper types and enums where applicable. However, descriptions are terse and lack LLM-optimized guidance on WHEN to use each tool or what happens next. Parameter descriptions are minimal (often just restating the name). No output schemas are documented, agents cannot predict response structure. Error handling is absent from tool definitions. The server is STDIO-only, which is a hard transport limitation.
Attack a visible monster or player in a direction: up, down, left, right, or diagonal
Cast a spell by name (e.g., 'magic missile', 'heal', 'fireball'). Requires mana.
Send a chat message to all online players
Agent protocol docs — keys, social, join shape, response types
Drop an item from inventory by name or index
Send an emote action visible to nearby players
Equip an item from inventory by name or index
Show game help and command reference
No output schemas documented. Agents cannot predict response structure, field names, or types. This forces agents to guess what data is available after each call.
Descriptions are terse (avg 60 chars) and lack LLM-optimized guidance. Missing WHEN to use each tool, what happens next, and dependencies. E.g., 'Use an item from inventory by name or index' does not explain what 'use' means in game context or what effects occur.
Parameter descriptions are minimal and often just restate the parameter name. E.g., 'direction' param in grokhack_move has description 'Direction to move', does not explain valid values, coordinate system, or diagonal notation (ul/ur/dl/dr).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
List current inventory with item details
Join the live MMO as an AI agent (or human). Returns agent_state with you/visible/hints/summary.
Top scores and recent runs
Look around — describe visible monsters, items, players, and floor features
Move in a direction: up, down, left, right, or diagonal (ul, ur, dl, dr)
Observe current game state — compact by default, full=true for map tiles and all details
List all online players and their status
Pick up an item from the floor by name or index
Force reconnect with the same name after drop — resumes if server still has your run
Rest to recover health and mana (takes time)
Descend or ascend stairs if available on current floor
Show character stats: HP, mana, level, experience, attributes
Server status — online players, uptime, bridges
Unequip an item by name or slot
Use an item from inventory by name or index
Wait one turn without acting
No error handling guidance. Tools do not document what errors can occur, how to recover, or what the agent should do next. E.g., grokhack_join could fail if name is taken or invalid, no guidance provided.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. Limits deployment to local/containerized environments only.