SwapWizard

SwapWizard MCP サーバー

SwapWizard DeFi API 用の Model Context Protocol（MCP）サーバーです。AI エージェントがスワップの見積もりを取得し、流動性を管理し、5 つの EVM チェーン上のプールを見つけられるようにします。

ノンカストディアル：すべてのツールは router、callData、value を返します。エージェントがトランザクションを提示し、ユーザーは自身のウォレットで署名します。SwapWizard が秘密鍵を保管することはありません。

クイックスタート

1. API キーを取得する

swapwizard.xyz/integrators にアクセスし、ウォレットを接続してメッセージに署名します（ガス代はかかりません）。

2. MCP 経由で接続する

リモート（インストール不要）

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

ローカル — Claude Desktop

claude_desktop_config.json に追加します：

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

ローカル — Cursor

.cursor/mcp.json に追加します：

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

ローカル — Claude Code

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

利用可能なツール

ツール	説明
get_supported_chains	サポート対象の EVM チェーンを、ID、ガストークン、DEX の一覧、ポジション設定とともに一覧表示します
get_supported_dexes	SwapWizard がチェーンごとにルーティングする AMM／DEX ソース
check_api_health	API の稼働状況を確認します
search_liquidity_pools	チェーン、トークン、種類、または GeckoTerminal のトレンド（trending: true と任意の timeframe：5m／1h／6h／24h、デフォルトは 5m）でプールを検索します。poolId、シンボル、手数料ティア、プロトコル、APY、TVL、24 時間の取引高を返します
list_user_lp_positions	LP ポジションの詳細情報をすべて表示します：価値、手数料、APR、レンジ内かどうか、インパーマネントロス
get_swap_quote	すべての DEX を対象に最適なスワップルートを取得します。署名可能な router、callData、value を返します
get_clean_quote	プールの状態から呼び出し元自身の LP ポジションを除外したスワップ見積もりを取得します（リバランス用）
zap_into_lp_position	任意のトークンから任意の LP ポジションに、1 回のトランザクションで参加します
zap_out_of_lp_position	任意の LP ポジションから任意のトークンへ、1 回のトランザクションで退出します。sender を渡すと nftManager を自動検出します

すべての見積もりツール（get_swap_quote、get_clean_quote、zap_into_lp_position、zap_out_of_lp_position）は、任意の affiliateCode を受け付けます。これは SwapWizard にオンチェーン登録されたアフィリエイトウォレットアドレスで、API に転送され、アフィリエイト手数料がそのアドレスに支払われます。

集中流動性のサポート

SwapWizard は従来の V2 形式の LP に限定されません。統合されている 22 のプロトコルのうち 13 は集中流動性（CL）AMM であり、レンジを完全に管理できます：

• 価格レンジのカスタマイズ — zap_into_lp_position は tickLower／tickUpper を受け付け、任意のレンジで CL ポジションをミントします（省略するとプロトコルのデフォルトが適用されます）。トークンの分割、中間スワップ、ミント、レンジ設定を 1 回のトランザクションで行います。
• ポジションの監視 — list_user_lp_positions は、すべての CL ポジションについて、ティック、レンジ内かどうか、未回収の手数料、APR、米ドル換算額を返します。
• 自己影響を除外した見積もり — get_clean_quote は、プールの状態から自身のレンジ内 CL 流動性を除外してスワップ価格を算出します（リバランスおよび退出用）。
• リバランス — zap_out_of_lp_position（バーン＋回収＋スワップを 1 回のトランザクションで実行）の後、新しいレンジを指定して zap_into_lp_position を実行します。

チェーン別プロトコル

プロトコル	種類	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	—	—	✓	—	—
Fluid DEX	CL	✓	✓	✓	✓	✓
Balancer V3	CL	✓	—	—	✓	✓
Uniswap V2	Classic	✓	✓	✓	✓	✓
SushiSwap V2	Classic	✓	✓	✓	✓	✓
PancakeSwap V2	Classic	—	✓	—	✓	—
PancakeSwap Infinity Bin	Classic	—	✓	—	✓	—
QuickSwap V2	Classic	—	—	✓	—	—
Aerodrome Classic	Classic	—	—	—	✓	—
THENA Classic	Classic	—	✓	—	—	—
Curve	Classic	✓	—	✓	—	✓
Balancer V2	Classic	✓	—	✓	✓	✓

