Let Claude, Codex or any MCP-capable AI read, analyse and improve your Path of Exile build inside Path of Building, live.
PoB Agent Edition is a Path of Building Community fork with a built-in AI connection, plus its own MCP server with 27 focused Path of Building tools. Ask "why do I keep dying?" or "what is the best upgrade for 50 chaos?" and the AI answers with PoB's own calculations, edits the build in the open window and finds instant-buyout trade items that fit your build.
Public beta. Everything in the latest release is tested, but few people have used it yet, so please report problems. Known limits:
- Windows only.
- The 3.30 passive trees are an early preview taken from Path of Building's next update.
- Each download is about 250 MB (portable about 280 MB). Older and Ruthless passive trees download the first time a build needs them, so the first open of such a build needs internet.
- The atlas tree share links have not been checked against pathofexile.com yet.
- What it does
- Install (Windows, about 5 minutes)
- First questions to ask your AI
- Supported AI apps
- Trade searches and account safety
- Updating
- FAQ
- Credits and license
| Feature | What you get |
|---|---|
| Live AI control | The AI reads and edits the build open in the PoB window (127.0.0.1 only, nothing leaves your PC). You see every change immediately. |
| Build diagnosis | Resistances, max hit taken, EHP, suppression/block/evade, ailments, mana and reservation, DPS. Every number comes from PoB's own calculation, so there is no guessing. |
| Cheap upgrade finder | plan_upgrades searches pathofexile.com trade (instant buyout only), simulates each item in your build and ranks the results by gain per chaos. The results also appear in the AI Advisor card. |
| Overview dashboard | Dark theme, in-game style inventory with item icons, damage by type, skills, gear and ailments on one page. |
| Atlas tree planner | Plan the atlas passive tree with GGG's official 3.30 data: import or share links, see a summary per league mechanic, and let the AI plan it with you. |
| Safe by default | The AI never overwrites your build (it saves variants as new files), never buys anything and never touches the game client. |
| Explains PoE1 | Made for players coming from Path of Exile 2: the AI explains PoE1 systems such as gem links, flasks, pantheon and the atlas, and compares them with PoE2. |
Both are on the Releases page. Pick one:
| Download | For | You need |
|---|---|---|
PoB-Agent-Edition-<version>-win64.zip |
Easiest. Install.cmd adds Start menu and desktop shortcuts and connects your AI apps. |
Node.js 20+ (the installer offers to install it) |
PoB-Agent-Edition-<version>-win64-portable.zip |
Unzip and play. No installer, no shortcuts, no registry changes. Brings its own Node.js (about 30 MB more). Can keep builds and settings inside its folder, for a USB stick. | Nothing |
Each zip has a .sha256 file next to it if you want to check the download.
You need: Windows 10 or 11, Node.js 20 or newer (the LTS version is fine), and an AI app that supports MCP (see Supported AI apps).
- Download the latest
PoB-Agent-Edition-<version>-win64.zipfrom Releases. - Extract it to any folder you like, for example
C:\Games\PoB Agent Edition. Folders without spaces or special permissions work best. AvoidProgram Files. - Double-click
Install.cmdin that folder. It:- checks for Node.js and offers to install it with
wingetif it is missing, - adds PoB Agent Edition to the Start menu and the desktop,
- connects the AI apps it finds (Claude Desktop, Claude Code, Codex) to the
pobMCP server, - writes
mcp-config.jsonfor any other MCP app.
- checks for Node.js and offers to install it with
- Restart your AI app, open PoB Agent Edition and load a build. If the AI does not see the
pobtools afterwards, close the AI app completely and runInstall.cmdonce more: Claude rewrites its settings file while it is open and can undo the change. - Optional, for trade searches: open Options > Trade session ID in PoB Agent Edition and paste your POESESSID (how to find it).
Your normal Path of Building keeps working as before. Agent Edition is a separate program and reads the same Documents\Path of Building\Builds folder.
- Download
PoB-Agent-Edition-<version>-win64-portable.zipand extract it anywhere (a USB stick works too). - Double-click
Start PoB Agent Edition.cmdto play. Nothing is installed. - To use it with your AI app, double-click
Connect AI apps.cmd. It only adds thepobentry to Claude Desktop, Claude Code and Codex, using the Node.js in the folder. It also asks whether to keep builds and settings inside the folder (portable data mode, theportable.txtfile): then nothing is written outside the folder, but your normal PoB won't see those builds. Otherwise they stay inDocuments\Path of Building, shared with your normal PoB.- No scripts at all?
Start PoB Agent Edition.cmdwritesmcp-config.txtwith the entry for this folder; copy it into your AI app's MCP settings. - Moved the folder? Run
Connect AI apps.cmdagain (AI apps need the full path). Disconnect AI apps.cmdremoves the entry again. After that, deleting the folder leaves nothing behind (in portable data mode).
- No scripts at all?
Prefer not to run the installer? Both ways below work without it. All the installer does is create shortcuts and add one entry to your AI app's config.
Manual install (no scripts)
-
Install Node.js 20+ (LTS).
-
Download and extract the release zip, for example to
C:\Games\PoB Agent Edition. -
Start PoB from
PathOfBuilding\runtime\Path{space}of{space}Building.exe. You can right-click it and choose Send to > Desktop (create shortcut). -
Add the
pobMCP server to your AI app. ReplaceC:/Games/PoB Agent Editionwith your folder and use forward slashes.Claude Desktop: open Settings > Developer > Edit Config (
%APPDATA%\Claude\claude_desktop_config.json) and add this inside"mcpServers":"pob": { "command": "node", "args": ["C:/Games/PoB Agent Edition/agent-mcp/build/index.js"] }
Claude Code: run this in a terminal:
claude mcp add pob --scope user -- node "C:/Games/PoB Agent Edition/agent-mcp/build/index.js"Codex: add this to
%USERPROFILE%\.codex\config.toml:[mcp_servers.pob] command = "node" args = ["C:/Games/PoB Agent Edition/agent-mcp/build/index.js"]
Other apps: use the same command and args in their MCP settings.
-
The server finds PoB and LuaJIT next to itself, so no other settings are needed. Builds are read from
Documents\Path of Building\Builds; to use another folder, add"env": { "POB_DIRECTORY": "D:/My/Builds" }. -
Restart the AI app.
From source with git (developers)
git clone --recurse-submodules https://github.com/urbanvcode/pob-agent-edition.git
cd pob-agent-edition
cd agent-mcp; npm ci; npm run build; cd ..
.\Install.cmd # optional: or follow the manual steps aboveTo update later, run tools\update.ps1 (it does git pull, git submodule update --init and npm ci && npm run build in agent-mcp, then renews the AI connections). See docs/DEVELOPMENT.md.
Uninstall
Run Install.cmd -Uninstall. It removes the shortcuts and the pob entry from the AI apps. Then delete the folder. Your builds are not touched.
- "Check my build in PoB: what's wrong with it, most important first?"
- "Are my resistances capped? What is my weakest max hit?"
- "Find the best upgrades for 50 chaos per item in the current league."
- "Explain what suppression does, compared to PoE2."
- "Plan my atlas tree for Essence farming and explain each mechanic."
- "Try swapping this support gem and show me before/after DPS. Save it as a new build."
Any app that can run a local MCP (Model Context Protocol) server over stdio works.
| App | Setup |
|---|---|
| Claude Desktop | Automatic (Install.cmd) |
| Claude Code (CLI, desktop, IDE) | Automatic, when the claude command is installed |
| OpenAI Codex CLI | Automatic, when ~/.codex exists |
| Others (Cursor, Antigravity, Windsurf, VS Code, ...) | Copy the pob entry from mcp-config.json into the app's MCP settings |
AI assistants get their working rules (diagnosis order, trade safety, how to save) from the server automatically. A human-readable copy is in AGENTS.md.
- Instant buyout listings only. The AI shows you items and a trade link, and you click buyout. There is no whispering and no auto-buying.
- Nothing touches the game client. No overlays, no input automation, no memory reading.
- Polite with GGG's servers. At most 1 request every 2 seconds, every published pathofexile.com rate limit is respected before it is reached, and there are at most 16 trade requests per question. If the site asks for a pause, the AI tells you instead of retrying.
- Your POESESSID stays on your PC. It is stored in
Documents\Path of Building\AgentEdition.jsonand is never printed or sent anywhere except pathofexile.com.
More details: docs/TRADE.md and SECURITY.md.
| What | How |
|---|---|
| PoB Agent Edition | Once a day PoB Agent Edition asks GitHub whether a new version is out (nothing else is sent; switch it off in Options > Check for Agent Edition updates). If one is, the Overview shows a banner: What's new shows the changes, Update now updates and restarts PoB, Later hides it for a day, Skip this version hides it until the next one. Your AI app mentions it once too. |
| By hand | Run tools\update.ps1 in the folder (works for the installer, portable and git versions). It downloads the matching zip from GitHub, checks its SHA256, waits for PoB to close, keeps the old version in <folder>.previous, replaces the program files, renews the AI connections if you had set them up, and can restart PoB (-Restart). Builds and settings are never touched. tools\update.ps1 -Check only reports; tools\update.ps1 -Rollback goes back to the previous version. |
| Fully manual | Download the new release zip, extract it over the old folder (or into a new one) and run Install.cmd (or Connect AI apps.cmd) again. The changelog lists what changed. |
| Game data (items, uniques, passive tree) | Comes with each release. Releases follow official Path of Building Community updates. |
| Atlas tree | Comes from GGG's official export; developers run tools/update-atlas.ps1. |
Is this the official Path of Building? No. It is a fork of Path of Building Community with extra AI features. All calculations are PoB's own.
Does it work with Path of Exile 2? Not yet. This edition is for Path of Exile 1. A PoE2 edition is on the roadmap.
Can it get my account banned? It never interacts with the game client and only uses the public trade website within its rate limits, the same way a person browsing the trade site does. You always buy manually.
Does the AI see my builds or my POESESSID? The AI app sees the build data it asks PoB for, as with any MCP tool. The POESESSID is never shown to the AI or printed.
Do I need an API key? No. You use your existing AI app (Claude, Codex, ...). PoB Agent Edition itself is free.
Mac or Linux? Not supported yet, because Path of Building's runtime is Windows-only. It may work under Wine but is untested.
- Path of Building Community by Openarl and the PoB Community team (MIT license, see
PathOfBuilding/LICENSE.md). - pob-mcp by ianderse (GPL-3.0). Our MCP server (
agent-mcp/) is based on and inspired by it: versions up to 0.1.0 shipped a fork of pob-mcp, and the Lua build operations, the trade client and other parts are ported from it. Thank you! - Atlas tree data: grindinggear/atlastree-export.
- LuaJIT (MIT).
PoB Agent Edition's own code is licensed under the GPL-3.0.
This project is not affiliated with or endorsed by Grinding Gear Games. Path of Exile is a trademark of Grinding Gear Games.
Keywords: Path of Building AI, PoB AI assistant, Path of Exile build optimizer, PoE build checker, Claude Path of Building, Codex Path of Building, Path of Building MCP server, PoE trade upgrade finder, PoE atlas tree planner, PoE1 build helper.

