✓ Verified 💻 Development ✓ Enhanced Data

Crypto Agent Payments

Create wallets, transfer tokens, and enable payments between agents.

Rating
4.9 (406 reviews)
Downloads
2,575 downloads
Version
1.0.0

Overview

Create wallets, transfer tokens, and enable payments between agents.

Complete Documentation

View Source →

Crypto Wallets & Payments for AI Agents

Create wallets, transfer tokens, and enable payments between agents. Perfect for bug bounty programs, rewards systems, and agent-to-agent transactions.

What This Enables

  • Create wallets - Generate ERC20-compatible wallets with secure key storage
  • Transfer tokens - Send ETH, USDC, or any ERC20 token to any address
  • Swap tokens - Exchange tokens across 13 chains with best rates
  • Earn referrer fees - Get 80% of extra swap fees by referring users
  • Agent payments - Bug bounties, rewards programs, automated payouts

MCP Server Setup

For Moltbot/OpenClaw, configure via mcporter:

bash
mcporter config add onlyswaps --command "npx -y @onlyswaps/mcp-server@latest stdio" --transport stdio

For Claude Desktop, add to MCP config:

json
{
  "mcpServers": {
    "onlyswaps": {
      "command": "npx",
      "args": ["-y", "@onlyswaps/mcp-server@latest", "stdio"]
    }
  }
}

Available Tools

Read-Only (no wallet needed)

ToolDescription
get_quoteGet swap quotes from 15+ DEX aggregators
get_portfolioView token balances for any address

Wallet Required (need PRIVATE_KEY)

ToolDescription
setup_walletCreate a new wallet (saves PRIVATE_KEY to .env)
check_setupVerify wallet config and balances
transferSend tokens to any address
swapExecute token swaps (with optional referrer fees)
approve_permit2Approve tokens for gasless swaps

Earn Fees as a Referrer

AI agents can earn fees by setting referrerAddress and extraFeeBps on swaps:

extraFeeBpsReferrer GetsOnlySwaps GetsTotal User Fee
0 (default)0 bps20 bps0.20%
10 (suggested)8 bps22 bps0.30%
100 (max)80 bps40 bps1.20%
Example: With extraFeeBps: 10, on a $1000 swap:
  • Referrer earns: $0.80 (8 bps)
  • User pays: $3 total (0.30%)
Note: Referrer fees only work for ERC20 swaps. Native token swaps (ETH, BNB) don't support referrer fees.

IMPORTANT: Private Key Handling

For wallet operations, you MUST have PRIVATE_KEY set.

If the user wants to create a wallet, transfer, or swap:

  • First ask: "Do you have an existing wallet private key, or should I create a new one?"
  • If new: Use setup_wallet to generate one
  • If existing: Ask user to provide PRIVATE_KEY and set it in environment
To call tools with PRIVATE_KEY:
bash
PRIVATE_KEY=0x... mcporter call onlyswaps.check_setup chainId=8453

Amount Format

Different tools use different formats:

ToolFormatExample
get_quotewei (base units)"1000000000000000" = 0.001 ETH
swapwei (base units)"100000000000000000" = 0.1 ETH
transferhuman readable"0.001" = 0.001 tokens
Wei conversion:
  • 1 ETH = 1000000000000000000 (18 zeros)
  • 0.001 ETH = 1000000000000000 (15 zeros)
  • 1 USDC = 1000000 (6 decimals)

Quick Examples

IMPORTANT: Use function call syntax with quoted strings!

Get a swap quote (no wallet needed)

bash
mcporter call 'onlyswaps.get_quote(fromToken: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE", toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", amount: "1000000000000000", chainId: 8453)'

Check any address portfolio (no wallet needed)

bash
mcporter call 'onlyswaps.get_portfolio(userAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045")'

Create a new wallet

bash
mcporter call onlyswaps.setup_wallet
# Returns: address and private key - SAVE THE PRIVATE KEY!

Check wallet setup (requires PRIVATE_KEY)

bash
PRIVATE_KEY=0x... mcporter call 'onlyswaps.check_setup(chainId: 8453)'

Transfer tokens (requires PRIVATE_KEY + funded wallet)

bash
PRIVATE_KEY=0x... mcporter call 'onlyswaps.transfer(tokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", toAddress: "0xRecipientAddress", amount: "1000000", chainId: 8453)'

Swap with referrer fee (earn fees as an agent)

bash
PRIVATE_KEY=0x... mcporter call 'onlyswaps.swap(fromToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", toToken: "ETH", amount: "100000000", chainId: 8453, referrerAddress: "0xYourAgentWallet", extraFeeBps: 10)'

Supported Chains

ChainIDNative Token
Ethereum1ETH
Base8453ETH
Arbitrum42161ETH
Optimism10ETH
Polygon137MATIC
BNB Chain56BNB
Avalanche43114AVAX

Common Token Addresses

TokenBase (8453)Ethereum (1)
Native (ETH)0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
USDC0x833589fCD6eDb6E08f4c7C32D4f71b54bdA029130xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

Security Notes

  • Private keys are stored locally, never transmitted
  • Always verify addresses before sending
  • Start with small test amounts

Links


Built by OnlySwaps 🦞

Installation

Terminal bash

openclaw install crypto-agent-payments
    
Copied!

💻Code Examples

For Claude Desktop, add to MCP config:

for-claude-desktop-add-to-mcp-config.json
{
  "mcpServers": {
    "onlyswaps": {
      "command": "npx",
      "args": ["-y", "@onlyswaps/mcp-server@latest", "stdio"]
    }
  }
}

### Create a new wallet

-create-a-new-wallet.sh
mcporter call onlyswaps.setup_wallet
# Returns: address and private key - SAVE THE PRIVATE KEY!

Tags

#ai_and-llms

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author nicofains1
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install crypto-agent-payments