Defi Trading MCP

🚀 DeFi Trading Agent MCP Server

Transform your AI assistant into an autonomous crypto trading agent capable of real-time market analysis, portfolio management, and seamless trade execution across over 17 blockchains.

🚀 Quick Start

Installation

npm install -g defi-trading-mcp

Create a New Wallet (Recommended)

npx defi-trading-mcp --create-wallet

This generates a new wallet with a private key and address for secure trading.

💡 Usage Tip

Need crypto? See our guide: How to Load Crypto into Your Wallet

✨ Features

🔍 Starting Prompt Examples

Simple Quote

Get me a quote for 0.1 eth to usdc on Base chain.

Quote and Swap

Get me a quote for 0.1 eth on ethereum chain and execute the swap.

Memecoin Opportunity Scanner

"Scan for newly launched memecoins on Base with >$100K liquidity, pick one or two tokens and analyze the best entry opportunities"

Advanced Analysis Process:

1. Discovery Phase: Uses get_new_pools to find tokens launched in the last 24 hours.
2. Volume Filtering: Identifies pools with over $100K liquidity and high trading activity.
3. Technical Analysis: Pulls OHLCV data to analyze price patterns and momentum.
4. Risk Assessment: Evaluates liquidity depth, holder concentration, and volatility.
5. Entry Strategy: Determines the optimal entry price, position size, and risk management.
6. Execution: Places a gasless swap with calculated slippage and stop - loss levels.

Example AI Analysis:

"Found 3 promising new tokens:
🚀 $ROCKET (0x123...): 2M volume, bullish OHLCV pattern, 85% liquidity locked
📈 Entry: $0.0001 (current support level)
💰 Size: 2% portfolio allocation
🛡️ Stop: $0.000085 (-15%)
🎯 Target: $0.00015 (+50%)
Executing gasless swap now..."

Risk Management Agent

"Monitor my portfolio and alert me if any position drops more than 15%"

Agent Actions:

1. Continuously monitors portfolio values.
2. Calculates position changes.
3. Provides alerts and recommendations.
4. Can execute protective trades.

🤖 Trading Agent Capabilities

• Autonomous Portfolio Management
• Intelligent Market Analysis
• Advanced Trade Execution
• Risk Management & Security

🛠️ Trading Agent Tools

Portfolio Management

• get_portfolio_tokens - Multi - chain portfolio analysis with prices and metadata.
• get_portfolio_balances - Fast balance checking across all chains.
• get_portfolio_transactions - Complete transaction history analysis.

Market Intelligence & Analysis

• get_trending_pools - Identify hot trading opportunities with volume metrics.
• get_new_pools - Discover newly launched tokens and liquidity pools.
• get_pool_ohlcv - Technical analysis with OHLCV candlestick data.
• get_pool_trades - Analyze recent trading activity and whale movements.
• get_token_price - Real - time pricing with 24 - hour change indicators.
• get_token_data - Deep token research with metadata and social links.
• get_token_info - Comprehensive token analysis including descriptions.
• search_pools - Find specific pools by token symbol or contract address.

Smart Trading

• get_swap_price - Get best prices across all DEXes.
• get_swap_quote - Get executable quotes with transaction data.
• execute_swap - Execute trades with optimal routing.
• get_supported_chains - List all 17+ supported blockchains.

Gasless Trading

• get_gasless_price - Get prices for gas - free trades.
• get_gasless_quote - Get gasless swap quotes.
• submit_gasless_swap - Execute trades without holding ETH.
• get_gasless_status - Monitor gasless transaction status.

Utility Tools

• convert_wei_to_formatted - Convert blockchain units to human - readable.
• convert_formatted_to_wei - Convert amounts to blockchain format.

Plus 25+ additional tools for comprehensive DeFi trading and analysis.

💡 Agent Use Cases

DeFi Portfolio Manager

"Analyze my DeFi portfolio and suggest optimizations"

• Tracks performance across all chains.
• Identifies underperforming assets.
• Suggests rebalancing strategies.
• Executes optimization trades.

Technical Analysis Expert

"Analyze the OHLCV data for trending tokens and identify the best entry points"

Advanced Technical Analysis:

• Pattern Recognition: Identifies bullish/bearish patterns in OHLCV data.
• Support/Resistance: Calculates key price levels using historical data.
• Volume Analysis: Analyzes trading volume for momentum confirmation.
• Entry Timing: Determines optimal entry points based on technical indicators.
• Risk Management: Sets stop - loss and take - profit levels automatically.
• Position Sizing: Calculates optimal allocation based on volatility and risk tolerance.

Example Technical Analysis:

"$TOKEN shows strong bullish momentum:
📊 OHLCV Analysis: Higher lows pattern, volume increasing 300%
📈 Support Level: $0.00085 (tested 3x, held strong)
📉 Resistance: $0.0012 (previous high, light volume)
💡 Strategy: Enter at $0.00095, Stop at $0.00082, Target $0.0015
⚖️ Risk/Reward: 1:4 ratio, recommended 1.5% portfolio allocation"

