Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

SwapWizard

by DeFiRe-businessversion 1.8.9i★ 7iComputer or cloudOfficial site ↗
Registry nameio.github.DeFiRe-business/swapwizard-mcp

How to install

What it does

Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains

  • Connects Computer or cloud
  • Account or key Cloud: No key needed · Local: Needs SWAPWIZARD_API_KEY
  • Category Crypto & blockchain

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity11/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness3/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score22/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install SwapWizard. Follow https://mcp.popnx.com/i/defire-business-swapwizard-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (mcp.swapwizard.xyz) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameSwapWizard
    Remote MCP server URL · Addresshttps://mcp.swapwizard.xyz/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsSwapWizard

  4. Try it

    Use SwapWizard and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using SwapWizard or shows a SwapWizard tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameSwapWizard
    Connection · Addresshttps://mcp.swapwizard.xyz/mcp
  3. Pick SwapWizard in a chat

    Start a new chat and pick SwapWizard from your plugins before typing

  4. Try it

    Use SwapWizard and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using SwapWizard or shows a SwapWizard tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user swapwizard https://mcp.swapwizard.xyz/mcp
  3. Type /mcp in Claude Code

    You should see SwapWizard listed as connected

  4. Try it

    Use SwapWizard and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using SwapWizard or shows a SwapWizard tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use SwapWizard and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using SwapWizard or shows a SwapWizard tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use SwapWizard and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using SwapWizard or shows a SwapWizard tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.swapwizard.xyz/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use SwapWizard💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user swapwizard https://mcp.swapwizard.xyz/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "swapwizard": {
      "url": "https://mcp.swapwizard.xyz/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "swapwizard": {
      "type": "http",
      "url": "https://mcp.swapwizard.xyz/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user swapwizard --env SWAPWIZARD_API_KEY=your-value -- npx -y @swapwizard/mcp-server

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "swapwizard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@swapwizard/mcp-server"
      ],
      "env": {
        "SWAPWIZARD_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • SWAPWIZARD_API_KEY secret required env
    API key from https://swapwizard.xyz/integrators

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
121/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
1.8.9
Published to registryi
Jun 13, 2026
Code last changedi
Jul 12, 2026
Last checked
Nov 19, 2026
Maker
DeFiRe-business
Packages
npm: @swapwizard/mcp-server
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 19, 2026. The maker wrote them, not us; we show them as plain text.

  • 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

  • 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, underlyingTokens (token addresses), fee tier, protocol, dexKind, APY, apyBase (fee-only APY excluding reward emissions), TVL (USD), 24h/7d volume (USD), stablecoin flags,

  • 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; sta

  • 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. Eac

  • 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

  • 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

  • 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 tr

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

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account DeFiRe-business, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 4 months ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 325 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 11 tool descriptions and found no hidden instructions to the AI

The cloud address answered 5 of the last 5 checks · latest 325 ms · checked Nov 19, 2026

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @swapwizard/mcp-server@1.8.9

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/defire-business-swapwizard-mcp.svg)](https://mcp.popnx.com/en/servers/defire-business-swapwizard-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Crypto & blockchaini

  • More stars than 96% of the other 1766 servers in this category
  • Published to the registry more recently than 19% of the other 1766 servers in this category
  • Basic checks equal to or better than 99% of the other 1766 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is SwapWizard safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: SWAPWIZARD_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 4 months ago, and the latest version (1.8.9) reached the registry 5 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

DexSQL

SQL for Android APK and DEX files: classes, methods, strings, references and smali.

by LSPosedGrowing★ 320Updated 32 days ago

Runs on your computer✓ lsposed.org

PayRam

Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.

by PayRamGrowing★ 158Updated 43 days ago

Runs in the cloud✓ service owner · payram.com

DexPaprika

DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.

by coinpaprikaGrowing★ 120Updated 6 days ago

Runs in the cloud✓ service owner · dexpaprika.com

X402 List MCP

Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.

by mcccsmEarly↓ 80/wk★ 18Updated 40 days ago

Computer or cloud✓ service owner · x402-list.com
Compared with similar ones
This one
SwapWizard
DexSQLPayRamDexPaprikaAlchemy MCP ServerX402 List MCP
Runs whereCloud or install on your computerInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/52/33/44/44/45/5
LicenseMITNOASSERTION–MITMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

ToolDescription
get_supported_chainsList supported EVM chains with IDs, gas tokens, DEX list, and position config
get_supported_dexesAMMs/DEX sources SwapWizard routes across per chain
check_api_healthAPI availability check
search_liquidity_poolsDiscover 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_positionsFull LP position details: value, fees, APR, in-range status, impermanent loss
get_swap_quoteBest swap route across all DEXes. Returns router + callData + value ready to sign
get_clean_quoteSwap quote excluding the caller's own LP position from pool state (for rebalancing)
zap_into_lp_positionSingle-tx entry into any LP position from any token
zap_out_of_lp_positionSingle-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
ProtocolTypeEthereumBSCPolygonBaseArbitrum
Uniswap V3CL✓✓✓✓✓
Uniswap V4CL✓✓✓✓✓
SushiSwap V3CL✓✓✓✓✓
PancakeSwap V3CL✓✓—✓✓
PancakeSwap Infinity CLCL—✓—✓—
Aerodrome Slipstream (+ V2)CL———✓—
Camelot (Algebra)CL————✓
THENA Fusion (Algebra)CL—✓———
QuickSwap V3 (Algebra)CL——✓——
RetroCL——✓——
Fluid DEXCL✓✓✓✓✓
Balancer V3CL✓——✓✓
Uniswap V2Classic✓✓✓✓✓
SushiSwap V2Classic✓✓✓✓✓
PancakeSwap V2Classic—✓—✓—
PancakeSwap Infinity BinClassic—✓—✓—
QuickSwap V2Classic——✓——
Aerodrome ClassicClassic———✓—
THENA ClassicClassic—✓———
CurveClassic✓—✓—✓
Balancer V2Classic✓—✓✓✓

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:

  1. If the input token is not native, approve the router to spend the token amount (ERC-20 approve)
  2. Send a transaction: to: router, data: callData, value: value

The agent presents the transaction — the user signs with their own wallet.

Agent Flows

Swap
  1. get_supported_chains — find available chains
  2. get_swap_quote — get best route + callData
  3. User approves (if non-native) and signs the transaction
Add Liquidity
  1. search_liquidity_pools — find target pool by tokens
  2. zap_into_lp_position — get router + callData
  3. User approves and signs the transaction
Remove Liquidity
  1. list_user_lp_positions — get current positions
  2. zap_out_of_lp_position — get router + callData (pass sender for auto-detection)
  3. User signs the transaction
Rebalance (with clean quote)
  1. list_user_lp_positions — get position details
  2. get_clean_quote — price excluding own liquidity
  3. zap_out_of_lp_position — exit current position
  4. 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:

  1. Burned the NFT position, receiving WLFI + USDC
  2. Swapped WLFI → USDC via the best available route
  3. 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:

English Español

Supported Chains

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

Environment Variables

VariableRequiredDefaultDescription
SWAPWIZARD_API_KEYYes—API key from swapwizard.xyz/integrators
SWAPWIZARD_API_URLNohttps://api.swapwizard.xyzAPI base URL

Affiliate Integration

Earn fees by embedding SwapWizard in your site:

<div data-swapwizard="swap" data-affiliate="0xYourAddress" data-theme="dark"></div>

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.

Links

License

MIT