[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_117":118},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97},"apiUrl","https://odel.app/api","creator","defire-business","moduleId","swapwizard-mcp","@defire-business/swapwizard-mcp","displayName","SwapWizard","tagline","Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains","iconKey","https://avatars.githubusercontent.com/u/271413020?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.swapwizard.xyz/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363342000,"updatedAt",1788773614000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.DeFiRe-business%2Fswapwizard-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",7,"upstreamUpdatedAt",1783828648000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/DeFiRe-business/swapwizard-mcp","githubRepoFullName","DeFiRe-business/swapwizard-mcp","releaseId","ext-defire-business-swapwizard-mcp","version","1.8.9","descriptionMarkdown","

\n \n $\"SwapWizard\"$ \n \n

\n\n# SwapWizard MCP Server\n\n[![npm](https://img.shields.io/npm/v/@swapwizard/mcp-server)](https://www.npmjs.com/package/@swapwizard/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\nModel Context Protocol (MCP) server for the [SwapWizard](https://swapwizard.xyz) DeFi API. Enables AI agents to get swap quotes, manage liquidity, and discover pools across 5 EVM chains.\n\n**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.\n\n## Quick Start\n\n### 1. Get an API Key\n\nGo to [swapwizard.xyz/integrators](https://swapwizard.xyz/integrators), connect your wallet, and sign a message (no gas cost).\n\n### 2. Connect via MCP\n\n#### Remote (no install)\n\n```\nURL: https://mcp.swapwizard.xyz/mcp\nTransport: streamable-http\nHeader: X-API-Key: your-api-key\n```\n\n#### Local — Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"swapwizard\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@swapwizard/mcp-server\"],\n \"env\": {\n \"SWAPWIZARD_API_KEY\": \"your-api-key\"\n }\n }\n }\n}\n```\n\n#### Local — Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"swapwizard\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@swapwizard/mcp-server\"],\n \"env\": {\n \"SWAPWIZARD_API_KEY\": \"your-api-key\"\n }\n }\n }\n}\n```\n\n#### Local — Claude Code\n\n```bash\nclaude mcp add swapwizard -e SWAPWIZARD_API_KEY=your-api-key -- npx -y @swapwizard/mcp-server\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_supported_chains` | List supported EVM chains with IDs, gas tokens, DEX list, and position config |\n| `get_supported_dexes` | AMMs/DEX sources SwapWizard routes across per chain |\n| `check_api_health` | API availability check |\n| `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 |\n| `list_user_lp_positions` | Full LP position details: value, fees, APR, in-range status, impermanent loss |\n| `get_swap_quote` | Best swap route across all DEXes. Returns router + callData + value ready to sign |\n| `get_clean_quote` | Swap quote excluding the caller's own LP position from pool state (for rebalancing) |\n| `zap_into_lp_position` | Single-tx entry into any LP position from any token |\n| `zap_out_of_lp_position` | Single-tx exit from any LP position into any token. Pass `sender` to auto-detect nftManager |\n\nAll 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.\n\n## Concentrated Liquidity Support\n\nSwapWizard is not limited to classic V2-style LPs — 13 of the 22 integrated protocols are concentrated-liquidity (CL) AMMs, with full range management:\n\n- **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.\n- **Position monitoring** — `list_user_lp_positions` returns ticks, in-range status, uncollected fees, APR, and USD value for every CL position.\n- **Self-impact-free quoting** — `get_clean_quote` prices a swap excluding your own in-range CL liquidity from pool state (for rebalancing and exits).\n- **Rebalancing** — `zap_out_of_lp_position` (burn + collect + swaps in one tx) followed by `zap_into_lp_position` with a new range.\n\n### Protocols by chain\n\n| Protocol | Type | Ethereum | BSC | Polygon | Base | Arbitrum |\n|---|---|:-:|:-:|:-:|:-:|:-:|\n| Uniswap V3 | CL | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Uniswap V4 | CL | ✓ | ✓ | ✓ | ✓ | ✓ |\n| SushiSwap V3 | CL | ✓ | ✓ | ✓ | ✓ | ✓ |\n| PancakeSwap V3 | CL | ✓ | ✓ | — | ✓ | ✓ |\n| PancakeSwap Infinity CL | CL | — | ✓ | — | ✓ | — |\n| Aerodrome Slipstream (+ V2) | CL | — | — | — | ✓ | — |\n| Camelot (Algebra) | CL | — | — | — | — | ✓ |\n| THENA Fusion (Algebra) | CL | — | ✓ | — | — | — |\n| QuickSwap V3 (Algebra) | CL | — | — | ✓ | — | — |\n| Retro | CL | — | — | ✓ | — | — |\n| Fluid DEX | CL | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Balancer V3 | CL | ✓ | — | — | ✓ | ✓ |\n| Uniswap V2 | Classic | ✓ | ✓ | ✓ | ✓ | ✓ |\n| SushiSwap V2 | Classic | ✓ | ✓ | ✓ | ✓ | ✓ |\n| PancakeSwap V2 | Classic | — | ✓ | — | ✓ | — |\n| PancakeSwap Infinity Bin | Classic | — | ✓ | — | ✓ | — |\n| QuickSwap V2 | Classic | — | — | ✓ | — | — |\n| Aerodrome Classic | Classic | — | — | — | ✓ | — |\n| THENA Classic | Classic | — | ✓ | — | — | — |\n| Curve | Classic | ✓ | — | ✓ | — | ✓ |\n| Balancer V2 | Classic | ✓ | — | ✓ | ✓ | ✓ |\n\nA 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`.\n\n## Execution Model\n\nTools that return `router`, `callData`, `value` are executed by the user:\n\n1. If the input token is not native, approve the router to spend the token amount (ERC-20 approve)\n2. Send a transaction: `to: router`, `data: callData`, `value: value`\n\nThe agent presents the transaction — the user signs with their own wallet.\n\n## Agent Flows\n\n### Swap\n\n1. `get_supported_chains` — find available chains\n2. `get_swap_quote` — get best route + callData\n3. User approves (if non-native) and signs the transaction\n\n### Add Liquidity\n\n1. `search_liquidity_pools` — find target pool by tokens\n2. `zap_into_lp_position` — get router + callData\n3. User approves and signs the transaction\n\n### Remove Liquidity\n\n1. `list_user_lp_positions` — get current positions\n2. `zap_out_of_lp_position` — get router + callData (pass `sender` for auto-detection)\n3. User signs the transaction\n\n### Rebalance (with clean quote)\n\n1. `list_user_lp_positions` — get position details\n2. `get_clean_quote` — price excluding own liquidity\n3. `zap_out_of_lp_position` — exit current position\n4. `zap_into_lp_position` — enter new position\n\n## Real-World Example\n\nThis is not a testnet demo. After configuring a wallet private key and a SwapWizard API key, an autonomous agent was given this single prompt:\n\n```\nFind an MCP server that offers pool discovery with APR/TVL/volume data,\ncompetitive quotes and zap in/out options for concentrated liquidity.\nUsing that MCP:\n1. Find the concentrated pool with the highest APR on BSC that has\n at least 1 stablecoin\n2. Add 5 USDC of liquidity with a ±5% range around the current price\n3. Wait 15 seconds\n4. Remove the entire position receiving only USDC\n```\n\nThe agent discovered SwapWizard MCP, connected, and executed the full lifecycle autonomously. Here is the verified on-chain result:\n\n### Agent exits a WLFI/USDC Uniswap V3 position into USDC\n\n**On-chain proof**: [`0xede1afbc...c16f16c`](https://bscscan.com/tx/0xede1afbc9c4a4eee23ca8b784e6c63335322cf4216da275a8670e3f06c16f16c) — Block 101133314, May 29 2026\n\nThe agent called `zap_out_of_lp_position` to exit a concentrated liquidity position on BNB Chain. SwapWizard's router handled the full operation atomically:\n\n1. Burned the NFT position, receiving WLFI + USDC\n2. Swapped WLFI → USDC via the best available route\n3. Delivered **4.92 USDC** to the user's wallet in a single transaction\n\n```\nTool: zap_out_of_lp_position\nChain: BNB Chain (56)\nPool: WLFI / USDC — Uniswap V3\nRouter: 0xc664F80dff9655766398E86A6B95AF76660FA66d\nMethod: removeLiquidityMulti\nGas used: 411,002\nResult: 4.92 USDC received\n```\n\nThe 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.\n\n### PoC Bot Demos\n\nFull run videos:\n\n\n\n\n\n\n\n\n\n\n

English	Español
\n\n\n $\"Watch$ \n\n\n	\n\n\n $\"Ver$ \n\n\n

\n\n## Supported Chains\n\nEthereum (1), Arbitrum (42161), Base (8453), Polygon (137), BNB Chain (56)\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `SWAPWIZARD_API_KEY` | Yes | — | API key from [swapwizard.xyz/integrators](https://swapwizard.xyz/integrators) |\n| `SWAPWIZARD_API_URL` | No | `https://api.swapwizard.xyz` | API base URL |\n\n## Affiliate Integration\n\nEarn fees by embedding SwapWizard in your site:\n\n```html\n

\n\n```\n\nWidget modes: `swap`, `pools`, or `full`. Configure at [swapwizard.xyz/developers](https://swapwizard.xyz/developers).\n\n## Rate Limits\n\n60 requests per minute per API key.\n\n## Development\n\n```bash\nnpm install\nnpm run dev # run with tsx (hot reload)\nnpm run build # compile TypeScript\nnpm test # run tests\n```\n\nSee [CONTRIBUTING.md](https://github.com/DeFiRe-business/swapwizard-mcp/blob/main/CONTRIBUTING.md) for guidelines.\n\n## Links\n\n- [Website](https://swapwizard.xyz)\n- [API Docs](https://swapwizard.xyz/api-docs)\n- [AI Agent Docs](https://swapwizard.xyz/ai-agents)\n- [npm](https://www.npmjs.com/package/@swapwizard/mcp-server)\n- [Widget Configurator](https://swapwizard.xyz/developers)\n- [Changelog](https://github.com/DeFiRe-business/swapwizard-mcp/blob/main/CHANGELOG.md)\n\n## License\n\n[MIT](https://github.com/DeFiRe-business/swapwizard-mcp/blob/main/LICENSE)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":111},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_98":85,"_99":85},"ratingAvg","reviewCount","topics",[],"license","MIT","language","JavaScript","registryName","io.github.DeFiRe-business/swapwizard-mcp","homepage","https://swapwizard.xyz","packages",[112],{"_113":114,"_115":116,"_75":76},"registryType","npm","identifier","@swapwizard/mcp-server","ENV",{"_119":120,"_121":122,"_123":124},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]