Uniswap Trader MCP
by
Automates token swaps on Uniswap across multiple blockchains for AI agents, providing real‑time price quotes, swap execution with slippage control, and trade suggestions.
Uniswap Trader MCP Overview
What is Uniswap Trader MCP about?
Uniswap Trader MCP enables AI agents to interact with Uniswap V3 on a variety of EVM‑compatible chains. It offers price quotation, optimal routing, and automated swap execution, handling native and ERC‑20 tokens while respecting configurable slippage tolerances and deadlines.
How to use Uniswap Trader MCP?
- Installation – Install the server via npm or Smithery. Example with Smithery:
Or clone the repo and runnpx -y @smithery/cli install @kukapay/uniswap-trader-mcp --client claudenpm install. - Configuration – Supply environment variables such as
INFURA_KEYandWALLET_PRIVATE_KEYand ensure each supported chain has an entry inchainConfigs.jswith a valid RPC URL, WETH address, and SwapRouter address. - Start the server – Run the entry point (e.g.,
node server/index.js). - Interact via tools – Use the
getPriceandexecuteSwaptools from an AI agent, providing parameters likechainId, token addresses, amount, trade type, slippage, and deadline.
Key features of Uniswap Trader MCP
- Real‑time price quotes with multi‑hop route optimization.
- Swap execution on Uniswap V3 with configurable slippage and deadline.
- Trade suggestions based on liquidity, fee tiers, and optimal paths.
- Multi‑chain support for Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base.
- AI‑agent ready tools (
getPrice,executeSwap) with clear JSON schemas.
Use cases of Uniswap Trader MCP
- Autonomous trading bots that need reliable price data and execution on multiple DEXes.
- Portfolio rebalancing agents that shift assets across chains.
- Research tools that simulate trades and evaluate routing efficiency.
- Decentralized finance (DeFi) services offering swap‑as‑a‑service via AI assistants.
FAQ from the Uniswap Trader MCP
Q: Which chains are supported? A: Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche, and Base.
Q: How are slippage and deadlines handled?
A: slippageTolerance defaults to 0.5% and deadline defaults to 20 minutes; both can be overridden in the executeSwap request.
Q: What environment variables are required?
A: INFURA_KEY (or equivalent RPC provider key) and WALLET_PRIVATE_KEY for signing transactions.
Q: Do I need to provide token addresses?
A: Yes, unless using the placeholder "NATIVE" for the native token of the selected chain.
Q: How do I add a new chain?
A: Add an entry in chainConfigs.js with the chain’s RPC URL, WETH address, and SwapRouter address.
Uniswap Trader MCP's README
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
-
Clone the Repository:
git clone https://github.com/kukapay/uniswap-trader-mcp.git cd uniswap-trader-mcp -
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: StringtokenOut: StringamountIn: 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.
Uniswap Trader MCP Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Uniswap Trader MCP's Information
- Author
- kukapay
- Category
- Finance & Payments
- Language
- JavaScript
- License
- MIT License
- Version
- v1.0.1
- Stars
- 27
- Updated
- 21 days ago
Configuration
{
"mcpServers": {
"Uniswap Trader MCP": {
"command": "node",
"args": [
"server/index.js"
],
"env": {
"INFURA_KEY": "<YOUR_INFURA_KEY>",
"WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
}
}
}
}Configure Clients
Similar MCP Servers like Uniswap Trader MCP
Explore related MCPs that share similar capabilities and solve comparable challenges
Goat
by goat-sdk
Enables AI agents to send and receive payments, purchase goods and services, execute investment strategies, tokenize assets, and obtain financial insights by leveraging blockchains, stablecoins, and wallets.
Financial Datasets MCP Server
by financial-datasets
Provides access to income statements, balance sheets, cash flow statements, stock prices, market news, and cryptocurrency data through MCP tools for AI assistants.
Alpaca MCP Server
Officialby alpacahq
Enables large language models to trade stocks and options, retrieve real‑time and historical market data, and manage portfolios using plain English commands through a local or remote MCP server.
Xero MCP Server
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
Sec Edgar Mcp
by stefanoamorelli
Provides an MCP server that connects AI models to SEC EDGAR filings, enabling real‑time retrieval of company filings, financial statements, and insider‑trading data with exact XBRL precision and verifiable filing references.
MetaTrader MCP Server
by ariadng
Enables AI LLMs to execute trades on the MetaTrader 5 platform through the Model Context Protocol.
Alpha Vantage MCP Server
Officialby calvernaz
Provides access to Alpha Vantage stock market data via an MCP server, supporting stdio and HTTP streaming modes with optional OAuth 2.1 authentication.
Freqtrade Mcp
by kukapay
Integrates the Freqtrade cryptocurrency trading bot with MCP, exposing its REST API as tools for AI agents to perform automated trading operations.
Crypto Indicators MCP Server
by kukapay
Provides a comprehensive set of cryptocurrency technical analysis indicators and ready‑to‑use trading strategies through an MCP interface, enabling AI agents and applications to generate buy, hold, or sell signals.