--- name: cross-chain-swap description: Execute a cross-chain token swap via Uniswap's bridge infrastructure. Handles quoting, safety validation, bridge monitoring, and destination confirmation. Use when the user wants to swap tokens across different chains. model: opus allowed-tools: [Task(subagent_type:cross-chain-executor), mcp__uniswap__getSupportedChains, mcp__uniswap__getTokenInfo] --- # 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"). 2. **Validate inputs**: - Verify both chains are supported via `mcp__uniswap__getSupportedChains`. - Verify tokens exist on their respective chains via `mcp__uniswap__getTokenInfo`. - If source and destination chain are the same: redirect to `execute-swap` skill instead. 3. **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. 4. **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 ```text 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 | --- Source attribution: modbender Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/cross-chain-swap/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 skill-library-mcp contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: modbender Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/cross-chain-swap/SKILL.md Attribution basis: Source repository record Fields of work: Marketing, Sales Roles: Growth Marketer, Product Marketer, Sales Engineer Specialties: API Tools: Uniswap Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: a695afeb99dafd756e7a0064fcca4f5288df7639c02cfa0dfa18b31df9ff18d7