MCP Technical Analysis

MCP server bridging AI assistants with crypto market analysis, delivering real-time data, technical insights, and trading signals. Ideal for research, analysis tools, or AI financial advisors across multiple assets and timeframes.

Generate Convert Improve

Install / Use

npx skills add FajarArrizki/mcp-technical-analysis

Installs into whichever agent you are using.

About this skill

Quality Score

0/100

README

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

| Tool | Data Status | |------|-------------| | get_External_data | ✅ longShortRatio, whalePositions, recentLiquidations, largeTrades, marketOverview | | get_long_short_ratio | ✅ hyperscreenerRatio, whalePositions, topTradersOverall | | get_liquidation_levels | ✅ liquidationHeatmap with price levels, recentLiquidations | | get_volume_analysis | ✅ CVD (cvdTrend, cvdDelta) |

🏠 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