uniswap-trader-mcp

Integrations

  • Enables token swaps on Uniswap DEX on the BNB Chain (Binance Smart Chain), supporting BNB as the native token.

  • Enables token swaps on Uniswap DEX on the Ethereum mainnet, with price quotes, swap execution, and trading suggestions.

  • Supports token swaps on Uniswap DEX on the Optimism Layer 2 network, with real-time price quotes and optimized routing.

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

  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 IDNameNotes
1EthereumMainnet, widely used for Uniswap trades
10OptimismLayer 2, requires Optimism RPC
137PolygonFast and low-cost, uses MATIC as native
42161ArbitrumLayer 2, Arbitrum One network
42220CeloMobile-first blockchain, uses CELO
56BNB ChainBinance Smart Chain, uses BNB
43114AvalancheHigh-throughput, uses AVAX
8453BaseCoinbase’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.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Supported Chains
            2. Tools and Prompts
          2. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              An MCP server implementation that enables access to DexScreener API data, providing real-time information on DEX pairs, token profiles, and market statistics across multiple blockchains.
              Last updated -
              7
              6
              JavaScript
              The Unlicense
            • -
              security
              A
              license
              -
              quality
              An MCP server providing tools for AI agents to mint ERC-20 tokens across multiple blockchains.
              Last updated -
              6
              9
              JavaScript
              MIT License
              • Linux
              • Apple
            • -
              security
              A
              license
              -
              quality
              An MCP server for executing token swaps on the Solana blockchain using Jupiter's Ultra API, enabling users to fetch optimal swap orders and execute transactions with slippage control.
              Last updated -
              JavaScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              An MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.
              Last updated -
              20
              193
              Python
              GPL 3.0
              • Apple
              • Linux

            View all related MCP servers

            ID: wjbh1v7a2r