SwapWizard
Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains
| Endpoint | https://mcp.swapwizard.xyz/mcp (streamable-http) |
|---|---|
| Registry version | 1.8.9 |
| Now | 11 tools · grade F (38) · pin ts_aa36a497a8ddd833758fefb28158394d · protocol 2025-06-18 |
| First / last listed | 2026-11-06 00:30 UTC / 2026-11-06 00:30 UTC |
| Grade over time | 2026-11-06: F (38), 11 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_setup_guide get_supported_chains check_api_health get_supported_dexes search_liquidity_pools analyze_pool list_user_lp_positions get_swap_quote get_clean_quote zap_into_lp_position zap_out_of_lp_position
get_setup_guide | Returns the complete setup and usage guide for SwapWizard. Call this FIRST before using any other tool. Covers: required configuration (API key, Alchemy RPC URL, private key), how to use poolId correctly, step-by-step operational flows for swap/zap in/zap out/analyze, transaction execution details, and approval rules. params: none |
get_supported_chains | Maps to GET /chains. Lists supported EVM chains with chain IDs and native gas tokens: Ethereum, Arbitrum, Base, Polygon, BNB Chain. params: none |
check_api_health | Maps to GET /health. Returns service availability. Use to confirm the API is responsive before attempting operations. params: none |
get_supported_dexes | Returns the AMMs / DEX sources SwapWizard routes across per chain. Each DEX includes its display name and slug (e.g. "uniswap-v3") — use the slug as the 'project' filter in search_liquidity_pools to filter pools by protocol. params: chainId |
search_liquidity_pools | Maps to GET /pools. Discovers liquidity pools across supported AMMs and chains, returning id, poolId, symbol, underlyingTokens (token addresses), fee tier, protocol, dexKind, APY, apyBase (fee-only APY excluding reward emissions), TVL (USD), 24h/7d volume (USD), stablecoin flags, and hooksAddress (custom hook contract for Uniswap V4 / PancakeSwap Infinity pools; null when the pool has no hook — ho params: chainId*, project, dexKind, tokens, search, poolType, hookless, stableOnly, semiStableOnly, sortBy, sortOrder, signal, topPerVenue, trending, timeframe, page, pageSize |
analyze_pool | Maps to GET /pools/analyze/:id. Returns real-time momentum data for a specific pool from GeckoTerminal: multi-timeframe volume (5m, 15m, 30m, 1h, 6h), price changes (5m–24h), buy/sell transaction counts, unique traders (24h), and reserve in USD. Data is cached for 10 minutes; stale entries are refreshed on-demand. Use the numeric id field returned by search_liquidity_pools. params: id* |
list_user_lp_positions | Maps to GET /positions. Reads all LP positions a wallet holds on a given chain by calling the SwapWizard API, which discovers positions across all supported protocols: Uniswap V2/V3/V4, Aerodrome, Thena, SushiSwap, PancakeSwap, Algebra, Balancer, Curve, and all Solidly forks. Each position includes positionId, nftManager, dexName, liquidityKind, token addresses, amounts, fees, in-range status, APR params: chainId*, owner*, rpcUrl |
get_swap_quote | Maps to POST /quote. Returns the best swap quote across all integrated DEX protocols, with router, callData, value, price impact, route summary, and gas estimate in one response. Surplus and positive slippage are returned to the user in the same transaction. Supports an optional affiliateCode (registered affiliate wallet address) forwarded to the API so the affiliate fee is paid on-chain to that a params: chainId*, tokenIn*, tokenOut*, side*, amount*, slippageBps, affiliateCode, excludePositions |
get_clean_quote | Maps to POST /quote with excludePositions=true. Shortcut to get_swap_quote that prices the swap as if the caller's own LP position were not in the pool, for concentrated-liquidity positions in the active tick range. Use when an agent holds a significant position in the pool it is about to trade against (rebalancing, exit, treasury sizing) and needs a quote unaffected by its own liquidity. Returns params: chainId*, owner*, tokenIn*, tokenOut*, side*, amount*, slippageBps, affiliateCode, rpcUrl |
zap_into_lp_position | Maps to POST /addliquidity/quote. Builds a single-transaction zap to enter an LP position from ANY input token — the deposit token does NOT have to be one of the pool's underlying tokens. SwapWizard handles all intermediate swaps, the LP mint, and price-range setup in a single transaction. FULL CONCENTRATED LIQUIDITY SUPPORT: for CL pools (Uniswap V3/V4, PancakeSwap V3/Infinity CL, Aerodrome Slips params: chainId*, poolId*, deposits*, sender, tickLower, tickUpper, affiliateCode |
zap_out_of_lp_position | Maps to POST /removeliquidity/quote. Builds a single-transaction zap to exit an LP position into ANY output token — you can withdraw into any token, not just the pool's underlying tokens. SwapWizard handles LP burn, fee collection, and intermediate swaps in a single transaction. Supports an optional affiliateCode (registered affiliate wallet address) forwarded to the API so the affiliate fee is pa params: chainId*, positionId*, poolId, nftManager, dexName, liquidityKind, withdrawals*, sender*, percent, affiliateCode |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.