How do I install SwapWizard?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does SwapWizard need an API key?

The publisher lists these environment variables: SWAPWIZARD_API_KEY.

What transport does SwapWizard use?

SwapWizard is reached over HTTP.

When was SwapWizard last checked?

Last checked 2026-11-09. Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains

SwapWizard MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.swapwizard.xyz/mcp

Credentials from the publisher

SWAPWIZARD_API_KEY — API key from https://swapwizard.xyz/integrators

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.defire-business-swapwizard-mcp https://mcp.swapwizard.xyz/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.defire-business-swapwizard-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.swapwizard.xyz/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.8.9

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

SwapWizard MCP Server

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

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

Quick Start

1. Get an API Key

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

2. Connect via MCP

Remote (no install)

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

Local — Claude Desktop

Add to claude_desktop_config.json:

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

Local — Cursor

Add to .cursor/mcp.json:

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

Local — Claude Code

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

Available Tools

Tool	Description
`get_supported_chains`	List supported EVM chains with IDs, gas tokens, DEX list, and position config
`get_supported_dexes`	AMMs/DEX sources SwapWizard routes across per chain
`check_api_health`	API availability check
`search_liquidity_pools`	Discover pools by chain, tokens, type, or GeckoTerminal trending (`trending: true` + optional `timeframe`: 5m/1h/6h/24h, default 5m). Returns poolId, symbol, fee tier, protocol, APY, TVL, 24h volume
`list_user_lp_positions`	Full LP position details: value, fees, APR, in-range status, impermanent loss
`get_swap_quote`	Best swap route across all DEXes. Returns router + callData + value ready to sign
`get_clean_quote`	Swap quote excluding the caller's own LP position from pool state (for rebalancing)
`zap_into_lp_position`	Single-tx entry into any LP position from any token
`zap_out_of_lp_position`	Single-tx exit from any LP position into any token. Pass `sender` to auto-detect nftManager

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

Concentrated Liquidity Support

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_position accepts tickLower / tickUpper to 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_positions returns ticks, in-range status, uncollected fees, APR, and USD value for every CL position.
Self-impact-free quoting — get_clean_quote prices 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 by zap_into_lp_position with a new range.

Protocols by chain

Protocol	Type	Ethereum	BSC	Polygon	Base	Arbitrum
Uniswap V3	CL	✓	✓	✓	✓	✓
Uniswap V4	CL	✓	✓	✓	✓	✓
SushiSwap V3	CL	✓	✓	✓	✓	✓
PancakeSwap V3	CL	✓	✓	—	✓	✓
PancakeSwap Infinity CL	CL	—	✓	—	✓	—
Aerodrome Slipstream (+ V2)	CL	—	—	—	✓	—
Camelot (Algebra)	CL	—	—	—	—	✓
THENA Fusion (Algebra)	CL	—	✓	—	—	—
QuickSwap V3 (Algebra)	CL	—	—	✓	—	—
Retro	CL	—	—	✓	—

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

Execution Model

Tools that return router, callData, value are 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.

Agent Flows

Swap

get_supported_chains — find available chains
get_swap_quote — get best route + callData
User approves (if non-native) and signs the transaction

Add Liquidity

search_liquidity_pools — find target pool by tokens
zap_into_lp_position — get router + callData
User approves and signs the transaction

Remove Liquidity

list_user_lp_positions — get current positions
zap_out_of_lp_position — get router + callData (pass sender for auto-detection)
User signs the transaction

Rebalance (with clean quote)

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

Real-World Example

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 called zap_out_of_lp_position to 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
Delivered 4.92 USDC to 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-detected nftManager, dexName, and liquidityKind from the sender address.

PoC Bot Demos

Full run videos:

Supported Chains

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

Environment Variables

Variable	Required	Default	Description
`SWAPWIZARD_API_KEY`	Yes	—	API key from swapwizard.xyz/integrators
`SWAPWIZARD_API_URL`	No	`https://api.swapwizard.xyz`	API base URL

Affiliate Integration

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, or full. Configure at swapwizard.xyz/developers.

Rate Limits

60 requests per minute per API key.

Development

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

See CONTRIBUTING.md for guidelines.

License

MIT

SwapWizard

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install SwapWizard?

Does SwapWizard need an API key?

What transport does SwapWizard use?

When was SwapWizard last checked?

Documentation

SwapWizard MCP Server

Quick Start

1. Get an API Key

2. Connect via MCP

Remote (no install)

Local — Claude Desktop

Local — Cursor

Local — Claude Code

Available Tools

Concentrated Liquidity Support

Protocols by chain

Execution Model

Agent Flows

Swap

Add Liquidity

Remove Liquidity

Rebalance (with clean quote)

Real-World Example

Agent exits a WLFI/USDC Uniswap V3 position into USDC

PoC Bot Demos

Supported Chains

Environment Variables

Affiliate Integration

Rate Limits

Development

Links

License