Crypto MCP - Complete Documentation

🌟 Overview

Crypto MCP is a comprehensive Model Context Protocol server providing 61+ tools for cryptocurrency analysis, trading, and market intelligence. Built with modern web technologies and AI integration.

🪙 Real-time Data

Live cryptocurrency prices, market data, and technical indicators from CoinGecko and Binance APIs.

🏦 Trading Integration

Full Bitget futures trading support with account management, order execution, and position tracking.

🤖 AI-Powered

Integrated OpenRouter AI assistant with access to all tools for intelligent market analysis.

⚡ Quick Start

🌐 Web Interface

Visit the main dashboard
Click "🎓 Complete Walkthrough" for guided tour
Try demo buttons for quick examples
Configure API keys for trading features
Chat with AI assistant about crypto markets

🔧 MCP Integration

Download the local MCP server
Add configuration to Claude Desktop
Set environment variables for trading
Restart Claude Desktop
Access 61+ tools in Claude conversations

⚙️ Configuration

Remote Service Access

🌐 No Configuration Required

This is a hosted service. Simply use the MCP endpoint below - no environment variables or local setup needed.

API Key Setup

🔑 Required for Trading

• Bitget API Key: For futures trading
• Bitget Secret: For authentication
• Bitget Passphrase: For secure access

Get these from Bitget API settings

🌐 Optional Enhancements

• CoinGecko Pro: Higher rate limits
• Serper API: Web search capabilities
• CryptoPanic: News aggregation

Free versions work with rate limits

🔗 MCP Integration

Claude Desktop

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "crypto-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/crypto-mcp/enhanced-local-mcp-server.js"
      ],
      "env": {
        "BITGET_API_KEY": "your_api_key_here",
        "BITGET_API_SECRET": "your_secret_here", 
        "BITGET_PASSPHRASE": "your_passphrase_here"
      }
    }
  }
}

Config Locations:
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Cline/Roocode

MCP Server URL: https://crypto-6ierws6lm-fr3k-ais-projects.vercel.app/api/
Protocol: HTTP
Tools Available: 61+ crypto analysis and trading tools
Authentication: Optional (API keys for trading features)

Headers (if using API keys):
X-BITGET-API-KEY: your_api_key
X-BITGET-SECRET: your_secret  
X-BITGET-PASSPHRASE: your_passphrase

Custom MCP Clients

# List available tools
curl -X POST https://crypto-4znwz1hg1-fr3k-ais-projects.vercel.app/api/mcp/list-tools

# Call a tool
curl -X POST https://crypto-4znwz1hg1-fr3k-ais-projects.vercel.app/api/mcp/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "getCryptoPrice", 
    "arguments": {"symbol": "bitcoin"}
  }'

📋 API Reference

Core Endpoints

Endpoint	Method	Description
`/api/mcp/list-tools`	GET	List all available tools
`/api/mcp/call-tool`	POST	Execute a specific tool
`/api/health`	GET	Health check endpoint
`/chat-working.html`	GET	Main dashboard interface

Tool Categories

🪙 Crypto Data (3 tools)

• getCryptoPrice - Real-time prices
• getMarketData - Market statistics
• getCoinInfo - Coin details

🏦 Exchange (12 tools)

• get_wallet_balance - Account balance
• place_exchange_order - Order execution
• get_exchange_positions - Position tracking
• And 9 more trading tools...

📊 Indicators (22 tools)

• rsi - Relative Strength Index
• macd - MACD signals
• bollinger_bands - Volatility bands
• And 19 more indicators...

😊 Sentiment (3 tools)

• get_fear_greed_index - Market sentiment
• get_crypto_news - Latest news
• search_web - Web search

🛠️ Complete Tools Catalog

Comprehensive reference for all 61+ available tools with parameters and examples.

💡 Pro Tip: Use the "🎓 Complete Walkthrough" feature on the main dashboard for an interactive tour of all tools with live examples and parameter explanations.

💡 Usage Examples

Getting Crypto Prices

# Get Bitcoin price
curl -X POST /api/mcp/call-tool \
  -H "Content-Type: application/json" \
  -d '{"name": "getCryptoPrice", "arguments": {"symbol": "bitcoin"}}'

# Response
{
  "bitcoin": {
    "usd": 43250.50,
    "usd_24h_change": 2.5
  }
}

Technical Analysis

# Calculate RSI for Bitcoin
curl -X POST /api/mcp/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "rsi", 
    "arguments": {
      "symbol": "BTCUSDT",
      "interval": "1h", 
      "period": 14
    }
  }'

# Response
{
  "rsi": 65.23,
  "signal": "neutral",
  "timestamp": "2024-01-15T10:30:00Z"
}

Trading Operations

# Get account balance
curl -X POST /api/mcp/call-tool \
  -H "Content-Type: application/json" \
  -d '{"name": "get_wallet_balance", "arguments": {}}'

# Place market order
curl -X POST /api/mcp/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "place_exchange_order",
    "arguments": {
      "symbol": "BTCUSDT",
      "side": "buy",
      "amount": 0.001,
      "type": "market"
    }
  }'

🔧 Troubleshooting

Common Issues

❌ "bitget requires 'secret' credential"

This error occurs when trading tools are called without proper API credentials.

Solution: Configure your Bitget API keys using the "🔑 Configure API Keys" button or set environment variables.

⚠️ Rate Limiting Errors

API calls are being made too frequently.

Solution: The system has built-in rate limiting. Wait a few seconds and try again.

ℹ️ MCP Connection Issues

Claude Desktop not recognizing the MCP server.

Solution: Check file paths, restart Claude Desktop, verify JSON syntax in config file.

Performance Optimization

• Caching: Price data is cached for 30 seconds to reduce API calls
• Rate Limits: Automatic rate limiting prevents API quota exhaustion
• Error Handling: Graceful fallbacks when external APIs are unavailable
• Parallel Processing: Multiple indicators can be calculated simultaneously

🔑 Bitget API Keys Setup

Complete step-by-step guide to create and configure your Bitget API keys for futures trading.

⚠️ Important Security Notice

• Only enable futures trading permissions (not spot or margin)
• Set IP restrictions to your specific IP address
• Start with small amounts for testing
• Never share your API keys with anyone
• Store keys securely and rotate them regularly

📋 Step-by-Step Instructions

1 Create Bitget Account

• Visit www.bitget.com
• Click "Sign Up" and create your account
• Complete email/phone verification
• Enable 2FA (Two-Factor Authentication) for security
• Complete KYC verification (required for API access)

2 Access API Management

• Log in to your Bitget account
• Go to "Profile" → "API Management" (or "Security" → "API Management")
• Click "Create API Key"
• You may need to verify with 2FA/email code

3 Configure API Permissions

• API Key Name: Enter a descriptive name (e.g., "Crypto MCP Trading")
• Permissions: Select Futures Trading only
• IP Restriction: Add your IP address for security
• Passphrase: Create a strong passphrase (you'll need this later)
• Do NOT enable "Withdraw" or "Transfer" permissions

4 Get Your API Credentials

• After creating the API key, you'll see three values:
API Key:
bg_xxxxxxxxxxxxxxxxxx
Secret Key:
xxxxxxxxxxxxxxxxxxxxxxxxxxx
Passphrase:
your_custom_passphrase
• Important: Copy and save all three values immediately
• The Secret Key is only shown once - save it securely!

5 Input Keys into Crypto MCP

• Return to the Crypto MCP dashboard
• Click the "🔑 Configure API Keys" button
• Enter your three Bitget credentials:
Bitget API Key: bg_xxxxxxxxxxxxxxxxxx

Bitget Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxx

Bitget Passphrase: your_custom_passphrase
• Click "Test API Keys" to verify the connection
• If successful, click "Save API Keys"

✅ Verification Steps

After setting up your API keys, test these features:

• Click "💳 Exchange Balance" demo to check account balance
• Try "🏪 Trading Markets" to see available trading pairs
• Test "📊 Price Ticker" for real-time prices
• Use the walkthrough to explore all trading tools

💰 Trading Tips

• Start Small: Begin with small position sizes while learning
• Paper Trading: Use Bitget's testnet for risk-free practice
• Risk Management: Always set stop-losses and position limits
• Monitor Closely: Keep track of open positions and market conditions
• Leverage Caution: Higher leverage increases both profits and losses

💬 Support & Community

📞 Getting Help

• Documentation: This comprehensive guide
• Interactive Walkthrough: Built-in tutorial system
• AI Assistant: Ask questions in the chat interface
• Demo Examples: Pre-configured demonstrations

🚀 Advanced Features

• Custom Strategies: Build algorithmic trading strategies
• Portfolio Analytics: Multi-exchange portfolio tracking
• Risk Management: Advanced position sizing and stop-losses
• Knowledge Graphs: Entity relationship management

🌟 Version Information

Current Version

v2.1.0

Last Updated

2024-01-15

Tools Available

61+ tools

🚀 Crypto MCP Documentation

📚 Table of Contents