# Suwappu Dex

> 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.

- Skill: `bankrbot/suwappu-dex` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bankrbot/suwappu-dex`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bankrbot/suwappu-dex/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: BankrBot (https://skillmd.com/u/bankrbot)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/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:
   ```bash
   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):
   ```bash
   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