Agentwallet MCP Server

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 automatically pays for operations with USDC from this wallet.

Auto-pay safety cap. AGENTWALLET_MAX_AUTOPAY (optional, default 1) is the maximum amount, in human-readable units of the asset, that x402 auto-pay will authorize for a single payment. Any 402 requirement above this cap is rejected instead of paid, so a malformed or tampered payment requirement cannot drain the wallet. Raise it only if you genuinely need larger automatic payments (for example "5" to allow up to 5 USDC per call).

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

Supported Chains

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

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: security@hifriendbot.com

License

MIT