Metamask Agent Wallet
Use when the user asks anything about blockchain wallets, transactions, signing, token transfers, supported chains, wallet balances, perpetual futures trading, prediction markets, token swaps, cross-chain bridges, market data, token discovery, decoding EVM calldata, DeFi earn/yield vaults, installing or removing third-party `mm` CLI plugins, or authentication via the MetaMask Agentic CLI; also when an HTTP request returns 402 Payment Required / x402, when an MCP tool call returns an x402 payment-required result, or the agent needs to pay for a paywalled API, endpoint, file, tool, or resource. Single entry point for all mm CLI operations.
- Skill ID
- metamask/agent-skills/metamask-agent-wallet
- Publisher
- metamask
- Repository
- agent-skills
- Installs
- 0
- Files
- 41
- License
- MIT
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
metamask/agent-skills/metamask-agent-walletInstalls these files- SKILL.md
- references/auth.md
- references/chain.md
- references/decode.md
- references/doctor.md
- references/earn.md
- references/errors.md
- references/market-data.md
- references/perps.md
- references/plugins.md
- references/polling.md
- references/predict.md
- references/signing.md
- references/swap.md
- references/transaction.md
- references/transfer.md
- references/tx-history.md
- references/wallet.md
- references/x402.md
- scripts/amount_to_hex.py
- scripts/x402_pay.py
- workflows/bridge.md
- workflows/earn-supply.md
- workflows/earn-withdraw.md
- workflows/login.md
- workflows/market-data.md
- workflows/onboarding.md
- workflows/perps-close-position.md
- workflows/perps-modify-position.md
- workflows/perps-open-position.md
- workflows/predict-funding.md
- workflows/predict-history.md
- workflows/predict-manage-orders.md
- workflows/predict-markets.md
- workflows/predict-place-order.md
- workflows/predict-portfolio.md
- workflows/predict-setup.md
- workflows/swap.md
- workflows/troubleshooting.md
- workflows/x402-mcp.md
- workflows/x402-pay.md
What this skill tells the agent
MetaMask Agentic CLI Skill
This skill documents the mm CLI surface for MetaMask Agent Wallet authentication, wallet lifecycle, balance queries, token transfers, message and typed-data signing, raw transactions, chain discovery, market data, token discovery, perpetual futures trading, prediction market trading, prediction trade/redeem history, token swaps, cross-chain bridges, DeFi earn/yield vaults, and EVM calldata decoding.
Use the routing table to select the relevant reference file. CLI behavior lives in references/. Repeatable operational patterns live in workflows/.
Command Routing
Match the user's intent to a command and reference file, then read the reference before constructing a command. If intent spans multiple domains, load them sequentially in dependency order.
| User Intent | Command | Reference |
|---|---|---|
| Check authentication status | mm auth status | auth.md |
| Login in MetaMask Agentic CLI | mm login | auth.md |
| Choose a wallet mode and set up policies | mm init | auth.md |
| Show current init settings | mm init show | auth.md |
| Sign in via QR code with MetaMask Mobile | mm login qr | auth.md |
| Sign in via browser (Google or Email) | mm login browser | auth.md |
| Sign out | mm logout | auth.md |
| Reset CLI session | mm reset | auth.md |
| Show CLI configuration | mm config get | auth.md |
| Set CLI configuration | mm config set | auth.md |
| Set BYOK mnemonic encryption password | mm wallet password set | auth.md |
| Change BYOK mnemonic encryption password | mm wallet password change | auth.md |
| Remove BYOK mnemonic encryption password | mm wallet password remove | auth.md |
| Interpret raw CLI error codes | AuthError, ValidationError, WALLET_ERROR | errors.md |
| Inspect CLI, skills, environment, and session health | mm doctor | doctor.md |
| List installed CLI plugins | mm plugins | plugins.md |
| Inspect an installed CLI plugin | mm plugins inspect | plugins.md |
| Install a CLI plugin | mm plugins install | plugins.md |
| Update a CLI plugin | mm plugins update | plugins.md |
| Uninstall a CLI plugin | mm plugins uninstall | plugins.md |
| Remove all user-installed CLI plugins | mm plugins reset | plugins.md |
| Link a local plugin directory for development | mm plugins link | plugins.md |
| Enable or disable the plugin beta | mm config set experimentalPlugins | plugins.md |
| Decode EVM calldata into a human-readable intent | mm decode | decode.md |
| Create a wallet | mm wallet create | wallet.md |
| List all wallets | mm wallet list | wallet.md |
| Switch active wallet | mm wallet select | wallet.md |
| Show active wallet details | mm wallet show | wallet.md |
| Show active wallet address | mm wallet address | wallet.md |
| Check the active wallet balance | mm wallet balance | wallet.md |
| Show a QR code and address to fund the active wallet | mm wallet add-fund | wallet.md |
| Show current trading mode | mm wallet trading-mode get | wallet.md |
| Set trading mode to guard or beast | mm wallet trading-mode set | wallet.md |
| View wallet policy | mm wallet policy get | wallet.md |
| Set wallet policy | mm wallet policy set | wallet.md |
| Show project policy template | mm wallet policy template | wallet.md |
| Sign a plaintext message | mm wallet sign-message | signing.md |
| Sign EIP-712 typed data | mm wallet sign-typed-data | signing.md |
| Send a raw EVM transaction | mm wallet send-transaction | transaction.md |
| Transfer native tokens or ERC-20 tokens | mm transfer | transfer.md |
| List supported chains by the CLI | mm chains list | chain.md |
| List pending wallet requests | mm wallet requests list | polling.md |
| Watch a wallet polling id | mm wallet requests watch | polling.md |
| Query spot or historical prices | mm price ... | market-data.md |
| Discover tokens, token networks, or token metadata | mm token ... | market-data.md |
| List perpetual markets | mm perps markets | perps.md |
| Check perps account balance | mm perps balance | perps.md |
| List open perpetual positions | mm perps positions | perps.md |
| Get a quote for a perpetual order | mm perps quote | perps.md |
| List resting perpetual orders | mm perps orders | perps.md |
| Open a perpetual position | mm perps open | perps.md |
| Close a perpetual position | mm perps close | perps.md |
| Modify leverage, take-profit, or stop-loss | mm perps modify | perps.md |
| Cancel a resting perps order | mm perps cancel | perps.md |
| Deposit USDC into a perps venue | mm perps deposit | perps.md |
| Withdraw USDC from a perps venue | mm perps withdraw | perps.md |
| Transfer USDC between spot and perp accounts | mm perps transfer | perps.md |
| List perpetual futures venues | mm perps list-venues | perps.md |
| List available DEXs for a venue | mm perps dexs | perps.md |
| Set Predict trading mode | mm predict mode | predict.md |
| One-time Predict setup | mm predict setup | predict.md |
| Create or refresh Predict credentials | mm predict auth | predict.md |
| Repair Predict approvals | mm predict approve | predict.md |
| Check Predict back-end status and account setup | mm predict status | predict.md |
| Check if Polymarket is geoblocked for your IP | mm predict geoblock | predict.md |
| List prediction markets | mm predict markets list | predict.md |
| Search prediction markets | mm predict markets search | predict.md |
| Inspect a prediction market | mm predict markets get | predict.md |
| List Polymarket events | mm predict events list | predict.md |
| Inspect a Polymarket event | mm predict events get | predict.md |
| List Polymarket event series | mm predict series list | predict.md |
| Inspect a Polymarket event series | mm predict series get | predict.md |
| List Polymarket tags | mm predict tags list | predict.md |
| Inspect a Polymarket tag | mm predict tags get | predict.md |
| Preview a prediction order cost | mm predict quote | predict.md |
| Place a prediction market order | mm predict place | predict.md |
Use this skill in a project
Open any RiverX project, search the Skills panel for metamask/agent-skills/metamask-agent-wallet, and install it in one click.