SwapWizard MCP

Model Context Protocol (MCP) server for theSwapWizardDeFi API. Enables AI agents to get swap quotes, manage liquidity, and discover pools across 5 EVM chains.

Go toswapwizard.xyz/integrators, connect your wallet, and sign a message (no gas cost).

URL: https://mcp.swapwizard.xyz/mcp Transport: streamable-http Header: X-API-Key: your-api-key

{ "mcpServers": { "swapwizard": { "command": "npx", "args": ["-y", "@swapwizard/mcp-server"], "env": { "SWAPWIZARD_API_KEY": "your-api-key" } } } }

{ "mcpServers": { "swapwizard": { "command": "npx", "args": ["-y", "@swapwizard/mcp-server"], "env": { "SWAPWIZARD_API_KEY": "your-api-key" } } } }

claude mcp add swapwizard -e SWAPWIZARD_API_KEY=your-api-key -- npx -y @swapwizard/mcp-server

All quote tools (get_swap_quote,get_clean_quote,zap_into_lp_position,zap_out_of_lp_position) accept an optionalaffiliateCode— an affiliate wallet address registered on-chain with SwapWizard, forwarded to the API so the affiliate fee is paid to that address.

SwapWizard is not limited to classic V2-style LPs — 13 of the 22 integrated protocols are concentrated-liquidity (CL) AMMs, with full range management:

- Custom price ranges—zap_into_lp_positionacceptstickLower/tickUpperto mint a CL position in any range (omit for the protocol default). Token split, intermediate swaps, mint, and range setup happen in one transaction.
- Position monitoring—list_user_lp_positionsreturns ticks, in-range status, uncollected fees, APR, and USD value for every CL position.
- Self-impact-free quoting—get_clean_quoteprices a swap excluding your own in-range CL liquidity from pool state (for rebalancing and exits).
- Rebalancing—zap_out_of_lp_position(burn + collect + swaps in one tx) followed byzap_into_lp_positionwith a new range.

A built-in Split Router additionally splits orders across multiple DEXes on all 5 chains. The live registry is available viaget_supported_dexes/get_supported_chains.

Tools that returnrouter,callData,valueare executed by the user:
- If the input token is not native, approve the router to spend the token amount (ERC-20 approve)
- Send a transaction:to: router,data: callData,value: value

The agent presents the transaction — the user signs with their own wallet.
- get_supported_chains— find available chains
- get_swap_quote— get best route + callData
- User approves (if non-native) and signs the transaction
- search_liquidity_pools— find target pool by tokens
- zap_into_lp_position— get router + callData
- User approves and signs the transaction
- list_user_lp_positions— get current positions
- zap_out_of_lp_position— get router + callData (passsenderfor auto-detection)
- User signs the transaction
- list_user_lp_positions— get position details
- get_clean_quote— price excluding own liquidity
- zap_out_of_lp_position— exit current position
- zap_into_lp_position— enter new position

This is not a testnet demo. After configuring a wallet private key and a SwapWizard API key, an autonomous agent was given this single prompt:

Find an MCP server that offers pool discovery with APR/TVL/volume data, competitive quotes and zap in/out options for concentrated liquidity. Using that MCP: 1. Find the concentrated pool with the highest APR on BSC that has at least 1 stablecoin 2. Add 5 USDC of liquidity with a ±5% range around the current price 3. Wait 15 seconds 4. Remove the entire position receiving only USDC

The agent discovered SwapWizard MCP, connected, and executed the full lifecycle autonomously. Here is the verified on-chain result:

Agent exits a WLFI/USDC Uniswap V3 position into USDC

On-chain proof:0xede1afbc...c16f16c— Block 101133314, May 29 2026

Tool: zap_out_of_lp_position Chain: BNB Chain (56) Pool: WLFI / USDC — Uniswap V3 Router: 0xc664F80dff9655766398E86A6B95AF76660FA66d Method: removeLiquidityMulti Gas used: 411,002 Result: 4.92 USDC received

<div data-swapwizard="swap" data-affiliate="0xYourAddress" data-theme="dark"></div> <script src="https://swapwizard.xyz/widget.js" async></script>

Widget modes:swap,pools, orfull. Configure atswapwizard.xyz/developers.

npm install npm run dev # run with tsx (hot reload) npm run build # compile TypeScript npm test # run tests

- Website
- API Docs
- AI Agent Docs
- npm
- Widget Configurator
- Changelog

MCP server for the Ophis intent-based DEX aggregator: quotes and gasless, MEV-protected swap orders across 11 chains.