Skip to content

hifriendbot/agentwallet-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

AgentWallet demo — AI agent pays x402 invoice automatically

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

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:

  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

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

License

MIT

About

Permissionless wallet infrastructure for AI agents. Create wallets, sign transactions, and broadcast on EVM + Solana. Pay and accept x402 payments. Built-in guards. No KYC. Up to 50% less expensive than Coinbase.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors