> For the complete documentation index, see [llms.txt](/llms.txt). # Commands reference All `mm` commands accept global flags unless noted. ## Global flags[​](#global-flags "Direct link to 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`[​](#mm-doctor "Direct link to 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`[​](#mm-init "Direct link to 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`[​](#mm-login "Direct link to mm-login") Sign in to MetaMask Agent Wallet. ``` mm login [qr | browser] [--token ] [--timeout ] [--no-wait] mm login browser [--no-wait] mm login qr [--timeout ] ``` 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`[​](#mm-auth-status "Direct link to mm-auth-status") Check authentication status. No additional flags beyond global flags. ## `mm logout`[​](#mm-logout "Direct link to mm-logout") Sign out and revoke the CLI session. ## `mm reset`[​](#mm-reset "Direct link to mm-reset") Clear local session and wallet state files. ## `mm chains list`[​](#mm-chains-list "Direct link to mm-chains-list") List supported EVM networks. No auth required. ## `mm wallet`[​](#mm-wallet "Direct link to mm-wallet") Wallet lifecycle and signing commands. ### `mm wallet create`[​](#mm-wallet-create "Direct link to mm-wallet-create") ``` mm wallet create [--chain-namespace ] [--name ] [--trading-mode guard|beast] ``` Returns `policyYaml: string | null` in structured output. ### `mm wallet list`[​](#mm-wallet-list "Direct link to mm-wallet-list") ``` mm wallet list [--chain-namespace ] ``` ### `mm wallet select`[​](#mm-wallet-select "Direct link to mm-wallet-select") ``` mm wallet select [--chain-namespace ] [--id ] [--address
] [--name ] ``` ### `mm wallet show`[​](#mm-wallet-show "Direct link to mm-wallet-show") ``` mm wallet show [--chain-namespace ] [--id ] [--address
] [--name ] ``` Returns `policyYaml: string | null` in structured output. ### `mm wallet address`[​](#mm-wallet-address "Direct link to mm-wallet-address") ``` mm wallet address [--chain-namespace ] ``` ### `mm wallet add-fund`[​](#mm-wallet-add-fund "Direct link to 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 ] ``` ### `mm wallet balance`[​](#mm-wallet-balance "Direct link to mm-wallet-balance") ``` mm wallet balance [--currency ] [--chain ] [--token ] [--address
] ``` ### `mm wallet trading-mode get`[​](#mm-wallet-trading-mode-get "Direct link to 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`[​](#mm-wallet-trading-mode-set "Direct link to 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 ``` ### `mm wallet policy get`[​](#mm-wallet-policy-get "Direct link to 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`[​](#mm-wallet-policy-set "Direct link to mm-wallet-policy-set") Set the policy for the active server wallet. Server-wallet mode only. ``` mm wallet policy set --policy ``` ### `mm wallet policy template`[​](#mm-wallet-policy-template "Direct link to 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 "Direct link to mm-wallet-sign-message") ``` mm wallet sign-message --message --chain-id [--wait] ``` ### `mm wallet sign-typed-data`[​](#mm-wallet-sign-typed-data "Direct link to mm-wallet-sign-typed-data") ``` mm wallet sign-typed-data --chain-id --payload '' [--wait] ``` ### `mm wallet send-transaction`[​](#mm-wallet-send-transaction "Direct link to mm-wallet-send-transaction") ``` mm wallet send-transaction --chain-id --payload '' [--wait] ``` ### `mm wallet requests list`[​](#mm-wallet-requests-list "Direct link to mm-wallet-requests-list") List pending server-wallet requests. Server-wallet mode only. ### `mm wallet requests watch`[​](#mm-wallet-requests-watch "Direct link to mm-wallet-requests-watch") ``` mm wallet requests watch --polling-id ``` ### `mm wallet password`[​](#mm-wallet-password "Direct link to mm-wallet-password") ``` mm wallet password set --new= mm wallet password change --current= --new= mm wallet password remove --current= ``` ## `mm transfer`[​](#mm-transfer "Direct link to mm-transfer") Send native currency or ERC-20 tokens on one EVM chain. ``` mm transfer --to
--amount --chain-id --token [--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 "Direct link to mm-swap") ### `mm swap quote`[​](#mm-swap-quote "Direct link to mm-swap-quote") ``` mm swap quote --from --to --amount --from-chain [--to-chain ] [--to-address
] [--slippage ] [--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 "Direct link to mm-swap-execute") ``` mm swap execute --quote-id mm swap execute --from --to --amount --from-chain [--to-chain ] [--to-address
] [--slippage ] [--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 "Direct link to mm-swap-status") ``` mm swap status --quote-id [--tx-hash ] ``` ## `mm tx history`[​](#mm-tx-history "Direct link to mm-tx-history") List recent transactions for the active wallet or specific addresses. ``` mm tx history [--addresses ] [--chain ] [--type ] [--limit ] ``` | 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`[​](#mm-perps "Direct link to mm-perps") Hyperliquid perpetuals commands. Most commands require `--venue hyperliquid`. | Command | Usage summary | | -------------------- | --------------------------------------------------------------------------------- | | mm perps list-venues | List supported venues | | mm perps dexs | --venue : list HIP-3 DEX identifiers (Hyperliquid) | | mm perps markets | --venue [--symbol ] | | mm perps balance | --venue | | mm perps positions | --venue | | mm perps orders | --venue | | mm perps quote | Quote before open | | mm perps open | --venue --symbol --side long\|short --size --leverage | | mm perps close | Close a position | | mm perps modify | Modify leverage or TP/SL | | mm perps cancel | --venue --order-id | | mm perps deposit | --venue --amount | | mm perps withdraw | Withdraw from venue | | mm perps transfer | Transfer between spot and perpetual accounts | ## `mm predict`[​](#mm-predict "Direct link to 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 --help` for command-specific flags. ## `mm decode`[​](#mm-decode "Direct link to 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`[​](#mm-price "Direct link to mm-price") | Command | Usage | | ------------------- | --------------------------------------------------- | | mm price spot | --asset-ids [--vs ] [--market-data] | | mm price history | Historical prices | | mm price currencies | Supported quote currencies | | mm price networks | Supported price networks | ## `mm token`[​](#mm-token "Direct link to mm-token") | Command | Usage | | ------------------------ | ---------------------------------- | | mm token assets | --asset-ids | | mm token networks | List token networks | | mm token list popular | --chain | | mm token list trending | --chain | | mm token list search | --query [--chain ] | | mm token list top-gainer | --chain | ## Help[​](#help "Direct link to Help") Every command supports `--help`: ``` mm transfer --help mm perps open --help ```