defi-trading-mcp

DeFi Trading Agent MCP Server - Transform your AI into an autonomous crypto trading agent

20 stars JavaScriptAI & Machine Learning Updated Oct 19, 2025

ai-agentbaseblockchaincryptocrypto-trading-agentdefiethereumgaslessmcpmemecoinportfolioswaptrading-agenttrading-bot

Documentation

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

code

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

Quote and Swap

code

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

Memecoin Opportunity Scanner

code

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

code

"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

code

"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

bash

npm install -g defi-trading-mcp

Create a New Wallet (Recommended)

bash

npx defi-trading-mcp@latest --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

bash

npm install -g defi-trading-mcp

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

json

{
  "mcpServers": {
    "defi-trading": {
      "command": "npx",
      "args": ["defi-trading-mcp@latest"],
      "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

bash

npm install -g defi-trading-mcp

Step 2: Add to Claude Code - Replace the placeholders with your environment variables

For macOS/Linux/WSL:

bash

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@latest

For Windows (native, not WSL):

bash

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@latest

> 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

bash

claude mcp list

Step 4: Update wallet details (if needed)

If you need to update your private key or wallet address after initial setup:

bash

# 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@latest

Step 5: Start using the trading agent

Open Claude Code and start trading.

Example Prompt:

code

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

Claude Desktop

Step 1: Install the MCP

bash

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.

json

{
  "mcpServers": {
    "defi-trading": {
      "command": "npx",
      "args": ["defi-trading-mcp@latest"],
      "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

bash

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

bash

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:

json

{
  "defi-trading": {
    "command": "npx",
    "args": ["defi-trading-mcp@latest"],
    "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:

code

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

json

{
  "mcpServers": {
    "defi-trading": {
      "command": "npx",
      "args": ["defi-trading-mcp@latest"],
      "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_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._

🌐 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 transmitted to servers

💡 Agent Use Cases

DeFi Portfolio Manager

code

"Analyze my DeFi portfolio and suggest optimizations"

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

Technical Analysis Expert

code

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

code

"$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

code

"Look for arbitrage opportunities between chains"

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

Risk Monitor

code

"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

code

"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 last 24h"

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 portfolio at $0.0001 with stop-loss at $0.00008"

6. Execution: Places gasless swap with optimal slippage settings

🚀 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.

Frequently asked questions

What is defi-trading-mcp?

defi-trading-mcp is DeFi Trading Agent MCP Server - Transform your AI into an autonomous crypto trading agent

How do I install defi-trading-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is defi-trading-mcp open source?

Yes — it is hosted on GitHub at https://github.com/edkdev/defi-trading-mcp and has 20 stars.

Related MCP tools

anything-llm

The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

50,686 JavaScript

ai-agentscustom-ai-agentsdeepseek+16

cursor-talk-to-figma-mcp

CTTF: MCP integration between Cursor and Figma, allowing Cursor Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

5,539 JavaScript

agentagenticagentic-ai+11