DeFi Trading Agent

DeFi Trading Agent MCP Server

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

🎯 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 last 24h
2. Volume Filtering: Identifies pools with >$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 optimal entry price, position size, and risk management
6. Execution: Places 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

🚀 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 private key and address for secure trading.

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

⚙️ 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 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

Add the MCP to Claude Code using the command line:

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

Windows 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 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: 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 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"
      }
    }
  }
}

🤖 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 24h 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_quot

---

README truncated. View full README on GitHub.