agentwallet-mcp
v1.7.2
Published
MCP server for AgentWallet — lets AI agents create wallets, sign transactions, broadcast on EVM + Solana, pay x402 invoices, and accept x402 payments
Downloads
751
Maintainers
Readme
AgentWallet MCP Server
Permissionless wallet infrastructure for AI agents. Create wallets, sign transactions, and broadcast on-chain — on any EVM chain and Solana. Up to 50% less expensive than Coinbase. Built-in guards. No KYC. The only AI agent wallet that accepts crypto for its own API fees.
No KYC. No KYT. No approval process. No transaction monitoring. No one can block your wallet. Pay with USDC on-chain — no credit card required.
Features
- 29 MCP tools — create wallets, send transactions, approve tokens, wrap ETH, transfer SPL tokens, pay and accept x402 payments, and more
- EVM + Solana — Ethereum, Base, Polygon, BSC, Arbitrum, Optimism, Avalanche, Zora, PulseChain, Solana, and any other EVM-compatible chain
- SOL + SPL tokens — native SOL transfers and SPL token transfers (USDC, USDT, etc.) with automatic account creation
- Built-in guards — daily spending limits, gas price protection, emergency pause, rate limiting, replay protection, and on-chain verification — all active by default
- x402 payments — pay for x402-enabled APIs automatically, or accept x402 payments on your own endpoints (EVM and Solana)
- Secure — Private keys encrypted at rest, decrypted only during signing, zeroed from memory immediately after
- Permissionless — No KYC. No KYT. No identity verification. No approval process. No compliance gatekeeping. Sign up, get an API key, and start transacting immediately.
- 30-second setup — three lines of config. No SDK to install. No dependencies to manage.
Pricing
- $0.00345 per operation (31% less expensive than Coinbase CDP)
- 6,000 free operations/month
- $0.0005 per x402 verification (50% less expensive than Coinbase)
- 1,000 free x402 verifications/month
- Pay with USDC on-chain via x402 — no credit card required
- No monthly fee, no tiers — just pay as you go
Quick Start
Get your free API key at hifriendbot.com/wallet — no credit card required, no KYC, no approval wait.
Claude Desktop / OpenClaw
Add to your config:
{
"mcpServers": {
"agentwallet": {
"command": "npx",
"args": ["-y", "agentwallet-mcp"],
"env": {
"AGENTWALLET_USER": "your_username",
"AGENTWALLET_PASS": "your_api_key",
"AGENTWALLET_WALLET_ID": "1"
}
}
}
}
AGENTWALLET_WALLET_IDis optional. Set it to enable x402 auto-pay — when you exceed the free tier without a credit card, the MCP server will automatically pay for operations with USDC from this wallet.
Claude Code
claude mcp add agentwallet \
-e AGENTWALLET_USER=your_username \
-e AGENTWALLET_PASS=your_api_key \
-e AGENTWALLET_WALLET_ID=1 \
-- npx -y agentwallet-mcpVS Code
Add to your settings:
{
"mcp": {
"servers": {
"agentwallet": {
"command": "npx",
"args": ["-y", "agentwallet-mcp"],
"env": {
"AGENTWALLET_USER": "your_username",
"AGENTWALLET_PASS": "your_api_key",
"AGENTWALLET_WALLET_ID": "1"
}
}
}
}
}Tools
| Tool | Description |
|------|-------------|
| create_wallet | Create a new EVM or Solana wallet |
| list_wallets | List all your wallets |
| get_wallet | Get wallet details by ID |
| get_balance | Check native token balance on any chain |
| get_token_balance | Check ERC-20 or SPL token balance |
| get_token_info | Get ERC-20 token name, symbol, and decimals |
| transfer | Send native tokens (ETH, SOL, POL, BNB, etc.) |
| transfer_token | Send ERC-20 or SPL tokens (USDC, USDT, etc.) |
| send_transaction | Sign and broadcast a raw transaction |
| sign_transaction | Sign a transaction without broadcasting |
| call_contract | Read-only contract call (eth_call) |
| approve_token | Approve ERC-20 token spending for DeFi |
| get_allowance | Check ERC-20 token allowance |
| wrap_eth | Wrap native tokens to WETH/WAVAX/etc. |
| unwrap_eth | Unwrap WETH back to native tokens |
| pay_x402 | Pay x402 invoices automatically (fetch, pay, retry) |
| create_paywall | Create an x402 paywall to charge for a resource |
| list_paywalls | List all your x402 paywalls |
| get_paywall | Get paywall details by ID |
| update_paywall | Update paywall pricing, resource, or status |
| delete_paywall | Delete a paywall |
| get_paywall_payments | View payment history for a paywall |
| get_x402_revenue | Aggregate revenue stats across all paywalls |
| buy_verification_credits | Buy x402 verification credits with USDC on-chain |
| get_usage | Check your monthly usage and billing |
| get_chains | List all supported chains |
| pause_wallet | Emergency pause a wallet |
| unpause_wallet | Resume a paused wallet |
| delete_wallet | Delete a wallet |
Supported Chains
| Chain | ID | Native Token | Stablecoin | |-------|-----|-------------|------------| | Ethereum | 1 | ETH | USDC | | Base | 8453 | ETH | USDC | | Polygon | 137 | POL | USDC | | BSC | 56 | BNB | USDT | | Arbitrum | 42161 | ETH | USDC | | Optimism | 10 | ETH | USDC | | Avalanche | 43114 | AVAX | USDC | | Zora | 7777777 | ETH | USDC | | PulseChain | 369 | PLS | USDC | | Solana | 900 | SOL | USDC | | Solana Devnet | 901 | SOL | USDC |
Use Case: GuessMarket
Pair with guessmarket-mcp to let your AI agent trade prediction markets:
- Create a wallet on Base
- Approve USDC spending
- Buy YES/NO shares on prediction markets
- Provide liquidity and earn trading fees
- Claim winnings
All on-chain. All through MCP. No frontend needed.
x402 Payments
AgentWallet natively supports the x402 open payment standard. When your Ai agent encounters an API that returns HTTP 402 Payment Required, the pay_x402 tool handles the entire flow automatically:
- Fetches the URL and detects the 402 response
- Parses the payment requirements (amount, token, chain)
- Executes the on-chain payment from your wallet
- Retries the request with proof of payment
- Returns the final response
Always set max_payment to control spending:
pay_x402(
url="https://api.example.com/premium-data",
wallet_id=1,
max_payment="1.00"
)Supports ERC-20 tokens, SPL tokens, and native tokens on EVM and Solana. Compatible with x402 V1 and V2 (CAIP-2 chain identifiers).
x402 Acceptance
AgentWallet also lets you accept x402 payments. Create a paywall, point it at any resource, and get a public URL that charges agents automatically:
create_paywall(
wallet_id=1,
name="Premium API",
amount="0.01",
token_name="USDC",
token_address="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
chain_id=8453,
resource_url="https://your-api.com/data"
)When an agent hits the paywall URL:
- Gets back HTTP 402 with payment requirements
- Pays on-chain using
pay_x402(or any x402-compatible client) - Retries with proof of payment
- Receives the protected content
On-chain verification ensures every payment is real. Replay protection prevents double-spending. Revenue tracking shows you who paid, how much, and when. 1,000 free verifications/month, then $0.0005 each — 50% less expensive than Coinbase.
How We Compare
| Feature | Coinbase CDP | AgentWallet | |---------|-------------|-------------| | Setup Time | Install SDK + configure | 3 lines of config | | Approval Process | Identity verification required | None — instant access | | KYC Required | Yes | No | | KYT / Transaction Monitoring | Yes | No | | Can Block Your Wallet | Yes | No | | Built-in Guards | Yes (requires setup) | Yes (active by default) | | Free Operations / Month | 5,000 | 6,000 | | Cost Per Operation | $0.005 | $0.00345 | | x402 Verification Cost | $0.001 | $0.0005 | | Free x402 Verifications / Month | 1,000 | 1,000 | | x402 Acceptance (Paywalls) | No | Yes | | Pay for API Fees with Crypto | No (credit card only) | Yes (USDC via x402) | | Supported Chains | 8 EVM + Solana | Any EVM + Solana | | Token Tools | Yes | ERC-20 + SPL (29 tools) | | MCP Server | Yes | Yes |
Pay with Crypto — No Credit Card Required
AgentWallet is the only AI agent wallet infrastructure that accepts crypto for its own API fees. Every competitor — Coinbase CDP, Circle, MoonPay, Crossmint, Turnkey — requires a credit card or monthly invoice. With AgentWallet, your agent can pay for operations with USDC on-chain via the x402 protocol. No credit card, no invoice, no billing portal. Just on-chain payments.
When your agent exceeds the free tier (6,000 ops/month) without a credit card configured, the API returns HTTP 402 with USDC payment instructions. Your agent pays on-chain, retries with proof of payment, and the operation executes. Fully automated via the MCP server.
You can also pre-purchase x402 verification credits with USDC using the buy_verification_credits tool — keeping your paywalls running beyond the free 1,000 verifications/month without needing a credit card.
Built-in Guards
All guards are active by default — no configuration required.
- Encrypted at rest — private keys encrypted before storage and never leave the server
- Memory zeroing — keys wiped from memory immediately after every signing operation
- Daily spending limits — set a per-wallet daily cap in USD, enforced automatically on every transaction
- Gas price protection — transactions blocked when gas prices spike above safe thresholds
- Emergency pause — instantly freeze any wallet or all wallets with one click
- Rate limiting — API requests capped per minute to prevent abuse and brute force attacks
- Replay protection — every x402 payment verified on-chain with unique transaction tracking
- On-chain verification — x402 payments verified directly on the blockchain with finalized commitment
- Bug bounty program: $50–$500 for responsible disclosure (details)
Links
- Website: hifriendbot.com/wallet
- npm: agentwallet-mcp
- Security: [email protected]
License
MIT
