Skip to main content
Glama

wow-stats

A levelling log for World of Warcraft: Forever, with an MCP server so your own AI assistant can read it.

A small program on the computer you play on reads what the game and your addons already save. A server you run turns it into your climb: time per level against Polestar's route, where the hours went, the next upgrade per slot and where it drops, the dungeons worth running, deaths, one journal entry per play session, a plan for your next two hours. Claude, ChatGPT or any MCP client can ask about it, and the server re-runs the SQL behind every number your assistant wants to keep.

It runs on your computer or a small box at home. Nothing goes anywhere else unless you set it up that way.

The Overview of the demo character Nibbet, level 34: behind the route at 2.0 times Polestar's route time, the next level in 2h 27m of play, 90% of guide steps in order, his next moves, and time per level against the route

Live demo: Nibbet-Gearholt, an invented Gnome priest, no install (online once the repository is public).

Three ways in

  1. Try the demo: Docker and five made-up characters on your computer, about 10 minutes, no game needed.

  2. Track my character: run the server, add the addons and the small program on the computer you play on.

  3. Join a friend's server: someone runs it for you and sent you a link. Nothing from this repository needed.

Then, for your AI: Connect your AI. Everything else is in the manual, also on the docs site.

Related MCP server: whoop-ai-mcp

The demo in two commands

With Docker running, from the top of a copy of this repository (Mac, Linux, or Git Bash on Windows):

cd deploy/compose && export INGEST_PASSWORD=demo-password-only
docker compose up -d --build ui && docker compose exec -T ui python - --vl http://victorialogs:9428 < ../../dev/seed.py

The first run builds the image, a minute or two. It ends with 1831 events into http://victorialogs:9428. Open http://127.0.0.1:8080/: five made-up characters, each with a DEMO DATA banner. docker compose down -v removes it all. PowerShell, a port already taken, or the sites for friends: Try the demo.

How it fits together

 the PC you play on                      your server (docker compose)
 the shipper  ---POST over HTTPS--->  ui :8080  ---> VictoriaLogs (your events, kept)
   every 5 min, reads WTF/ and Logs/     |  your page (the full view, behind your login)
                                         |  /mcp for your AI assistant
                                         +-- publish + site :8081: static copies for friends
                                         +-- optional: exporter ---> VictoriaMetrics
                                             (Battle.net data, 23 days)
  • Your data stays yours. Your page shows everything, behind your login. Friends get a sealed copy with a key in the link; anyone gets a public copy cut to an allow list. Neither ever shows other players, what killed you, or where you are now. Privacy tiers.

  • No model on the server. Your assistant does the thinking, in your own account; the server hands it data and checks its numbers. Ask about your character.

  • Known addons only. It reads Polestar and other well-known addons; it never asks you to install one of its own. Addons.

  • Small. One player fits in 2 vCPU and 2 GiB of RAM; a year of events takes a few MiB. Sizing.

The manual

What changed in each version: CHANGELOG.md.

License

GPL-3.0-only (LICENSE). The kit ships route times and gear data made from Polestar (GPL-3.0-only) and its quest database forever-db (GPL-3.0), so it is GPL too. Thanks to fitzforge and Polestar's contributors: the route clock and the gear scoring are theirs. The gear data carries parts under MIT, from ForeverLevelingBiS v0.12.0-beta by Thunder and from wowsims: their notices are in THIRD_PARTY.md.

The images (/app/LICENSE) and the shipper's installers (LICENSE next to the installed script) carry the license and name the source they were built from: this repository at the matching tag, <SOURCE_URL>/tree/v<version>, where SOURCE_URL is wowstats.SOURCE_URL (pyproject's [project.urls] Source).

The page's fonts (Cinzel, Alegreya, Alegreya Sans) are under the SIL Open Font License, their licence files in web/fonts/.

World of Warcraft is a trademark of Blizzard Entertainment. Item names, icons and models the server fetches stay Blizzard's: this kit doesn't bundle them.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables a local MCP-compatible AI client to query saved World of Warcraft: Forever auction, character, profession, recipe, item-source, and map data from a read-only local dashboard. It works without an AI subscription and keeps all research data on your own machine.
      1
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      A read-only MCP server that gives AI assistants like Claude, Codex, and GitHub Copilot access to your WHOOP recovery, sleep, HRV, strain, and workout data. It enables natural-language queries about daily readiness, personal baselines, trends across periods, sleep debt, and HYROX or triathlon performance, all without manually exporting data.
      14 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      A read-only MCP server that lets Claude Desktop, Claude Code, Codex and GitHub Copilot query WHOOP recovery, sleep, HRV, strain and workout data through natural language, answering questions about personal baselines, trends and sleep debt. It also rebuilds HYROX sessions, tracks triathlon load and readiness with auditable evidence, and serves a chart-first local dashboard.
      14 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      A read-only WHOOP MCP server that lets Claude Desktop, Claude Code, Codex and GitHub Copilot answer questions about your own recovery, sleep, HRV, strain and workouts, comparing days against your personal baselines without exporting data yourself. It also adds HYROX and triathlon race tracking, readiness bandwidth and a local chart-first dashboard.
      14 npm
      MIT