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 stderr |
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 (default) or byok |
--mode | No | guard (default) or beast (server-wallet only) |
--mnemonic | No | BYOK only. Prefer MM_MNEMONIC env var |
Environment variables: MM_MNEMONIC, MM_PASSWORD (BYOK encryption).
mm login
Sign in to MetaMask Agent Wallet.
mm login [qr | google | email] [--token <token>] [--no-wait]
mm login qr
mm login google [--no-wait]
mm login email [--no-wait]
| Flag | Required | Description |
|---|---|---|
--token | No | Pre-minted token as cliToken:cliRefreshToken. Env: MM_CLI_TOKEN |
--no-wait | No | Print sign-in URL and exit (not supported for QR) |
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 and Solana networks. No auth required.
mm wallet
Wallet lifecycle and signing commands.
mm wallet create
mm wallet create [--chain-namespace <namespace>] [--name <name>]
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>]
mm wallet address
mm wallet address [--chain-namespace <namespace>]
mm wallet balance
mm wallet balance [--currency <code>] [--chain <chains>] [--token <token>] [--address <address>]
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>] [--slippage <percent>]
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>] [--slippage <percent>]
mm swap status
mm swap status --quote-id <id> [--tx-hash <hash>]
mm perps
Hyperliquid perpetuals commands. Most commands require --venue hyperliquid.
| Command | Usage summary |
|---|---|
mm perps list-venues | List supported venues |
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 perp 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 markets search | Search markets |
mm predict markets list | List markets with filters |
mm predict market | Inspect a market |
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 book | Order book for a token |
mm predict watch | Watch a predict job |
Run mm predict <command> --help for command-specific flags.
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