> For the complete documentation index, see [llms.txt](/llms.txt).

# 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[​](#prerequisites "Direct link to Prerequisites")

- **Node.js** 22.x or later
- **npm** 10.x or later
- Access to the [Early Access Program](https://metamask.io/agent-wallet)
- An AI agent that supports skills (Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, or similar)

## 1. Install the CLI[​](#1-install-the-cli "Direct link to 1. Install the CLI")

- npm
- Yarn
- pnpm
- Bun

```
npm install -g @metamask/agentic-cli

```

```
yarn global add @metamask/agentic-cli

```

```
pnpm add -g @metamask/agentic-cli

```

```
bun add --global @metamask/agentic-cli

```

## 2. Add skills to your agent[​](#2-add-skills-to-your-agent "Direct link to 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[​](#3-complete-setup "Direct link to 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[​](#sign-in "Direct link to 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[​](#initialize-wallet "Direct link to Initialize wallet")

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

#### Wallet mode (choose one)[​](#wallet-mode-choose-one "Direct link to 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):[​](#trading-mode-server-wallet-only "Direct link to 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](/agent-wallet/reference/architecture/#trading-modes) for guardrails and approval conditions.

Confirm your choices with `mm init show`.

For headless or CI environments, see [Use the CLI directly](/agent-wallet/use-the-cli-directly/).

## 4. Transfer funds and verify[​](#4-transfer-funds-and-verify "Direct link to 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[​](#next-steps "Direct link to Next steps")

- [Send tokens](/agent-wallet/guides/send-tokens/)
- [Architecture](/agent-wallet/reference/architecture/)