# SwapWizard

MCP-сервер для DeFi-операций в EVM-сетях: котировки, пулы и позиции ликвидности. Подходит агентам, которым нужно подготовить транзакцию для подписи.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: DeFiRe-business
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/DeFiRe-business/swapwizard-mcp
- Обновлён: 2026-07-12
- HTML: https://affpapa.org/nevibecode/mcp/swapwizard

## Что делает

SwapWizard даёт агенту инструменты для поиска пулов, получения котировок обмена и работы с LP-позициями в пяти EVM-сетях. Сервер возвращает данные о пулах, включая APR, TVL, объём и комиссию, а также маршруты обмена через разные DEX.

Для концентрированной ликвидности доступны пользовательские диапазоны, вход и выход из позиции через одну транзакцию, мониторинг тиков и расчёт котировки без учёта собственной ликвидности. Без `SWAPWIZARD_API_KEY` локальный сервер не получит доступ к API.

Модель некастодиальная: SwapWizard возвращает `router`, `callData` и `value`, а пользователь сам подтверждает транзакцию своим кошельком. Для токена ERC-20 сначала требуется выдать роутеру разрешение на расходование суммы.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.swapwizard.xyz/mcp`
- Переменные окружения: `SWAPWIZARD_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http swapwizard-mcp https://mcp.swapwizard.xyz/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env SWAPWIZARD_API_KEY=<SWAPWIZARD_API_KEY> --transport stdio swapwizard -- npx -y @swapwizard/mcp-server
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add swapwizard --url https://mcp.swapwizard.xyz/mcp
```

2. **Командой платформы**
```bash
codex mcp add swapwizard --env SWAPWIZARD_API_KEY=<SWAPWIZARD_API_KEY> -- npx -y @swapwizard/mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "swapwizard": {
            "url": "https://mcp.swapwizard.xyz/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "swapwizard": {
            "command": "npx",
            "args": [
                "-y",
                "@swapwizard/mcp-server"
            ],
            "env": {
                "SWAPWIZARD_API_KEY": "<SWAPWIZARD_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "swapwizard": {
            "type": "http",
            "url": "https://mcp.swapwizard.xyz/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "swapwizard": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@swapwizard/mcp-server"
            ],
            "env": {
                "SWAPWIZARD_API_KEY": "<SWAPWIZARD_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http swapwizard https://mcp.swapwizard.xyz/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e SWAPWIZARD_API_KEY=<SWAPWIZARD_API_KEY> swapwizard npx -y @swapwizard/mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- находить пулы по токенам и сети
- получать маршрут обмена через DEX
- добавлять ликвидность в заданном диапазоне
- выводить LP-позицию в нужный токен
- пересчитывать обмен без собственной ликвидности

## Примеры запросов агенту
- Найди пулы для этой пары токенов и покажи APR, TVL и объём.
- Получи лучший маршрут обмена в этой сети и подготовь данные транзакции для подписи.
- Проверь мою LP-позицию, затем рассчитай выход в один токен без учёта моей ликвидности.

## Похожие
- [liquidity-planner](https://affpapa.org/nevibecode/skills/liquidity-planner.md) — скилл · 1200 установок
- [lp-integration](https://affpapa.org/nevibecode/skills/lp-integration.md) — скилл · 440 установок
- [lp-math](https://affpapa.org/nevibecode/skills/lp-math.md) — скилл · 432 установки
- [impermanent-loss](https://affpapa.org/nevibecode/skills/impermanent-loss.md) — скилл · 427 установок
- [1inch](https://affpapa.org/nevibecode/skills/1inch.md) — скилл · 352 установки
- [mcp](https://affpapa.org/nevibecode/mcp/swap-api-mcp.md) — MCP-сервер · ★ 22

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
