Uniswap V3

Uniswap V3 is the most widely used decentralized exchange protocol. This package provides full integration with Uniswap V3 for swaps, liquidity provision, and position management.

Installation

pnpm add @universal-crypto-mcp/defi-uniswap-v3

Supported Networks

Network	Router Address	Status
Ethereum	`0xE592427A0AEce92De3Edee1F18E0157C05861564`	✅
Arbitrum	`0xE592427A0AEce92De3Edee1F18E0157C05861564`	✅
Optimism	`0xE592427A0AEce92De3Edee1F18E0157C05861564`	✅
Polygon	`0xE592427A0AEce92De3Edee1F18E0157C05861564`	✅
Base	`0x2626664c2603336E57B271c5C0b26F421741e481`	✅
BNB Chain	`0xB971eF87ede563556b2ED4b1C0b0019111Dd85d2`	✅

Quick Start

import { UniswapV3 } from '@universal-crypto-mcp/defi-uniswap-v3';

const uniswap = new UniswapV3({
  rpcUrl: process.env.ETHEREUM_RPC_URL,
  chainId: 1,
});

// Get a swap quote
const quote = await uniswap.getQuote({
  tokenIn: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', // WETH
  tokenOut: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
  amount: '1000000000000000000', // 1 ETH
  fee: 3000, // 0.3% pool
});

console.log(`1 ETH = ${quote.amountOut / 1e6} USDC`);

MCP Tools

`uniswap_swap`

Execute a token swap.

const result = await uniswap.swap({
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amount: '1.0',
  slippage: 0.5, // 0.5%
  recipient: '0xYourAddress',
});

Parameters:

Parameter	Type	Required	Description
`tokenIn`	`string`	Yes	Input token (symbol or address)
`tokenOut`	`string`	Yes	Output token (symbol or address)
`amount`	`string`	Yes	Amount to swap
`slippage`	`number`	No	Slippage tolerance (default: 0.5%)
`recipient`	`string`	No	Recipient address
`deadline`	`number`	No	Transaction deadline (seconds)

`uniswap_quote`

Get a swap quote without executing.

const quote = await uniswap.getQuote({
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amount: '1.0',
});

console.log(`Expected output: ${quote.amountOut}`);
console.log(`Price impact: ${quote.priceImpact}%`);
console.log(`Route: ${quote.route.join(' → ')}`);

`uniswap_add_liquidity`

Add liquidity to a V3 pool.

const position = await uniswap.addLiquidity({
  token0: 'ETH',
  token1: 'USDC',
  amount0: '1.0',
  amount1: '2000',
  fee: 3000, // 0.3% pool
  tickLower: -887220,
  tickUpper: 887220,
});

console.log(`Position NFT ID: ${position.tokenId}`);

`uniswap_remove_liquidity`

Remove liquidity from a position.

await uniswap.removeLiquidity({
  tokenId: 12345,
  percentage: 100, // Remove 100%
  recipient: '0xYourAddress',
});

`uniswap_positions`

Get all LP positions for an address.

const positions = await uniswap.getPositions('0xYourAddress');

for (const pos of positions) {
  console.log(`Token ID: ${pos.tokenId}`);
  console.log(`Pool: ${pos.token0}/${pos.token1}`);
  console.log(`Liquidity: ${pos.liquidity}`);
  console.log(`Unclaimed Fees: ${pos.fees0} ${pos.token0}, ${pos.fees1} ${pos.token1}`);
}

`uniswap_collect_fees`

Collect accumulated fees from a position.

const fees = await uniswap.collectFees({
  tokenId: 12345,
  recipient: '0xYourAddress',
});

console.log(`Collected: ${fees.amount0} ${fees.token0}, ${fees.amount1} ${fees.token1}`);

Pool Information

`uniswap_pool_info`

Get pool details.

const pool = await uniswap.getPool({
  token0: 'ETH',
  token1: 'USDC',
  fee: 3000,
});

console.log(`Pool Address: ${pool.address}`);
console.log(`Liquidity: ${pool.liquidity}`);
console.log(`Current Tick: ${pool.tick}`);
console.log(`Price: ${pool.price}`);
console.log(`24h Volume: ${pool.volume24h}`);
console.log(`TVL: ${pool.tvl}`);

Fee Tiers

Fee Tier	Value	Best For
0.01%	100	Very stable pairs (USDC/USDT)
0.05%	500	Stable pairs (ETH/stETH)
0.30%	3000	Most pairs (ETH/USDC)
1.00%	10000	Exotic pairs

Advanced Usage

Multi-Hop Swaps

const quote = await uniswap.getQuote({
  tokenIn: 'WBTC',
  tokenOut: 'DAI',
  amount: '0.1',
  // Automatically finds best route through multiple pools
});

console.log(`Route: ${quote.route.join(' → ')}`);
// Route: WBTC → WETH → DAI

Exact Output Swaps

const swap = await uniswap.swap({
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amountOut: '1000', // Get exactly 1000 USDC
  type: 'exactOutput',
});

Concentrated Liquidity

// Add liquidity in a specific price range
const position = await uniswap.addLiquidity({
  token0: 'ETH',
  token1: 'USDC',
  amount0: '1.0',
  amount1: '2000',
  fee: 3000,
  // Active from $1800 to $2200
  priceLower: 1800,
  priceUpper: 2200,
});

Error Handling

import {
  InsufficientLiquidityError,
  SlippageExceededError,
  InvalidPairError,
} from '@universal-crypto-mcp/defi-uniswap-v3';

try {
  await uniswap.swap({ ... });
} catch (error) {
  if (error instanceof InsufficientLiquidityError) {
    console.error('Not enough liquidity for this swap');
  } else if (error instanceof SlippageExceededError) {
    console.error('Price moved too much, increase slippage');
  }
}