io.github.Yummybait-fin/uniswap-tx-builder-mcp

Build an UNSIGNED tx that approves `spender` to move up to `amount` of `token` on behalf of the wallet that signs it — e.g. the NonfungiblePositionManager before build_mint/build_increase, or Permit2 before a Permit2-paid build_swap. Pass amount="max" for an unlimited (uint256 max) allowance. Returns the tx plus unsigned rlp; when simulated, simulationResult={approved} decoded from the eth_call return data. Pass `sender` (the signing wallet) to eth_call-simulate before signing.

Build an UNSIGNED tx that removes all liquidity and collects everything from a Uniswap v3 position (multicalls when needed). Returns the tx (+ unsigned rlp) plus the read position. When simulated, simulationResult={decreaseLiquidity?: {amount0,amount1}, collect: {amount0,amount1}} decoded from the eth_call return data. Set burn=true to also burn the now-empty NFT in the same multicall. Set simulate=false to skip the eth_call dry-run (on by default).

Build an UNSIGNED tx that collects all uncollected fees from a Uniswap v3 position to `recipient`. Returns tx={to,data,value,chainId} plus rlp (the unsigned EIP-1559 serialization for signing services). When simulated, simulationResult={amount0,amount1} — the actual amounts eth_call reports would be collected. Set simulate=false to skip the eth_call dry-run (on by default).

Build an UNSIGNED tx that adds liquidity to an EXISTING Uniswap v3 position. Amounts are decimal strings (wei); mins are derived from slippageBps (default 0.5%). Returns the tx plus unsigned rlp. When simulated, simulationResult={liquidity,amount0,amount1} decoded from the eth_call return data. Simulation is OFF by default (needs token approvals + balances); pass simulate=true to attempt it.

Build an UNSIGNED tx that mints a new Uniswap v3 position. Amounts are decimal strings (wei) — compute them with get_pool_state (live ratio) right before minting, or stale prices revert the mint. Returns the tx plus unsigned rlp. When simulated, simulationResult={tokenId,liquidity,amount0,amount1} decoded from the eth_call return data. Simulation is OFF by default here (minting needs token approvals and balances, so eth_call usually reverts); pass simulate=true to attempt it.

Build an UNSIGNED tx that swaps `amountInWei` of `tokenIn` for `tokenOut` (exact-in, single hop through the `fee` pool) via the Universal Router. By default `tokenIn` pays via Permit2. When `sender` is given and Permit2 has no sufficient standing allowance for the Universal Router, this returns {permit2Required: true, typedData, permit} instead of a tx — sign `typedData` with `sender`'s wallet (e.g. sign_typed_data), then call build_swap again with the same args plus permit2=<the returned "permit"> and permit2Signature=<the signature> to get the tx, with a PERMIT2_PERMIT command embedded ahead of the swap — no separate on-chain Permit2 approval tx ever needed. With `wrapWei` (≥ amountInWei, requires tokenIn = WETH9) the tx is payable and wraps that much native ETH first, swaps amountInWei of it, and sweeps the WETH remainder — use this when the wallet holds native ETH instead of WETH (mutually exclusive with Permit2 payment/`permit2`). With `unwrapOut` (requires tokenOut = WETH9) the swap output is unwrapped to native ETH before reaching `recipient` — use this to sell a token for ETH. `wrapWei` and `unwrapOut` are mutually exclusive. `recipient` defaults to the tx sender. Returns the tx plus unsigned rlp. Pass `sender` to eth_call-simulate before signing.

Build an UNSIGNED payable tx that wraps `amountWei` native ETH into WETH via the Universal Router WRAP_ETH command (works under UR-allowlisting wallet policies where a direct WETH.deposit() doesn't). `recipient` defaults to the tx sender — omit it unless the WETH should go elsewhere. Returns the tx plus unsigned rlp. Pass `sender` (the signing wallet) to eth_call-simulate before signing.

READ-ONLY (builds no tx). Returns the pool's LIVE state: pool address, tick, sqrtPriceX96, price (token1 per token0, human units), tickSpacing. With rangePct: suggested tickLower/tickUpper within ±pct of spot, rounded INWARD to tick spacing. With balance0+balance1 (raw wei) + tickLower/tickUpper: amount0Desired/amount1Desired for build_mint computed from the live sqrtPrice ratio, plus which side limits. Errors if spot is outside the range. ALWAYS recompute amounts with this right before build_mint — stale ratios revert with 'Price slippage check'.

READ-ONLY (builds no tx). Lists every Uniswap v3 position NFT `owner` holds on `chainId` via the NonfungiblePositionManager, with each position's full state (token0/token1, fee, tickLower/tickUpper, liquidity, tokensOwed0/1) — feed a positionId straight into build_collect/build_close/build_increase.

READ-ONLY (builds no tx). Quotes an exact-in single-hop `tokenIn` → `tokenOut` swap (the same shape build_swap executes) via QuoterV2.quoteExactInputSingle — the live amountOut the pool would give at its CURRENT price, without sending a tx. Returns amountOut (wei), amountOutMin (amountOut after slippageBps, default 0.5% — feed this straight into build_swap), sqrtPriceX96After, initializedTicksCrossed, and gasEstimate. Call this immediately before build_swap: a quote read even a block earlier can go stale enough that the amountOutMin it produced reverts the swap.

READ-ONLY helper (builds no tx). Given a human price range (token1 per token0) and optional human token amounts, reads each token's decimals over RPC and returns the aligned tickLower/tickUpper (for the fee's tick spacing) plus wei amount0Desired/amount1Desired — ready to feed into build_mint. token0 must be < token1 by address. Does NOT compute the optimal amount ratio for the range.