GearTrade MCP Server

Model Context Protocol Server for AI-Powered Cryptocurrency Trading

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

** Key Features:**

• 38+ Trading Tools - Complete analysis & execution toolkit
• Real-time Market Data - Live prices, indicators, volume analysis
• Advanced Technical Analysis - RSI, MACD, Fibonacci, Order Book, etc.
• Risk Management - Position sizing, stop loss, take profit calculations
• Multi-Timeframe Analysis - Daily, 4H, 1H trend alignment
• 23 AI Prompts - Pre-configured trading workflows
• 19 Resources - Comprehensive trading documentation
• Streaming Support - HTTP/SSE for real-time updates
• Paper Trading - Test strategies without risk
• Live Execution - Trade on Hyperliquid (optional)

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

Live Deployment: https://geartrade-mcp-server.fajararrizki15.workers.dev/

What's Included

38+ Complete Trading Tools

• Price Tools (2): Real-time pricing for single/multiple assets
• Technical Analysis (2): 20+ indicators (RSI, EMA, MACD, Bollinger Bands, ATR, ADX, etc.)
• Volume Analysis (2): Buy/sell pressure, CVD, liquidity zones analysis
• Multi-Timeframe (2): Daily, 4H, 1H trend alignment analysis
• Advanced Analysis (3): Fibonacci, Order Book Depth, Liquidation Levels
• Market Analysis (8): Volume Profile, Market Structure, Candlestick Patterns, Divergence, Long/Short Ratio, Spot-Futures Divergence, External Data
• Risk Management (2): Position sizing, stop loss, take profit calculations
• Comprehensive Analysis (2): Complete crypto analysis with position setup
• Execution Tools (4): Spot & Futures trading (paper trading + live execution)
• Batch Operations (11): Multi-asset analysis for all above tools

19 Trading Resources

• geartrade://trading-strategies - Comprehensive trading strategies guide
• geartrade://risk-management - Risk management best practices
• geartrade://tools-overview - Complete tools overview
• geartrade://execution-workflow - Analysis to execution workflow
• geartrade://technical-indicators-guide - Technical indicators guide
• geartrade://hyperliquid-api-reference - Hyperliquid API reference
• Plus 13 more specialized guides (volume analysis, fibonacci, orderbook, etc.)

23 AI Trading Prompts

• Core Trading: analyze_and_execute, multi_asset_scan, comprehensive_analysis
• Technical Analysis: technical_indicator_analysis, volume_profile_analysis, market_structure_analysis
• Advanced: divergence_scan, liquidation_analysis, fibonacci_trading_strategy, spot_futures_arbitrage
• Risk Management: risk_analysis, position_monitoring, portfolio_review, volatility_analysis
• Plus 12 more specialized prompts

Quick Start

Fastest Way - Streaming Mode (Recommended)

# Terminal 1 - Start Streaming Server
bash scripts/start-mcp-stream.sh

# Terminal 2 - Connect Terminal UI
pnpm run terminal

Server runs at http://localhost:8787 with SSE streaming support!

Full Guide: See QUICKSTART.md and STREAMING_GUIDE.md

Installation:

# Clone the repository
git clone https://github.com/FajarArrizki/ai-trading-mcp-server.git
cd ai-trading-mcp-server

# Install dependencies
pnpm install

# Build the server
pnpm run build

Terminal UI (New!)

Interactive terminal interface untuk testing dan development - NO IMPORT ISSUES!

# Quick start
pnpm run terminal:build
pnpm run terminal

Features:

• Beautiful UI - Claude Code inspired design
• Zero Import Issues - Pure Node.js, deployment-ready
• Interactive Tools - Execute all 36 MCP tools
• Resource Access - Read all 25 resources
• Production Ready - Works everywhere, no bundling issues

Documentation:

• How to Use - Quick start guide
• Complete Guide - Full documentation
• Examples - Usage examples
• Deployment - Deploy anywhere
• Summary - Technical overview

Why Terminal UI?

Dibuat khusus untuk mengatasi masalah "pas di deployment ga bisa, karna mengunakan import":

• No dynamic imports
• No ESM/CJS conflicts
• Pure static imports
• Minimal dependencies
• Works in all environments

Configure MCP Client

Quick Start - MCP Integration

Option 1: HTTP Streaming Mode (Recommended)

Start the server:

cd /root/GEARTRADE
bash scripts/mcp-auto-start.sh

Server runs at http://localhost:8787 with SSE streaming support!

Configure Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "geartrade-local-stream": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/mcp"
      ],
      "env": {
        "AI_PROVIDER": "openrouter",
        "MODEL_ID": "openai/gpt-4-turbo",
        "OPENROUTER_API_KEY": "your_openrouter_api_key_here",
        "HYPERLIQUID_API_URL": "https://api.hyperliquid.xyz",
        "HYPERLIQUID_WALLET_API_KEY": "",
        "HYPERLIQUID_ACCOUNT_ADDRESS": "",
        "CANDLES_COUNT": "100"
      }
    }
  }
}

**Requi…