Skip to main content
The Flipside MCP enables cross-chain token swaps directly from your AI conversation. Swap tokens between NEAR, Ethereum, Base, Arbitrum, Solana, and more.

​
How It Works

  1. Get a quote - See pricing and estimated time
  2. Execute the swap - Get a deposit address
  3. Send tokens - Transfer to the deposit address
  4. Track status - Monitor until complete

​
Example Conversation

You: I want to swap 10 NEAR for USDC on Base Claude: Let me get a quote for that… [uses get_swap_quote] Quote:
  • You send: 10 NEAR (~$50.00)
  • You receive: ~49.25 USDC on Base
  • Estimated time: 2-5 minutes
  • Fee: ~$0.75
Would you like me to create this swap? You: Yes, proceed Claude: [uses execute_swap] Swap created! Send exactly 10 NEAR to: deposit_address_here ⚠️ Send within 5 minutes or the quote expires. Let me know once you’ve sent the tokens and I’ll track the status.

​
Available Tools

​
get_swap_tokens

List available tokens for swaps. Filter by blockchain or search by symbol. 
Tool: get_swap_tokens
Parameters:
  - blockchain: Filter by chain (near, base, eth, arb, solana)
  - search: Search by symbol (e.g., "usdc", "eth")

​
get_swap_quote

Get a preview quote for a swap. Does NOT create a deposit address. 
Tool: get_swap_quote
Parameters:
  - intent: Natural language (e.g., "swap 10 NEAR for USDC on Base")

  OR structured:
  - tokenIn: Input token assetId
  - tokenOut: Output token assetId
  - amount: Amount to swap
  - fromAddress: Sender address (for refunds)
  - toAddress: Recipient address

​
execute_swap

Create a swap and get a deposit address. Tokens must be sent within 5 minutes. 
Tool: execute_swap
Parameters:
  - intent: Natural language description

  OR structured:
  - tokenIn: Input token assetId
  - tokenOut: Output token assetId
  - amount: Amount to swap
  - fromAddress: Sender address
  - toAddress: Recipient address

​
get_swap_status

Check the status of one or more swaps. 
Tool: get_swap_status
Parameters:
  - depositAddresses: Array of deposit addresses to check
Status values:
  • PENDING_DEPOSIT - Waiting for tokens
  • PROCESSING - Swap in progress
  • SUCCESS - Completed successfully
  • REFUNDED - Returned to sender
  • FAILED - Swap failed

​
submit_deposit_tx

Submit your deposit transaction hash to speed up processing. 
Tool: submit_deposit_tx
Parameters:
  - depositAddress: The deposit address
  - txHash: Your deposit transaction hash

​
Supported Chains

ChainTokens
NEARNEAR, USDC, USDT, wETH, and more
EthereumETH, USDC, USDT, WBTC, and more
BaseETH, USDC, and more
ArbitrumETH, USDC, ARB, and more
SolanaSOL, USDC, and more
Use get_swap_tokens to see all available tokens.

​
Natural Language Support

You can describe swaps naturally:
  • “Swap 10 NEAR for USDC”
  • “Convert 100 USDC on Ethereum to NEAR”
  • “Exchange 0.5 ETH for USDC on Base”
  • “Trade my SOL for USDC”
Claude will parse your intent and use the appropriate tools.

​
Important Notes

Time limit: Deposit addresses expire in 5 minutes. Send tokens promptly after creating a swap.
Exact amounts: Send the exact amount quoted. Sending more or less may result in failed swaps or refunds.
Refunds: If a swap fails, tokens are automatically refunded to the sender address you provided.

​
Tracking Your Swap

After sending tokens:
You: I sent the NEAR, can you check the status? Claude: [uses get_swap_status] Status: PROCESSING Your swap is being processed. This usually takes 2-5 minutes. I’ll check again in a moment… Status: SUCCESS Your swap completed! 49.25 USDC has been sent to your Base address.

​
Tips

​
Always Get a Quote First

Quotes show exact amounts and fees before committing.

​
Provide Addresses

For cross-chain swaps, specify:
  • Where to send output tokens
  • Where to refund if something fails

​
Check Token Availability

“What tokens can I swap from NEAR to Base?” [Claude uses get_swap_tokens to show options]