>
Mechanic is the unified platform for WoW addon development, providing CLI tools, MCP integration, a web dashboard, and in-game diagnostics.
┌─────────────────────────────────────────────────────┐
│ Mechanic Desktop │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ CLI (mech) │ │ MCP Server │ │ Dashboard │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────┬───────────────────────────┘
│ SavedVariables Sync
┌─────────────────────────▼───────────────────────────┐
│ !Mechanic Addon │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Console │ │ Errors │ │ Tests │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────┘
MANDATORY: ALWAYS use MCP tools directly instead of the shell.
| Task | MCP Tool |
|---|---|
| Env Status | env.status() |
| Get Addon Output | addon.output(agent_mode=true) |
| Lint Addon | addon.lint(addon="MyAddon") |
| Format Addon | addon.format(addon="MyAddon") |
| Run Tests | addon.test(addon="MyAddon") |
| Sync Addon | addon.sync(addon="MyAddon") |
| Search APIs | api.search(query="*Spell*") |
mech)Command-line interface for all operations:
mech lint <addon> - Run Luacheckmech format <addon> - Run StyLuamech test <addon> - Run Busted testsmech release <addon> <version> "<message>" - Full release workflowExposes 53 AFD commands as MCP tools for AI agents. All functionality available via mech call <command> is also available as MCP tools.
Web UI at http://localhost:5173:
The !Mechanic addon provides: