agentwallet-mcp

Server-side EVM wallet for Ai agents. Send transactions, manage tokens, and interact with smart contracts across multiple chains.

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_ID is 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-mcp

VS 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

ToolDescription
create_walletCreate a new EVM or Solana wallet
list_walletsList all your wallets
get_walletGet wallet details by ID
get_balanceCheck native token balance on any chain
get_token_balanceCheck ERC-20 or SPL token balance
get_token_infoGet ERC-20 token name, symbol, and decimals
transferSend native tokens (ETH, SOL, POL, BNB, etc.)
transfer_tokenSend ERC-20 or SPL tokens (USDC, USDT, etc.)
send_transactionSign and broadcast a raw transaction
sign_transactionSign a transaction without broadcasting
call_contractRead-only contract call (eth_call)
approve_tokenApprove ERC-20 token spending for DeFi
get_allowanceCheck ERC-20 token allowance
wrap_ethWrap native tokens to WETH/WAVAX/etc.
unwrap_ethUnwrap WETH back to native tokens
pay_x402Pay x402 invoices automatically (fetch, pay, retry)
create_paywallCreate an x402 paywall to charge for a resource
list_paywallsList all your x402 paywalls
get_paywallGet paywall details by ID
update_paywallUpdate paywall pricing, resource, or status
delete_paywallDelete a paywall
get_paywall_paymentsView payment history for a paywall
get_x402_revenueAggregate revenue stats across all paywalls
buy_verification_creditsBuy x402 verification credits with USDC on-chain
get_usageCheck your monthly usage and billing
get_chainsList all supported chains
pause_walletEmergency pause a wallet
unpause_walletResume a paused wallet
delete_walletDelete a wallet

Supported Chains

ChainIDNative TokenStablecoin
Ethereum1ETHUSDC
Base8453ETHUSDC
Polygon137POLUSDC
BSC56BNBUSDT
Arbitrum42161ETHUSDC
Optimism10ETHUSDC
Avalanche43114AVAXUSDC
Zora7777777ETHUSDC
PulseChain369PLSUSDC
Solana900SOLUSDC
Solana Devnet901SOLUSDC

Use Case: GuessMarket

Pair with guessmarket-mcp to let your AI agent trade prediction markets:

  1. Create a wallet on Base
  2. Approve USDC spending
  3. Buy YES/NO shares on prediction markets
  4. Provide liquidity and earn trading fees
  5. 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:

  1. Fetches the URL and detects the 402 response
  2. Parses the payment requirements (amount, token, chain)
  3. Executes the on-chain payment from your wallet
  4. Retries the request with proof of payment
  5. 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:

  1. Gets back HTTP 402 with payment requirements
  2. Pays on-chain using pay_x402 (or any x402-compatible client)
  3. Retries with proof of payment
  4. 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

FeatureCoinbase CDPAgentWallet
Setup TimeInstall SDK + configure3 lines of config
Approval ProcessIdentity verification requiredNone — instant access
KYC RequiredYesNo
KYT / Transaction MonitoringYesNo
Can Block Your WalletYesNo
Built-in GuardsYes (requires setup)Yes (active by default)
Free Operations / Month5,0006,000
Cost Per Operation$0.005$0.00345
x402 Verification Cost$0.001$0.0005
Free x402 Verifications / Month1,0001,000
x402 Acceptance (Paywalls)NoYes
Pay for API Fees with CryptoNo (credit card only)Yes (USDC via x402)
Supported Chains8 EVM + SolanaAny EVM + Solana
Token ToolsYesERC-20 + SPL (29 tools)
MCP ServerYesYes

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

License

MIT

Related Servers