# The Slums MCP Server

Model Context Protocol server for managing the The Slums AzerothCore server.
Gives agents (Hermes, Claude, etc.) structured tools over the webapp's agent API.

## Tools

| Tool | Description |
|------|-------------|
| `status` | Server up/down, players, bots, totals |
| `online` | Online real players + bot count |
| `character` | Character lookup (level, class, guild, gold...) |
| `account` | Account lookup + characters |
| `create_account` | Register a new WoW account (SRP6) |
| `announce` | Server-wide in-game announcement |
| `run_command` | GM console command (safe commands) |
| `grant_gm` | Set GM level (1-3) |
| `ban_account` | Ban an account |
| `host_event` | Announce + chain GM commands for events |

## Run

```bash
python3 -m venv venv
./venv/bin/pip install mcp requests
SLUMS_AGENT_KEY=<your-main-key> ./venv/bin/python server.py
```

## Configure with an MCP client

```json
{
  "mcpServers": {
    "the-slums": {
      "command": "/root/slums-mcp/venv/bin/python",
      "args": ["/root/slums-mcp/server.py"],
      "env": {
        "SLUMS_AGENT_KEY": "your-main-key"
      }
    }
  }
}
```

## Security

- The agent API is **localhost-only** — the webapp rejects non-local callers
- The key is **not** in this repo — set `SLUMS_AGENT_KEY` in the environment
- Ask the server admin for the main key (or use a readonly key for lookups)