Path of Building MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| POB_CMD | No | LuaJIT binary path, e.g. /opt/homebrew/bin/luajit. | luajit |
| POB_DIRECTORY | No | Path to your PoB builds directory. Defaults to the OS-default Builds directory. | |
| POB_FORK_PATH | No | Path to the PathOfBuilding/src directory containing HeadlessWrapper.lua and Modules/. | ~/Projects/PathOfBuilding/src |
| POB_TIMEOUT_MS | No | Lua request timeout in milliseconds. | 10000 |
| POB_LUA_ENABLED | No | Set to "true" to enable the Lua bridge (headless Path of Building via LuaJIT). Default is "false"; when unset, the Lua-based high-fidelity calculation tools report that the bridge isn't enabled. | false |
| POE_TRADE_ENABLED | No | Set to "true" to enable the Trade API tools. Default is "false". | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| analyze_buildC | Analyze a Path of Building build file and extract detailed information including stats, skills, gear, passive skill tree analysis with keystones, notables, jewel sockets, build archetype detection, and optimization suggestions |
| compare_buildsA | Compare two Path of Building builds side by side |
| list_buildsA | List all available Path of Building builds |
| get_build_statsC | Extract specific stats from a build (Life, DPS, resistances, etc.) |
| start_watchingA | Start monitoring the builds directory for changes. Builds will be auto-reloaded when saved in PoB. |
| stop_watchingA | Stop monitoring the builds directory for changes. |
| get_recent_changesB | Get a list of recently changed build files. |
| watch_statusA | Check if file watching is currently enabled. |
| refresh_tree_dataA | Force refresh the passive skill tree data cache. Use this if tree data seems outdated. |
| compare_treesA | Compare passive skill trees between two builds, showing differences in allocated nodes |
| get_nearby_nodesA | Find notable and keystone passives near your current tree allocation. Uses loaded Lua bridge build when no build_name is provided. |
| find_path_to_nodeA | Find the shortest path from your current tree to a specific passive node. Uses loaded Lua bridge build when no build_name is provided. |
| get_build_notesA | Read the notes/documentation from a PoB build file |
| set_build_notesA | Write notes/documentation into a PoB build file (overwrites existing notes) |
| analyze_defensesA | Deep-dive into defensive layers (avoidance/mitigation/recovery): EHP, spell suppression, evasion, block, armour/PDR, life regen, leech. Use this when you specifically want detailed defense breakdown. validate_build already covers this — only call analyze_defenses separately if you need more defensive detail than validate_build provides. |
| suggest_optimal_nodesC | AI-powered suggestion of optimal passive nodes based on build goals |
| optimize_treeA | Full passive tree optimization - removes inefficient nodes and reallocates to better options |
| analyze_itemsB | Analyze equipped items and suggest upgrades or improvements |
| optimize_skill_linksA | Analyze skill gem setups for 'more' multipliers, penetration, and support gem synergies. Flags missing multiplicative damage supports and suggests clear-speed vs bossing balance. |
| create_budget_buildC | Create a league-start/budget-friendly version of a build |
| validate_buildA | Comprehensive build validation: resistances, life pool, defensive layers (avoidance/mitigation/recovery), mana sustain, accuracy, flask immunities, damage scaling. Provides prioritized critical/warning/info recommendations. PREFER this over get_build_issues + analyze_defenses — it covers both in one call. Do not call all three. |
| export_buildA | Export a copy of a build to an XML file. Creates a variant/copy from an existing build file. NOTE: This does NOT export from Lua bridge - use save_tree to apply Lua bridge modifications back to files. |
| save_treeA | Update only the passive tree in an existing build file. Use this to apply tree optimizations or Lua bridge modifications back to the original build. |
| snapshot_buildA | Create a versioned snapshot of a build for easy rollback. Snapshots are stored separately with metadata tracking stats and changes. |
| list_snapshotsA | List all snapshots for a build with metadata and stats |
| restore_snapshotA | Restore a build from a snapshot. Optionally creates a backup of current state before restoring. |
| export_build_summaryA | Generate a clean markdown summary of the loaded build suitable for sharing on Reddit, Discord, or as build documentation |
| analyze_skill_linksB | Analyze skill gem setup and evaluate support gem choices. Detects build archetype, rates each support gem, and identifies issues with current setup. |
| suggest_support_gemsB | Get intelligent support gem recommendations based on build archetype. Provides ranked suggestions with DPS estimates, cost, and reasoning. |
| compare_gem_setupsA | Compare multiple gem configurations side-by-side to evaluate different options. NOTE: Full DPS comparison requires Lua bridge integration (future enhancement). |
| validate_gem_qualityC | Check all gems for quality and level improvements. Identifies missing quality, Exceptional upgrade opportunities, and corruption targets. |
| find_optimal_linksC | Auto-generate the best support gem combination for a skill based on budget and optimization goal. Provides step-by-step upgrade path. |
| gem_upgrade_pathA | Generate a prioritized gem upgrade shopping list showing which gems to level, quality, and upgrade to Exceptional versions, ordered by impact and budget |
| import_from_pobbinA | Download a shared Path of Building build from pobb.in by URL or build ID and save it to your builds directory. Accepts a full URL (https://pobb.in/AbCdEfGh) or a bare ID. Works for both PoE1 and PoE2 builds. |
| import_from_mobalyticsA | Scrape a Mobalytics PoE2 build guide and import it into your PoB2 builds directory. Delegates to the guide2pob Python package which must be installed (pip install -e ~/repos/guide2pob). Creates a ready-to-use .xml file you can immediately open with analyze_build or lua_load_build. |
| import_from_maxrollA | Scrape a Maxroll PoE2 build planner and import it into your PoB2 builds directory. Delegates to the guide2pob Python package (pip install -e ~/repos/guide2pob). Creates a ready-to-use .xml file with all phases merged into switchable Tree specs, Item Sets, and Skill Sets. |
| upload_build_to_pobbinA | Upload a local PoB2 build to pobb.in and get a shareable web link plus a pob2:// deep link that opens the build directly in Path of Building 2. |
| get_currency_ratesA | Get current currency exchange rates from poe.ninja. Returns real-time market prices for all currencies in Chaos Orb equivalent. Updated every 5 minutes from live trading data. IMPORTANT: Use the EXACT league name the user specifies - do not substitute or guess. |
| find_arbitrageA | Find currency arbitrage opportunities - profitable trading loops where you can trade currencies in a circle and end up with more than you started. Uses real-time poe.ninja rates to identify market inefficiencies. Perfect for making passive income through currency trading. IMPORTANT: Use the EXACT league name the user specifies - do not substitute or guess. |
| calculate_trading_profitA | Calculate the profit/loss from a specific trading chain. Useful for testing your own trading strategies or validating arbitrage opportunities before executing them. Shows step-by-step conversion rates. IMPORTANT: Use the EXACT league name the user specifies - do not substitute or guess. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 40 tools
Several clusters are near-duplicates: analyze_skill_links vs optimize_skill_links, suggest_support_gems vs find_optimal_links, suggest_optimal_nodes vs optimize_tree, and analyze_defenses vs validate_build vs get_build_stats all target largely the same questions. The descriptions openly admit overlap ("validate_build already covers this", "PREFER this over get_build_issues + analyze_defenses"), which helps, but an agent still faces real misselection risk across ~7 gem tools and ~4 validation/stat tools.
The dominant pattern is consistent snake_case verb_noun (list_builds, compare_builds, analyze_items, restore_snapshot, import_from_pobbin). A few deviations exist: watch_status is noun-first, gem_upgrade_path is a noun phrase with no verb, and snapshot_build uses a noun as a verb. These are minor and readable.
40 tools is well above the comfortable 3-15 range and above the 25+ 'heavy' threshold, driven by multiple near-redundant variants in the gem and tree-optimization areas. The domain is genuinely broad (build files, passive tree, gems, imports, currency trading), so some breadth is justified, but several tools could be merged without losing capability.
Coverage is strong: read/analyze/compare/export/save/notes, snapshot lifecycle (create/list/restore), tree inspection and optimization, gem analysis and upgrade paths, multi-source imports, publishing to pobb.in, and live currency/arbitrage tools. Gaps are modest — no delete/rename build or delete_snapshot, and item handling is read-only (analyze_items with no item editing), but agents can work around these.