SwapWizard MCP

SSE

by defire-business

32 downloads Not rated yet

GitHub Website SSE

About

"Non-custodial DeFi execution layer for AI agents powered by the SwapWizard API — swap quotes and execution, zap in/out of LP positions, ro uting across AMMs, and pool discovery and analysis on 5 EVM chains.

Details

Transport: SSE

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name SwapWizard MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

`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.

`get_supported_chains`

Maps to GET /chains. Lists supported EVM chains with chain IDs and native gas tokens: Ethereum, Arbitrum, Base, Polygon, BNB Chain.

`check_api_health`

Maps to GET /health. Returns service availability. Use to confirm the API is responsive before attempting operations.

`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.

`search_liquidity_pools`

Maps to GET /pools. Discovers liquidity pools across supported AMMs and chains, returning id, poolId, symbol, fee tier, protocol, dexKind, APY, TVL (USD), 24h/7d volume (USD), and stablecoin flags. KEY PARAMETERS: Use `trending: true` to get only pools currently trending on GeckoTerminal. Use `sortBy` ("apy", "tvl", "volume1d", "volume7d") with `sortOrder` ("asc", "desc") to control ranking — default is tvl desc. Use `topPerVenue` to limit to top N pools per DEX by APY. Supports filtering by …

`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.

`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, and USD values. The API uses Alchemy's NFT APIs for optimal position discovery — pass an Alchem…

`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 excludePositions parameter that prices the swap excluding the caller's own LP position from pool state. Returns signable data only; never signs or broadcasts. EXECUTION FLOW: (1) If the input token is non-native, send an ERC-2…

`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 the same router/callData/value execution fields as get_swap_quote. EXECUTION FLOW: same as get_sw…

`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. Supports Uniswap V3/V4, Curve, Balancer, Aerodrome. Surplus returned to the user. IMPORTANT: The poolId parameter MUST come verbatim from the poolId field in the search_liquidity_pools response — do NOT con…

`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. REQUIRED WORKFLOW: First call list_user_lp_positions, then pass the returned fields (positionId, nftManager, dexName, liquidityKind) here along with sender, poolId, and withdrawals. EXECUTION FLOW: (1) APPROVE — For N…

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Transport

"stdio"

Package

"@swapwizard/mcp-server"

Registry

"npm"

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

Non-custodial: every tool returnsrouter,callData, andvalue— the agent presents the transaction, the user signs with their own wallet. SwapWizard never holds keys.

Go to swapwizard.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

The agent calledzap_out_of_lp_positionto exit a concentrated liquidity position on BNB Chain. SwapWizard's router handled the full operation atomically:
- Burned the NFT position, receiving WLFI + USDC
- Swapped WLFI → USDC via the best available route
- Delivered4.92 USDCto the user's wallet in a single transaction

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

The agent requested the quote, the user approved the NFT and signed — no manual parameter tuning, no contract interaction, no slippage calculation. The MCP server auto-detectednftManager,dexName, andliquidityKindfrom thesenderaddress.

Ethereum (1), Arbitrum (42161), Base (8453), Polygon (137), BNB Chain (56)

Earn fees by embedding SwapWizard in your site:

<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 at swapwizard.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

Free token-safety scans plus paid x402 verdicts, signals, radar and EVM swap quotes for AI agents.

Solana agent trust scoring via x402 micropayments.

Non-custodial stablecoin yield. Stablecoin Yield Index (SYX) + 12 USDC vault APYs across Ethereum, Base, Arbitrum.

Pay-per-call x402 data APIs for AI agents — token rug-check, on-chain reads, web search, and AI-visibility (does AI recommend a brand). USDC on Base, no API key.

Live cross-DEX crypto prices read from on-chain pool state: per-venue price, liquidity depth and gross cross-venue spread across BSC, Polygon, Arbitrum, Base, Avalanche and Optimism. Works keyless, no account.

MCP server for Base L2 DeFi operations with 9 monetized endpoints: gas estimates, yield farming, token analysis, contract audit, wallet health, DEX quotes, price feeds, mnemonic generation. Built with FastMCP Python SDK.

Crypto data & trading MCP with 42+ tools: prices, DeFi, NFTs, Solana swaps

DeFi execution on Base, Citrea, HyperEVM and Monad via Fibrous aggregation: swap quotes, swaps, transfers, cross-chain portfolio and Aave V3.

MCP server for Fuse Network: balances, tokens, staking, DeFi data, swaps and on-chain transactions.

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

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

Claude Desktop / Cursor

McpServers

Transport

Package

Registry

Agent exits a WLFI/USDC Uniswap V3 position into USDC

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

`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`