crypto-agent-paymentsCreate and manage ERC20 wallets, transfer and swap tokens across 13 chains, enable agent payments, and earn referrer fees in AI agent ecosystems.
Install via ClawdBot CLI:
clawdbot install nicofains1/crypto-agent-paymentsCreate wallets, transfer tokens, and enable payments between agents. Perfect for bug bounty programs, rewards systems, and agent-to-agent transactions.
For Moltbot/OpenClaw, configure via mcporter:
mcporter config add onlyswaps --command "npx -y @onlyswaps/mcp-server@latest stdio" --transport stdioFor Claude Desktop, add to MCP config:
{
"mcpServers": {
"onlyswaps": {
"command": "npx",
"args": ["-y", "@onlyswaps/mcp-server@latest", "stdio"]
}
}
}| Tool | Description |
|------|-------------|
| get_quote | Get swap quotes from 15+ DEX aggregators |
| get_portfolio | View token balances for any address |
| Tool | Description |
|------|-------------|
| setup_wallet | Create a new wallet (saves PRIVATE_KEY to .env) |
| check_setup | Verify wallet config and balances |
| transfer | Send tokens to any address |
| swap | Execute token swaps (with optional referrer fees) |
| approve_permit2 | Approve tokens for gasless swaps |
AI agents can earn fees by setting referrerAddress and extraFeeBps on swaps:
| extraFeeBps | Referrer Gets | OnlySwaps Gets | Total User Fee |
|-------------|---------------|----------------|----------------|
| 0 (default) | 0 bps | 20 bps | 0.20% |
| 10 (suggested) | 8 bps | 22 bps | 0.30% |
| 100 (max) | 80 bps | 40 bps | 1.20% |
Example: With extraFeeBps: 10, on a $1000 swap:
Note: Referrer fees only work for ERC20 swaps. Native token swaps (ETH, BNB) don't support referrer fees.
For wallet operations, you MUST have PRIVATE_KEY set.
If the user wants to create a wallet, transfer, or swap:
setup_wallet to generate oneTo call tools with PRIVATE_KEY:
PRIVATE_KEY=0x... mcporter call onlyswaps.check_setup chainId=8453Different tools use different formats:
| Tool | Format | Example |
|------|--------|---------|
| get_quote | wei (base units) | "1000000000000000" = 0.001 ETH |
| swap | wei (base units) | "100000000000000000" = 0.1 ETH |
| transfer | human readable | "0.001" = 0.001 tokens |
Wei conversion:
1000000000000000000 (18 zeros)1000000000000000 (15 zeros)1000000 (6 decimals)IMPORTANT: Use function call syntax with quoted strings!
mcporter call 'onlyswaps.get_quote(fromToken: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE", toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", amount: "1000000000000000", chainId: 8453)'mcporter call 'onlyswaps.get_portfolio(userAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045")'mcporter call onlyswaps.setup_wallet
# Returns: address and private key - SAVE THE PRIVATE KEY!PRIVATE_KEY=0x... mcporter call 'onlyswaps.check_setup(chainId: 8453)'PRIVATE_KEY=0x... mcporter call 'onlyswaps.transfer(tokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", toAddress: "0xRecipientAddress", amount: "1000000", chainId: 8453)'PRIVATE_KEY=0x... mcporter call 'onlyswaps.swap(fromToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", toToken: "ETH", amount: "100000000", chainId: 8453, referrerAddress: "0xYourAgentWallet", extraFeeBps: 10)'| Chain | ID | Native Token |
|-------|-----|--------------|
| Ethereum | 1 | ETH |
| Base | 8453 | ETH |
| Arbitrum | 42161 | ETH |
| Optimism | 10 | ETH |
| Polygon | 137 | MATIC |
| BNB Chain | 56 | BNB |
| Avalanche | 43114 | AVAX |
| Token | Base (8453) | Ethereum (1) |
|-------|-------------|--------------|
| Native (ETH) | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE |
| USDC | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
Built by OnlySwaps 🦞
Generated Mar 1, 2026
AI agents can automatically pay out rewards to security researchers who report vulnerabilities. The skill enables creating wallets for new participants, transferring tokens upon successful bug reports, and using swap tools to convert rewards into preferred currencies. This streamlines payouts across multiple blockchains.
AI agents can autonomously conduct financial transactions with each other, such as paying for services or settling debts. The skill allows agents to generate wallets, transfer tokens directly, and swap assets to meet payment requirements, facilitating seamless economic interactions in decentralized networks.
AI agents can earn passive income by referring users to token swap services, capturing a share of transaction fees. By setting a referrer address and extra fee basis points, agents incentivize usage while generating revenue from swaps executed through the platform, particularly for ERC20 tokens.
Organizations can implement automated reward distributions for employee incentives or customer loyalty programs. The skill enables creating wallets for recipients, transferring tokens based on predefined criteria, and swapping tokens to optimize reward values, reducing manual overhead in payout processes.
Users can manage crypto portfolios across 13 supported chains, using tools to view balances, get swap quotes, and execute trades for optimal rates. This scenario is ideal for investors or traders needing to rebalance assets efficiently without manual intervention across multiple blockchain networks.
Generate revenue by charging users a fee on token swaps, with a portion shared with referrers like AI agents. The platform aggregates rates from 15+ DEXs, offering competitive pricing while earning from each transaction, especially through extra fee basis points set by referrers.
Offer the skill as a service for AI developers and organizations, providing tools for wallet creation, payments, and swaps within agent ecosystems. Revenue comes from licensing, usage-based pricing, or premium features like advanced analytics and support for additional blockchains.
Build a network where AI agents act as referrers, earning 80% of extra swap fees they generate. The business model incentivizes agents to promote swap services, driving user volume and creating a scalable revenue stream from increased transaction activity across supported chains.
💬 Integration Tip
Start by setting up the MCP server with the provided configuration, then test read-only tools like get_quote before handling private keys for wallet operations.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection