Uniswap-Trader-MCP
Provides price quotes and executes token swaps on Uniswap V3 on the BNB Chain network.
Provides price quotes and executes token swaps on Uniswap V3 on the Ethereum network.
Provides price quotes and executes token swaps on Uniswap V3 on the Optimism network.
Provides price quotes and executes token swaps on Uniswap V3 on the Polygon network.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Uniswap-Trader-MCPGet a price quote for swapping 1 ETH to DAI on Ethereum"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Overview
See the technical note Liquidity Math in Uniswap v3 and the Uniswap v3 whitepaper for the description of the purpose of this code.
For a Jupyter Notebook version of the code, see yj's work here: https://github.com/uniyj/uni-v3-peri/tree/main/atiselsts-uniswap-v3-liquidity-math.
Contents
uniswap-v3-liquidity-math.py- implementation of the equations and examples from the "Liquidity Math in Uniswap v3" papersubgraph-liquidity-query-example.py- query the Uniswap v3 subgraph information to show the amounts locked in the current tick range of the USDC/WETH 0.3% poolsubgraph-liquidity-range-example.py- shows the amounts locked in all ticks with nonzeroliquidityNetin the USDC/WETH 0.3% poolsubgraph-liquidity-positions-example.py- shows the amounts locked in all active positions in the USDC/WETH 0.3% pool
Related MCP server: Armor Crypto MCP
Installation and usage
Install dependency with:
pip install -r requirements.txtExecute from the command line, for example with:
./subgraph-liquidity-range-example.pyExample outputs
Example output of uniswap-v3-liquidity-math.py
Example 1: how much of USDC I need when providing 2 ETH at this price and range?
amount of USDC y=5076.10
p_a=1500.00 (75.00% of P), p_b=2500.00 (125.00% of P)
Example 2: I have 2 ETH and 4000 USDC, range top set to 3000 USDC. What's the bottom of the range?
lower bound of the price p_a=1333.33
Example 3: Using the position created in Example 2, what are asset balances at 2500 USDC per ETH?
Amount of ETH x=0.85 amount of USDC y=6572.89
delta_x=-1.15 delta_y=2572.89
Amount of ETH x=0.85 amount of USDC y=6572.89Example output of subgraph-liquidity-query-example.py
L=22510401004259913887
tick=195879
Current price: 0.000321 WETH for 1 USDC (3115.361406 USDC for 1 WETH)
Amounts at the current tick range: 1318490.67 USDC and 785.63 WETHExample output of subgraph-liquidity-range-example.py
...
tick=195660 price=3184.336897 USDC for WETH
1193.68 WETH locked (potentially worth 3789699.28 USDC)
tick=195720 price=3165.289029 USDC for WETH
1199.90 WETH locked (potentially worth 3786639.86 USDC)
tick=195780 price=3146.355100 USDC for WETH
1218.77 WETH locked (potentially worth 3823192.07 USDC)
tick=195840 price=3127.534429 USDC for WETH
Current tick, both assets present!
1332170.50 USDC and 781.24 WETH remaining in the current tick range
potentially 3770791.99 USDC or 1209.30 WETH in total in the current tick range
tick=195900 price=3108.826338 USDC for WETH
3748424.25 USDC locked (potentially worth 1209.36 WETH)
tick=195960 price=3090.230154 USDC for WETH
3782324.42 USDC locked (potentially worth 1227.64 WETH)
tick=196020 price=3071.745208 USDC for WETH
3762895.47 USDC locked (potentially worth 1228.68 WETH)
tick=196080 price=3053.370833 USDC for WETH
3740185.70 USDC locked (potentially worth 1228.62 WETH)
...This server cannot be deployed
Maintenance
Related MCP Connectors
Multi-aggregator swap router for AI agents on Base. 10 bps fee. MCP-native, non-custodial.
MCP server giving AI agents one-connection access to crypto & DeFi data: DeFi protocol TVL, stableco
HiveCapital MCP Server — autonomous investment layer for AI agents
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceAn MCP server for AI agents to automate token swaps on Uniswap DEX across multiple blockchains.838MIT

Armor Crypto MCPofficial
AlicenseCqualityCmaintenanceAn MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.37179GPL 3.0- AlicenseNot gradedqualityFmaintenanceAn MCP server that enables AI agents to interact with PumpSwap for real-time token swaps and automated on-chain trading.7MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server designed for AI agents to perform optimal token swaps on the Sui blockchain.6MIT