# SwapWizard

An MCP server for DeFi swaps, pool discovery, and LP position workflows across five EVM chains. It prepares transactions for the user to sign.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: DeFiRe-business
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/DeFiRe-business/swapwizard-mcp
- Updated: 2026-07-12
- HTML: https://affpapa.org/en/nevibecode/mcp/swapwizard

## What it does

SwapWizard gives an agent tools for finding liquidity pools, comparing swap routes, and inspecting or changing LP positions across five EVM chains. Pool search can return APR, TVL, volume, fee tier, and protocol details, while quote tools provide transaction data from the selected route.

Concentrated-liquidity workflows include custom tick ranges, one-transaction entry and exit, position monitoring, and quotes that exclude the caller’s own liquidity. A local setup needs `SWAPWIZARD_API_KEY` to reach the API.

The service is non-custodial. Each execution-oriented tool returns `router`, `callData`, and `value`; the user approves ERC-20 spending when required and signs the wallet transaction. SwapWizard does not hold private keys.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.swapwizard.xyz/mcp`
- Environment variables: `SWAPWIZARD_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http swapwizard-mcp https://mcp.swapwizard.xyz/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SWAPWIZARD_API_KEY=<SWAPWIZARD_API_KEY> --transport stdio swapwizard -- npx -y @swapwizard/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add swapwizard --url https://mcp.swapwizard.xyz/mcp
```

2. **Platform CLI**
```bash
codex mcp add swapwizard --env SWAPWIZARD_API_KEY=<SWAPWIZARD_API_KEY> -- npx -y @swapwizard/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "swapwizard": {
            "url": "https://mcp.swapwizard.xyz/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "swapwizard": {
            "command": "npx",
            "args": [
                "-y",
                "@swapwizard/mcp-server"
            ],
            "env": {
                "SWAPWIZARD_API_KEY": "<SWAPWIZARD_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "swapwizard": {
            "type": "http",
            "url": "https://mcp.swapwizard.xyz/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "swapwizard": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@swapwizard/mcp-server"
            ],
            "env": {
                "SWAPWIZARD_API_KEY": "<SWAPWIZARD_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http swapwizard https://mcp.swapwizard.xyz/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SWAPWIZARD_API_KEY=<SWAPWIZARD_API_KEY> swapwizard npx -y @swapwizard/mcp-server
```
Replace <…> with your own values

## When to use it
- discover liquidity pools by chain and token
- compare swap routes across DEXes
- enter an LP position with a chosen range
- exit a position into a selected token
- price a rebalance without self-impact

## Example prompts
- Find pools for this token pair and report APR, TVL, and volume.
- Get the best swap route on this chain and prepare the transaction for my wallet to sign.
- Inspect my LP positions, then price an exit that excludes my own liquidity.

## Similar
- [liquidity-planner](https://affpapa.org/en/nevibecode/skills/liquidity-planner.md) — skill · 1200 installs
- [lp-integration](https://affpapa.org/en/nevibecode/skills/lp-integration.md) — skill · 440 installs
- [lp-math](https://affpapa.org/en/nevibecode/skills/lp-math.md) — skill · 432 installs
- [impermanent-loss](https://affpapa.org/en/nevibecode/skills/impermanent-loss.md) — skill · 427 installs
- [1inch](https://affpapa.org/en/nevibecode/skills/1inch.md) — skill · 352 installs
- [mcp](https://affpapa.org/en/nevibecode/mcp/swap-api-mcp.md) — MCP server · ★ 22

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md