Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGENTWALLET_PASS | Yes | Your AgentWallet API key. | |
| AGENTWALLET_USER | Yes | Your AgentWallet username. | |
| AGENTWALLET_WALLET_ID | No | 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. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_wallet | Create a new EVM or Solana wallet. Returns the wallet ID and address. Private key is encrypted server-side and never exposed. |
| list_wallets | List all wallets owned by the authenticated user. Returns wallet IDs, addresses, labels, chain IDs, and status. |
| get_wallet | Get details for a specific wallet by ID. Returns address, label, chain, spending limits, and pause status. |
| get_balance | Get the native token balance for a wallet on a specific chain. Returns balance in both wei (or lamports for Solana) and human-readable format. |
| sign_transaction | Sign a transaction with a wallet's private key. For EVM: returns signed raw transaction hex. For Solana: returns base64 signed transaction. Does NOT broadcast — use send_transaction for sign + broadcast. |
| send_transaction | Sign and broadcast a transaction. Returns the transaction hash (EVM) or signature (Solana) on success. The transaction is signed server-side and broadcast via RPC. |
| transfer | Send native tokens (ETH, AVAX, BNB, POL, PLS, SOL) to an address. Specify the amount in human-readable format (e.g. "0.1" for 0.1 ETH). The amount is converted to wei/lamports automatically. Signs and broadcasts the transaction. |
| get_token_balance | Get the ERC-20 or SPL token balance for a wallet on a specific chain. Returns the raw balance and human-readable balance. Use get_chains to find stablecoin addresses for each chain. |
| transfer_token | Send ERC-20 tokens (EVM) or SPL tokens (Solana) to an address. Specify the amount in human-readable format (e.g. "100" for 100 USDC). Signs and broadcasts the transaction. Use get_chains to find stablecoin addresses. |
| call_contract | Execute a read-only call against a smart contract (eth_call). Returns the raw hex result. Does not cost gas or modify state. Useful for reading on-chain data like token balances, prices, positions. |
| approve_token | Approve a spender contract to transfer ERC-20 tokens on your behalf. Required before interacting with any DeFi protocol (DEXs, lending, etc.). Use amount "max" for unlimited approval, or specify an exact amount. |
| get_allowance | Check how many ERC-20 tokens a spender is approved to transfer. Returns the allowance in both raw and human-readable format. Use this to check if an approval is needed before a DeFi transaction. |
| wrap_eth | Wrap native tokens (ETH, AVAX, BNB, POL, PLS) into their wrapped ERC-20 version (WETH, WAVAX, etc.). Required for most DeFi protocols that use ERC-20 tokens instead of raw native tokens. Specify amount in human-readable format (e.g. "0.5" for 0.5 ETH). |
| unwrap_eth | Unwrap wrapped tokens (WETH, WAVAX, WBNB, etc.) back to native tokens. Specify amount in human-readable format (e.g. "0.5" for 0.5 WETH). |
| get_token_info | Get the name, symbol, and decimals of any ERC-20 token by its contract address. Useful for discovering token details before transfers or approvals. |
| pay_x402 | Handle an x402 payment flow. Fetches a URL, and if the server returns HTTP 402 Payment Required, parses the payment requirements, executes the on-chain payment, and retries the request with proof of payment. Returns the final response. Supports the x402 open payment standard (https://x402.org). Set max_payment to prevent overspending. |
| get_usage | Get the current month's usage statistics. Returns operations count, tier info, remaining quota, and fees. |
| buy_verification_credits | Buy x402 verification credits with USDC on-chain. Paywall owners need credits to process verifications beyond the free tier (1,000/month) when they don't have Stripe billing configured. Returns 402 payment instructions — pay on-chain and retry with proof. |
| pause_wallet | Emergency pause a wallet. No transactions can be signed while paused. |
| unpause_wallet | Resume a paused wallet so transactions can be signed again. |
| get_chains | List all supported chains (EVM + Solana) with their chain IDs, native tokens, stablecoins, and RPC configuration status. |
| delete_wallet | Delete (soft-delete) a wallet. The wallet will no longer appear in listings and cannot be used for transactions. |
| create_paywall | Create an x402 paywall that charges agents/clients for accessing a resource. Returns a public access URL that returns HTTP 402 until paid. Agents pay on-chain, then retry with proof to get the content. |
| list_paywalls | List all your x402 paywalls. Returns paywall IDs, names, pricing, access URLs, payment counts, and revenue totals. |
| get_paywall | Get details for a specific x402 paywall by ID. Returns pricing, access URL, payment stats, and configuration. |
| update_paywall | Update an x402 paywall configuration. Can change price, resource URL, active status, or any other field. |
| delete_paywall | Delete an x402 paywall. The access URL will return 404 after deletion. |
| get_paywall_payments | Get payment history for a specific x402 paywall. Returns verified payments with TX hashes, payer addresses, amounts, and timestamps. |
| get_x402_revenue | Get aggregate x402 revenue statistics across all your paywalls. Returns total payments and revenue broken down by chain and token. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |