Execute Swap

Execute a token swap on Uniswap with full safety validation.

Activation

Use this skill when the user says any of:

• "Swap X for Y"
• "Buy X with Y"
• "Sell X for Y"
• "Trade X for Y"
• "Exchange X to Y"
• "Convert X to Y"

Input Extraction

Extract these parameters from the user's message:

| Parameter | Required | Default | Source |

|-----------|----------|---------|--------|

| tokenIn | Yes | — | Token name/symbol/address |

| tokenOut | Yes | — | Token name/symbol/address |

| amount | Yes | — | Numeric value |

| chain | No | ethereum | Chain name or context |

| slippage | No | 0.5% | Explicit percentage |

| routing | No | auto | "via V3", "use UniswapX", etc. |

Workflow

1. Validate inputs: Resolve token symbols using search_tokens. Confirm chain is supported.

1. Pre-flight safety check: Call check_safety_status to verify:

• Spending limits have room for this trade
• Rate limits are not exhausted
• Circuit breaker is not tripped

1. Delegate to trade-executor: Launch Task(subagent_type:trade-executor) with:

• tokenIn, tokenOut, amount, chain
• slippageTolerance (in bps)
• routingPreference (auto/v2/v3/v4/uniswapx)

1. Report result to the user in a clear format:

Swap Executed Successfully

  Input:  500.00 USDC
  Output: 0.1538 WETH ($499.55)
  Price:  1 WETH = $3,248.04
  Impact: 0.01%
  Gas:    $0.42

  Tx: https://basescan.org/tx/0xABC...

  Safety: All 7 checks passed

Error Handling

| Error | User Message | Suggested Action |

|-------|-------------|-----------------|

| SAFETY_SPENDING_LIMIT_EXCEEDED | "This swap would exceed your $X daily limit." | Reduce amount or wait |

| SAFETY_TOKEN_NOT_ALLOWED | "TOKEN is not on your allowlist." | Add to config |

| SAFETY_SIMULATION_FAILED | "Swap simulation failed: [reason]." | Check addresses, try smaller |

| INSUFFICIENT_LIQUIDITY | "Not enough liquidity at acceptable slippage." | Try smaller amount |

MCP server dependency

This skill relies on Uniswap MCP tools for chain support lookup, token search, safety checks, and swap execution.

When used in isolation (for example, from a skills catalog), ensure the Agentic Uniswap MCP server is running:

• Repo: Agentic-Uniswap MCP server
• Package: @agentic-uniswap/mcp-server