Useelk/trading-mcp-server

Trading MCP Server

MCP (Model Context Protocol) server for cryptocurrency trading with Claude Desktop. Connect to MEXC, Binance, Bybit, and other exchanges via CCXT.

Features

• 20 Trading Tools for Claude Desktop
• Multi-Exchange Support via CCXT (MEXC, Binance, Bybit, OKX, and 100+ more)
• Demo Mode for safe testing
• Real-time Market Data (tickers, orderbook, OHLCV, spreads)
• Technical Analysis (RSI, MACD, EMA, Bollinger Bands, Stochastic)
• Market Scanning (spread detection, TA signals, comprehensive opportunity finder)
• Order Management (place, cancel, list)
• Perpetual Futures (leverage, positions, P&L tracking)

Installation

npm install trading-mcp-server

Quick Start

1. Create .env file

EXCHANGE=mexc
MEXC_API_KEY=your_api_key
MEXC_SECRET=your_secret
TRADING_MODE=demo
MARKET_TYPE=spot

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "trading": {
      "command": "npx",
      "args": ["trading-mcp-server"],
      "env": {
        "EXCHANGE": "mexc",
        "MEXC_API_KEY": "your_key",
        "MEXC_SECRET": "your_secret",
        "TRADING_MODE": "demo"
      }
    }
  }
}

3. Restart Claude Desktop

Available Tools

Account Tools (2)

Market Data Tools (6)

Order Tools (4)

Futures Tools (2)

Technical Analysis Tools (2)

Market Scanning Tools (3)

System Tools (1)

Total: 20 Tools (2 Account + 6 Market + 4 Order + 2 Futures + 2 TA + 3 Scanner + 1 System)

Example Prompts for Claude

Account & Balance

"Show my balance"
"Show my futures balance"
"What are my open positions?"

Spot Trading

"Get the current price of BTC/USDT"
"Show me the top 10 pairs by volume"
"What's the spread on ETH/USDT?"
"Place a $50 market buy for SOL/USDT"

Perpetual Futures Trading

"Set 10x leverage for BTC/USDT:USDT short positions"
"Place a short order for 0.001 BTC/USDT:USDT at $90,000 with 10x leverage"
"Place a limit sell for BTC/USDT:USDT with stop loss at $91,000 and take profit at $88,000"
"Get current leverage for BTC/USDT:USDT"

Technical Analysis

"Run technical analysis on BTC/USDT"
"Find buy signals across all USDT pairs"
"What's the RSI for ETH/USDT on the 1h timeframe?"
"Show me all indicators for SOL/USDT"
"Find the top 10 buy signals with at least 60% confidence"

Market Scanning

"Scan for wide spreads with high volume"
"Find the best trading opportunities right now"
"Show me pairs with spreads above 0.2% and volume over 100k USDT"
"Find opportunities sorted by combined score"

Multi-Timeframe Analysis

"Analyze BTC/USDT across multiple timeframes"
"Find pairs with strong buy signals on 15m and 1h"

Trading Modes

Always start with demo mode!

Technical Analysis

The server includes 5 technical indicators:

TA Signal Confidence

The analyze_symbol_ta and find_ta_signals tools generate buy/sell recommendations based on consensus across all 5 indicators:

• 60%+ confidence (3/5 indicators agree) = Strong signal
• 80%+ confidence (4/5 indicators agree) = Very strong signal
• 100% confidence (5/5 indicators agree) = Unanimous signal

Market Scanning

Spread Scanner

Finds pairs with wide bid-ask spreads, useful for market-making strategies.

TA Signal Scanner

Scans all USDT pairs for technical analysis signals. Configurable:

• Signal type (buy/sell/any)
• Minimum confidence (1-100)
• Timeframe (1m, 5m, 15m, 1h, 4h, 1d)
• Volume filter
• Result limit

Best Opportunities Scanner

Comprehensive scanner that combines:

• Volume Score (20%): Higher volume = better liquidity
• Spread Score (30%): Wider spread = more profit potential
• TA Score (50%): Signal confidence from technical analysis

Returns opportunities sorted by combined score, confidence, volume, or spread.

Supported Exchanges

• MEXC
• Binance
• Bybit
• Bitget
• OKX
• And 100+ more via CCXT

Programmatic Usage

import { TradingMCPServer, ExchangeAdapter } from 'trading-mcp-server';

const server = new TradingMCPServer({
  exchange: 'mexc',
  apiKey: 'your_key',
  secret: 'your_secret',
  mode: 'demo',
  marketType: 'spot'
});

await server.run();

Configuration

Scanner Defaults

Security

• Never share your API keys
• Use API keys without withdrawal permission
• Start with demo mode
• Set conservative limits
• Test with small amounts first

Changelog

v1.2.0

• Added cancel_all_orders tool (20 total tools)
• Added clientOrderId passthrough for idempotent order placement
• Improved error logging in scanner tools
• Added comprehensive .env.example template
• Added .npmignore for cleaner npm packages
• Bug fixes and stability improvements
• Added 9 new tools (19 total, up from 10)
• Technical analysis with 5 indicators
• Market scanning for spreads and TA signals
• Comprehensive opportunity finder
• Multi-symbol analysis support
• Futures positions tracking

v1.0.0

• Initial release with 10 basic trading tools
• Spot and perpetual futures support
• Demo mode for safe testing

License

MIT