All servers / Web3 / AgentWallet MCP server
AgentWallet MCP server
MCP server for AgentWallet: self-custody local signing on EVM and Solana, or hosted wallets. Sign, broadcast, pay x402 invoices, and accept x402 payments.
Tested by ConnectATDScore 86 out of 100. Tested 2026-11-19 on package version 1.14.15. Package: agentwallet-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (12.6 seconds including download)
- Tools offered: 40
- Last published: 2026-11-12
- Weekly downloads (npm): 706
- License: MIT · Direct dependencies: 6
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
create_wallet2 of 2 parameters describedCreate a new EVM or Solana wallet. Returns the wallet ID and address. Private key is encrypted server-side and never exposed.
list_walletsno parametersList all wallets owned by the authenticated user. Returns wallet IDs, addresses, labels, chain IDs, and status.
get_wallet1 of 1 parameter describedGet details for a specific wallet by ID. Returns address, label, chain, spending limits, and pause status.
get_balance2 of 2 parameters describedGet 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_transaction10 of 10 parameters describedSign 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. A signed transaction is a spend: under a spend policy it is checked, reserved on the ledger and counted against the budgets exactly as send_transaction is, because the caller can broadcast it.
send_transaction10 of 10 parameters describedSign and broadcast a transaction. Returns the transaction hash (EVM) or signature (Solana) on success. The transaction is signed server-side and broadcast via RPC.
transfer4 of 4 parameters describedSend 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_balance4 of 4 parameters describedGet 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_token6 of 6 parameters describedSend 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_contract3 of 3 parameters describedExecute 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_token6 of 6 parameters describedApprove a spender contract to transfer ERC-20 tokens on your behalf. Required before interacting with any DeFi protocol (DEXs, lending, etc.). Specify an exact amount. "max" (an unlimited allowance) is refused by default and always under a spend policy; only the operator can allow it, with AGENTWALLET_ALLOW_UNLIMITED_APPROVAL=1 while no policy is set. Under a spend policy an approval is a spend: it counts against the budgets and the spender is checked as a recipient.
get_allowance5 of 5 parameters describedCheck 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_eth3 of 3 parameters describedWrap 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_eth3 of 3 parameters describedUnwrap 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_info2 of 2 parameters describedGet the name, symbol, and decimals of any ERC-20 token by its contract address. Useful for discovering token details before transfers or approvals.
pay_x40210 of 10 parameters describedHandle an x402 payment flow. Fetches a URL, and if the server returns HTTP 402 Payment Required, parses the payment requirements (v1 body or v2 PAYMENT-REQUIRED header), signs an EIP-3009 TransferWithAuthorization for the "exact" scheme (no gas, nothing broadcast by the payer), and retries the request with the payment header. AgentWallet paywalls are paid by on-chain transfer instead. The "upto" scheme is settled with a Permit2 authorization bounded by the cap. Returns the final response and the settlement receipt. Supports the x402 open payment standard (https://x402.org). max_payment can only lower the operator's cap for one call.
check_approval1 of 1 parameter describedStatus of a payment approval created when pay_x402 exceeded the cap on a hosted wallet. Returns pending, approved, denied or expired. Once approved, call pay_x402 again with approval_id.
approve_permit24 of 4 parameters describedOne-time ERC-20 approval of a token to the Permit2 contract, needed before paying x402 "upto" endpoints with that token. A normal on-chain transaction (needs gas). Pass amount to grant a bounded allowance; with no amount it asks for the maximum, which is refused by default, under AGENTWALLET_MAX_TX_TOKEN, and always under a spend policy (where the allowance counts against the budgets). Only the operator can allow a maximum approval, with AGENTWALLET_ALLOW_UNLIMITED_APPROVAL=1 while no policy is set. Permit2 itself only moves what each signed authorization allows.
check_token_risk2 of 2 parameters describedAssess an ERC-20 token before approving or swapping it: honeypot, taxes, owner powers, verified source, holder concentration, DEX liquidity. Uses GoPlus Security (free, no key) with an on-chain fallback. A warning for the caller to weigh, never a block.
get_usageno parametersGet the current month's usage statistics. Hosted AgentWallet is free: returns the operations count and what is left under the fair-use ceiling.
buy_verification_credits1 of 1 parameter describedHosted AgentWallet is free and x402 verifications carry no fee, so there are no credits to buy: this call reports that and spends nothing. Kept so existing agent configurations do not break.
pause_wallet1 of 1 parameter describedEmergency pause a wallet. No transactions can be signed while paused.
unpause_wallet1 of 1 parameter describedResume a paused wallet so transactions can be signed again.
get_chainsno parametersList all supported chains (EVM + Solana) with their chain IDs, native tokens, stablecoins, and RPC configuration status.
delete_wallet1 of 1 parameter describedDelete (soft-delete) a wallet. The wallet will no longer appear in listings and cannot be used for transactions. The wallet is read first and the delete names its address, so a wallet that cannot be read is never deleted.
create_paywall11 of 11 parameters describedCreate 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_paywalls2 of 2 parameters describedList all your x402 paywalls. Returns paywall IDs, names, pricing, access URLs, payment counts, and revenue totals.
get_paywall1 of 1 parameter describedGet details for a specific x402 paywall by ID. Returns pricing, access URL, payment stats, and configuration.
update_paywall8 of 8 parameters describedUpdate an x402 paywall configuration. Can change price, resource URL, active status, or any other field.
delete_paywall1 of 1 parameter describedDelete an x402 paywall. The access URL will return 404 after deletion.
get_paywall_payments3 of 3 parameters describedGet payment history for a specific x402 paywall. Returns verified payments with TX hashes, payer addresses, amounts, and timestamps.
get_x402_revenueno parametersGet aggregate x402 revenue statistics across all your paywalls. Returns total payments and revenue broken down by chain and token.
quote_x4025 of 5 parameters describedAsk what an x402 endpoint charges without paying: fetches the URL, parses the 402 requirements, says which option this wallet would pay (chain, asset, amount, recipient), whether the per-payment cap, the spend policy and the rolling budgets would allow it, and nothing is signed. Call it before pay_x402 when the price is unknown.
discover_x4024 of 4 parameters describedFind x402-paid APIs by subject in the public x402 index (the Bazaar published by the CDP facilitator). Returns resources with their method, price and chain, re-priced from this client's own registry. Listings are sellers' own words. Nothing is paid; follow up with quote_x402 or pay_x402.
list_payments3 of 4 parameters describedSpends recorded in this wallet's ledger (x402 payments, transfers, auto-pay), newest first, each with its latest outcome (signed, settled, declined, unknown, broadcast, void). The ledger is a hash-chained append-only file when AGENTWALLET_LEDGER or a policy names one; otherwise this process only.
export_receipts2 of 3 parameters describedEvery spend in the ledger as CSV or JSONL text (oldest first), for expense records. Returns the text; write it wherever it belongs.
spend_policyno parametersThe spend policy this server enforces (AGENTWALLET_POLICY), its sha256, the rolling budgets with what is spent and what remains, per-host spending, the ledger's path and integrity, and whether the connected client can answer approval questions. Read-only.
simulate_transaction5 of 5 parameters describedDry-run an EVM transaction with nothing signed: the local guards (native cap, token cap, fee cap), the spend policy, the node's gas estimate (which fails when the call would revert), the worst-case fee, whether the balance covers it, and the call's return data. Local mode runs the full check; hosted mode runs the policy and an eth_call.
wallet_modeno parametersReport whether this server is signing locally (self-custody, the private key never leaves this machine) or through the hosted AgentWallet API (custodial). Use this to verify custody before moving funds.
export_wallet_key1 of 1 parameter describedExplain how to export the private key of a hosted (custodial) AgentWallet so it can be moved to self-custody or any other wallet. Export itself is deliberately human-gated and is not performed by this tool.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.