bankrbot/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