Skip to main content
Glama
wipebot-mcp

wipebot-mcp

by Enf0

Wipebot is a raid assistant for World of Warcraft®. Ask why a pull wiped, what killed you, what to change before the next one or how the next boss works, and it answers from the raid's Warcraft Logs report, the game's guides and the raid notes you give it. Code works out the numbers from the log, and an AI model picks what to read and explains it. Ask in Claude, ChatGPT or another assistant that takes MCP connectors, or in Discord, where it answers in the guild's channels and DMs and posts after each wipe. Use the free public copy, or run your own for your guild.

Try it

A public copy runs at wipebot.enfo.dev, free and best effort, for any guild:

  • Claude: Add to Claude on that page, then Continue and sign in with Warcraft Logs.

  • ChatGPT and others: add https://wipebot.enfo.dev/mcp as a custom MCP server and sign in with Warcraft Logs.

  • Discord: Add to Discord on that page, then an admin runs /wipebot setup and adds the server's AI key (sign in with OpenRouter, or paste an OpenRouter or Anthropic key): the server's answers run on it. Then DM or mention the bot.

Every guild shares the public copy, and Warcraft Logs lets it read only so much each hour: when that's used up, questions that need new data wait for the next hour. One person gets only a part of each hour's share, so a single long night can't use it up for everyone; past it, the copy says when to ask again. Signed in with Warcraft Logs, your questions use your own allowance first. For your guild alone, run your own copy (Setup).

Related MCP server: wow-char-export

What you can ask

Ask in your own words:

  • Why did we wipe? What ended the pull (an enrage, a mechanic that killed many, deaths one after another) and the first mistake that led there, with the pull drawn under the answer. In Discord, it posts this after every wipe.

  • What killed me? The seconds before a death, the healing, and whether a defensive you had ready would have saved you.

  • How did I do tonight? Your night on the boss, your cooldowns pull by pull, and your casts, talents and gear against the top players of your spec.

  • Who keeps getting hit by Virulence? Who missed their kick? Per player over the night, and checked against the raid note your officers saved.

  • Give us the short version of this boss. The guides side by side with Blizzard's latest hotfixes, and a spec's priorities and cooldowns, before there's a log.

More, with examples: docs/features.md.

How it works

The analysis is code: tools compute every number in an answer from the log, and the model picks the tools and explains their output. The tools are an MCP server, used two ways:

  • Connector: members add your server to Claude, ChatGPT or similar and sign in with Warcraft Logs; answers run on their own subscription.

  • Discord bot: the guild asks in channels and DMs, and it can post after each wipe; answers run on the host's Anthropic or OpenRouter key, or on an AI key a server's admin added (/wipebot setup).

Setup

You need a Warcraft Logs API client from warcraftlogs.com/api/clients (not a public client) and the guild's reports public. The connector and the bot run with Docker Compose.

git clone https://github.com/Enf0/wipebot.git && cd wipebot
cp .env.example .env
mkdir -p data/wipebot-discord data/wipebot-mcp data/wipebot-notes && sudo chown -R 1000:1000 data

Connector

  1. In .env, set WCL_CLIENT_ID and WCL_CLIENT_SECRET, WIPEBOT_PUBLIC_URL (e.g. https://wipebot.example.com) and WIPEBOT_ALLOWED_GUILDS (the guild's warcraftlogs.com address). Give the client the redirect URL https://<your host>/wcl/callback.

  2. docker compose up -d --build wipebot-mcp, with a reverse proxy serving HTTPS in front of 127.0.0.1:8000.

  3. Members add https://<your host>/mcp as a connector and sign in with Warcraft Logs. In Claude, a link fills the connector in for them, and a plugin adds the method too (docs/setup.md).

Discord bot

  1. Create an application in the developer portal, turn off Public Bot, and set DISCORD_TOKEN, ANTHROPIC_API_KEY (or OPENROUTER_API_KEY) and the Warcraft Logs client in .env.

  2. docker compose up -d --build wipebot-discord, and invite it with the link in its log.

  3. Raiders can ask it about any report they link right away, and about the game without one. Run /wipebot setup with the guild's Warcraft Logs page, and it also finds the guild's latest raid by itself, posts after wipes and keeps raid notes. /help shows raiders what to ask.

Every setting, the Warcraft Logs quota, raid notes and plans, upgrading and troubleshooting: docs/setup.md.

Costs and data

  • The connector costs only hosting: members' answers run on their own plan. The bot's answers cost about $0.15-0.25 each with Claude Opus (docs/models.md), and a long one (a whole night, many pulls compared) $0.40 or more; /usage shows what they've cost.

  • Everything Wipebot keeps stays in ./data: who signed in, the characters and preferences raiders give the bot, and what each answer cost (docs/setup.md). Only what an answer needs goes to the model.

Limitations

  • Built and tested for retail raids, for now. It may answer about a Mythic+ log's boss fights, but it knows nothing of keys yet (the timer, trash, affixes) and its guides and comparisons are for raids. Classic logs are on Warcraft Logs' separate Classic sites, which it doesn't read yet.

  • The method, how to read a raid log, is a skill: the bot and Claude with the plugin use it. A connector alone gets only the tools, whose output carries what code can decide of the method, since assistants don't yet load skills from a server (docs/reference/mcp-clients.md).

  • The Discord bot is built and tested on Claude (Opus by default, Sonnet and Haiku compared in docs/models.md). Through OpenRouter, WIPEBOT_MODEL can name another model, untested so far. The connector works with any assistant that takes MCP connectors.

Development

CONTRIBUTING.md: setting up (uv and just), the checks, and how the tests (tests/README.md) and evals (evals/README.md) work. Maintained on a best-effort basis; for a feature, open an issue before a pull request.

Contact

Open an issue, or reach the maintainer: Enfo (enf0) on Discord, or enfo@enfo.dev. Security problems go privately through Security → Report a vulnerability (CONTRIBUTING.md).

License

Wipebot is free software under the GNU Affero General Public License v3.0 or later. You may use, change and host it; if you run a changed copy for others, as a connector or a bot, you must offer them its source under the same license.

Wipebot isn't affiliated with or endorsed by Blizzard Entertainment or Warcraft Logs. World of Warcraft and Warcraft are trademarks or registered trademarks of Blizzard Entertainment, Inc.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Everything about World of Warcraft: Forever, in the chat app you already use. Anything you'd look up is already in your chat. Close your other tabs. Why thott.bot? - Everything, connected. Quests, items, recipes, NPCs and maps are linked: what a quest needs, where that item drops, where you turn it in, what it crafts. Your AI gets the whole picture in one place, not scraps from dozens of random sites. - Current to the minute. Every new build, patch and hotfix reaches thott.bot within minutes of landing, even the silent ones. - Straight from Blizzard. Game facts come from Blizzard's own files and posts, not old guides or forum guesses. Community guides are labeled as such. What it knows: - Your characters: link Battle.net and your AI knows the characters you actually play, their gear, talents, quests and more, updated every time you log out. - Patch notes and changes: every build and hotfix, and exactly what each changed. - Quests and leveling: every quest, its chain, route and rewards, and leveling guides. - Talents and builds: the builds players run right now, counted daily from millions of real characters at every level, every spec's talent pick rates, and every talent change. - Spells and abilities: every spell and ability, and every change to each. - Classes and races: every class, race and racial, and what Forever changed for each. - Items and gear: every item and item set, where it drops and who sells it. - Crafting and professions: every profession, recipe and reagent, what each reagent makes, and profession leveling guides. - Auction house: live prices on every WoW Forever auction house, hourly. - The world: zones, maps, flight paths, dungeons, raids and bosses, battlegrounds. - Collections: mounts, pets, toys, achievements, reputations and holidays. - Interface and addons: every setting, key binding and chat command, the addon API and banned addons. - Blizzard news: news and developer posts (blue posts) from the official forums. In ChatGPT and Claude, ask to see it: your characters' sheets with the gear and stats they logged out with, the game's own tooltips, clickable talent trees, quest chains, maps and before-and-after cards. For every WoW Forever player, from first-timers to theorycrafters and addon developers.

      https://mcp.thott.bot/mcp
    • Query your app's logs, metrics and incidents from your AI assistant.

      https://mcp.rudow.ai/mcp
    • Teamfight Tactics data & AI coaching for Claude and ChatGPT — 19 tools, built-in Riot key.

    • Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides comprehensive World of Warcraft guild analytics, player character analysis, and auction house market data through the Blizzard Battle.net API. Supports both Retail and Classic WoW with real-time market insights, guild roster management, and demographic analytics.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for World of Warcraft that provides 26 tools for accessing characters, guilds, realms, game data, and auction house info via Blizzard's Battle.net APIs. It enables natural-language queries for character audits, Mythic+ reviews, market analysis, and more.
      MIT