> 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 2FA 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 |

### Initialize wallet[​](#initialize-wallet "Direct link to Initialize wallet")

During `mm init`, choose a wallet mode and trading mode. The CLI prompts for each when you omit flags. See [Use the CLI directly](/agent-wallet/use-the-cli-directly/#3-initialize-wallet) for what each wallet and trading mode means.

Confirm your choices with `mm init show`.

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

## 4. Fund and verify[​](#4-fund-and-verify "Direct link to 4. Fund 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 on Base?

```

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/concepts/architecture/)