uniswap-trader-mcp

What is Uniswap Trader MCP?

Uniswap Trader MCP is an MCP (Multi-Chain Protocol) server designed to enable AI agents to automate token swaps on the Uniswap Decentralized Exchange (DEX) across various blockchain networks. It provides a programmatic interface for AI agents to interact with Uniswap V3, facilitating automated trading strategies and liquidity management.

How to use Uniswap Trader MCP?

To use Uniswap Trader MCP, you first need to install it. You can do this either via Smithery for automatic installation with Claude Desktop or through manual installation by cloning the repository and installing dependencies. Configuration involves setting up environment variables for your Infura key and wallet private key. Once set up, AI agents can interact with the server using defined tools like getPrice to fetch real-time price quotes and executeSwap to perform token swaps. The project supports multiple blockchains, and each chain needs to be configured with a valid RPC URL, WETH address, and SwapRouter address.

Key Features of Uniswap Trader MCP

• Price Quotes: Obtain real-time price quotes for token swaps, including multi-hop route optimization.
• Swap Execution: Execute swaps on Uniswap V3 with customizable slippage tolerance and transaction deadlines.
• Swap Suggestions: Generate trading suggestions based on factors like liquidity, fees, and optimal trading paths.
• Multi-Chain Support: Compatibility with a wide range of popular blockchain networks, including Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base.

Use Cases of Uniswap Trader MCP

• Automated Trading: AI agents can execute automated trading strategies on Uniswap, taking advantage of price discrepancies or market opportunities.
• Liquidity Management: AI agents can manage liquidity positions on Uniswap V3, optimizing fee collection and minimizing impermanent loss.
• Arbitrage Opportunities: Identify and execute arbitrage opportunities across different token pairs or chains.
• DEX Integration: Developers can integrate Uniswap trading functionalities into their AI applications or platforms.

FAQ about Uniswap Trader MCP

Q: What are the prerequisites for running Uniswap Trader MCP? A: You need Node.js (version 14.x or higher), npm, a funded wallet with a private key, and access to blockchain RPC endpoints for supported chains.

Q: Which blockchains are supported? A: Uniswap Trader MCP supports Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base.

Q: How do I get a price quote for a swap? A: You can use the getPrice tool, specifying the chainId, tokenIn, tokenOut, and either amountIn or amountOut along with the tradeType.

Q: How do I execute a swap? A: You use the executeSwap tool, providing similar parameters as getPrice, along with optional slippageTolerance and deadline.

Q: Is there a license for this project? A: Yes, it is released under the MIT License.

Uniswap Trader MCP

An MCP server for AI agents to automate token swaps on Uniswap DEX across multiple blockchains.

Features

• Price Quotes: Get real-time price quotes for token swaps with multi-hop route optimization.
• Swap Execution: Execute swaps on Uniswap V3 with configurable slippage tolerance and deadlines.
• Swap Suggestions: Generate trading suggestions based on liquidity, fees, and optimal paths.
• Multi-Chain Support: Compatible with Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base.

Prerequisites

• Node.js: Version 14.x or higher.
• npm: For package management.
• Wallet: A funded wallet with a private key for executing swaps.
• RPC Endpoints: Access to blockchain RPC URLs (e.g., Infura, Alchemy) for supported chains.

Installation

Installing via Smithery

To install Uniswap Trader MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kukapay/uniswap-trader-mcp --client claude

Manual Installation

1. Clone the Repository:

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

2. Install Dependencies:

   npm install
   

Configuration

{
  "mcpServers": {
    "Uniswap-Trader-MCP": {
      "command": "node",
      "args": ["path/to/uniswap-trader-mcp/server/index.js"],
      "env": {
        "INFURA_KEY": "your infura key",
        "WALLET_PRIVATE_KEY": "your private key"
      }
    }
  }
}

Usage

Supported Chains

The following blockchains are supported. Ensure each chain is configured in chainConfigs.js with a valid RPC URL, WETH address, and SwapRouter address.

Chain ID	Name	Notes
1	Ethereum	Mainnet, widely used for Uniswap trades
10	Optimism	Layer 2, requires Optimism RPC
137	Polygon	Fast and low-cost, uses MATIC as native
42161	Arbitrum	Layer 2, Arbitrum One network
42220	Celo	Mobile-first blockchain, uses CELO
56	BNB Chain	Binance Smart Chain, uses BNB
43114	Avalanche	High-throughput, uses AVAX
8453	Base	Coinbase’s Layer 2, built on Optimism

Tools and Prompts

1. getPrice

Fetches a price quote for a Uniswap swap.

Schema:

• chainId: Number (default: 1)
• tokenIn: String (e.g., "NATIVE" or token address)
• tokenOut: String (e.g., "NATIVE" or token address)
• amountIn: String (optional, required for "exactIn")
• amountOut: String (optional, required for "exactOut")
• tradeType: "exactIn" or "exactOut" (default: "exactIn")

Example prompt:

Get me a price quote for swapping 1 ETH to DAI on Ethereum.

Output:

{
  "chainId": 1,
  "tradeType": "exactIn",
  "price": "3000.50",
  "inputAmount": "1.000000",
  "outputAmount": "3000.50",
  "minimumReceived": "2985.50",
  "maximumInput": "1.005000",
  "route": [
    {
      "tokenIn": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "tokenOut": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "fee": 3000
    }
  ],
  "estimatedGas": "150000"
}

2. executeSwap

Executes a swap on Uniswap.

Schema:

• chainId: Number (default: 1)
• tokenIn: String
• tokenOut: String
• amountIn: String (optional, required for "exactIn")
• amountOut: String (optional, required for "exactOut")
• tradeType: "exactIn" or "exactOut" (default: "exactIn")
• slippageTolerance: Number (default: 0.5, in percentage)
• deadline: Number (default: 20, in minutes)

Example prompt:

Swap 1 ETH for DAI on Ethereum with a 0.5% slippage tolerance and a 20-minute deadline.

Output:

{
  "chainId": 1,
  "txHash": "0x1234...abcd",
  "tradeType": "exactIn",
  "amountIn": "1.000000",
  "outputAmount": "2990.75",
  "minimumReceived": "2985.50",
  "maximumInput": "1.005000",
  "fromToken": "NATIVE",
  "toToken": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
  "route": [
    {
      "tokenIn": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "tokenOut": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "fee": 3000
    }
  ],
  "gasUsed": "145000"
}

License

MIT License. See LICENSE for details.