組み込みの Split Router は、5つすべてのチェーンで複数の DEX に注文を分割することもできます。最新のレジストリは get_supported_dexes / get_supported_chains から確認できます。

実行モデル

router、callData、value を返すツールは、ユーザーが実行します。

1. 入力トークンがネイティブトークンでない場合、ルーターがそのトークン額を使用できるよう承認します（ERC-20 approve）
2. トランザクションを送信します：to: router、data: callData、value: value

エージェントがトランザクションを提示し、ユーザーは自身のウォレットで署名します。

エージェントのフロー

スワップ

1. get_supported_chains — 利用可能なチェーンを確認します
2. get_swap_quote — 最適なルートと callData を取得します
3. ユーザーが承認し（ネイティブトークン以外の場合）、トランザクションに署名します

流動性の追加

1. search_liquidity_pools — トークンから対象のプールを検索します
2. zap_into_lp_position — router と callData を取得します
3. ユーザーが承認し、トランザクションに署名します

流動性の削除

1. list_user_lp_positions — 現在のポジションを取得します
2. zap_out_of_lp_position — router と callData を取得します（自動検出には sender を渡します）
3. ユーザーがトランザクションに署名します

リバランス（クリーンな見積もりを使用）

1. list_user_lp_positions — ポジションの詳細を取得します
2. get_clean_quote — 自身の流動性を除外した価格を取得します
3. zap_out_of_lp_position — 現在のポジションから退出します
4. zap_into_lp_position — 新しいポジションに入ります

実際の例

これはテストネットのデモではありません。ウォレットの秘密鍵と SwapWizard API キーを設定した後、自律型エージェントに次のプロンプトを1つだけ与えました。

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

エージェントは SwapWizard MCP を検出して接続し、一連の処理をすべて自律的に実行しました。検証済みのオンチェーン結果は次のとおりです。

エージェントが WLFI/USDC Uniswap V3 ポジションを USDC に変換して退出

オンチェーンでの証明：0xede1afbc...c16f16c — Block 101133314、2026年5月29日

エージェントは zap_out_of_lp_position を呼び出し、BNB Chain 上の集中流動性ポジションから退出しました。SwapWizard のルーターが一連の処理をすべてアトミックに実行しました。

1. NFT ポジションをバーンし、WLFI と USDC を受け取りました
2. 利用可能な最適なルートで WLFI → USDC にスワップしました
3. 1回のトランザクションで、ユーザーのウォレットに4.92 USDCを届けました

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

エージェントが見積もりを取得し、ユーザーが NFT を承認して署名するだけで完了しました。手動でのパラメーター調整、コントラクトとのやり取り、スリッページ計算は不要です。MCP サーバーは sender アドレスから nftManager、dexName、liquidityKind を自動検出しました。

PoC ボットのデモ

全編の動画：

英語	スペイン語

対応チェーン

Ethereum（1）、Arbitrum（42161）、Base（8453）、Polygon（137）、BNB Chain（56）

環境変数

変数	必須	デフォルト	説明
SWAPWIZARD_API_KEY	はい	—	swapwizard.xyz/integrators で取得する API キー
SWAPWIZARD_API_URL	いいえ	https://api.swapwizard.xyz	API のベース URL

アフィリエイト連携

SwapWizard をサイトに埋め込んで、手数料を獲得できます：

<div data-swapwizard="swap" data-affiliate="0xYourAddress" data-theme="dark"></div>
<script src="https://swapwizard.xyz/widget.js" async></script>

ウィジェットのモード：swap、pools、full。設定は swapwizard.xyz/developers で行ってください。

レート制限

API キーごとに毎分 60 リクエストです。

開発

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

ガイドラインについては、CONTRIBUTING.md をご覧ください。

リンク

• ウェブサイト
• API ドキュメント
• AI エージェントのドキュメント
• npm
• ウィジェット設定ツール
• 変更履歴

ライセンス

MIT