Uniswap Trader MCP

🚀 Uniswap Trader MCP

An MCP server for AI agents to automatically execute token swaps across multiple chains on Uniswap DEX.

🚀 Quick Start

The Uniswap Trader MCP is a powerful tool that enables AI agents to perform token swaps across multiple blockchain networks on Uniswap DEX. It provides real - time price queries, efficient trade execution, and optimal trade suggestions.

✨ Features

• Price Query: Get real - time token swap prices with support for multi - hop path optimization.
• Trade Execution: Execute swaps on Uniswap V3 with configurable slippage tolerance and deadline.
• Trade Suggestion: Generate trade suggestions for the optimal path based on liquidity and fees.
• Multi - Chain Support: Support the following blockchain networks:
  • Ethereum (ETH)
  • Binance Smart Chain (BSC)
  • Polygon Network
  • Arbitrum One

📦 Installation

Prerequisites

To use this server, you need the following:

• Node.js version 14.0 or higher.
• npm package manager.
• Configure wallets and private keys to connect to different blockchain networks.

Steps

1. Clone the project repository:

   git clone https://github.com/your-repository.git
   cd uniswap-trader-mcp
   

2. Install dependencies:

   npm install
   

3. Start the server:

   npm start
   

📚 Documentation

Configuration

Add the following content to the config.json file to configure wallets and networks:

{
  "wallets": [
    {
      "network": "eth",
      "address": "0xYourEthAddress",
      "privateKey": "your-eth-private-key"
    },
    {
      "network": "bsc",
      "address": "0xYourBscAddress", 
      "privateKey": "your-bsc-private-key"
    }
  ],
  "supportedChains": ["eth", "bsc", "polygon", "arbitrum"]
}

Usage Instructions

Tools and Tips

getPrice Command

Get the current price of a specified token pair.

• Input Parameters:
  • fromToken: Source token address or name (e.g., ETH)
  • toToken: Target token address or name
• Example Command:

  getPrice --fromToken "ETH" --toToken "DAI"
  

• Output Result:

  {
    "chainId": 1,
    "price": 2000.5,
    "lastUpdated": "2024-03-15T12:34:56Z"
  }
  

executeSwap Command

Execute a token swap on a specified blockchain.

• Input Parameters:
  • fromToken: Source token address or name
  • toToken: Target token address
  • amount: Quantity of the source token to swap
  • slippageTolerance (optional): Allowed slippage ratio, default is 0.5%.
  • deadline (optional): Valid time for the transaction in minutes, default is 20 minutes.
• Example Command:

  executeSwap --fromToken "ETH" --toToken "DAI" --amount 1.0
  

• Output Result:

  {
    "chainId": 1,
    "txHash": "0x123456789abcd...",
    "status": "success",
    "gasUsed": 145000
  }
  

📄 License

This project is under the MIT License. For more information, please refer to LICENSE.