Arbitrage Hunter

"Look for arbitrage opportunities between chains"

• Compares prices across networks.
• Identifies profitable spreads.
• Calculates gas costs and slippage.
• Executes profitable arbitrage.

Risk Monitor

"Alert me if any of my positions drop more than 10%"

• Continuous portfolio monitoring.
• Real - time price alerts.
• Automatic stop - loss execution.
• Risk assessment reports.

Advanced Market Analysis Agent

"Analyze newly launched memecoins on Base with high volume and determine entry strategy"

Comprehensive Analysis:

• Trend Detection: Identifies trending pools with unusual volume spikes.
• Technical Analysis: Uses OHLCV data to analyze price patterns and momentum.
• Liquidity Assessment: Evaluates pool depth and trading sustainability.
• Risk Scoring: Calculates risk metrics based on volatility and liquidity.
• Entry Optimization: Determines optimal entry points using technical indicators.
• Position Sizing: Recommends allocation based on portfolio risk management.

Example Analysis Flow:

1. Discovery: "Find new tokens with >1000% volume increase in the last 24 hours".
2. Research: Pulls token metadata, social links, and trading history.
3. Technical Analysis: Analyzes OHLCV patterns for support/resistance levels.
4. Risk Assessment: Evaluates liquidity, holder distribution, and volatility.
5. Strategy: "Enter 2% of the portfolio at $0.0001 with a stop - loss at $0.00008".
6. Execution: Places a gasless swap with optimal slippage settings.

🌐 Supported Networks

17+ Blockchain Networks:

• Ethereum - The original DeFi ecosystem.
• Base - Coinbase's L2 with low fees.
• Polygon - Fast and cheap transactions.
• Arbitrum - Leading Ethereum L2.
• Optimism - Optimistic rollup scaling.
• BSC - Binance Smart Chain.
• Avalanche - Fast, Scalable, Customizable.
• Blast - Native yield for ETH and stablecoins.
• Linea - ConsenSys zkEVM.
• Scroll - zkRollup technology.
• Mantle - Modular blockchain network.
• Mode - DeFi - focused L2.
• Worldchain - World ID integration.
• Unichain - Uniswap's dedicated chain.
• Berachain - Proof - of - liquidity consensus.
• Ink - Kraken's L2 solution.
• MonadTestnet - Next - gen parallel EVM.

Use get_supported_chains for the complete current list.

🔐 Security & Trust

Local Key Management

• Private keys never leave your device.
• All transaction signing happens locally.
• No sensitive data is transmitted to servers.

📦 Installation

⚙️ Configuration

Required Keys

• USER_PRIVATE_KEY: Your private key (for signing transactions locally, stays local, never transmitted).
• USER_ADDRESS: Your Ethereum wallet address.
• COINGECKO_API_KEY: CoinGecko API key for market data (How to get your CoinGecko API key).

Optional Configuration

• ALCHEMY_API_KEY: Add an Alchemy API key to use your own RPCs; otherwise, public RPCs will be used.

🔧 Premium RPC Integration

Your ALCHEMY_API_KEY automatically enables premium RPCs for:

• 15 Major Chains: Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Worldchain, Berachain, Blast, Linea, Scroll, Mantle, Ink, MonadTestnet.
• Enhanced Performance: Lower latency, better uptime.
• Automatic Fallback: Public RPCs for other chains.

🔒 Security

• Private keys remain on your device.
• No sensitive data is transmitted to external servers.
• Secure transaction signing locally.

MEV Protection

• Ethereum transactions are protected from MEV attacks, sandwich attacks, and front - running.
• Private mempool routing ensures your trades aren't visible to MEV bots.
• Fair pricing without manipulation from malicious actors.
• Automatic protection - no additional configuration required.

🔧 MCP Client Setup

Kiro IDE

Step 1: Install the MCP

npm install -g defi-trading-mcp

Add to ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "defi-trading": {
      "command": "npx",
      "args": ["defi-trading-mcp"],
      "env": {
        "USER_PRIVATE_KEY": "your_private_key_here",
        "USER_ADDRESS": "0xYourWalletAddress",
        "COINGECKO_API_KEY": "CG-your_coingecko_api_key",
        "ALCHEMY_API_KEY": "your_alchemy_api_key"
      }
    }
  }
}

Claude Code

Step 1: Install the MCP

npm install -g defi-trading-mcp

Step 2: Add to Claude Code - Replace the placeholders with your environment variables For macOS/Linux/WSL:

claude mcp add defi-trading \
  -e USER_PRIVATE_KEY=your_private_key_here \
  -e USER_ADDRESS=0xYourWalletAddress \
  -e COINGECKO_API_KEY=CG-your_coingecko_api_key \
  -e ALCHEMY_API_KEY=your_alchemy_api_key \
  -- npx defi-trading-mcp

For Windows (native, not WSL):

