Skip to main content
Glama
Path of Building MCP Server

Path of Building MCP Server

by Demonad112

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
POB_CMDNoLuaJIT binary path, e.g. /opt/homebrew/bin/luajit.luajit
POB_DIRECTORYNoPath to your PoB builds directory. Defaults to the OS-default Builds directory.
POB_FORK_PATHNoPath to the PathOfBuilding/src directory containing HeadlessWrapper.lua and Modules/.~/Projects/PathOfBuilding/src
POB_TIMEOUT_MSNoLua request timeout in milliseconds.10000
POB_LUA_ENABLEDNoSet 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_ENABLEDNoSet 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

CapabilityDetails
tools
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.2/5.0

Scored across 40 tools

Disambiguation2/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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.

Maintenance

ActivitySlowing
ResponsivenessNo recent community issues