Bridge Tokens

Overview

Bridges tokens from one chain to another — a simplified cross-chain operation where the token stays the same (e.g., USDC on Ethereum to USDC on Base). Delegates to the cross-chain-executor agent with tokenOut = tokenIn to streamline the workflow.

This is the simpler sibling of cross-chain-swap. Use this when the user just wants to move tokens, not swap them.

When to Use

Activate when the user asks:

• "Bridge 1000 USDC from Ethereum to Base"
• "Move my ETH to Arbitrum"
• "Transfer USDC to Optimism"
• "Send tokens to another chain"
• "Bridge tokens"
• "Move all my USDC from Polygon to Base"

Parameters

Workflow

1. Extract parameters from the user's request. Identify:
2. Which token to bridge.
3. The amount.
4. Source and destination chains.

5. Resolve the same token's address on both chains via mcp__uniswap__getTokenInfo.

6. Validate inputs:

7. Verify both chains are supported via mcp__uniswap__getSupportedChains.
8. Verify the token exists on both chains.

9. If source and destination chain are the same: inform the user no bridge is needed.

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

11. tokenIn = token (on source chain).
12. tokenOut = same token (on destination chain).
13. amount, sourceChain, destChain, recipient.

14. The agent handles quoting, safety, execution, monitoring, and confirmation.

15. Present results: Format the bridge report for the user, highlighting:

16. Amount sent and received (should be very close, minus bridge fee).
17. Bridge fee.
18. Settlement time.

Output Format

Bridge Complete

  Token:       USDC
  Sent:        1,000.00 USDC on Ethereum
  Received:    999.50 USDC on Base
  Bridge Fee:  0.50 USDC ($0.50)
  Settlement:  1 min 48 sec

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

  Risk: LOW | Safety: APPROVED

Important Notes

• Bridge operations transfer the same token between chains. The received amount will be slightly less due to bridge fees.
• Settlement times vary by chain pair (typically 1-10 minutes).
• Not all tokens are bridgeable between all chains. The executor will check availability.
• For moving tokens AND swapping to a different token, use cross-chain-swap instead.

Error Handling