Uniswap Trader MCP Server

What does “Uniswap Trader” MCP Server do?

The Uniswap Trader MCP Server is a Model Context Protocol (MCP) server designed to enable AI agents to automate token swaps on the Uniswap decentralized exchange (DEX) across multiple blockchains. By connecting AI assistants to Uniswap’s trading infrastructure, this server empowers developers and autonomous agents to perform real-time price queries, execute swaps, and generate trading suggestions with multi-hop route optimization. Supporting major blockchains—including Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base—the Uniswap Trader MCP Server streamlines DeFi operations, making it possible for applications and agents to interact programmatically with Uniswap for tasks such as liquidity management, portfolio balancing, and dynamic trading strategies.

List of Prompts

• getPrice
  Provides a reusable prompt template for fetching a price quote for a Uniswap swap. It accepts parameters like chainId, tokenIn, tokenOut, amountIn, amountOut, and tradeType to standardize price querying interactions between clients and Uniswap.

List of Resources

• Supported Chains
  Exposes data about available blockchains (Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, Base) with relevant configuration details such as RPC URLs, WETH addresses, and SwapRouter addresses.
• (No further explicit resources are described in the provided documentation.)

List of Tools

• getPrice
  Fetches a price quote for a Uniswap swap, allowing users or agents to obtain current rates and routing for any supported token pair on any supported chain.

Use Cases of this MCP Server

• Automated Token Swapping
  AI agents can autonomously execute swaps between different tokens on Uniswap, optimizing for price, fees, and liquidity across multiple blockchains.
• Real-Time Price Discovery
  Developers and trading bots can use the server to fetch up-to-date price quotes and simulate trades before execution, supporting dynamic pricing models and arbitrage.
• Multi-Chain Trading Strategies
  The server’s support for multiple EVM-compatible chains enables cross-chain DeFi operations, portfolio balancing, and liquidity migration.
• AI-Powered Trading Suggestions
  Agents can generate and surface optimal trading routes and strategies based on real market data, swap fees, and available liquidity.
• DeFi Portfolio Management
  Applications can leverage the MCP server to automate rebalancing, hedging, or liquidity provision strategies across diverse blockchains.

How to set it up

Windsurf

1. Prerequisites: Ensure Node.js (14.x+) and npm are installed.
2. Install Uniswap Trader MCP:
   Use npm or Smithery CLI to install the package.
3. Edit Configuration:
   Update your Windsurf configuration to include the MCP server.
4. Add MCP Server JSON:
   Insert the following snippet into your 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"
         }
       }
     }
   }
   

5. Save/Restart & Verify:
   Save your configuration and restart Windsurf. Test by issuing a getPrice request.

Claude

1. Prerequisites: Node.js (14.x+), npm, Smithery CLI installed.
2. Install via Smithery:

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

3. Edit Configuration:
   Add the MCP to the mcpServers section as in the JSON above.
4. Set Environment Variables:
   Use environment variables for API keys and wallet private keys for security.
5. Restart & Verify:
   Restart Claude Desktop and verify by running a swap command.

Cursor

1. Ensure Prerequisites: Node.js and npm.
2. Install the MCP: Download or clone the MCP repo.
3. Configure MCP Server:
   Add the following to Cursor’s 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"
         }
       }
     }
   }
   

4. Save/Restart:
   Save changes and reload Cursor.

Cline

1. Install Prerequisites: Node.js, npm.
2. Clone & Install: Clone the repository and run npm install.
3. Configure Cline:
   Add the MCP server entry to your 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"
         }
       }
     }
   }
   

4. Restart & Test:
   Restart Cline and test with a sample token swap.

Securing API Keys

Always use environment variables in the env section of your configuration to avoid hardcoding sensitive credentials.

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

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "Uniswap-Trader-MCP": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “Uniswap-Trader-MCP” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion

The Uniswap Trader MCP Server provides a clear, well-structured integration for automating Uniswap swaps across major blockchains. It offers a practical, production-ready tool for DeFi agents and developers, with solid documentation and security guidance. However, the set of tools and resources is currently quite focused, and there’s no explicit mention of sampling or Roots support.

MCP Score: 7/10

MCP Score