@wenrwa/mcp-server

MCP (Model Context Protocol) server for Wenrwa — 26 AI trading tools for Solana. Swap tokens, manage wallets, batch trades, explore 90+ real-world asset (RWA) tokens, and set up persistent agent identities through Claude Desktop, Claude Code, or any MCP-compatible AI agent.

Setup

1. Get an API key

curl -X POST https://app.wenrwa.com/api/v1/sdk/register \
  -H "Content-Type: application/json" \
  -d '{"mainWalletPubkey": "YOUR_SOLANA_PUBLIC_KEY", "name": "My Agent"}'

Save the apiKey (wen_...) and secretKey from the response.

2. Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "wenrwa": {
    "command": "npx",
    "args": ["@wenrwa/mcp-server"],
    "env": {
      "WENRWA_API_KEY": "wen_your-api-key",
      "WENRWA_API_URL": "https://app.wenrwa.com/api/v1/sdk"
    }
  }
}

3. Claude Code

claude mcp add wenrwa \
  -e WENRWA_API_KEY=wen_your-api-key \
  -e WENRWA_API_URL=https://app.wenrwa.com/api/v1/sdk \
  -- npx @wenrwa/mcp-server

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | WENRWA_API_KEY | Yes | — | Your wen_... API key | | WENRWA_API_URL | No | https://app.wenrwa.com/api/v1/sdk | API base URL |

Tools (26)

Swap & Trading

| Tool | Description | |------|-------------| | wenrwa_swap | Execute a token swap (accepts symbols like "SOL" or mint addresses) | | wenrwa_swap_build | Build unsigned swap transaction (two-step flow) | | wenrwa_swap_submit | Submit a signed swap transaction | | wenrwa_get_quote | Get a swap quote from Jupiter without executing | | wenrwa_transfer | Send tokens to another wallet |

Account & Wallets

| Tool | Description | |------|-------------| | wenrwa_account | Get account info, API key details, permissions | | wenrwa_get_balance | Get default wallet token balances | | wenrwa_get_balance_by_wallet | Get balances for a specific wallet by ID | | wenrwa_create_wallet | Create a new trading wallet | | wenrwa_list_wallets | List all trading wallets | | wenrwa_get_transactions | Get transaction history |

Token Discovery

| Tool | Description | |------|-------------| | wenrwa_search_tokens | Search tokens by symbol or name | | wenrwa_get_token_info | Get detailed token info by mint address |

Cart (Batch Swaps)

| Tool | Description | |------|-------------| | wenrwa_cart_add | Add a swap to the cart | | wenrwa_cart_list | List pending cart items | | wenrwa_cart_update | Update a cart item | | wenrwa_cart_remove | Remove an item from the cart | | wenrwa_cart_clear | Clear all cart items | | wenrwa_cart_execute | Execute all cart items as batch |

RWA (Real World Assets) — 90+ Tokens

| Tool | Description | |------|-------------| | wenrwa_rwa_list_tokens | List/filter RWA tokens (stocks, treasuries, commodities) | | wenrwa_rwa_get_token | Get detailed RWA token info (price, liquidity, premium) | | wenrwa_rwa_categories | List RWA categories with token counts | | wenrwa_rwa_providers | List RWA providers/issuers | | wenrwa_rwa_knowledge | Get risk, fee, and trading hour info for an RWA token |

Agent Identity

| Tool | Description | |------|-------------| | wenrwa_setup | Set up a persistent agent identity — generates keypair, registers with API, saves credentials to disk | | wenrwa_list_agents | List all agent identities on this machine with optional wallet balances |

Fees

• Swap: 0.2% (20 bps) per swap
• Gasless USDC: Dynamic USDC fee when swapping from USDC with no SOL for gas ($0.10 if output token account exists, dynamic fee min $0.50 if first time receiving that token — scales with SOL price; no SOL needed to start trading)
• Transfer: Free
• Token-2022: No platform fee (xStock tokens)

Gasless USDC Swaps

Users and agents can start trading with USDC only — no SOL needed. When swapping from USDC and the wallet has insufficient SOL for gas, the platform wallet signs the swap transaction as the Solana fee payer and charges a dynamic USDC convenience fee ($0.10 if the output token account already exists, or a dynamic fee based on current SOL price — minimum $0.50 — if it must be created to cover Solana ATA rent). One atomic transaction — no separate SOL funding needed. Rate limits: 5/hr, 20/day per wallet. This applies to wenrwa_swap, wenrwa_swap_build, and wenrwa_cart_execute.

Links

• Trading App
• Full API Docs
• API Quickstart
• Agent Marketplace
• Agent Skills
• OpenAPI Spec (Trading)
• OpenAPI Spec (Marketplace)

License

MIT