POE2Scout MCP Server - Professional Trading Intelligence

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.

Architecture Overview

graph LR
    A[POE2Scout APIpoe2scout.com] -->|HTTP RequestsRate Limited: 2/sec| B[POE2Scout MCP ServerThis Project]
    B -->|11 Trading ToolsJSON-RPC 2.0| C[Claude Code / LLMYour AI Application]
    C -.->|Optional ExtensionAPI Integration| D[Custom Trading BotDashboard/Automation]
    
    B1[Multi-tier CacheL1: MemoryL2: SQLite] -.->|Performance| B
    B2[Rate LimiterCircuit BreakerRetry 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:

1. POE2Scout API → Raw market data (Divine Orbs, Chaos Orbs, etc.)
2. MCP Server → Processes, caches, and exposes 11 trading tools
3. Claude Code/LLM → YOUR PRIMARY APPLICATION - Provides intelligent trading analysis
4. Custom Extensions → Optional bots/dashboards that integrate with Claude’s analysis

What This MCP Server Provides

🎯 Reliable Data Pipeline

• 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

📊 Trading-Focused Data Coverage

• 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

Available Tools

POE2Scout MCP provides 11 specialized tools for currency trading and market analysis:

🎯 Core Trading Tools

• analyze_price_history - Advanced market analysis with trend detection, volatility assessment, and trading signals
• get_leagues - Current league data with Divine Orb pricing
• basic_search - Find currency items by name with price history
• get_currency_items - Major currency exchange rates and volume data

📊 Market Intelligence Tools

• get_unique_items - High-value unique item discovery (limited data coverage)