swapwizard.xyz

## Setup requirements - **SwapWizard API key** — sign in with your wallet at https://swapwizard.xyz/integrators (SIWE, no gas cost). - **Alchemy RPC URL** — pass as rpcUrl to list_user_lp_positions and get_clean_quote. Without it, position discovery is slower and recently created positions may not appear. - **Private key or wallet signer** — required to sign and broadcast on-chain transactions (approvals and the main tx). SwapWizard never signs or broadcasts on your behalf. - **MCP client config** — when creating a `.mcp.json` file for the remote endpoint, set `"type": "streamable-http"` and `"url": "https://mcp.swapwizard.xyz/mcp"` with an `"X-API-Key"` header. - **Security: use environment variables** — NEVER hardcode secrets in code or config files. Store API keys, private keys, and RPC URLs in environment variables (e.g. `SWAPWIZARD_API_KEY`, `WALLET_PRIVATE_KEY`, `ALCHEMY_RPC_URL`) and reference them from your configuration. ## poolId rule - search_liquidity_pools returns a `poolId` field (string) → pass it **as-is** to zap_into_lp_position and zap_out_of_lp_position. Do NOT construct, modify, or guess poolId values. - search_liquidity_pools returns an `id` field (number) → use it **only** for analyze_pool. ## Operational flows - **Swap**: get_supported_chains → get_swap_quote → approve router → wait for on-chain confirmation → get_swap_quote again (fresh quote) → send tx to router. - **Zap in**: search_liquidity_pools → zap_into_lp_position → approve router → wait for on-chain confirmation → zap_into_lp_position again (fresh quote) → send tx to router. The `deposits` array accepts ANY token — it does not have to be one of the pool's tokens. SwapWizard handles all intermediate swaps, the LP mint, and price-range setup in a single transaction. - **Zap out**: list_user_lp_positions → zap_out_of_lp_position → setApprovalForAll(router, true) on the nftManager → wait for on-chain confirmation → zap_out_of_lp_position again (fresh quote) → send tx to router. The `withdrawals` array accepts ANY output token — you can exit into any token, not just the pool's underlying tokens. SwapWizard handles the LP burn, fee collection, and intermediate swaps in a single transaction. - **Analyze**: search_liquidity_pools → analyze_pool with the numeric id. - **Momentum entry**: search_liquidity_pools with `trending: true, timeframe: "6h", signal: "entry", sortBy: "signal", sortOrder: "desc"` → returns pools whose volume is accelerating with healthy LP flow, ranked by APR. Take the top result, read its `suggestedRangePct` for the price range, then follow the Zap in flow. Use timeframe "6h" for sustained traction (LP-yield), "1h" for faster reaction. Note the 6h window reflects sustained traction, not the last few minutes — for instantaneous heat, cross-check the 5m window (real-time GeckoTerminal). - **Momentum exit**: list_user_lp_positions → for each position read `momentumSignal`. If "exit" (dying volume or LPs leaving) or absent (pool fell out of the momentum ranking — momentum exhausted), follow the Zap out flow. ## Transaction execution - Quote tools return `router`, `callData`, and `value`. - Send the transaction to the `router` contract address with `data: callData` and `value: value`. This requires a private key or wallet signer. - ALWAYS fetch a fresh quote after the approval is confirmed — the previous quote expires and its callData becomes stale. ## Approval rules - **ERC-20 tokens** (swaps, zap in): call `approve(router, amount)` on the input token contract. - **NFT-based positions** (zap out): call `setApprovalForAll(router, true)` on the `nftManager` contract. Do NOT use `approve(router, tokenId)` — most position managers only check operator approval. - **PCS Infinity BIN positions**: call `approveForAll(router, true)` on the `nftManager`. - **Classic LP pools** (Curve, Balancer, Uniswap V2, Solidly): approve the LP token as a standard ERC-20.