Suwappu DEX

Other

Cross-chain token swaps, quotes, portfolio and prices across 14 chains via the Suwappu DEX MCP server. Read-only by default; swap execution is opt-in and gated.

Install

openclaw skills install @0xsoftboi/suwappu-dex

Suwappu — Cross-chain DEX 🌸

Swap, quote, and track tokens across 14 chains (12 EVM + Solana + TRON) through Suwappu's hosted MCP server. Routing is automatic across 10+ providers (Li.Fi, CoW Protocol, Jupiter, Wormhole, Across, CCTP, …). This skill wraps the live server — no SDK or wrapper code required.

Setup (one command)

  1. Get a free API key:
    curl -X POST https://api.suwappu.bot/v1/agent/register \
      -H "Content-Type: application/json" -d '{"name":"my-openclaw"}'
    # -> save the suwappu_sk_... value
    export SUWAPPU_API_KEY=suwappu_sk_...
    
  2. Register the MCP server with OpenClaw. Read-only by default (swap execution excluded):
    openclaw mcp add suwappu \
      --url https://api.suwappu.bot/mcp \
      --transport streamable-http \
      --header "Authorization=Bearer $SUWAPPU_API_KEY" \
      --exclude execute_swap
    openclaw mcp probe suwappu      # should list the tools
    
  3. To enable swap execution, re-add without --exclude execute_swap on a dedicated trading agent only (see Safety). Verify with openclaw mcp doctor.

Tools (live)

Read-only (safe, no funds move):

  • get_quote <from> <to> <amount> <chain> — best route, price impact, gas, fees, expiry
  • get_prices <token> [chain] — USD price + 24h change
  • get_portfolio [chain] — balances + USD values across chains
  • list_chains / list_tokens <chain> — supported chains / popular tokens
  • get_tempo_tokens — trending tokens
  • browse_mpp_directory — market/provider directory
  • predict_markets / predict_market_detail — Polymarket-style prediction markets

State-changing (gated, opt-in):

  • execute_swap <quote_id> — execute a previously returned quote. Excluded unless explicitly enabled.

Typical flow

  1. list_chains → see what's available
  2. get_quote ETH USDC 0.1 base → best route (returns a quote_id)
  3. (trading agent only) confirm with the user → execute_swap <quote_id>
  4. get_portfolio → verify it landed

Examples

  • "Quote 0.5 ETH to USDC on Base" → get_quote
  • "What's my portfolio worth across chains?" → get_portfolio
  • "Best price to bridge 500 USDC to Arbitrum" → get_quote

Safety

  • Read-only by default. execute_swap is excluded via --exclude and should only be enabled on an isolated trading agent with explicit tool-allowlisting (agents.json).
  • Agent proposes, user approves. Always get_quote first, show the route/price impact, and require user confirmation before any execute_swap. Preserve the quote_id end to end for audit.
  • Non-custodial. Keys live in Turnkey TEE enclaves; Suwappu enforces 2FA + per-swap/hourly/daily spending limits + tx simulation server-side — these guardrails hold even if the agent errs.
  • Never put SUWAPPU_API_KEY in committed files — pass it as an env var / SecretRef.

Fees & docs

0.3% per swap, gas from wallet balance, no subscription. Full API: https://api.suwappu.bot/docs