Back to search
pob-mcp
MCP serverGitHub
MCP server for Path of Building (PoE1): an AI assistant imports characters, tweaks passives, gems and items and measures EHP/DPS changes in a live PoB window you watch
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/shrikus--pob-mcp)HTML
<a href="/listings/shrikus--pob-mcp"><img src="/api/listings/shrikus--pob-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 70 lines
- # pob-mcp
- An MCP server that lets an AI assistant work inside [Path of Building Community](https://github.com/PathOfBuildingCommunity/PathOfBuilding) (Path of Exile 1) — with PoB's own calculation engine, in a PoB window you watch live.
- The assistant can import a character, read every calculated stat, allocate passives, swap gems and items, and measure changes ("what does this node / this trade item do to my EHP?") without touching the build. Everything it does shows up in the PoB window, so you can follow along and click in the same window yourself.
- ## How it works
- - **GUI mode (default).** `lua/LaunchMcp.lua` starts the normal PoB `Launch.lua` from a PoB source checkout and then loads `lua/gui_bridge.lua`, which listens on `127.0.0.1:49100` and runs commands from `lua/helpers.lua` between frames. PoB only runs frames while its window has focus, so each call briefly focuses the PoB window and then gives focus back to where it was (`POB_KEEP_FOCUS=1` keeps it on PoB). The window is started automatically on the first call.
- - **Headless mode (`POB_HEADLESS=1`).** PoB's `HeadlessWrapper.lua` runs inside Python via [lupa](https://github.com/scoder/lupa) (LuaJIT), with the same `helpers.lua`. Useful for bulk comparisons without a window.
- PoB quirks handled in headless mode: its LuaJIT fork supports `+=`/`..=` (rewritten at load time), `lua-utf8` is replaced by a small shim, `Inflate`/`Deflate` use `zlib1.dll` through LuaJIT FFI, and Lua output goes to stderr so stdout stays clean for MCP stdio.
- ## Requirements
- - Windows (GUI mode uses the PoB Windows runtime and Win32 focus calls; headless mode should also work elsewhere with a `zlib` shared library via `POB_ZLIB`)
- - Python 3.11+
- - A PoB source checkout:
- ```
- git clone --depth 1 https://github.com/PathOfBuildingCommunity/PathOfBuilding.git
- ```
- By default it is expected next to this repo (`../PathOfBuilding`); otherwise set `POB_ROOT`.
- ```
- pip install -r requirements.txt
- ```
- ## Register with Claude Code
- ```
- claude mcp add pob -s user -- python /path/to/pob-mcp/server.py
- ```
- or add to `~/.claude.json`:
- ```json
- "mcpServers": {
- "pob": { "type": "stdio", "command": "python", "args": ["C:\\path\\to\\pob-mcp\\server.py"] }
- }
- ```
- ## Tools
- | Tool | What it does |
- |---|---|
- | `open_window` | Start the PoB window with the bridge |
- | `load_character(account, character)` | Import from the official pathofexile.com API (public profile) |
- | `load_code`, `export_code`, `save_build(name)` | PoB import codes; save XML into `Documents/Path of Building/Builds` |
- | `stats`, `life_breakdown` | Calculated output of the main skill and defences |
- | `skills`, `set_main_skill`, `set_gems` | Socket groups |
- | `tree`, `node_info`, `allocate`, `deallocate` | Passive tree (shortest path) |
- | `preview_nodes`, `compare_nodes`, `preview_item` | Stat delta via PoB's tooltip calculator — nothing changes |
- | `equipped_items`, `set_item` | Items from game/trade text (Ctrl+C) |
- | `config` | Configuration tab (charges, conditions, enemy, …) |
- | `show(tab)`, `highlight(text)` | Point the user at a tab or glow nodes in the tree |
- ## Environment
- | Variable | Default | |
- |---|---|---|
- | `POB_ROOT` | `../PathOfBuilding` | PoB source checkout |
- | `POB_HEADLESS` | unset | `1` = no window |
- | `POB_MCP_PORT` | `49100` | bridge port |
- | `POB_KEEP_FOCUS` | unset | `1` = leave focus on PoB after a call |
- | `POB_BUILDS` | `~/Documents/Path of Building/Builds` | where `save_build` writes |
- | `POB_ZLIB` | `$POB_ROOT/runtime/zlib1.dll` | zlib for headless import codes |
- After editing `lua/helpers.lua` while the window is open, call `GuiPoB().reload_helpers()` (or restart the window).
- Path of Building is © its contributors and MIT-licensed; this project only loads it from your local checkout.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.