### Install Poe2-mcp-server Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Clone the repository, navigate to the directory, install dependencies, and build the project. ```bash git clone https://github.com/sergeyklay/poe2-mcp-server.git cd poe2-mcp-server npm install npm run build ``` -------------------------------- ### Example Prompts for Poe2-mcp-server Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md A list of example prompts that can be used with the Poe2-mcp-server to query game information. ```plaintext How much is an Exalted Orb worth right now? ``` ```plaintext What are the top 10 most valuable items in the Currency exchange? ``` ```plaintext Show me my play session history ``` ```plaintext Which classes are most popular on the ladder this league? ``` ```plaintext Look up Essence Drain on poe2db ``` ```plaintext Decode this build: pobb.in/abc123 ``` ```plaintext Analyze poe.ninja/poe2/pob/19f0c ``` ```plaintext Compare my local build to this guide ``` ```plaintext What's the French name for Chaos Bolt? → uses `poe2_db_lookup` with `lang="fr"` ``` ```plaintext Parse this item I found: [paste Ctrl+C text] ``` -------------------------------- ### Example Conversation: Item Evaluation Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md A sample conversation demonstrating how the server might respond to a user asking about a found item. ```plaintext I just found this, is it any good? Item Class: Body Armours Rarity: Rare Empyrean Shelter Vaal Regalia -------- Quality: +20% (augmented) -------- Energy Shield: 286 (augmented) -------- Requirements: Level: 68 Int: 194 -------- Sockets: S S -------- Item Level: 74 -------- +42 to maximum Life (implicit) -------- 78% increased Energy Shield (rune) -------- +92 to maximum Energy Shield +38% to Lightning Resistance +24% to Cold Resistance 14% increased Stun and Block Recovery ``` ```plaintext This is a strong ES chest for mid-mapping. Here's the breakdown: - 286 Energy Shield at +20% quality with a rune boosting ES by 78% — that's solid. - +92 flat ES on top of the base makes this a high-ES piece for its tier. - Dual resistances (38% lightning + 24% cold) cover a big chunk of your res needs. - +42 max life implicit gives hybrid survivability. For a level 68 Vaal Regalia at item level 74, this is a keeper. The main upgrade path would be finding one with higher flat ES or a third resistance, but that's an endgame min-max concern. Use it now — it'll carry you through T5+ maps comfortably. ``` -------------------------------- ### Example Conversation: Quest Boss Difficulty Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md A sample conversation where a user asks about difficulty with a quest boss, and the server provides context and tips. ```plaintext I'm stuck on this quest boss... keeps killing me. Is this normal? ``` ```plaintext Looking at your logs — you're in the Trial of Chaos (zone level 38) and you've died twice to the boss already. This is the quest version with Chimeral Inscribed Ultimatum: 4 rooms, boss in room 4. Yes, this is normal and happens to many players! Here's why: The boss in room 4 is one of three random encounters: Uxmal (Chimera), Chetza (Bird with blood attacks), or Bahlak (Three-headed bird with lightning). All of them hit hard, especially against energy shield builds. The key thing to know: your quest key doesn't drop on death. It returns to you, so you can retry as many times as you need. Tips to get through: 1. ... 2. ... ... ``` -------------------------------- ### Configure Custom Game Path in Claude Desktop Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md If Path of Exile 2 is installed in a non-standard location, specify the custom game path using the --poe2-path argument. ```json { "mcpServers": { "poe2": { "command": "node", "args": [ "C:\\path\\to\\poe2-mcp-server\\dist\\index.js", "--poe2-path", "D:\\Games\\Path of Exile 2" ] } } } ``` -------------------------------- ### Open Claude Desktop Config on Windows Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Quickly open the claude_desktop_config.json file on Windows using the Run dialog. ```cmd notepad %APPDATA%\Claude\claude_desktop_config.json ``` -------------------------------- ### Windows Path Configuration for Claude Desktop Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md When using Windows, specify the path to the server's index.js using double backslashes or forward slashes in the args array. ```json "args": ["C:\\absolute\\path\\to\\poe2-mcp-server\\dist\\index.js"] ``` -------------------------------- ### System Prompt for Path of Exile 2 Coach Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md A detailed system prompt for creating a PoE2 coach agent using MCP tools. It outlines the role, tool usage protocol, and context gathering strategy. ```markdown # Path of Exile 2 Coach ## Role You are a knowledgeable Path of Exile 2 coach. You explain complex game systems in clear terms without being condescending. Communicate in the user's language. ## Tool Usage Protocol You have access to a PoE 2 MCP server with tools for: game logs, wiki, datamined game database (poe2db), currency prices, item prices, item clipboard parsing with enrichment (mod tiers, base stats, unique pricing), build decoding/comparison, and meta build stats. These tools are your PRIMARY data source for everything PoE 2 related. For EVERY user message about gameplay, follow this sequence BEFORE responding: 1. **Read player logs** (`poe2_log_summary`) to get current zone, level, deaths, session context 2. **Use MCP tools** (wiki, database, currency, items, builds) for any game knowledge needed 3. **Fall back to web search** ONLY if MCP tools didn't have the answer 4. **Respond** to the user with all context already gathered ## Gather Context, Don't Ask NEVER ask the user for information you can obtain from tools: - "What level are you?" → read the logs - "What zone are you in?" → read the logs - "How many times did you die?" → read the logs - "What does skill X do?" → use `poe2_wiki_search` or `poe2_db_lookup` - "How much does Y cost?" → use `poe2_currency_check` or `poe2_item_price` - "What builds are popular?" → use `poe2_meta_builds` - "Is this item good?" → use `poe2_parse_item` with `enrich=true`, read the mod tier table - "What build should I follow?" → use `poe2_pob_decode` to decode a guide build Only ask the user for things no tool can provide: personal preferences, build goals. If logs are unavailable or the game is not running, state this briefly and proceed with available information. ## Item Evaluation (poe2_parse_item) When a user pastes item text (Ctrl+C from game), ALWAYS call `poe2_parse_item` with `enrich=true`. The enrichment section contains: ``` -------------------------------- ### Development Commands Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Run these commands in the project root to manage development and building. 'npm run dev' enables watch mode for automatic recompilation. ```bash npm run dev # Watch mode: recompiles on file changes npm run build # One-time build npm start # Run the server (stdio) ``` -------------------------------- ### Rebuild Command Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md After adding a new tool, rebuild the project using this command. ```bash npm run build ``` -------------------------------- ### Configure Custom PoB2 Path in Claude Desktop Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md To specify a custom PoB2 builds directory for relevant tools, use the --pob2-path argument. ```json "args": [ "C:\\path\\to\\poe2-mcp-server\\dist\\index.js", "--pob2-path", "D:\\PoB\\Builds" ] ``` -------------------------------- ### Configure Claude Desktop for Poe2-mcp-server Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Add the poe2-mcp-server configuration to your claude_desktop_config.json. Ensure the path to the server's index.js is absolute. ```json { "mcpServers": { "poe2": { "command": "node", "args": ["/absolute/path/to/poe2-mcp-server/dist/index.js"] } } } ``` -------------------------------- ### Add Poe2-mcp-server to Claude Code with Custom League Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Specify a custom default league when adding the server to Claude Code using the --league argument. ```bash claude mcp add poe2 node /path/to/poe2-mcp-server/dist/index.js --league "Standard" ``` -------------------------------- ### Configure Custom Default League in Claude Desktop Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Override the default league for price/economy tools by specifying it with the --league argument. This acts as a fallback if no league is specified per-request. ```json "args": [ "C:\\path\\to\\poe2-mcp-server\\dist\\index.js", "--league", "Standard" ] ``` -------------------------------- ### Add Poe2-mcp-server to Claude Code with Custom Game Path Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md When adding the server to Claude Code, you can specify a custom game path using the --poe2-path argument. ```bash claude mcp add poe2 node /path/to/poe2-mcp-server/dist/index.js --poe2-path "/path/to/Path of Exile 2" ``` -------------------------------- ### Run MCP Inspector Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Inspect the poe2-mcp-server using the MCP Inspector tool. This command runs the inspector against the local dist/index.js file. ```bash npx @modelcontextprotocol/inspector node dist/index.js ``` -------------------------------- ### Add Poe2-mcp-server to Claude Code Source: https://github.com/sergeyklay/poe2-mcp-server/blob/main/README.md Add the poe2-mcp-server to Claude Code using the 'claude mcp add' command. Specify the node command and the absolute path to the server's index.js. ```bash claude mcp add poe2 node /absolute/path/to/poe2-mcp-server/dist/index.js ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.