AgentWallet MCP Server

Permissionless EVM wallet infrastructure for AI agents. Create wallets, sign transactions, and broadcast on-chain — on any EVM chain.

No KYC. No KYT. No transaction monitoring. No one can block your wallet.

Features

• 28 MCP tools — create wallets, send transactions, approve tokens, wrap ETH, pay and accept x402 payments, and more
• Any EVM chain — Ethereum, Base, Polygon, BSC, Arbitrum, Optimism, Avalanche, Zora, PulseChain, and any other EVM-compatible chain
• x402 payments — pay for x402-enabled APIs automatically, or accept x402 payments on your own endpoints
• Secure — Private keys encrypted at rest, decrypted only during signing, zeroed from memory immediately after
• Permissionless — No identity verification, no compliance gatekeeping. Create a wallet and transact immediately.

Pricing

• $0.0069 per transaction (31% less expensive than Coinbase CDP)
• 6,000 free transactions/month
• 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).

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"
      }
    }
  }
}

Claude Code

claude mcp add agentwallet \
  -e AGENTWALLET_USER=your_username \
  -e AGENTWALLET_PASS=your_api_key \
  -- 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"
        }
      }
    }
  }
}

Tools

Tool	Description
create_wallet	Create a new wallet on any EVM chain
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 token balance
get_token_info	Get ERC-20 token name, symbol, and decimals
transfer	Send native tokens (ETH, POL, BNB, etc.)
transfer_token	Send ERC-20 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
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

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 (USDC, USDT) and native tokens on any chain. 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.

Security

• Private keys are generated server-side and encrypted at rest
• Keys are decrypted only during transaction signing and zeroed from memory immediately after
• EIP-1559 transactions only with gas safety caps
• Bug bounty program: $50–$500 for responsible disclosure (details)

Links

• Website: hifriendbot.com/wallet
• npm: agentwallet-mcp
• Security: security@hifriendbot.com

License

MIT