# wow-stats

<figure class="shot">
<img class="light-only" src="https://sam-dumont.github.io/wow-mcp/images/overview-light.webp" width="1100" height="705" alt="The Overview of a made-up level 34 priest: behind the route at 2.0 times Polestar's time, the next level in 2h 27m of play, 90% of guide steps in order, then his next moves and his time per level">
<img class="dark-only" src="https://sam-dumont.github.io/wow-mcp/images/overview-dark.webp" width="1100" height="705" alt="The same Overview in the dark theme">
<figcaption>The Overview of Nibbet, a made-up priest. <a href="https://sam-dumont.github.io/wow-mcp/demo/">Open his pages</a>.</figcaption>
</figure>

## Pick your path

<div class="paths">
<a class="path" href="https://sam-dumont.github.io/wow-mcp/play/getting-started/">
<span class="path-kicker">Play</span>
<strong>A friend runs a server</strong>
<span>They sent you a link. Add Polestar, run one command, play. About 15 minutes, no admin rights.</span>
<span class="path-go">Join a friend's server</span>
</a>
<a class="path" href="https://sam-dumont.github.io/wow-mcp/ai/connect/">
<span class="path-kicker">Connect your AI</span>
<strong>Ask about your character</strong>
<span>Claude, ChatGPT and a dozen other assistants can read your data and plan your next two hours.</span>
<span class="path-go">Connect your AI</span>
</a>
<a class="path" href="https://sam-dumont.github.io/wow-mcp/self-host/try-at-home/">
<span class="path-kicker">Self-host</span>
<strong>Run it yourself</strong>
<span>One Docker Compose file on a small box at home, for you and your friends. Try it with made-up characters first.</span>
<span class="path-go">Try it at home</span>
</a>
</div>

## What's on your page

- **Your pace**: your time per level against [Polestar](https://github.com/fitzforge/polestar)'s route, and the hours of play to the next level. [Overview and next moves](https://sam-dumont.github.io/wow-mcp/play/overview/)
- **Your next upgrade**: the best item per slot, the points it adds and where it drops, auction house included. [Gear and upgrades](https://sam-dumont.github.io/wow-mcp/play/gear/)
- **The dungeon worth running**: XP against your questing pace, the quests to pick up first, the drops you'd wear. [Dungeons](https://sam-dumont.github.io/wow-mcp/play/dungeons/)
- **A plan for tonight**: 1 to 6 hours of guide steps, checkpoints and where to log out. [Plan your next hours](https://sam-dumont.github.io/wow-mcp/play/plan/)
- **Your history**: every level, one journal entry per evening, your look at each level in 3D. [Climb, timeline, journal](https://sam-dumont.github.io/wow-mcp/play/history/)

## What it doesn't do

- **Touch the game.** It reads the files WoW and your addons already save, after they save
  them. No addon of its own, no memory reading.
- **Send your data anywhere.** It goes from your computer to the server you (or a friend)
  run, and nowhere else. Friends see what you choose to share. [What's shared](https://sam-dumont.github.io/wow-mcp/play/privacy/)
- **Run an AI on the server.** Your own assistant does the thinking, in your own account.

How the pieces fit: [How it works](https://sam-dumont.github.io/wow-mcp/how-it-works/). Questions:
[Questions and answers](https://sam-dumont.github.io/wow-mcp/faq/).

<p class="fineprint">Free software under the GPL-3.0. The route times and gear scoring come from
<a href="https://github.com/fitzforge/polestar">Polestar</a> and its contributors; other credits in
<a href="https://github.com/sam-dumont/wow-mcp/blob/main/THIRD_PARTY.md">THIRD_PARTY.md</a>. World of Warcraft is a trademark of Blizzard
Entertainment; this project isn't affiliated with Blizzard.</p>
