Model Context Protocol Server for AI-Powered Cryptocurrency Analysis

A comprehensive Model Context Protocol (MCP) server that bridges AI assistants with professional cryptocurrency market analysis capabilities. This server transforms AI conversations by providing real-time market data, sophisticated technical analysis, and intelligent trading insights through standardized MCP protocols. Whether you're building analysis tools, research systems, or AI financial advisors, this server delivers the complete infrastructure needed for data-driven market analysis and decision-making across multiple timeframes and asset classes.

🎬 MCP Technical Analysis Server Demo

Watch the full demonstration of AI-powered cryptocurrency analysis capabilities

🔥 Key Features:

• 🔴 69 Analysis & Trading Tools - Complete market analysis + trading execution + Hyperliquid operations
• 📊 Real-time Market Data - Live prices, indicators, volume analysis
• 🎯 Advanced Technical Analysis - 35 technical indicators (MAs, oscillators, channels, patterns)
• 💰 Risk Management - Position sizing, stop loss, take profit calculations
• 📈 Multi-Timeframe Analysis - Daily, 4H, 1H trend alignment
• 🤖 31 AI Prompts - Pre-configured analysis workflows for Day Trading, Swing Trading, Position Trading
• 📚 4 Resources - Comprehensive trading guides and documentation
• 🔄 Streaming Support - HTTP/SSE for real-time updates
• 💹 Hyperliquid Futures - Testnet & Mainnet futures execution with slippage protection (0.010% - 8.00%)
• 🪙 Hyperliquid Spot - Market & limit orders with automatic slippage retry (mainnet ready)
• 💼 Account Operations - Balance checks, transfers (spot ↔ perp), send USD/tokens (6 operations)
• 🌉 Bridge Operations - Withdraw to Arbitrum L1, check withdrawal status (2 operations)
• 🐋 HyperScreener Integration - Whale positions, liquidations, top traders, large trades data
• 🎯 Whale Tracking - Track specific wallet addresses with labeling & change detection alerts
• 📊 Tier Classification - Market breakdown by trader tier (🦐 Shrimp to 🐉 Institutional)
• 🔗 BTC Correlation - Altcoin correlation with BTC, beta analysis, market regime detection
• 📈 Enhanced L2 Order Book - Real-time bids/asks with depth and imbalance from Hyperliquid
• 🧠 AI Memory (Mem0) - Persistent memory for trading preferences, trade journal, pattern learning
• ✅ Production Ready - All 104 components (69 tools + 4 resources + 31 prompts) validated and working
• 🏗️ Fully Modular - Clean architecture with 5 tool categories, 83.8% code reduction in core file

📋 Recent Updates

December 3, 2025 - Hyperliquid Account & Spot Trading Integration + TypeScript Fix

Bug Fixes

• ✅ Fixed TypeScript compilation error: Added slippageType property to TradeResult interface in futures trading tools
• ✅ Build now completes successfully without errors

New Hyperliquid Tools (3)

Account Operations (6 operations merged)

• ✅ hyperliquid_account_operations - Balance checks, transfers (spot ↔ perp), send USD/tokens
  • check_spot_balance - View all spot token balances
  • check_perp_balance - View perpetual positions and margin
  • transfer_spot_to_perp - Move funds to futures trading
  • transfer_perp_to_spot - Move funds to spot trading
  • send_spot_token - Send tokens to other addresses
  • send_usd - Send USD to other addresses

Bridge Operations (2 operations merged)

• ✅ hyperliquid_bridge_operations - L1 Arbitrum bridge
  • withdraw_to_arbitrum - Withdraw to Arbitrum (3-hour bridge)
  • check_withdraw_status - Check withdrawal status

Spot Trading (1 tool)

• ✅ spot_trade - Buy/sell spot tokens with slippage retry (0.010% → 8.00%)
  • Market orders with automatic slippage retry (same as futures)
  • Limit orders with exact price execution
  • Token decimal handling and price formatting
  • Production Ready - Use mainnet with small amounts ($5-10)
  • Testnet Limitations:
    • ⚠️ ZERO liquidity - Orders will be rejected even with high slippage (13.919%+)
    • ⚠️ Hyperliquid limit - Max slippage cannot exceed 80% from reference price
    • ⚠️ Not recommended for spot trading tests
    • ✅ Solution: Use mainnet with small amounts for realistic testing

Testing & Validation:

• $100+ real transactions executed on testnet
• 100% coverage for account and bridge operations
• Spot trading tested: Successfully executed HYPE trades with 13.919% slippage on testnet
• Comprehensive documentation: See FINAL_SUMMARY.md for complete implementation details

Data Now Available

🏠 Local Development: Run the MCP server locally for full control and privacy
🌐 HTTP Streaming: Remote MCP connection via mcp-remote for Cursor IDE

🌟 What's Included

📊 69 Complete Analysis & Trading Tools

• Market Data (5): Price, indicators, volume analysis, multi-timeframe, external data
• Order Book & Market (8): Order book depth, volume profile, market structure, regime, patterns, divergence, liquidation, long/short ratio
• Position & Whale Tracking (4): Position tracking, correlation analysis, whale position tracking, tier classification
• Risk Management (2): Position sizing and risk/reward calculations
• Hyperliquid Account (3): Account operations (6 ops), bridge operations (2 ops), spot trading (1 tool)
• Moving Averages (10): MA envelope, VWMA, McGinley, Rainbow, Kaufman, Hull, WMA, SMMA, DEMA, TEMA
• Oscillators (18): Stochastic RSI, CMO, PPO, AO, Gator, Elder Ray, Fisher, KST, Schaff, Coppock, TSI, RVI, DPO, Momentum, ROC, Ultimate, TRIX
• Merged Indicator Tools (7): Volume indicators, volatility, trend, strength, channels, pivot points, patterns
• Trading Execution (5): Hyperliquid futures (testnet/mainnet), spot trading, account operations, bridge operations
• AI Memory (8): Save preferences, log trades, get insights, check patterns, remember, recall, get all, delete

📚 4 Educational Resources

• Comprehensive documentation for trading strategies, risk management, and technical analysis
• API references and integration guides
• Specialized guides for volume analysis, Fibonacci, orderbook, and more
• NEW: Usage patterns guide for Day Trading, Swing Trading, Position Trading
• NEW: Complete tools reference (69 tools with parameters including AI Memory)

🤖 31 AI Analysis Prompts

• Core analysis workflows for comprehensive market research
• Technical analysis prompts for indicator-based insights
• Risk management and position sizing guidance
• Specialized prompts for advanced trading strategies
• NEW: Day Trading Analysis with fast oscillators (stochastic_rsi, fisher_transform)
• NEW: Swing Trading Analysis with multi-timeframe and divergence
• NEW: Position Trading Analysis with volume profile and long-term momentum
• NEW: Risk Management Analysis with liquidation levels
• NEW: Oscillators Analysis (11 oscillator indicators)
• NEW: Moving Averages Analysis (10 MA indicators)

🚀 Quick Start

1️⃣ Installation

# Clone the repository
git clone https://github.com/FajarArrizki/mcp-technical-analysis.git
cd mcp-technical-analysis

# Install dependencies
pnpm install

# Build the server
pnpm run build

2️⃣ Run Server

Server runs at http://localhost:8787 with SSE streaming support for real-time market analysis!

🐧 Linux / Mac

# Start Streaming Server (from project root)
bash scripts/mcp-auto-start.sh

# Or with full path
bash /path/to/mcp-technical-analysis/scripts/mcp-auto-start.sh

🪟 Windows

# Start Streaming Server (from project root)
scripts\mcp-auto-start.bat

# Or with full path (adjust to your installation directory)
C:\Users\YourUsername\Downloads\mcp-technical-analysis\scripts\mcp-auto-start.bat

Alternative - Manual Start:

# Terminal 1 - Start server
pnpm run stream

# Terminal 2 - Test with MCP client
pnpm run terminal

3️⃣ Add to MCP Client

🪟 Windows - Cursor IDE / Claude Desktop

Add to mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "mcp-technical-analysis": {
      "command": "cmd",
      "args": ["/c", "C:\\Users\\YourUsername\\Downloads\\mcp-technical-analysis\\scripts\\mcp-auto-start.bat"],
      "env": {
        "CANDLES_COUNT": "75"
      },
      "description": "MCP Technical Analysis Server - Windows"
    }
  }
}

🐧 Linux / Mac - Cursor IDE / Claude Desktop

Add to .cursor/mcp.json or mcp.json:

{
  "mcpServers": {
    "mcp-technical-analysis": {
      "command": "bash",
      "args": ["/path/to/mcp-technical-analysis/scripts/mcp-auto-start.sh"],
      "description": "MCP Technical Analysis Server - Linux/Mac"
    }
  }
}

⚡ Claude Code (CLI) - All Platforms

# Add the MCP server to Claude Code
claude mcp add --transport http mcp-technical-analysis http://localhost:8787/mcp

# List configured servers
claude mcp list

# Check server status
/mcp

🌐 Remote Access via mcp-remote

For remote MCP connection, add to .mcp.json in project root:

{
  "mcpServers": {
    "mcp-technical-analysis": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8787/mcp"]
    }
  }
}

🌍 Geographic Access & Restrictions

Binance Access in Restricted Countries

If Binance is banned or restricted in your country, you can still access the platform and use this MCP server by configuring Cloudflare's DNS (1.1.1.1). If Cloudflare DNS fails, use a VPN as an alternative solution.

Recommended Setup:

1. First, try configuring DNS to use Cloudflare's 1.1.1.1 (primary) and 1.0.0.1 (secondary)
2. If DNS configuration doesn't work, use a reputable VPN service (NordVPN, ExpressVPN, or similar)
3. Connect to a server in a country where Binance operates freely (e.g., Netherlands, Singapore, Japan)

Cloudflare DNS Configuration (Try First):

# Linux DNS configuration
sudo nano /etc/resolv.conf
# Add these lines:
nameserver 1.1.1.1
nameserver 1.0.0.1

VPN Alternative (If DNS Fails):

• Install a reputable VPN service
• Connect to a server in an unrestricted country
• Access Binance normally through the VPN connection

Countries with Complete Bans

Countries with Partial Restrictions

Note: This information is for educational purposes. Always comply with local laws and regulations regarding cryptocurrency trading in your jurisdiction.

📦 MCP Capabilities

The MCP Technical Analysis Server exposes 104 total components through the Model Context Protocol:

• 69 Tools - Executable functions for analysis, trading, and account management
• 31 Prompts - Pre-configured AI workflows for trading strategies
• 4 Resources - Educational documentation and guides

Component Breakdown

📊 Total: 104 Components
├─ 🔧 Tools: 69
│  ├─ Account (10): Account ops, bridge, AI memory
│  ├─ Analysis (15): Market analysis, patterns, structure
│  ├─ Data (3): Price, positions, ratios
│  ├─ Indicators (35): MAs, oscillators, channels, patterns
│  └─ Trading (6): Futures, spot, risk management
├─ 🤖 Prompts: 31
│  ├─ Day Trading (9): Scalping, momentum, range
│  ├─ Swing Trading (11): Multi-timeframe, patterns
│  └─ Position Trading (11): Long-term trends, macro
└─ 📚 Resources: 4
   ├─ Trading Strategy Guide
   ├─ Technical Analysis Reference
   ├─ Risk Management Guide
   └─ Tool Usage Patterns

🔧 Tools (69)

📚 Resources (4)

Educational documentation accessible through the MCP protocol.

🤖 Prompts (31)

🛠️ Technology Stack

🏗️ Architecture

High-Level Overview

╔══════════════════════════════════════════════════════════════════════════════════════════════╗
║                                                                                              ║
║                            MCP TECHNICAL ANALYSIS SERVER v1.1.0                              ║
║                          AI-Powered Cryptocurrency Trading Platform                          ║
║                                                                                              ║
╠══════════════════════════════════════════════════════════════════════════════════════════════╣
║                                                                                              ║
║                           ╭──────────────────────────────────────────╮                       ║
║                           │  AI ASSISTANTS & CLIENTS                 │                       ║
║                           │  ┌─────────┐ ┌─────────┐ ┌──────────────┐│                       ║
║                           │  │ Claude  │ │ Cursor  │ │ Claude Code  ││                       ║
║                           │  │ Desktop │ │   IDE   │ │     CLI      ││                       ║
║                           │  └────┬────┘ └───┬─────┘ └──────┬───────┘│                       ║
║                           ╰───────┼──────────┼──────────────┼────────╯                       ║
║                                   │          │              │                                ║
║                                   └──────────┼──────────────┘                                ║
║                                              │                                               ║
║                                        ◀═══ MCP Protocol ═══▶                                ║
║                                              │                                               ║
║  ┌───────────────────────────────────────────┼──────────────────────────────────────────────┐║
║  │                                           ▼                                              │║
║  │  ╔════════════════════════════════════════════════════════════════════════════════════╗  │║
║  │  ║                         GEARTRADE MCP SERVER v1.1.0                                ║  │║
║  │  ║         69 Tools • 4 Resources • 31 Prompts • Modular Architecture                 ║  │║
║  │  ╚════════════════════════════════════════════════════════════════════════════════════╝  │║
║  │                                            │                                             │║
║  │                                            ▼                                             │║
║  │  ┌────────────────────────────────────────────────────────────────────────────────────┐  │║
║  │  │  MODULAR TOOL SYSTEM (69 Tools in 5 Categories)                                    │  │║
║  │  │  ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌──────────────────┐  │  │║
║  │  │  │ ACCOUNT (10)    │ │ ANALYSIS (15)   │ │ DATA (3)        │ │ INDICATORS (35)  │  │  │║
║  │  │  │ ─────────────── │ │ ─────────────── │ │ ─────────────── │ │ ──────────────── │  │  │║
║  │  │  │ • Account Ops   │ │ • Market        │ │ • Price Data    │ │ • Moving Avg (10)│  │  │║
║  │  │  │   (6 ops)       │ │   Sentiment     │ │ • Positions     │ │ • Oscillators(18)│  │  │║
║  │  │  │ • Bridge Ops    │ │ • Technical     │ │ • Long/Short    │ │ • Channels (3)   │  │  │║
║  │  │  │   (2 ops)       │ │   Analysis      │ │   Ratio         │ │ • Pivots (3)     │  │  │║
║  │  │  │ • AI Memory (8) │ │ • Whale Track   │ │                 │ │ • Volatility (6) │  │  │║
║  │  │  │   - Preferences │ │ • Tier Class    │ │                 │ │ • Volume (8)     │  │  │║
║  │  │  │   - Trade Log   │ │ • Patterns      │ │                 │ │ • Trend (6)      │  │  │║
║  │  │  │   - Insights    │ │ • Liquidations  │ │                 │ │ • Strength (4)   │  │  │║
║  │  │  │   - Recall      │ │ • Order Book    │ │                 │ │ • Patterns (3)   │  │  │║
║  │  │  └─────────────────┘ └─────────────────┘ └─────────────────┘ └──────────────────┘  │  │║
║  │  │  ┌─────────────────────────────────────────────────────────────────────────────┐   │  │║
║  │  │  │ TRADING (6)                                                                 │   │  │║
║  │  │  │ ────────────────────────────────────────────────────────────────────────────│   │  │║
║  │  │  │ • Futures Trading (Testnet/Mainnet) • Spot Trading • Position Close         │   │  │║
║  │  │  │ • Risk Management (2 tools)          • Auto-retry Slippage 0.010% → 8.00%   │   │  │║
║  │  │  └─────────────────────────────────────────────────────────────────────────────┘   │  │║
║  │  └────────────────────────────────────────────────────────────────────────────────────┘  │║
║  │                                            │                                             │║
║  │                                            ▼                                             │║
║  │  ┌────────────────────────────────────────────────────────────────────────────────────┐  │║
║  │  │  CORE ANALYSIS ENGINE                                                              │  │║
║  │  │  ┌────────────────────────────┐           ┌──────────────────────────────────┐     │  │║
║  │  │  │  TECHNICAL ANALYSIS        │           │  AI MEMORY (Mem0 Platform)       │     │  │║
║  │  │  │  ────────────────────────  │           │  ──────────────────────────────  │     │  │║
║  │  │  │  • 35+ Indicators          │           │  • Vector Search & Recall        │     │  │║
║  │  │  │  • CVD & Volume Profile    │           │  • LLM Memory Extraction         │     │  │║
║  │  │  │  • Market Structure        │           │  • Trading Preferences Storage   │     │  │║
║  │  │  │  • Multi-Timeframe (MTF)   │           │  • Trade Journal & History       │     │  │║
║  │  │  │  • Divergence Detection    │           │  • Pattern Win Rate Analysis     │     │  │║
║  │  │  │  • Risk Calculations       │           │  • Personalized Insights         │     │  │║
║  │  │  └────────────────────────────┘           └──────────────────────────────────┘     │  │║
║  │  └────────────────────────────────────────────────────────────────────────────────────┘  │║
║  │                                            │                                             │║
║  │                                            ▼                                             │║
║  │  ┌────────────────────────────────────────────────────────────────────────────────────┐  │║
║  │  │  EXTERNAL DATA SOURCES                                                             │  │║
║  │  │  ┌────────────────────┐ ┌────────────────────┐ ┌────────────────────┐ ┌──────────┐ │  │║
║  │  │  │  HYPERLIQUID API   │ │  HYPERSCREENER     │ │  BINANCE API       │ │ MEM0 API │ │  │║
║  │  │  │  ────────────────  │ │  ────────────────  │ │  ────────────────  │ │──────────│ │  │║
║  │  │  │  • Live Prices     │ │  • Whale Positions │ │  • Historical OHLCV│ │ • Memory │ │  │║
║  │  │  │  • L2 Order Book   │ │  • Liquidations    │ │  • Multi-Timeframe │ │   Store  │ │  │║
║  │  │  │  • Funding Rates   │ │  • L/S Ratio       │ │  • Volume Data     │ │ • Vector │ │  │║
║  │  │  │  • Open Interest   │ │  • Large Trades    │ │  • Market Stats    │ │   Search │ │  │║
║  │  │  │  • Trade Execution │ │  • Top Traders     │ │  • Correlations    │ │ • LLM    │ │  │║
║  │  │  │  • Account Ops     │ │  • Heatmaps        │ │                    │ │   Extract│ │  │║
║  │  │  │  • Spot Trading    │ │  • Tier Data       │ │                    │ │          │ │  │║
║  │  │  │  • Bridge to L1    │ │  • Market Summary  │ │                    │ │          │ │  │║
║  │  │  └────────────────────┘ └────────────────────┘ └────────────────────┘ └──────────┘ │  │║
║  │  └────────────────────────────────────────────────────────────────────────────────────┘  │║
║  │                                            │                                             │║
║  │                                            ▼                                             │║
║  │  ┌────────────────────────────────────────────────────────────────────────────────────┐  │║
║  │  │  AI & SECURITY LAYER                                                               │  │║
║  │  │  ┌──────────────────────────┐         ┌────────────────────────────────────────┐   │  │║
║  │  │  │  AI PROMPTS (31)         │         │  SECURITY & VALIDATION                 │   │  │║
║  │  │  │  ──────────────────────  │         │  ──────────────────────────────────    │   │  │║
║  │  │  │  • Day Trading (9)       │         │  • Zod Schema Validation               │   │  │║
║  │  │  │  • Swing Trading (11)    │         │  • Mainnet Confirmation Required       │   │  │║
║  │  │  │  • Position Trading (11) │         │  • Auto-retry Slippage (0.010%-8.00%)  │   │  │║
║  │  │  │  • Risk Management       │         │  • Asset Whitelist (Mainnet)           │   │  │║
║  │  │  │  • Oscillators Analysis  │         │  • Position Size Limits (Max 25%)      │   │  │║
║  │  │  │  • MA Analysis           │         │  • Min Order Value ($10)               │   │  │║
║  │  │  └──────────────────────────┘         └────────────────────────────────────────┘   │  │║
║  │  └────────────────────────────────────────────────────────────────────────────────────┘  │║
║  │                                            │                                             │║
║  │                                            ▼                                             │║
║  │  ┌────────────────────────────────────────────────────────────────────────────────────┐  │║
║  │  │  STREAMING & EXECUTION INFRASTRUCTURE                                              │  │║
║  │  │  ┌─────────────────────────────┐     ┌─────────────────────────────────────────┐   │  │║
║  │  │  │  HTTP/SSE STREAMING         │     │  HYPERLIQUID EXECUTION ENGINE           │   │  │║
║  │  │  │  • Port: localhost:8787     │     │  • Futures: Testnet/Mainnet             │   │  │║
║  │  │  │  • Server-Sent Events       │     │  • Spot: Market/Limit Orders            │   │  │║
║  │  │  │  • mcp-remote Compatible    │     │  • Account: 6 Operations                │   │  │║
║  │  │  │  • Real-time Tool Updates   │     │  • Bridge: Arbitrum L1 (3h)             │   │  │║
║  │  │  │  • Cross-platform Scripts   │     │  • Slippage: Auto-retry 0.010%-8.00%    │   │  │║
║  │  │  └─────────────────────────────┘     └─────────────────────────────────────────┘   │  │║
║  │  └────────────────────────────────────────────────────────────────────────────────────┘  │║
║  └──────────────────────────────────────────────────────────────────────────────────────────┘║ 
╚══════════════════════════════════════════════════════════════════════════════════════════════╝

Component Details

🎯 MCP Protocol Layer

• Tool Execution: 58 specialized analysis & trading tools for comprehensive market intelligence
• Resource Management: 22 detailed documentation resources for research and education
• Prompt System: 32 AI-optimized prompts for structured analysis workflows

🔒 Security & Validation Layer

• Input Validation: Comprehensive Zod schema validation for all data inputs
• Trading Safety: Mainnet trading requires explicit confirmation, asset whitelist, position size limits
• Testnet Support: Full trading capabilities on testnet for safe testing
• Configurable Slippage: Dynamic slippage with auto-retry (0.01% to 50%)

📊 Analysis Engine Components

• Technical Indicators: 35+ indicators across momentum, volume, volatility, and trend analysis
• CVD (Cumulative Volume Delta): Real-time buy/sell pressure analysis with trend detection
• Market Structure: Advanced change-of-character detection, market regime analysis, and fractal analysis
• Volume Profile: POC, VAH, VAL, HVN, LVN for session and composite analysis
• Multi-Timeframe: Cross-timeframe trend alignment (Daily, 4H, 1H) and confirmation signals
• Risk Management: Position sizing, stop-loss, take-profit, and R:R calculations

🧠 AI Memory Layer (Mem0)

• Trading Preferences: Persistent storage of leverage, risk %, pairs, trading style
• Trade Journal: Auto-logged trades with entry/exit reasons, PnL, lessons learned
• Pattern Learning: Historical pattern matching with win rate analysis
• Personalized Insights: Context-aware recommendations based on user history
• Vector Search: Semantic search across all stored memories

