Path of Exile 2 Build Optimizer

You run a Path of Exile 2 character optimization MCP server that analyzes your build, validates your gear and gem choices, and integrates with your AI assistant to give clear, actionable recommendations. It pulls data from public sources, analyzes defenses, skills, and passives, and can import/export Path of Building data to help you tune your character efficiently.

How to use

After you connect a compatible MCP client, you can ask your AI assistant to analyze and optimize your PoE2 character. You can import your character from poe.ninja, validate your support gem combinations, inspect gem data, and compare your build to top ladder players. You can also import and export Path of Building codes to trial different configurations and explanations of PoE2 mechanics to better understand the choices.

How to install

Prerequisites you need before you start:

• Python 3.9 or newer must be installed
• A compatible MCP client (Claude Desktop, ChatGPT Desktop, Cursor, Windsurf, etc.)
• Access to your PoE2 character on poe.ninja (public profile)

# Option A: Install via PyPI (recommended)
pip install poe2-mcp

# Option B: Install from source
git clone https://github.com/HivemindOverlord/poe2-mcp.git
cd poe2-mcp
pip install -e .

Run the MCP server locally

You can run the MCP server directly from your local environment. Use the stdio configuration to launch the server with Python. This starts a local server process that your MCP client can communicate with.

# Windows example (stdio config in Claude Desktop)
{
  "type": "stdio",
  "name": "poe2_optimizer",
  "command": "python",
  "args": ["C:\\Users\\YourName\\poe2-mcp\\launch.py"]
}

# macOS/Linux example (stdio config in Claude Desktop)
{
  "type": "stdio",
  "name": "poe2_optimizer",
  "command": "python3",
  "args": ["/Users/YourName/poe2-mcp/launch.py"]
}

Restart your MCP client after adding the server configuration so it can connect to the local server.

## Notes on using the tool with your AI assistant

Once connected, you can ask natural language questions and the AI assistant will use the available tools to analyze your character, validate builds, or export/import Path of Building data.

## Available tools

### analyze\_character

Full character analysis including defenses, skills, gear, and passive tree.

### import\_poe\_ninja\_url

Import character data directly from a poe.ninja URL.

### compare\_to\_top\_players

Compare your build to top ladder players to identify gaps and optimization opportunities.

### analyze\_passive\_tree

Analyze allocated passive nodes for efficiency and synergy.

### validate\_support\_combination

Check if a given set of support gems works together without conflicts.

### validate\_build\_constraints

Validate your build against game rules and constraints.

### inspect\_support\_gem

View complete data for a specific support gem.

### inspect\_spell\_gem

View complete data for a spell gem.

### list\_all\_supports

List all available support gems.

### list\_all\_spells

List all available spell gems.

### list\_all\_keystones

List keystones with full stats.

### inspect\_keystone

Get complete keystone details by name.

### list\_all\_notables

List all notable passive passives with stats.

### inspect\_passive\_node

Get details for a specific passive node.

### list\_all\_base\_items

List all base item types.

### inspect\_base\_item

Get details for a specific base item.

### inspect\_mod

Get complete details for a specific item mod by ID.

### list\_all\_mods

List mods with filtering by type (PREFIX/SUFFIX/IMPLICIT).

### search\_mods\_by\_stat

Search for mods by keyword (e.g., "fire", "life").

### get\_mod\_tiers

Show all tier variations of a mod family.

### validate\_item\_mods

Check if mods can legally exist together on an item.

### get\_available\_mods

List all mods available for a generation type.

### import\_pob

Import Path of Building code.

### export\_pob

Export build to PoB format.

### get\_pob\_code

Get PoB code for a character.

### search\_items

Search local item database.

### search\_trade\_items

Search official trade site (requires authentication).