get_supported_chainsLABSCO SUMMARY
Routing and position maths done for you, signing left to you.
The agent can find the pool, price the swap and assemble a zap, but what comes back is an unsigned transaction with router, callData and value — the signature stays with the wallet holder.
What it is
An MCP server for the SwapWizard DeFi API across 5 EVM chains. It quotes swaps across DEXes, discovers liquidity pools, reads a wallet's LP positions, and builds single-transaction zaps into and out of positions. Every tool returns router, callData and value: the agent presents the transaction and the wallet stays with the person.
What you get
- The best swap route across all supported DEXes, returned as router, callData and value ready to sign
- A quote that excludes the caller's own LP position from pool state, for rebalancing
- Pools discovered by chain, tokens or type, with poolId, symbol, fee tier, protocol, APY, TVL and recent trading volume
- GeckoTerminal trending pools over the time window you pick
- A wallet's LP positions in full: value, fees, APR, in-range status and impermanent loss
- Single-transaction entry into and exit from an LP position
- The supported chains with their IDs, gas tokens and DEX lists, and an API availability check
Requirements
A SwapWizard API key: connect a wallet at swapwizard.xyz/integrators and sign a message, which costs no gas. Remotely, connect to https://mcp.swapwizard.xyz/mcp with an X-API-Key header; locally, run npx against @swapwizard/mcp-server with SWAPWIZARD_API_KEY. Non-custodial — no private key is ever given to the server.
Setup effort
One command plus a key — npx -y -p @swapwizard/mcp-server swapwizard-mcp, then supply credentials
USE CASES
01
Getting the best price on a swap
One quote covers all the DEXes SwapWizard routes across on that chain, and returns the transaction to sign.
02
Finding a pool worth entering
Search by chain, token pair or type, or take what is trending over the window you care about.
03
Checking how your positions are actually doing
Value, fees earned, APR, whether the position is in range, and the impermanent loss against it.
04
Entering or leaving a position in one transaction
A zap does the swap and the deposit together, so the position opens without a manual two-step.
05
Rebalancing without your own liquidity skewing the quote
The clean quote takes your existing position out of pool state before pricing the trade.
06
Checking the service is up before a run
A health call, so a failed quote is not confused with a failed strategy.
9 tools
Listed in project docs. Your client may show a different list.
get_supported_dexescheck_api_healthsearch_liquidity_poolslist_user_lp_positionsget_swap_quoteget_clean_quotezap_into_lp_positionzap_out_of_lp_positionBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- npx on PATH
- SWAPWIZARD_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y -p @swapwizard/mcp-server swapwizard-mcpHosted endpoint
ENDPOINT URL
https://mcp.swapwizard.xyz/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Any MCP client — remote
Add a remote server with the URL https://mcp.swapwizard.xyz/mcp (streamable HTTP transport).
Send your SwapWizard API key in an X-API-Key header.
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"swapwizard": {
"command": "npx",
"args": [
"-y",
"-p",
"@swapwizard/mcp-server",
"swapwizard-mcp"
],
"env": {
"SWAPWIZARD_API_KEY": "<YOUR_SWAPWIZARD_API_KEY>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add swapwizard -e SWAPWIZARD_API_KEY=<YOUR_SWAPWIZARD_API_KEY> -- npx -y -p @swapwizard/mcp-server swapwizard-mcp