🌐 Data Integration

🐋 HyperScreener API Integration

• Base URL: https://api-hyperliquid.asxn.xyz/api
• Liquidations: /node/liquidations, /node/liquidations/{SYMBOL}, /node/liquidations/summary
• Positions: /node/positions, /node/positions/{SYMBOL}, /node/positions/{SYMBOL}/long|short
• Market Summary: /node/market/summary, /node/market/summary/{SYMBOL}
• Market Data: /market-data/funding-rates, /market-data/open-interest, /market-data/volume, /market-data/stats/24h
• Total: 14 verified endpoints with proper error handling and response parsing

🐋 HyperScreener Integration

The server integrates data from HyperScreener API (https://api-hyperliquid.asxn.xyz/api) to provide whale and liquidation intelligence:

HyperScreener API Endpoints

Enhanced Hyperliquid Data

📁 Project Structure

mcp-technical-analysis/
├── packages/
│   ├── .env.example                        # Environment variables template
│   └── geartrade-mcp-server/               # Main MCP server package (v1.1.0)
│       ├── src/                            # Source code (TypeScript)
│       │   ├── index.ts                    # Entry point (804 lines, 83.8% reduction!)
│       │   │                               # Registers 69 tools, 31 prompts, 4 resources
│       │   ├── formatters/                 # Output formatting utilities (17 files)
│       │   │   ├── indicators.ts           # Technical indicator formatting
│       │   │   ├── volume.ts               # Volume analysis formatting
│       │   │   ├── orderbook.ts            # Order book depth formatting
│       │   │   ├── liquidation.ts          # Liquidation levels formatting
│       │   │   ├── position.ts             # Position data formatting
│       │   │   └── ...                     # 12 other formatters
│       │   ├── memory/                     # AI Memory (Mem0) integration
│       │   │   └── [Memory storage files]  # Trade journal, preferences
│       │   ├── prompts/                    # AI prompt templates (31 prompts)
│       │   │   └── index.ts                # Day/Swing/Position trading workflows
│       │   ├── resources/                  # Educational resources (4 resources)
│       │   │   └── index.ts                # Trading guides and references
│       │   ├── server/                     # HTTP/SSE infrastructure
│       │   │   ├── cors.ts                 # CORS middleware
│       │   │   └── json-rpc.ts             # JSON-RPC 2.0 handler
│       │   ├── tools/                      # 69 MCP tools (Modular Architecture ✨)
│       │   │   ├── README.md               # Tools documentation
│       │   │   ├── index.ts                # Main registration (imports all categories)
│       │   │   ├── account/                # Account tools (10 tools)
│       │   │   │   ├── index.ts            # Export all account tools
│       │   │   │   ├── hyperliquid-account-operations.ts   # 1 tool, 6 operations
│       │   │   │   ├── hyperliquid-bridge-operations.ts    # 1 tool, 2 operations
│       │   │   │   └── memory-tools.ts     # 8 AI memory tools
│       │   │   ├── analysis/               # Analysis tools (15 tools)
│       │   │   │   ├── index.ts            # Export all analysis tools
│       │   │   │   ├── market-sentiment.ts # Market sentiment (1 tool)
│       │   │   │   ├── technical-analysis-tools.ts   # Indicators, volume, MTF (3 tools)
│       │   │   │   ├── market-data-tools.ts          # Orderbook, liquidations, correlation (4 tools)
│       │   │   │   ├── pattern-analysis-tools.ts     # Patterns, structure, regime (5 tools)
│       │   │   │   └── whale-analysis-tools.ts       # Whale tracking, tiers (2 tools)
│       │   │   ├── data/                   # Data tools (3 tools)
│       │   │   │   ├── index.ts            # Export all data tools
│       │   │   │   └── price-position-tools.ts       # Price, position, long/short (3 tools)
│       │   │   ├── indicators/             # Indicator tools (35 tools)
│       │   │   │   ├── index.ts            # Export all indicator tools
│       │   │   │   ├── moving-averages.ts  # 10 MA indicators
│       │   │   │   ├── oscillators.ts      # 14 oscillator indicators
│       │   │   │   ├── channels.ts         # 3 channel indicators (merged)
│       │   │   │   ├── pivot-points.ts     # 3 pivot indicators (merged)
│       │   │   │   ├── trend-indicators.ts # 6 trend indicators (merged)
│       │   │   │   ├── patterns.ts         # 3 pattern indicators (merged)
│       │   │   │   ├── strength-indicators.ts     # 4 strength indicators (merged)
│       │   │   │   ├── volatility-indicators.ts   # 6 volatility indicators (merged)
│       │   │   │   └── volume-indicators.ts       # 8 volume indicators (merged)
│       │   │   └── trading/                # Trading tools (6 tools)
│       │   │       ├── index.ts            # Export all trading tools
│       │   │       ├── hyperliquid-testnet-futures-trade.ts  # Testnet futures
│       │   │       ├── hyperliquid-mainnet-futures-trade.ts  # Mainnet futures
│       │   │       ├── spot-trading.ts     # Spot trading
│       │   │       ├── close-position.ts   # Position closing
│       │   │       └── risk-management-tools.ts   # Risk calculations (2 tools)
│       │   └── signal-generation/          # Core analysis engine
│       │       ├── analysis/               # Market analysis algorithms
│       │       │   ├── bounce.ts           # Bounce detection
│       │       │   ├── candlestick.ts      # Pattern recognition
│       │       │   ├── divergence.ts       # RSI divergence
│       │       │   ├── market-regime.ts    # Regime classification
│       │       │   ├── market-structure.ts # Structure analysis
│       │       │   ├── tier-classification.ts  # Trader tiers
│       │       │   ├── trend-detection.ts  # Trend identification
│       │       │   └── volume-analysis.ts  # Volume profile
│       │       ├── data-fetchers/          # External API integrations
│       │       │   ├── hyperliquid.ts      # Hyperliquid exchange API
│       │       │   ├── hyperscreener.ts    # HyperScreener liquidations/whales
│       │       │   └── market-data.ts      # Multi-source aggregation
│       │       ├── exit-conditions/        # Exit strategy calculations
│       │       │   └── stop-loss.ts        # SL/TP calculations
│       │       ├── risk-management/        # Risk calculations
│       │       │   ├── leverage.ts         # Dynamic leverage
│       │       │   └── margin.ts           # Margin requirements
│       │       ├── technical-indicators/   # 35+ indicator implementations
│       │       │   ├── momentum.ts         # RSI, MACD, Stochastic
│       │       │   ├── fibonacci.ts        # Fibonacci retracement
│       │       │   ├── correlation-analysis.ts  # BTC correlation
│       │       │   └── ...                 # 32 other indicators
│       │       ├── types/                  # TypeScript type definitions
│       │       └── utils/                  # Utility functions
│       ├── dist/                           # Compiled JavaScript output
│       ├── package.json                    # Package v1.1.0 configuration
│       ├── tsconfig.json                   # TypeScript configuration
│       └── local-server.ts                 # HTTP/SSE streaming server
├── scripts/                                # Automation scripts
│   ├── mcp-auto-start.sh                   # Linux/Mac auto-start
│   └── mcp-auto-start.bat                  # Windows auto-start
├── package.json                            # Workspace root config (v1.1.0)
├── pnpm-workspace.yaml                     # PNPM workspace config
├── pnpm-lock.yaml                          # Dependency lock file
├── mcp.json                                # MCP configuration
├── LICENSE                                 # MIT License
└── README.md                               # This file

📊 Code Statistics:
  - Total Files: 150+
  - Total Lines: 30,000+
  - TypeScript: 100%
  - Components: 104 (69 tools + 31 prompts + 4 resources)
  - Main File Reduction: 4,943 → 804 lines (83.8% reduction!)

Key Directories

📝 README Files (16 total):

• 1 root README.md
• 3 main directory READMEs (scripts/, packages/, geartrade-mcp-server/)
• 3 src/ READMEs (src/, memory/, signal-generation/)
• 9 subdirectory READMEs (formatters/, prompts/, resources/, server/, tools/account/, tools/analysis/, tools/data/, tools/indicators/, tools/trading/)

🛠️ Development

# Development mode
pnpm run dev

# Build
pnpm run build

# Validate MCP config
pnpm run validate

# List tools & resources
pnpm run list

🔐 Security & Trading Safety

Analysis & Trading Environment

This server provides both market analysis and trading execution capabilities with comprehensive safety measures.

Security Features:

• ✅ Zod schema validation for all inputs
• ✅ Testnet trading for safe testing (no real funds)
• ✅ Mainnet safety checks:
  • Futures: confirmExecution: true required, asset whitelist, min $10, max 25% equity
  • Spot: confirmMainnet: true required, start with small amounts ($5-10)
  • Account Ops: confirmMainnet: true for transfers and withdrawals
  • Bridge: 3-hour withdrawal to Arbitrum L1 with status tracking
• ✅ Slippage protection:
  • Futures: 0.01% - 50% configurable
  • Spot: 0.010% - 8.00% automatic retry (same mechanism as futures)
• ✅ Auto-fallback to GTC orders on no liquidity
• ✅ Environment variables for wallet security:
  • AGENT_WALLET_PRIVATE_KEY - API wallet private key
  • MAIN_WALLET_ADDRESS - Main trading account address
  • MEM0_API_KEY - Persistent AI memory
  • ARBITRUM_RPC_URL - L1 bridge endpoint (DRPC recommended)

🌐 API Endpoints (HTTP Streaming Mode)

When running bash scripts/mcp-auto-start.sh:

Test Commands:

# Health check
curl http://localhost:8787/health

# List all tools
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Get BTC price
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ticker":"BTC"}}}'

Made with ❤️ by the GearTrade Team