A Model Context Protocol (MCP) server that provides AI assistants with professional trading data from POE2Scout - a specialized platform for Path of Exile 2 currency trading and market intelligence. Built for traders, day traders, and currency speculators who need reliable market data and trend analysis.
graph LR
A[POE2Scout API<br/>poe2scout.com] -->|HTTP Requests<br/>Rate Limited: 2/sec| B[POE2Scout MCP Server<br/>This Project]
B -->|11 Trading Tools<br/>JSON-RPC 2.0| C[Claude Code / LLM<br/>Your AI Application]
C -.->|Optional Extension<br/>API Integration| D[Custom Trading Bot<br/>Dashboard/Automation]
B1[Multi-tier Cache<br/>L1: Memory<br/>L2: SQLite] -.->|Performance| B
B2[Rate Limiter<br/>Circuit Breaker<br/>Retry Logic] -.->|Reliability| B
style A fill:#ff6b6b,stroke:#fff,stroke-width:2px,color:#fff
style B fill:#4ecdc4,stroke:#fff,stroke-width:3px,color:#000
style C fill:#45b7d1,stroke:#fff,stroke-width:3px,color:#fff
style D fill:#96ceb4,stroke:#fff,stroke-width:2px,color:#000
style B1 fill:#feca57,stroke:#fff,stroke-width:1px,color:#000
style B2 fill:#ff9ff3,stroke:#fff,stroke-width:1px,color:#000
Data Flow:
- POE2Scout API → Raw market data (Divine Orbs, Chaos Orbs, etc.)
- MCP Server → Processes, caches, and exposes 11 trading tools
- Claude Code/LLM → YOUR PRIMARY APPLICATION - Provides intelligent trading analysis
- Custom Extensions → Optional bots/dashboards that integrate with Claude's analysis
- 11 focused tools for direct POE2Scout API access
- Rate-limited HTTP client (2 req/sec, burst 5) with intelligent retry logic
- Real-time market data with proper error handling and caching
- JSON-RPC 2.0 compliance for seamless AI integration
- Major currencies only - Divine Orb, Chaos Orb, and other high-volume items
- Volume-based pricing - Trade quantities for liquidity assessment
- Price history with trends - Essential for day trading decisions
- Outlier detection - Automatically flags market manipulation attempts
- Professional trader tools - Built for currency speculation, not casual gear shopping
POE2Scout MCP provides 11 specialized tools for currency trading and market analysis:
analyze_price_history- Advanced market analysis with trend detection, volatility assessment, and trading signalsget_leagues- Current league data with Divine Orb pricingbasic_search- Find currency items by name with price historyget_currency_items- Major currency exchange rates and volume data
get_unique_items- High-value unique item discovery (limited data coverage)get_item_categories- Available trading categoriesget_unique_base_items- Base item reference dataget_uniques_by_base_name- Filter unique items by base type
get_api_status- Rate limiting and system health monitoringget_item_filters- Available search filters and categoriesget_landing_splash_info- Platform status and featured content
Key Limitation: POE2Scout focuses on high-volume traded items only. Most specific gear searches return empty results - this is normal and expected.
👤 User: Should I buy Divine Orbs at current market price?
🤖 POE2 AI: Let me analyze Divine Orb market conditions...
[MCP call: analyze_price_history → comprehensive analysis]
📈 MARKET ANALYSIS:
• Current Price: [Current market rate]
• Trend: Stable/Flat (medium volatility)
• Volume: 302 quantity (excellent liquidity)
• Recommendation: Sell - 13.8% above average
💡 TRADING SIGNAL: WEAK SELL
⚠️ Price slightly elevated - consider waiting for dip
📊 Recent range: [Dynamic price range]
👤 User: I have 3 Divine Orbs - what's the smartest trading strategy?
🤖 POE2 AI: Let me analyze current market conditions first...
[MCP call: get_currency_items → market analysis]
💰 STRATEGY ANALYSIS:
• Divine stability: [Current volatility assessment]
• Alternative currencies: [High-value options analysis]
• Market timing: [League phase considerations]
📊 METHODOLOGY:
• Assess your gear upgrade timeline
• Compare Divine vs other currency stability
• Factor in league age and market maturity
• Keep emergency reserves for opportunities
👤 User: Divine Orb shows 302 quantity - is that good liquidity?
🤖 POE2 AI: Moderate liquidity analysis:
• 302 quantity = [Market value worth of trading]
• Previous volume: 5,012 (significant drop)
• Execution: May take time for large trades
📊 VOLUME GUIDE:
🔥 HIGH (1000+): Instant execution
✅ MEDIUM (100-999): Normal trading
⚠️ LOW (<100): Price manipulation risk
👤 User: Find arbitrage between leagues
🤖 POE2 AI: Cross-league price analysis:
💎 DIVINE ORB ARBITRAGE:
• Dawn of the Hunt: [Current SC price]
• HC Dawn of the Hunt: [Current HC price]
• Spread: [Price difference] ([% difference])
📊 ANALYSIS:
• Hardcore economy typically smaller
• Can't transfer between leagues
• Shows relative economy health
👤 User: [Currency] just spiked massively - is this real?
🤖 POE2 AI: Market manipulation analysis:
🚨 PRICE SPIKE ANALYSIS:
• Current: [Spike price] (massive increase!)
• Previous: [Normal range] (historical average)
• Volume: [Current volume] (check if artificial)
💡 VERDICT: [Analysis based on volume/history]
⚠️ Compare with historical patterns
📊 Historical range: [Dynamic range]
👤 User: Someone offers [X] for [Y currency] - fair deal?
🤖 POE2 AI: Trade analysis:
[DEAL ASSESSMENT]
📊 Current market rate: [Live market rate]
💰 Price difference: [Above/below market %]
📈 Recent range: [Dynamic price range]
🎯 RECOMMENDATION: [Based on current analysis]
Current Exalted Orb: 1 exalt (base unit)
Stable baseline currency for all pricing
Volume: High liquidity
Status: Standard measurement unit
🔥 HIGH-VALUE CURRENCIES:
1. Divine Orb: [Current rate] (stable store of value)
2. Perfect Jeweller's: [Current rate] (high-value)
3. Greater Jeweller's: [Current rate] (watch for spikes)
⚠️ Check volumes before trading!
CURRENT HOLDINGS: 8 Divine Orbs (typical geared endgamer)
ANALYSIS FRAMEWORK:
• Market phase: [Early league vs established economy]
• Currency stability: [Volatility vs other options]
• Personal timeline: [Gear upgrade plans vs investment horizon]
METHODOLOGY:
• Calculate gear upgrade costs in current market
• Assess opportunity cost of holding vs trading
• Diversify based on market conditions, not fixed ratios
• Adjust allocation based on league maturity and goals
# Add to Claude with email configuration
claude mcp add -e [email protected] -- poe2scout-mcp node /path/to/dist/index.jsgit clone https://github.com/vanzan01/poe2scout-mcp.git
cd poe2scout-mcp
npm install
npm run build
# Set email (required by API)
export POE2SCOUT_CONTACT_EMAIL="[email protected]"- Check the volume/quantity - low volume = unreliable price
- Trust high-volume items only (100+ quantity)
- Some currencies show data anomalies - focus on consistent patterns
- Normal behavior - POE2Scout focuses on currency trading
- Limited unique item coverage
- Use official trade site for gear
- Check both price AND volume
- Volume drops = temporary liquidity issue
- Wait for volume normalization before trading large amounts
- Always check volume - Volume under 100 = price manipulation risk
- Divine Orb is your benchmark - Most stable high-value currency
- Exalted for baseline - All prices measured in exalts
- Perfect Jeweller's for storage - High value, good liquidity
- Cross-reference big trades - Verify large value transactions
✅ Reliable Data:
- Divine Orb pricing (consistently accurate)
- Volume/quantity data (helps identify bad prices)
- Price history trends
- Some currencies show extreme price swings
- Low volume items may have stale pricing
- Not real-time (updates periodically)
Built on top of POE2Scout - the platform providing the trading data that makes this possible.
MIT
