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)

Tool	Description
get_balance	Get account balance (spot or futures)
get_positions	Get open futures positions with P&L

Market Data Tools (6)

Tool	Description
get_ticker	Get current price for spot or perpetual pair
get_multiple_tickers	Get ticker data for multiple symbols at once
get_orderbook	Get order book depth
get_ohlcv	Get historical candlesticks (OHLCV)
get_all_pairs	Get all USDT pairs with volume and spread
get_spread	Get bid-ask spread for a pair

Order Tools (4)

Tool	Description
place_order	Place spot or perpetual order (demo mode simulates)
cancel_order	Cancel an open order
cancel_all_orders	Cancel all open orders (optionally for specific symbol)
get_open_orders	List all open orders

Futures Tools (2)

Tool	Description
set_leverage	Set leverage for perpetual futures (1-125x)
get_leverage	Get current leverage setting

Technical Analysis Tools (2)

Tool	Description
analyze_symbol_ta	Full TA analysis (RSI, MACD, EMA, Bollinger, Stochastic) with buy/sell/hold recommendation
get_indicator	Get specific indicator (RSI, MACD, EMA, Bollinger, Stochastic, or all)

Market Scanning Tools (3)

Tool	Description
find_ta_signals	Scan ALL USDT pairs for TA signals, ranked by confidence
scan_spreads	Find wide bid-ask spreads for market-making opportunities
scan_best_opportunities	Comprehensive scan combining spread, volume, and TA signals

System Tools (1)

Tool	Description
get_mode	Get current trading mode (demo/live)

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

Mode	Description
demo	Orders are simulated (safe for testing)
live	Orders are real (use with caution)

Always start with demo mode!

Technical Analysis

The server includes 5 technical indicators:

Indicator	Description	Signal Generation
RSI (14)	Relative Strength Index	Oversold <35, Overbought >65
MACD (12,26,9)	Moving Average Convergence Divergence	Crossovers and histogram
EMA (9,21)	Exponential Moving Averages	Crossovers and trend
Bollinger Bands (20,2)	Price bands based on std deviation	Position within bands
Stochastic (14,3)	Momentum oscillator	Oversold <20, Overbought >80

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

Environment Variable	Description	Default
EXCHANGE	Exchange name	mexc
MEXC_API_KEY	API key	-
MEXC_SECRET	API secret	-
TRADING_MODE	demo or live	demo
MARKET_TYPE	spot or swap	spot
LOG_LEVEL	Log level	info

Scanner Defaults

Parameter	Default	Description
MIN_VOLUME_USDT	50,000	Minimum 24h volume to analyze
MAX_PAIRS	100	Maximum pairs to scan
MIN_CONFIDENCE	50	Minimum TA signal confidence

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