Uniswap Trader MCP

1# Uniswap Trader MCP
2[![smithery badge](https://smithery.ai/badge/@kukapay/uniswap-trader-mcp)](https://smithery.ai/server/@kukapay/uniswap-trader-mcp)
3 
4An MCP server for AI agents to automate token swaps on Uniswap DEX across multiple blockchains.
5 
6## Features
7- **Price Quotes**: Get real-time price quotes for token swaps with multi-hop route optimization.
8- **Swap Execution**: Execute swaps on Uniswap V3 with configurable slippage tolerance and deadlines.
9- **Swap Suggestions**: Generate trading suggestions based on liquidity, fees, and optimal paths.
10- **Multi-Chain Support**: Compatible with Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base.
11 
12## Prerequisites
13- **Node.js**: Version 14.x or higher.
14- **npm**: For package management.
15- **Wallet**: A funded wallet with a private key for executing swaps.
16- **RPC Endpoints**: Access to blockchain RPC URLs (e.g., Infura, Alchemy) for supported chains.
17 
18## Installation
19 
20### Installing via Smithery
21 
22To install Uniswap Trader MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kukapay/uniswap-trader-mcp):
23 
24```bash
25npx -y @smithery/cli install @kukapay/uniswap-trader-mcp --client claude
26```
27 
28### Manual Installation
291. **Clone the Repository**:
30   ```bash
31   git clone https://github.com/kukapay/uniswap-trader-mcp.git
32   cd uniswap-trader-mcp
33   ```
34 
352. **Install Dependencies**:
36   ```bash
37   npm install
38   ```
39 
40## Configuration
41 
42```json
43{
44  "mcpServers": {
45    "Uniswap-Trader-MCP": {
46      "command": "node",
47      "args": ["path/to/uniswap-trader-mcp/server/index.js"],
48      "env": {
49        "INFURA_KEY": "your infura key",
50        "WALLET_PRIVATE_KEY": "your private key"
51      }
52    }
53  }
54}
55```
56## Usage
57 
58### Supported Chains
59The following blockchains are supported. Ensure each chain is configured in `chainConfigs.js` with a valid RPC URL, WETH address, and SwapRouter address.
60 
61| Chain ID | Name         | Notes                                      |
62|----------|--------------|--------------------------------------------|
63| 1        | Ethereum     | Mainnet, widely used for Uniswap trades   |
64| 10       | Optimism     | Layer 2, requires Optimism RPC            |
65| 137      | Polygon      | Fast and low-cost, uses MATIC as native   |
66| 42161    | Arbitrum     | Layer 2, Arbitrum One network             |
67| 42220    | Celo         | Mobile-first blockchain, uses CELO        |
68| 56       | BNB Chain    | Binance Smart Chain, uses BNB             |
69| 43114    | Avalanche    | High-throughput, uses AVAX                |
70| 8453     | Base         | Coinbase’s Layer 2, built on Optimism     |
71 
72 
73### Tools and Prompts
74 
75#### 1. `getPrice`
76Fetches a price quote for a Uniswap swap.
77 
78**Schema**:
79- `chainId`: Number (default: 1)
80- `tokenIn`: String (e.g., `"NATIVE"` or token address)
81- `tokenOut`: String (e.g., `"NATIVE"` or token address)
82- `amountIn`: String (optional, required for `"exactIn"`)
83- `amountOut`: String (optional, required for `"exactOut"`)
84- `tradeType`: `"exactIn"` or `"exactOut"` (default: `"exactIn"`)
85 
86Example prompt:
87 
88```
89Get me a price quote for swapping 1 ETH to DAI on Ethereum.
90```
91 
92Output:
93 
94```
95{
96  "chainId": 1,
97  "tradeType": "exactIn",
98  "price": "3000.50",
99  "inputAmount": "1.000000",
100  "outputAmount": "3000.50",
101  "minimumReceived": "2985.50",
102  "maximumInput": "1.005000",
103  "route": [
104    {
105      "tokenIn": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
106      "tokenOut": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
107      "fee": 3000
108    }
109  ],
110  "estimatedGas": "150000"
111}
112```
113 
114#### 2. `executeSwap`
115Executes a swap on Uniswap.
116 
117**Schema**:
118- `chainId`: Number (default: 1)
119- `tokenIn`: String
120- `tokenOut`: String
121- `amountIn`: String (optional, required for `"exactIn"`)
122- `amountOut`: String (optional, required for `"exactOut"`)
123- `tradeType`: `"exactIn"` or `"exactOut"` (default: `"exactIn"`)
124- `slippageTolerance`: Number (default: 0.5, in percentage)
125- `deadline`: Number (default: 20, in minutes)
126 
127Example prompt:
128 
129```
130Swap 1 ETH for DAI on Ethereum with a 0.5% slippage tolerance and a 20-minute deadline.
131```
132 
133Output:
134 
135```
136{
137  "chainId": 1,
138  "txHash": "0x1234...abcd",
139  "tradeType": "exactIn",
140  "amountIn": "1.000000",
141  "outputAmount": "2990.75",
142  "minimumReceived": "2985.50",
143  "maximumInput": "1.005000",
144  "fromToken": "NATIVE",
145  "toToken": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
146  "route": [
147    {
148      "tokenIn": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
149      "tokenOut": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
150      "fee": 3000
151    }
152  ],
153  "gasUsed": "145000"
154}
155```
156 
157## License
158MIT License. See [LICENSE](LICENSE) for details.
159