Quickstart

Install the mm CLI and agent skills, then complete one-time setup through the interactive CLI or by prompting your agent. After setup, use natural language for day-to-day wallet operations.

Prerequisites

• Node.js 22.x or later
• npm 10.x or later
• Access to the Early Access Program
• An AI agent that supports skills (Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, or similar)

1. Install the CLI

npm

npm install -g @metamask/agentic-cli

Yarn

yarn global add @metamask/agentic-cli

pnpm

pnpm add -g @metamask/agentic-cli

Bun

bun add --global @metamask/agentic-cli

2. Add skills to your agent

Skills teach your agent how to route natural-language requests to mm commands and follow safety patterns (confirm before transfers, quote before swaps, and similar rules).

npx skills add MetaMask/agent-skills

When prompted, install metamask-agent-wallet for full command routing. Add metamask-agent-workflows if you want multi-step workflow templates.

3. Complete setup

Use the interactive CLI or ask your agent to walk you through onboarding.

Interactive CLI: run mm with no arguments for the REPL, or step through setup:

mm login
mm init
mm auth status

Through your agent: prompt in natural language:

Set up MetaMask Agent Wallet: sign me in, help me pick a wallet mode and trading mode, and show my address.

Your agent asks which sign-in method, wallet mode, and trading mode you want before running commands.

Sign in

During mm login, choose QR code, Google, or email. Your sign-in method also determines how you receive 2-factor authentication approvals when a transaction needs your confirmation.

Sign-in method	2FA delivery
QR code	MetaMask Mobile push notification
Google or email	Email link with transaction details

QR code sign-in

Sign in with MetaMask Mobile by scanning the QR code the CLI displays. The CLI and your agent can access only the dedicated Agent Wallet created for this setup, not your main MetaMask wallet or its accounts. When a transaction needs approval, you receive a 2-factor authentication prompt in MetaMask Mobile.

Initialize wallet

During mm init, choose a wallet mode and, for server-wallet, a trading mode.

Wallet mode (choose one)

• Server wallet: keys are managed and secured server-side in a TEE, so agents can't access your main wallet. Signing uses an asynchronous model; long-running operations return a pollingId unless you pass --wait.
• Bring your own wallet: you supply a BIP-39 mnemonic. Keys stay under your local control and operations return immediately.

Trading mode (server wallet only):

• Guard Mode (Recommended): designed for everyday traders. Enforces security checks, network and recipient allowlists, address allowlists, and a rolling 24-hour outflow limit. Transactions outside your policy limits require 2-factor authentication before they execute.
• Beast Mode: designed for power users. Keeps the security check guardrail only. Malicious transactions and risky contracts are blocked and surfaced for 2-factor authentication approval.

See Trading modes for guardrails and approval conditions.

Confirm your choices with mm init show.

For headless or CI environments, see Use the CLI directly.

4. Transfer funds and verify

Fund the address shown by your agent or by mm wallet address.

Verify with a natural-language prompt:

What's my wallet address and balance?

Your agent checks auth and queries balances before you send transactions.

Next steps

• Send tokens
• Architecture