Skip to content

About

AI build assistant for Path of Building (Path of Exile 1): let Claude, Codex or any MCP app analyse, edit and upgrade your PoE build live

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PoB Agent Edition: an AI build assistant for Path of Building (Path of Exile 1)

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.

Latest release Platform: Windows Game: Path of Exile 1 License: GPL-3.0 Status: public beta

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.

PoB Agent Edition Overview dashboard with AI Advisor card

Contents

What it does

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.

Atlas tree planner tab

Install (Windows, about 5 minutes)

Download

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.

Installer version

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).

  1. Download the latest PoB-Agent-Edition-<version>-win64.zip from Releases.
  2. Extract it to any folder you like, for example C:\Games\PoB Agent Edition. Folders without spaces or special permissions work best. Avoid Program Files.
  3. Double-click Install.cmd in that folder. It:
    • checks for Node.js and offers to install it with winget if 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 pob MCP server,
    • writes mcp-config.json for any other MCP app.
  4. Restart your AI app, open PoB Agent Edition and load a build. If the AI does not see the pob tools afterwards, close the AI app completely and run Install.cmd once more: Claude rewrites its settings file while it is open and can undo the change.
  5. 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.

Portable version

  1. Download PoB-Agent-Edition-<version>-win64-portable.zip and extract it anywhere (a USB stick works too).
  2. Double-click Start PoB Agent Edition.cmd to play. Nothing is installed.
  3. To use it with your AI app, double-click Connect AI apps.cmd. It only adds the pob entry 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, the portable.txt file): then nothing is written outside the folder, but your normal PoB won't see those builds. Otherwise they stay in Documents\Path of Building, shared with your normal PoB.
    • No scripts at all? Start PoB Agent Edition.cmd writes mcp-config.txt with the entry for this folder; copy it into your AI app's MCP settings.
    • Moved the folder? Run Connect AI apps.cmd again (AI apps need the full path).
    • Disconnect AI apps.cmd removes the entry again. After that, deleting the folder leaves nothing behind (in portable data mode).

Other ways to install

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)
  1. Install Node.js 20+ (LTS).

  2. Download and extract the release zip, for example to C:\Games\PoB Agent Edition.

  3. Start PoB from PathOfBuilding\runtime\Path{space}of{space}Building.exe. You can right-click it and choose Send to > Desktop (create shortcut).

  4. Add the pob MCP server to your AI app. Replace C:/Games/PoB Agent Edition with 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.

  5. 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" }.

  6. 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 above

To 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.

First questions to ask your AI

  • "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."

Supported AI apps

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.

Trade searches and account safety

  • 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.json and is never printed or sent anywhere except pathofexile.com.

More details: docs/TRADE.md and SECURITY.md.

Updating

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.

FAQ

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.

Credits and license

  • 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.

About

AI build assistant for Path of Building (Path of Exile 1): let Claude, Codex or any MCP app analyse, edit and upgrade your PoE build live

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages