Commands reference

All mm commands accept global flags unless noted.

Global flags

Flag	Short	Description
--format	-f	Output format: text, json, yaml, toml, or toon
--json		Shorthand for --format=json
--toon		Shorthand for --format=toon
--verbose	-v	Show debug logs on standard error

mm doctor

Inspect CLI version, installed skills, environment, and session health. Does not require authentication or initialization.

mm doctor

Field	Description
authenticated	Whether the CLI session is valid
initialized	Whether wallet mode and trading mode are set
recommendedSkills	Status of metamask-agent-wallet
compatible	Whether installed skills match the CLI version (null if no skills found)
hints	Actionable guidance for missing skills, auth, init, or version mismatch

Run before the first wallet operation in a session. Do not run wallet commands until both authenticated and initialized are true.

mm init

Initialize wallet mode and trading mode.

mm init [--wallet server-wallet|byok] [--mode guard|beast]
mm init show

Flag	Required	Description
--wallet	No	server-wallet or byok
--mode	No	guard (recommended) or beast (server-wallet only)
--mnemonic	No	Bring your own wallet only. Prefer the MM_MNEMONIC environment variable

Environment variables: MM_MNEMONIC, MM_PASSWORD (bring your own wallet encryption).

Use mm wallet policy get to view wallet policy YAML. Policy is not included in mm init show output.

mm login

Sign in to MetaMask Agent Wallet.

mm login [qr | browser] [--token <token>] [--timeout <seconds>] [--no-wait]
mm login browser [--no-wait]
mm login qr [--timeout <seconds>]

On a TTY, bare mm login shows a method picker (Dashboard and QR). Use mm login browser for Google or email sign-in through the MetaMask dashboard. QR sign-in (mm login qr) is not available in production (COMING_SOON).

Flag	Required	Description
--token	No	Pre-minted token as cliToken:cliRefreshToken. Environment variable: MM_CLI_TOKEN
--timeout	No	Seconds to wait for QR or browser callback
--no-wait	No	Print sign-in URL and exit. Use with browser in headless mode. Not supported with QR

After you sign in successfully in server-wallet mode, the CLI syncs existing remote wallets from the server.

mm auth status

Check authentication status. No additional flags beyond global flags.

mm logout

Sign out and revoke the CLI session.

mm reset

Clear local session and wallet state files.

mm chains list

List supported EVM networks. No auth required.

mm wallet

Wallet lifecycle and signing commands.

mm wallet create

mm wallet create [--chain-namespace <namespace>] [--name <name>] [--trading-mode guard|beast]

Returns policyYaml: string | null in structured output.

mm wallet list

mm wallet list [--chain-namespace <namespace>]

mm wallet select

mm wallet select [--chain-namespace <namespace>] [--id <id>] [--address <address>] [--name <name>]

mm wallet show

mm wallet show [--chain-namespace <namespace>] [--id <id>] [--address <address>] [--name <name>]

Returns policyYaml: string | null in structured output.

mm wallet address

mm wallet address [--chain-namespace <namespace>]

mm wallet add-fund

Show a QR code and address to fund the active wallet. In headless mode (--json), outputs the address only.

mm wallet add-fund [--chain-namespace <namespace>]

mm wallet balance

mm wallet balance [--currency <code>] [--chain <chains>] [--token <token>] [--address <address>]

mm wallet trading-mode get

Show the current trading mode and active server-wallet address. Server-wallet mode only.

mm wallet trading-mode get

mm wallet trading-mode set

Set the trading mode for the active server wallet. Prompts for confirmation when switching to Beast mode.

mm wallet trading-mode set <guard|beast>

mm wallet policy get

Show the policy YAML for the active server wallet. Server-wallet mode only.

mm wallet policy get

mm wallet policy set

Set the policy for the active server wallet. Server-wallet mode only.

mm wallet policy set --policy <yaml>

mm wallet policy template

Show the project policy template. Server-wallet mode only.

mm wallet policy template

mm wallet sign-message

mm wallet sign-message --message <text> --chain-id <id> [--wait]

mm wallet sign-typed-data

mm wallet sign-typed-data --chain-id <id> --payload '<JSON>' [--wait]

mm wallet send-transaction

mm wallet send-transaction --chain-id <id> --payload '<JSON>' [--wait]

mm wallet requests list

List pending server-wallet requests. Server-wallet mode only.

mm wallet requests watch

mm wallet requests watch --polling-id <id>

mm wallet password

mm wallet password set --new=<password>
mm wallet password change --current=<old> --new=<new>
mm wallet password remove --current=<password>

mm transfer

Send native currency or ERC-20 tokens on one EVM chain.

mm transfer --to <address> --amount <value> --chain-id <id> --token <symbol-or-address> [--wait]

Flag	Required	Description
--to	Yes	Recipient hex address. ENS not supported
--amount	Yes	Human-readable amount
--chain-id	Yes	EVM chain ID
--token	Yes	native, symbol, or ERC-20 address
--wait	No	Block until complete (server-wallet)

mm swap

mm swap quote

mm swap quote --from <token> --to <token> --amount <amount> --from-chain <chain-id> [--to-chain <chain-id>] [--to-address <address>] [--slippage <percent>] [--refuel]

Flag	Required	Description
--to-chain	No	Destination chain ID. The default is --from-chain for same-chain swaps
--to-address	No	Recipient for bridged output tokens. Cross-chain only. The default is signer
--slippage	No	Maximum slippage as a percentage, 0–100 (default 0.5)
--refuel	No	Bundle destination native-gas top-up into a cross-chain quote. Cross-chain only

--refuel is opt-in and cross-chain only. Do not use it when the destination token is the destination chain's native gas asset; the backend returns NO_QUOTES.

mm swap execute

mm swap execute --quote-id <id>
mm swap execute --from <token> --to <token> --amount <amount> --from-chain <chain-id> [--to-chain <chain-id>] [--to-address <address>] [--slippage <percent>] [--refuel]

When executing by --quote-id, the persisted quote retains --to-address and --refuel settings from the quote step.

mm swap status

mm swap status --quote-id <id> [--tx-hash <hash>]

mm tx history

List recent transactions for the active wallet or specific addresses.

mm tx history [--addresses <addrs>] [--chain <chains>] [--type <filter>] [--limit <n>]

Flag	Required	Description
--addresses	No	Comma-separated EVM addresses. The default is all EVM wallets for account
--chain	No	Comma-separated chain filters (for example, 1,137)
--type	No	Filter by direction (in, out, self) or transaction category
--limit	No	Maximum transactions to return (1–500, default 50)

mm perps

Hyperliquid perpetuals commands. Most commands require --venue hyperliquid.

Command	Usage summary
mm perps list-venues	List supported venues
mm perps dexs	--venue <venue>: list HIP-3 DEX identifiers (Hyperliquid)
mm perps markets	--venue <venue> [--symbol <symbol>]
mm perps balance	--venue <venue>
mm perps positions	--venue <venue>
mm perps orders	--venue <venue>
mm perps quote	Quote before open
mm perps open	--venue <venue> --symbol <symbol> --side long|short --size <size> --leverage <n>
mm perps close	Close a position
mm perps modify	Modify leverage or TP/SL
mm perps cancel	--venue <venue> --order-id <id>
mm perps deposit	--venue <venue> --amount <amount>
mm perps withdraw	Withdraw from venue
mm perps transfer	Transfer between spot and perpetual accounts

mm predict

Polymarket prediction market commands.

Command	Description
mm predict setup	One-time predict setup
mm predict deposit	Fund predict deposit wallet
mm predict balance	Check predict balance
mm predict mode	Set mainnet or testnet
mm predict auth	Refresh predict credentials
mm predict approve	Repair approvals
mm predict status	Backend status
mm predict portfolio	Snapshot of pUSD balance, positions, redeemable winnings
mm predict redeem list	List redeemable winning positions
mm predict redeem	Redeem one or all winning positions
mm predict markets search	Search markets
mm predict markets list	List markets with filters
mm predict markets get	Inspect a market (slug, ID, or condition ID)
mm predict events list	List Polymarket events with filters
mm predict events get	Retrieve a single event by ID or slug
mm predict series list	List event series
mm predict series get	Retrieve a single event series
mm predict tags list	List Polymarket tags
mm predict tags get	Retrieve a tag by ID or slug
mm predict quote	Preview order cost
mm predict place	Place an order
mm predict cancel	Cancel orders
mm predict orders	List open orders
mm predict positions	View positions
mm predict withdraw	Withdraw pUSD from deposit wallet
mm predict book	Order book for a token
mm predict watch	Watch a predict job
mm predict geoblock	Check Polymarket geoblock for your IP

Run mm predict <command> --help for command-specific flags.

mm decode

Decode hex-encoded EVM calldata into a function name, parameters, and a plain-language summary. Use before signing unfamiliar raw transactions.

mm decode --payload <0x-calldata>
mm decode <0x-calldata>

Flag	Required	Description
--payload	Yes	Hex-encoded calldata (also positional)

mm price

Command	Usage
mm price spot	--asset-ids <ids> [--vs <currency>] [--market-data]
mm price history	Historical prices
mm price currencies	Supported quote currencies
mm price networks	Supported price networks

mm token

Command	Usage
mm token assets	--asset-ids <ids>
mm token networks	List token networks
mm token list popular	--chain <chain>
mm token list trending	--chain <chain>
mm token list search	--query <query> [--chain <chains>]
mm token list top-gainer	--chain <chain>

Help

Every command supports --help:

mm transfer --help
mm perps open --help