poe2-mcp-server

poe2-mcp-server

A Model Context Protocol (MCP) server that gives LLMs real-time access to Path of Exile 2 game data: currency exchange rates, item prices, wiki content, datamined game information, and ladder meta-build statistics.

All data is sourced from public APIs only. No API keys, no GGG OAuth registration, no accounts required.

Tools

Requirements

• Node.js ≥ 22
• npm

Installation

git clone https://github.com/sergeyklay/poe2-mcp-server.git
cd poe2-mcp-server
npm install
npm run build

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "poe2": {
      "command": "node",
      "args": ["/absolute/path/to/poe2-mcp-server/dist/index.js"]
    }
  }
}

Windows users: Use double backslashes or forward slashes in the path:

"args": ["C:\\absolute\\path\\to\\poe2-mcp-server\\dist\\index.js"]

To open the config file quickly, press Win + R and run:

notepad %APPDATA%\Claude\claude_desktop_config.json

Config file locations:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop after editing the config.

Claude Code

claude mcp add poe2 node /absolute/path/to/poe2-mcp-server/dist/index.js

MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Example Prompts

Once connected, try asking:

• "How much is an Exalted Orb worth right now?"
• "What are the top 10 most valuable items in the Currency exchange?"
• "Look up Energy Shield mechanics on the wiki"
• "Which classes are most popular on the ladder this league?"
• "Find datamined stats for Essence Drain on poe2db"
• "What's the French name for Chaos Bolt?" → uses poe2_db_lookup with lang="fr"

Example Conversation

User:

I'm 42 lvl at Act 3 and I just dropped a Divine Orb.
How much is it worth, what should I buy with it?

Claude:

Let me check the current price of a Divine Orb for you.

Nice drop! A Divine Orb is currently worth about 27.5 Chaos Orbs in Fate of the Vaal league,
and it's one of the more valuable currency drops you can get during the campaign.

Don't spend it yet. At level 42 in Act 3, you're still in the leveling phase — any gear you buy
now will be replaced within a few levels. The standard advice for your stage is:

- Divine Orbs are used to reroll the values of explicit modifiers on items — that's an endgame
  activity, not something useful during the campaign.
- If you really want to trade it, you could sell it for ~27 Chaos Orbs and use those later at endgame
  to buy specific gear upgrades for your Lich build once you've finished the campaign and know exactly
  what you need.

Stash it and keep pushing through Act 3. It'll be much more valuable to you at endgame than anything
you could buy with it right now.

Supported Leagues

Default league: Fate of the Vaal (patch 0.4.x). Any active PoE2 league can be passed by name:

Architecture

poe2-mcp-server/
├── src/
│   ├── index.ts              # Entry point: server init, stdio transport
│   ├── services/
│   │   └── api.ts            # HTTP client, rate limiter, type definitions
│   └── tools/
│       ├── currency.ts       # Currency exchange rate tools
│       ├── items.ts          # Exchange item price tools
│       ├── wiki.ts           # Wiki search & poe2db lookup
│       └── builds.ts         # Meta build overview
├── dist/                     # Compiled output (npm run build)
├── package.json
├── tsconfig.json
└── README.md

Data Sources

A built-in rate limiter ensures poe.ninja limits are respected automatically.

Development

npm run dev      # Watch mode: recompiles on file changes
npm run build    # One-time build
npm start        # Run the server (stdio)

Adding a New Tool

1. Create a file in src/tools/
2. Export a register*Tools(server: McpServer) function
3. Import and call it in src/index.ts
4. Rebuild: npm run build

Roadmap

• GGG OAuth API: live character data, equipment, passive tree (requires registration)
• Client.txt log parser: zone tracking, death counter, drop log from the game's local log file
• Official trade search: query the trade site for specific items
• RePoE integration: full datamined gem/item JSON from RePoE
• Craft simulator: probability calculations using Craft of Exile data

License

MIT

Disclaimer

This product isn't affiliated with or endorsed by Grinding Gear Games in any way.

Path of Exile is a registered trademark of Grinding Gear Games. All game content and materials are trademarks and copyrights of their respective owners.