Ccxt Mcp Server

🚀 CCXT MCP Server

[](./docs/standards/TAPS-v1.0-STANDARD.md) [](https://github.com/ccxt/ccxt) [](./LICENSE)

Universal cryptocurrency exchange access for Claude - Trade on 100+ exchanges through a single MCP interface!

🌟 What This Does

graph LR
    A[Claude Desktop] --> B[CCXT MCP Server]
    B --> C[CCXT Library]
    C --> D[Binance]
    C --> E[Coinbase]
    C --> F[Kraken]
    C --> G[Bybit]
    C --> H[...100+ more]

    style A fill:#f9f,stroke:#333,stroke-width:2px,color:#000
    style B fill:#bbf,stroke:#333,stroke-width:4px,color:#000
    style C fill:#bfb,stroke:#333,stroke-width:2px,color:#000
    style D fill:#fff,stroke:#333,stroke-width:1px,color:#000
    style E fill:#fff,stroke:#333,stroke-width:1px,color:#000
    style F fill:#fff,stroke:#333,stroke-width:1px,color:#000
    style G fill:#fff,stroke:#333,stroke-width:1px,color:#000
    style H fill:#fff,stroke:#333,stroke-width:1px,color:#000

This MCP server gives Claude the ability to:

• 📈 Get real-time prices from any crypto exchange
• 📊 Analyze order books and market depth
• 🔄 Compare prices across exchanges instantly
• 💰 Detect arbitrage opportunities automatically
• 📉 Fetch historical data for technical analysis
• 📐 Calculate technical indicators (RSI, MACD, Bollinger Bands, ATR, Stochastic, Ichimoku)

⚡ Quick Start (2 minutes)

1️⃣ Install

# Clone the repository
git clone https://github.com/MyronKoch/ccxt-mcp-server.git
cd ccxt-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

2️⃣ Add to Claude Desktop

{
  "mcpServers": {
    "ccxt-mcp-server": {
      "command": "node",
      "args": ["/path/to/ccxt-mcp-server/dist/index.js"]
    }
  }
}

3️⃣ Restart Claude & Trade!

Ask Claude: "What's the price of Bitcoin on Binance?"

🛠️ Available Tools

📋 Exchange Management

| Tool | Description | Example | |------|-------------|---------| | exchange_list | List all 106 supported exchanges | "Show me all available exchanges" | | exchange_init | Connect to specific exchange | "Initialize Binance connection" | | exchange_status | Check if exchange is working | "Is Coinbase operational?" | | exchange_markets | Get trading pairs | "What pairs does Kraken support?" |

📊 Market Data (No Auth Required!)

| Tool | Description | Example | |------|-------------|---------| | market_ticker | Current prices | "BTC price on Binance" | | market_orderbook | Bids & asks | "Show ETH order book" | | market_trades | Recent trades | "Latest SOL trades" | | market_ohlcv | Candlestick data | "1-hour BTC chart data" |

💼 Account & Analytics

| Tool | Description | Example | |------|-------------|---------| | account_balance | Check balances (requires env API keys) | "My Binance balance" | | analytics_compare_prices | Multi-exchange comparison | "Compare ETH on all exchanges" |

📐 Technical Analysis

| Tool | Description | Example | |------|-------------|---------| | indicators_calculate | Calculate technical indicators | "Calculate RSI and MACD for BTC/USDT on Binance" |

Supported Indicators:

• RSI - Relative Strength Index (overbought/oversold detection)
• MACD - Moving Average Convergence Divergence (trend detection)
• Bollinger Bands - Volatility and price range analysis
• ATR - Average True Range (volatility measurement)
• Stochastic - Momentum oscillator
• Ichimoku Cloud - Comprehensive trend analysis

🎯 Killer Features

🔍 Arbitrage Detection

graph TD
    A[Check BTC Price] --> B{Price Difference?}
    B -->|Yes| C[Buy on Exchange A]
    C --> D[Sell on Exchange B]
    D --> E[💰 Profit!]
    B -->|No| F[Keep Monitoring]

    style A fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style B fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style C fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style D fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style E fill:#0f0,stroke:#333,stroke-width:2px,color:#000
    style F fill:#fff,stroke:#333,stroke-width:2px,color:#000

The server automatically detects when the same asset has different prices across exchanges!

⚡ Real Examples

You: "Compare Bitcoin prices across major exchanges"

Claude: Analyzing BTC/USDT across exchanges...

📊 Price Comparison:
• Binance:   $67,234.50 
• Coinbase:  $67,256.00 (+$21.50)
• Kraken:    $67,245.75 (+$11.25)
• Bybit:     $67,232.00 (-$2.50)

🎯 Arbitrage Opportunity Detected!
Buy on Bybit at $67,232.00
Sell on Coinbase at $67,256.00
Potential profit: $24.00 per BTC (0.036%)

You: "Calculate RSI and MACD for BTC/USDT on Binance"

Claude: Analyzing Bitcoin technical indicators...

📐 Technical Analysis (1-hour timeframe):

RSI (14): 58.32
• Signal: Neutral
• Not overbought (>70) or oversold (Singleton Pattern]
        D[Response FormatterTAPS Compliance]
        E[Validation UtilsInput Safety]
    end

    subgraph CCXT[CCXT Integration]
        F[106 Exchange APIs]
        G[Normalized Data]
        H[Rate Limiting]
    end

    MCP --> Core
    Core --> CCXT

    style A fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style B fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style C fill:#bbf,stroke:#333,stroke-width:2px,color:#000
    style D fill:#bbf,stroke:#333,stroke-width:2px,color:#000
    style E fill:#bbf,stroke:#333,stroke-width:2px,color:#000
    style F fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style G fill:#fff,stroke:#333,stroke-width:2px,color:#000
    style H fill:#fff,stroke:#333,stroke-width:2px,color:#000

TAPS v1.0 Response Format

{
  "success": true,
  "data": {
    "symbol": "BTC/USDT",
    "bid": 67234.50,
    "ask": 67235.00,
    "last": 67234.75
  },
  "metadata": {
    "exchange": "binance",
    "timestamp": 1738123456789,
    "rateLimit": { "remaining": 99, "reset": 1738123460 },
    "version": "TAPS-1.0.0"
  }
}

🔒 Security

• 🔐 Environment-only credentials - API keys MUST be set via environment variables (never in request parameters)
• ⏱️ Adaptive rate limiting - Automatic exponential backoff prevents exchange bans
• 🔄 Automatic retries - Smart retry logic (up to 5 attempts) with backoff
• 🛡️ Input validation - Prevents costly mistakes and malformed requests
• 🧹 Credential sanitization - No leaks in logs or responses
• ✅ Testnet support - Safe development environment

Setting Up API Credentials

For account operations, set credentials as environment variables:

# .env file
BINANCE_API_KEY=your_api_key_here
BINANCE_SECRET=your_secret_here

# For other exchanges, use: EXCHANGEID_API_KEY and EXCHANGEID_SECRET
COINBASE_API_KEY=...
COINBASE_SECRET=...

Security Note: Credentials are NEVER accepted as tool parameters to prevent leakage in MCP logs.

📈 Supported Exchanges (106 Total!)

🌟 Tier 1 - Fully Tested

• Binance (+ Testnet)
• Coinbase (+ Sandbox)
• Kraken
• Bybit (+ Testnet)
• OKX

🚀 Tier 2 - Major Exchanges

• Bitfinex
• Huobi
• Gate.io
• KuCoin
• Bitget
• Bitstamp
• Gemini
• Crypto.com
• MEXC
• And 90+ more...

🧑‍💻 Development

# Install dependencies
npm install

# Development mode with hot reload
npm run dev

# Build for production
npm run build

# Run tests
npm test

Project Structure

ccxt-mcp-server/
├── src/
│   ├── index.ts                    # Main MCP server
│   ├── exchange-manager.ts         # Exchange instance management with rate limiting
│   ├── response-formatter.ts       # TAPS response formatting
│   ├── arbitrage/
│   │   └── advanced-scanner.ts     # Real-time arbitrage detection
│   ├── cache/
│   │   └── lru-cache-manager.ts    # LRU caching for market data
│   ├── indicators/
│   │   └── technical-analysis.ts   # RSI, MACD, Bollinger, ATR, Stochastic, Ichimoku
│   ├── rate-limiting/
│   │   └── adaptive-limiter.ts     # Exponential backoff retry logic
│   ├── risk/
│   │   └── risk-manager.ts         # Kelly Criterion, position sizing
│   ├── utils/
│   │   └── validation.ts           # Input validation and sanitization
│   └── types/
│       └── taps.ts                 # TAPS v1.0 type definitions
├── dist/                           # Compiled JavaScript
├── tests/                          # Comprehensive test suite
└── docs/
    ├── standards/
    │   └── TAPS-v1.0-STANDARD.md  # Protocol specification
    ├── architecture/
    │   └── ARCHITECTURE.md         # System design
    └── guides/
        └── TESTING-GUIDE.md        # Testing documentation

🐛 Troubleshooting

| Issue | Solution | |-------|----------| | "Exchange not found" | Check exact exchange ID (lowercase, e.g., binance not Binance) | | "Rate limit exceeded" | Server auto-retries with exponential backoff (up to 5 attempts) | | "Invalid symbol" | Use format: BTC/USDT not BTCUSDT | | "No balance data" | Set EXCHANGEID_API_KEY and EXCHANGEID_SECRET environment variables | | "Invalid credentials" | Credentials must be in .env file, NOT in tool parameters | | Build errors | Run npm install to ensure all dependencies are installed | | Type errors | Run npm run build - TypeScript is configured with Node.js types |

📊 Performance

• ⚡ Response time:

Built with ❤️ by Myron Koch First universal crypto exchange MCP server ever created! CCXT • TAPS v1.0 • MCP

📚 Documentation

• [TAPS v1.0 Standard](./docs/standards/TAPS-v1.0-STANDARD.md) - Trading API Protocol Standard specification
• [Architecture Guide](./docs/architecture/ARCHITECTURE.md) - System design and patterns
• [Testing Guide](./docs/guides/TESTING-GUIDE.md) - Comprehensive testing documentation
• [Implementation Roadmap](./docs/roadmaps/IMPLEMENTATION-ROADMAP.md) - Development phases
• [Ultimate Roadmap](./docs/roadmaps/ULTIMATE-IMPLEMENTATION-ROADMAP.md) - Future vision & competitive analysis

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MyronKoch
• Source: MyronKoch/ccxt-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.