@purpleflea/wallet-mcp
MCP server for Purple Flea Wallet — non-custodial multi-chain wallets with cross-chain swaps for AI agents.
What it does
Gives any MCP-compatible AI agent a full crypto wallet:
- Non-custodial multi-chain wallets — wallets across 10+ chains (Ethereum, Bitcoin, Solana, Monero, Base, Arbitrum, BSC, Tron, Zcash, Dogecoin, HyperEVM) from a single registration
- Cross-chain swaps — Powered by Wagyu, an aggregator of aggregators that routes across every DEX and bridge to find the best rate. Liquidity routed through Hyperliquid
- Privacy routing — Swap any token through Monero (XMR) to break the on-chain link between source and destination. Ring signatures + stealth addresses = no traceable path
- Referral commissions — Agents earn 10% of swap fees from agents they refer. Passive income that compounds as your network grows
Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"purple-flea-wallet": {
"command": "npx",
"args": ["-y", "@purpleflea/wallet-mcp"],
"env": {
"WALLET_API_URL": "https://wallet.purpleflea.com"
}
}
}
}
Environment Variables
| Variable | Description | Default |
|---|---|---|
WALLET_API_URL | Wallet API base URL | https://wallet.purpleflea.com |
Tools
Account & Wallet
| Tool | Description |
|---|---|
register | Register a new agent and create a multi-chain wallet. Returns deposit addresses for every supported chain. Optional referred_by referral code. |
create_wallet | Create a wallet for an existing agent. Idempotent — returns existing wallet if already created. |
balance | Get current USD balance, available funds, reserved amount, and lifetime totals. |
deposit_address | Get deposit addresses across all chains for an agent. |
transactions | Get transaction history — deposits, charges, swaps, commissions, and more. |
Swaps
| Tool | Description |
|---|---|
swap_quote | Get a swap quote via Wagyu aggregator. Finds best rate across all DEXs and bridges. |
swap | Execute a cross-chain swap. Creates an order and returns a deposit address to send funds to. |
privacy_swap | Two-leg privacy swap routed through Monero. Breaks the on-chain link between source and destination. Min $25 per XMR leg. |
swap_status | Check status of a swap order (pending, completed, failed). |
withdraw | Withdraw funds to an external address via cross-chain swap. |
supported_chains | List all supported chains, swap pairs, and minimum swap amounts. |
Referral System
| Tool | Description |
|---|---|
gossip | Get live agent count + referral program info. No auth required. |
referral_stats | View referral code, share link, total earnings, and per-agent commission breakdown. |
Referral System
Agents earn 10% commission on swap fees from every agent they refer:
- Your referral code: Shown in
referral_stats(e.g.ref_a1b2c3d4) - Share it: Embed in system prompts, tool descriptions, sub-agent instructions
- Passive income: Earn from every swap your referrals make
- Grows automatically: Every agent in your network generates commissions
Supported Chains
| Chain | Swap Support | Notes |
|---|---|---|
| Ethereum | Wagyu | EVM |
| BSC | Wagyu | EVM, same address as Ethereum |
| Arbitrum | Wagyu | EVM |
| Base | Wagyu | EVM |
| HyperEVM | Wagyu | EVM |
| Bitcoin | Wagyu | Native SegWit (bc1) |
| Solana | Wagyu | Ed25519 |
| Monero | Wagyu | Privacy coin, ring signatures |
| Tron | Deposit only | USDT TRC-20 |
| Zcash | Deposit only | Transparent addresses |
| Dogecoin | Deposit only | P2PKH |
Minimum Swap Amounts
- Standard swaps: $15 USD
- XMR swaps: $25 USD
- BTC swaps: $40 USD
Part of the Purple Flea Ecosystem
- Wallet MCP — Non-custodial multi-chain wallets with cross-chain swaps (you are here)
- Trading MCP — 275+ perpetual futures markets (TSLA, NVDA, GOLD, BTC via Hyperliquid)
- Casino MCP — Provably fair gambling, 0.5% house edge
- Domains MCP — Domain registration and DNS management
License
MIT