​

KyberSwap Plugin

[!IMPORTANT] Complete the short Base MCP onboarding flow defined in SKILL.md before calling any KyberSwap endpoint. The user’s wallet address is fetched lazily when needed.

​

Overview

​

Surface Routing

​

Endpoints

​

GET /api/v1/routes

GET https://aggregator-api.kyberswap.com/{chain}/api/v1/routes
  ?tokenIn={address}
  &tokenOut={address}
  &amountIn={amountInWei}
  &to={walletAddress}
  &slippageTolerance={bps}
  &source=base-mcp

{
  "data": {
    "routeSummary": {
      "amountIn": "100000000",
      "amountInUsd": "100.00",
      "amountOut": "38650000000000000",
      "amountOutUsd": "99.71",
      "gas": "300000",
      "gasUsd": "0.29",
      "...": "other fields — pass verbatim to build step"
    },
    "routerAddress": "0x6131B5fae19EA4f9D964eAc0408E4408b66337b5"
  }
}

​

POST /api/v1/route/build

{
  "url": "https://aggregator-api.kyberswap.com/{chain}/api/v1/route/build",
  "method": "POST",
  "headers": { "content-type": "application/json", "x-client-id": "base-mcp" },
  "body": {
    "routeSummary": { "...": "complete object from GET response" },
    "sender": "<walletAddress>",
    "recipient": "<walletAddress>",
    "slippageTolerance": 50,
    "deadline": "<current unix timestamp + 1200>",
    "source": "base-mcp"
  }
}

{
  "data": {
    "amountIn": "100000000",
    "amountOut": "38650000000000000",
    "gas": "300000",
    "transactionValue": "0",
    "routerAddress": "0x6131B5fae19EA4f9D964eAc0408E4408b66337b5",
    "data": "0x..."
  }
}

​

GET /api/v1/public/tokens (token resolution)

GET https://token-api.kyberswap.com/api/v1/public/tokens
  ?chainIds={chainId}
  &name={symbol}
  &isWhitelisted=true

​

Orchestration

​

Swap

1. get_wallets → walletAddress.
2. Resolve token symbols to addresses — use the ## Notes table first, then the token-api endpoint.
3. Compute amountIn in base units: multiply human amount by 10^decimals (ETH=18, USDC=6, WBTC=8).
4. Determine slippage: default 50 bps for common pairs, 100 bps for long-tail tokens. Apply thresholds in ## Risks & Warnings before proceeding.
5. GET /api/v1/routes → routeSummary, amountOut, amountOutUsd, gasUsd. Show the quoted output and gas cost to the user; confirm before proceeding.
6. POST /api/v1/route/build → data (swap calldata), transactionValue, routerAddress. Verify routerAddress equals 0x6131B5fae19EA4f9D964eAc0408E4408b66337b5 — abort and warn the user if it differs.
7. Build calls array:
   • Native tokenIn → [swap_call]
   • ERC-20 tokenIn → [approval_call, swap_call] — always include approval, no allowance check needed.
   • USDT on Ethereum — if existing allowance is non-zero, prepend a zero-approval call before the real approval.
8. send_calls(chain, calls) → approvalUrl, requestId.
9. Present approvalUrl to the user. Do not auto-approve. Call get_request_status(requestId) only after the user acts.

​

Submission

{
  "chain": "<chain string>",
  "calls": [
    {
      "to": "<tokenIn address>",
      "value": "0x0",
      "data": "<ERC-20 approve calldata>"
    },
    {
      "to": "0x6131B5fae19EA4f9D964eAc0408E4408b66337b5",
      "value": "<hex(transactionValue)>",
      "data": "<data from /route/build response>"
    }
  ]
}

{
  "chain": "<chain string>",
  "calls": [
    {
      "to": "0x6131B5fae19EA4f9D964eAc0408E4408b66337b5",
      "value": "<hex(transactionValue)>",
      "data": "<data from /route/build response>"
    }
  ]
}

Function: approve(address spender, uint256 amount)
Selector: 0x095ea7b3
spender:  000000000000000000000000{router without 0x}
amount:   {amountIn as 32-byte hex, left-padded with zeros}

Example — approve 100 USDC (amountIn = 100000000 = 0x5F5E100):
0x095ea7b3
  0000000000000000000000006131b5fae19ea4f9d964eac0408e4408b66337b5
  0000000000000000000000000000000000000000000000000000000005f5e100

​

Example Prompts

1. get_wallets → address.
2. GET /api/v1/routes on base — tokenIn=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC, 6 dec), tokenOut=0xEeee...eEEE, amountIn=100000000.
3. Show quoted output and gas to user; confirm.
4. POST /api/v1/route/build → data (swap calldata), transactionValue="0" → hex-encode to "0x0".
5. Encode approve calldata: router spends 100000000 USDC.
6. send_calls("base", [approval_call, swap_call]).

1. get_wallets → address.
2. GET /api/v1/routes on arbitrum — tokenIn=0xEeee...eEEE, tokenOut=0xaf88d065e77c8cC2239327C5EDb3A432268e5831 (USDC), amountIn=100000000000000000.
3. Show quoted output and gas to user; confirm.
4. POST /api/v1/route/build → data (swap calldata), transactionValue="10000000000000000" → hex-encode to "0xde0b6b3a7640000" (non-zero, native input).
5. No approval needed — native ETH.
6. send_calls("arbitrum", [swap_call]) with value=transactionValue.

1. get_wallets → address.
2. GET /api/v1/routes on polygon — tokenIn=0xEeee...eEEE, tokenOut=0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 (USDC), amountIn=500000000000000000000.
3. Return amountOutUsd and gasUsd to the user — no transaction submitted.

​

Risks & Warnings

• Slippage — Swaps can fill materially worse than the quoted price if market conditions shift between quote and execution. Apply the following thresholds:

  Tolerance	Level	Action
  ≤ 100 bps (1%)	Normal	Proceed.
  > 100 and ≤ 500 bps (5%)	Elevated	Mention the value and ask the user to confirm.
  > 500 and ≤ 2000 bps (20%)	High	Warn that the trade can fill significantly below quote and is a likely sandwich target. Require explicit confirmation.
  > 2000 bps	Very high	Strongly warn; do not submit without the user re-confirming the exact number.

  If the user does not specify slippage, default to 50 bps for common pairs (ETH/USDC, WBTC/ETH) and 100 bps for long-tail or volatile tokens. Always pass an explicit value — the API defaults to 0 bps if slippageTolerance is omitted, causing most trades to fail.

​

Notes