Agentic Wallet FAQs
What is MetaMask Agent Wallet?
MetaMask Agent Wallet is a fully self-custodial agent wallet that lets AI agents trade autonomously without forcing users to give up control. Your agent can execute DeFi operations — swaps, bridges, perpetuals on Hyperliquid, prediction markets on Polymarket, and token transfers — across multiple EVM chains, with security applied by default on every signing and transaction path.
How is this different from a regular MetaMask wallet?
The Agent Wallet is purpose-built for AI agents to act autonomously within user-defined limits, whereas the regular MetaMask wallet requires manual transaction approval every time. The key distinction: your agent operates freely within policies you set, and anything outside those policies requires your explicit approval.
What makes it different from other agentic wallets?
Most CEX-based agent wallets lock your agent to a single exchange and custody your keys. Other self-custody solutions treat transaction security as optional. MetaMask Agent Wallet ends the trade-off between giving the agent freedom to act and keeping users’ funds safe — your agent operates inside user-defined limits, with a mandatory security pipeline on every transaction.
About the Early Access Program
How do I join?
MetaMask Agent Wallet is available through the Early Access Program at metamask.io/agent-wallet. Spots are limited.
Is it free to join?
Yes. Early Access members get first access to the wallet, a direct line to the build team, and the ability to influence the product roadmap.
When does the product launch publicly?
The team will share more information on timing in the future.
Is the Agent Wallet truly self-custodial?
Yes — and there are two modes to choose from:
- Server-wallet (recommended): Keys are managed and secured server-side in a trusted execution environment (TEE), so agents can’t access your main wallet. You retain self-custody.
- Bring your own wallet (BYOK): You supply a BIP-39 mnemonic — useful when you need local key control or an existing seed phrase. You still get the full security pipeline.
You can export your secret recovery phrase and walk away at any time.
How does MetaMask protect my funds?
Supported EVM transactions pass through a mandatory 3-step pipeline before they land onchain:
- Transaction simulation: Balance changes, approvals, and gas are surfaced before signing.
- Transaction Shield (threat scanning): Powered by Blockaid and production-tested across millions of MetaMask transactions. Malicious transactions are auto-rejected. Flagged transactions require your approval before they execute.
- Smart Transactions: Built-in MEV protection, fewer failed transactions, and better gas where supported on the target chain.
Transactions deemed safe are guaranteed against loss up to $10,000/month.* See Transaction Shield for eligibility, coverage limits, and terms.
What trading modes are available?
Trading modes apply to server-wallet only. During mm init, you set outflow limits and allowlists, then choose a mode:
- Guard Mode (Recommended): Designed for everyday traders. Transactions outside your policy limits require 2-factor authentication approval. Guardrails include a network allowlist, token recipient allowlist, address allowlist, and a rolling 24-hour outflow limit.
- Beast Mode: Designed for power users. Malicious transactions are still blocked and surfaced for 2-factor authentication approval, but other guardrails are relaxed.
Switch modes at any time by re-running mm init with a different --mode value, or confirm your active configuration with mm init show.
How does 2FA approval work?
When 2-factor authentication is required, the CLI pauses the job until you approve or reject it:
| Sign-in method | Approval channel |
|---|---|
| QR code | MetaMask Mobile push notification |
| Google or email | Email link with transaction details |
The agent cannot proceed without your approval on flagged or policy-violating transactions.
What can my agent actually do?
After setup, you prompt your agent in plain language. Some examples:
| You ask your agent | What happens |
|---|---|
| “Show the wallet address and USDC balance” | Your agent checks auth, then queries balances. |
| “Send 10 USDT to 0x123… on Ethereum” | Your agent confirms details, then submits a transfer. |
| “Swap 0.1 ETH to USDC on Base” | Your agent fetches a quote, confirms with you, then executes. |
| “Open a 5x long on BTC with $100 on Hyperliquid” | Your agent deposits if needed, quotes, and opens the position. |
| “Bet 10 USDT on YES for BTC 5-min price up” | Your agent searches markets, confirms odds, and places the order. |
The full capabilities surface includes:
| Area | What your agent can do |
|---|---|
| Authentication | Sign in, check session, sign out |
| Wallet | Create wallet, show address, check balances |
| Send | Transfer native tokens and ERC-20s |
| Sign / raw transactions | Sign messages, typed data, and raw EVM transactions |
| Decode calldata | Inspect unfamiliar EVM calldata before signing |
| Swap / bridge | Quote, execute, and track swaps and cross-chain bridges |
| Perpetuals | Trade on Hyperliquid (deposit, open, modify, close) |
| Prediction markets | Search, quote, and trade on Polymarket |
| Market data | Spot prices, token discovery, supported chains |
See the commands reference for every flag and subcommand.
How do I get help?
Ask questions on the Builder Hub at builder.metamask.io under the Agent Wallet category. Full documentation is at docs.metamask.io/agent-wallet.
Please don’t share personal information on the forum or with anyone posing as a member of the team.
* Eligibility, coverage limits, and terms apply. See Transaction Shield for details.