claude mcp add defi-trading \
  -e USER_PRIVATE_KEY=your_private_key_here \
  -e USER_ADDRESS=0xYourWalletAddress \
  -e COINGECKO_API_KEY=CG-your_coingecko_api_key \
  -e ALCHEMY_API_KEY=your_alchemy_api_key \
  -- cmd /c npx defi-trading-mcp

⚠️ Important Note

The cmd /c wrapper is required on native Windows to prevent "Connection closed" errors when using npx.

Step 3: Verify the MCP is added

claude mcp list

Step 4: Update wallet details (if needed) If you need to update your private key or wallet address after the initial setup:

# Remove existing configuration
claude mcp remove defi-trading

# Add back with updated wallet details
claude mcp add defi-trading \
  -e USER_PRIVATE_KEY=your_new_private_key \
  -e USER_ADDRESS=0xYourNewWalletAddress \
  -e COINGECKO_API_KEY=CG-your_coingecko_api_key \
  -e ALCHEMY_API_KEY=your_alchemy_api_key \
  -- npx defi-trading-mcp

Step 5: Start using the trading agent Open Claude Code and start trading. Example Prompt:

"Check my portfolio across all chains and find trending memecoins on Base"

Claude Desktop

Step 1: Install the MCP

npm install -g defi-trading-mcp

Open Claude Desktop. Click the top - left menu with the three dashes. Click Developer. Then click Open App Config File. Your config file will open. Then add the following:

{
  "mcpServers": {
    "defi-trading": {
      "command": "npx",
      "args": ["defi-trading-mcp"],
      "env": {
        "USER_PRIVATE_KEY": "your_private_key_here",
        "USER_ADDRESS": "0xYourWalletAddress",
        "COINGECKO_API_KEY": "CG-your_coingecko_api_key",
        "ALCHEMY_API_KEY": "your_alchemy_api_key"
      }
    }
  }
}

Cursor

Quick Setup (2 Steps) Step 1: Install the package

npm install -g defi-trading-mcp

Step 2: Add to Cursor (One - Click) Click the button below to automatically configure the MCP in Cursor:

⚠️ Important Note

The deeplink only configures Cursor; you must install the npm package first!

Manual Setup Step 1: Install the MCP

npm install -g defi-trading-mcp

Step 2: Add to Cursor Configuration

1. Open Cursor.
2. Go to Settings → Extensions → MCP Servers.
3. Add a new server with the following configuration:

{
  "defi-trading": {
    "command": "npx",
    "args": ["defi-trading-mcp"],
    "env": {
      "USER_PRIVATE_KEY": "your_private_key_here",
      "USER_ADDRESS": "0xYourWalletAddress",
      "COINGECKO_API_KEY": "CG-your_coingecko_api_key",
      "ALCHEMY_API_KEY": "your_alchemy_api_key"
    }
  }
}

Step 3: Configure Environment Variables Replace the placeholder values with your actual credentials:

• USER_PRIVATE_KEY: Your wallet's private key.
• USER_ADDRESS: Your wallet address.
• COINGECKO_API_KEY: Your CoinGecko API key (Get one here).
• ALCHEMY_API_KEY: Your Alchemy API key (optional).

Step 4: Start Trading Open Cursor and start using the DeFi Trading Agent:

"Get me a quote for 0.1 ETH to USDC on Base chain"

Other MCP Clients

For other MCP clients like Github Copilot (mcp.json), Gemini Cli (settings.json), find the equivalent file and use the same pattern with environment variables:

{
  "mcpServers": {
    "defi-trading": {
      "command": "npx",
      "args": ["defi-trading-mcp"],
      "env": {
        "USER_PRIVATE_KEY": "your_private_key_here",
        "USER_ADDRESS": "0xYourWalletAddress",
        "COINGECKO_API_KEY": "CG-your_coingecko_api_key",
        "ALCHEMY_API_KEY": "your_alchemy_api_key"
      }
    }
  }
}

🚀 Why Choose DeFi Trading Agent MCP?

For Traders

• AI - Powered Analysis: Advanced market intelligence with OHLCV technical analysis.
• Memecoin Discovery: Automated scanning for newly launched high - potential tokens.
• Smart Entry Timing: AI determines optimal entry points using multiple indicators.
• Risk - Managed Trading: Automated position sizing and stop - loss calculations.
• Multi - chain Efficiency: Trade across 17+ networks seamlessly.
• Gas Optimization: Gasless trades save on transaction costs.
• Professional Grade: Built for high - volume trading.

💬 Community & Support

Join Our Community

• Telegram Group - Get help, share strategies, and connect with other traders.
• GitHub Issues - Report bugs and request features.
• GitHub Discussions - General questions and community chat.

Need Help?

• 💬 Quick questions: Join our Telegram group for real - time support.
• 🐛 Bug reports: Create an issue on GitHub.
• 💡 Feature requests: Share your ideas in GitHub Discussions.
• 📚 Documentation: Check our guides for CoinGecko API and Loading Crypto.

Transform your AI into an autonomous crypto trading agent today.