Cross-Chain Swap

Overview

Executes a cross-chain token swap — swapping a token on one chain for a different (or same) token on another chain. Delegates the full workflow to the cross-chain-executor agent, which handles quoting, route evaluation, safety checks, bridge monitoring, and destination confirmation.

When to Use

Activate when the user asks:

• "Swap ETH on Arbitrum for USDC on Base"
• "Cross-chain swap"
• "Buy USDC on Optimism using ETH from mainnet"
• "Move my ETH from Ethereum to Arbitrum and convert to USDC"
• "Swap tokens across chains"
• "Exchange X on chain A for Y on chain B"

Parameters

| Parameter | Required | Default | Description |

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

| tokenIn | Yes | — | Input token symbol or address on source chain |

| tokenOut | Yes | — | Output token symbol or address on destination chain |

| amount | Yes | — | Amount to swap (human-readable, e.g., "1.5" or "1000") |

| sourceChain | Yes | — | Source chain name (e.g., "ethereum", "arbitrum") |

| destChain | Yes | — | Destination chain name (e.g., "base", "optimism") |

| slippage | No | auto | Slippage tolerance (e.g., "0.5" for 0.5%) |

| recipient | No | Same wallet| Recipient address on destination chain |

Workflow

1. Extract parameters from the user's request. Identify:

• Which token they want to send and on which chain.
• Which token they want to receive and on which chain.
• The amount to swap.
• Resolve ambiguous chain references (e.g., "mainnet" = "ethereum").

1. Validate inputs:

• Verify both chains are supported via mcpuniswapgetSupportedChains.
• Verify tokens exist on their respective chains via mcpuniswapgetTokenInfo.
• If source and destination chain are the same: redirect to execute-swap skill instead.

1. Delegate to cross-chain-executor: Invoke Task(subagent_type:cross-chain-executor) with:

• tokenIn, tokenOut, amount, sourceChain, destChain, slippage, recipient.
• The agent handles the full 7-step workflow: quote, risk assessment, safety check, execution, bridge monitoring, confirmation, and reporting.

1. Present results: Format the execution report for the user, highlighting:

• Amounts sent and received.
• Total fees (gas + bridge).
• Settlement time.
• Any warnings from safety or risk checks.

Output Format

Cross-Chain Swap Complete

  Source:      1.5 ETH on Ethereum
  Destination: 2,850.25 USDC on Base
  Fees:        $3.50 (gas: $2.50, bridge: $1.00)
  Settlement:  2 min 35 sec

  Source Tx:   0xabc...123
  Bridge ID:   0x789...abc
  Dest Tx:     0xdef...456

  Risk: LOW | Safety: APPROVED

Important Notes

• Cross-chain swaps involve bridge operations that take time to settle (typically 1-10 minutes).
• The skill will monitor the bridge and report status updates during settlement.
• Bridge fees and slippage apply in addition to normal swap fees.
• If the bridge gets stuck, the executor will escalate with recovery instructions.

Error Handling

| Error | User-Facing Message | Suggested Action |

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

| Unsupported chain | "Chain [name] is not supported for cross-chain swaps." | Check supported chains |

| Same chain | "Source and destination are the same chain. Use a regular swap." | Use execute-swap skill |

| Safety veto | "This swap was blocked by safety checks: [reason]." | Reduce amount or check token |

| Risk veto | "Risk assessment vetoed: [reason]." | Choose a different route or amount |

| Bridge stuck | "Bridge settlement is taking longer than expected." | Wait or check order ID manually |

| Bridge failed | "Bridge operation failed. Funds should remain on source chain." | Check source wallet balance |

| Insufficient balance | "Not enough [token] on [chain] to execute this swap." | Check balance and reduce amount |