Uniswap Trader MCP

What is Uniswap Trader MCP about?

Automates token swaps on Uniswap V3 for AI agents, supporting eight EVM‑compatible chains. It delivers real‑time price quotes, multi‑hop route optimization, and execution with slippage and deadline controls.

How to use Uniswap Trader MCP?

1. Install the package (via Smithery or manually).
2. Configure environment variables INFURA_KEY and WALLET_PRIVATE_KEY.
3. Start the MCP server using the provided serverConfig.
4. Invoke the built‑in tools getPrice and executeSwap through the Model Context Protocol, supplying required parameters such as chainId, tokenIn, tokenOut, amounts, and trade type.

Key features of Uniswap Trader MCP

• Price Quotes: Real‑time quotes with multi‑hop path optimization.
• Swap Execution: Submit swaps on Uniswap V3 with configurable slippage tolerance and deadline.
• Swap Suggestions: Generates optimal trade suggestions based on liquidity and fees.
• Multi‑Chain Support: Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, Base.
• AI‑Ready Interfaces: getPrice and executeSwap schemas designed for seamless integration with AI agents.

Use cases of Uniswap Trader MCP

• Autonomous trading bots that need up‑to‑date pricing and execution across chains.
• AI assistants that can recommend and perform token swaps for users.
• Portfolio rebalancing services that require low‑latency swap routing.
• Research tools that analyze optimal paths and fees on Uniswap V3.

FAQ from the Uniswap Trader MCP

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

Q: How do I set the slippage tolerance? A: Provide slippageTolerance (percentage) in the executeSwap request; default is 0.5%.

Q: What environment variables are required? A: INFURA_KEY for RPC access and WALLET_PRIVATE_KEY for signing transactions.

Q: Can I get a price quote without executing a trade? A: Yes, use the getPrice tool with the desired parameters.

Q: How is the server started? A: Use the npx command defined in the serverConfig section below.

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.