create-test-pool

name	create-test-pool
description	Deploy a custom Uniswap pool on the local testnet with configurable parameters. Create pools with specific conditions (thin liquidity, wide spreads, exact tick ranges) to test agent behavior under controlled scenarios. Requires a running local testnet.
model	sonnet
allowed-tools	["mcp__uniswap__deploy_mock_pool","mcp__uniswap__fund_test_account","mcp__uniswap__get_pool_info","mcp__uniswap__search_tokens"]

Create Test Pool

Overview

Deploys a custom Uniswap pool on the local testnet with exact parameters you specify. This lets you create controlled test environments -- thin liquidity pools, extreme price ranges, specific fee tiers -- to test how agents behave under edge conditions.

Why this is 10x better than doing it manually:

1. No Solidity scripting: Creating a V3 pool manually requires calling createAndInitializePoolIfNecessary, computing sqrtPriceX96, calculating tick ranges, approving tokens, and calling mint. This does it all with natural language.
2. Token resolution: Say "WETH/USDC" and it resolves addresses, decimals, and sorts tokens correctly. No need to look up contract addresses.
3. Automatic funding: If the deployer account doesn't have enough tokens, the tool handles whale impersonation to fund the deployment.
4. Price-to-tick conversion: Specify a price like "2000" (USDC per WETH) and the tool computes the correct sqrtPriceX96 and tick range.
5. Edge case testing: Create pools with $100 liquidity to test thin-market behavior, or pools at extreme prices to test boundary conditions.
6. Verification: After deployment, you can immediately query the pool with get_pool_info to confirm state.

When to Use

Activate when the user says anything like:

• "Create a WETH/USDC pool with thin liquidity"
• "Deploy a test pool with 0.05% fee"
• "Set up a DAI/USDC pool at 1:1"
• "Create a pool with only $1000 liquidity"
• "Deploy a V2 pair for testing"
• "I need a pool with a narrow tick range"
• "Create a WBTC/WETH pool at the current price"
• "Set up a pool to test high slippage scenarios"

Do NOT use when no testnet is running (use setup-local-testnet first), or when the user wants to interact with existing mainnet pools (use analyze-pool).

Parameters

Parameter	Required	Default	How to Extract
token0	Yes	--	First token: "WETH", "USDC", or a 0x address
token1	Yes	--	Second token: "USDC", "DAI", or a 0x address
version	No	v3	"v2" or "v3"
fee	No	3000	Fee tier: 100 (0.01%), 500 (0.05%), 3000 (0.3%), 10000 (1%)
initialPrice	No	--	Price of token0 in token1 terms (e.g. 2000 for ETH at $2000)
liquidityUsd	No	1,000,000	Dollar value of initial liquidity
tickLower	No	auto	V3 lower tick (advanced users only)
tickUpper	No	auto	V3 upper tick (advanced users only)

Workflow

Step 1: Verify Testnet is Running

If the tool returns TESTNET_NOT_RUNNING, tell the user:

No local testnet is running. Let me set one up first.

Then suggest using setup-local-testnet or offer to do it for them.

Step 2: Extract Parameters

Parse the user's request carefully:

• Token pair: "WETH/USDC", "ETH/DAI", "WBTC/WETH"
  • Map "ETH" to "WETH" (Uniswap uses wrapped ETH)
• Fee tier: "0.05% fee" → 500, "0.3%" → 3000, "1%" → 10000, "0.01%" → 100
• Price: "at $2000" → initialPrice: 2000 (for WETH/USDC)
• Liquidity: "thin liquidity" → liquidityUsd: 1000, "$10M" → liquidityUsd: 10000000
• Version: "V2 pair" → version: "v2", default is "v3"

Common liquidity descriptions:

• "thin" / "low" / "shallow" → $1,000 - $10,000
• "moderate" / "normal" → $100,000 - $1,000,000
• "deep" / "high" → $10,000,000+

Step 3: Fund Deployer If Needed

If the pool requires tokens the deployer might not have, call mcp__uniswap__fund_test_account first to ensure the deployer (account #1: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266) has sufficient tokens.

Step 4: Deploy the Pool

Call mcp__uniswap__deploy_mock_pool with the extracted parameters.

Step 5: Verify and Present

Present the deployed pool with full details:

Test Pool Deployed

  Pool:       WETH/USDC (V3, 0.05% fee)
  Address:    0xNEW...
  Price:      1 WETH = 2,000 USDC
  Liquidity:  ~$1,000,000
  Tick Range: -204714 to -199514 (±50% around current price)

  Token0: USDC  0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48  (6 decimals)
  Token1: WETH  0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2  (18 decimals)

  Test Scenarios This Pool Enables:
  - Swap testing: "Get a quote for 1 WETH → USDC"
  - LP testing: "Add liquidity to the WETH/USDC pool"
  - Price impact: "What's the price impact of swapping 100 WETH?"
  - Time-dependent: "Advance 7 days and check fee accumulation"

Step 6: Suggest Follow-ups

  Next Steps:
  - Query pool state: "Get info on pool 0xNEW..."
  - Test a swap against this pool
  - Create another pool with different parameters
  - Advance time to test fee accumulation: "Time travel 7 days"

Important Notes

• Tokens are automatically sorted. Uniswap requires token0 < token1 by address. The tool handles this.
• V3 pools need initialization. The tool calls createAndInitializePoolIfNecessary which sets the initial price.
• Default tick range is ±50%. If no tick range is specified, liquidity is spread across a wide range around the initial price.
• Deployer is Anvil account #1. The first Anvil default account is used for deployment.
• Pool may already exist on fork. If you fork Ethereum and try to create a WETH/USDC 0.05% pool, it already exists. The tool will add liquidity to the existing pool.
• V2 pools always have 0.3% fee. The fee parameter is ignored for V2.

Error Handling

Error	User-Facing Message	Suggested Action
TESTNET_NOT_RUNNING	"No local testnet is running."	Run setup-local-testnet first
TESTNET_TOKEN_NOT_FOUND	"Cannot resolve token X."	Use a well-known symbol or provide the 0x address
TESTNET_CONTRACT_NOT_FOUND	"NonfungiblePositionManager not found on this chain."	Fork Ethereum mainnet which has all V3 contracts
TESTNET_DEPLOY_POOL_FAILED	"Failed to deploy pool: {reason}"	Check token balances, fund deployer if needed