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, or authen
By metamask · 802 installs
npx skills add metamask/agent-skills --skill metamask-agent-wallet
Source repository · Upstream listing
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](references/auth.md)
Login in MetaMask Agentic CLI mm login [auth.md](references/auth.md)
Choose a wallet mode and set up policies mm init [auth.md](references/auth.md)
Show current init settings mm init show [auth.md](references/auth.md)
Sign in via QR code with MetaMask Mobile mm login qr [auth.md](references/auth.md)
Sign in via browser (Google or Email) mm login browser [auth.md](references/auth.md)
Sign out mm logout [auth.md](references/auth.md)
Reset CLI session mm reset [auth.md](references/auth.md)
Show CLI configuration mm config get [auth.md](references/auth.md)
Set CLI configuration mm config set [auth.md](references/auth.md)
Set BYOK mnemonic encryption password mm wallet password set [auth.md](references/auth.md)
Change BYOK mnemonic encryption password mm wallet password change [auth.md](references/auth.md)
Remove BYOK mnemonic encryption password mm wallet password remove [auth.md](references/auth.md)
Interpret raw CLI error codes AuthError , ValidationError , WALLET ERROR [errors.md](references/errors.md)
Inspect CLI, skills, environment, and session health mm doctor [doctor.md](references/doctor.md)
Decode EVM calldata into a human readable intent mm decode [decode.md](references/decode.md)
Create a wallet mm wallet create [wallet.md](references/wallet.md)
List all wallets mm wallet list [wallet.md](references/wallet.md)
Switch active wallet mm wallet select [wallet.md](references/wallet.md)
Show active wallet details mm wallet show [wallet.md](references/wallet.md)
Show active wallet address mm wallet address [wallet.md](references/wallet.md)
Check the active wallet balance mm wallet balance [wallet.md](references/wallet.md)
Show a QR code and address to fund the active wallet mm wallet add fund [wallet.md](references/wallet.md)
Show current trading mode mm wallet trading mode get [wallet.md](references/wallet.md)
Set trading mode to guard or beast mm wallet trading mode set [wallet.md](references/wallet.md)
View wallet policy mm wallet policy get [wallet.md](references/wallet.md)
Set wallet policy mm wallet policy set [wallet.md](references/wallet.md)
Show project policy template mm wallet policy template [wallet.md](references/wallet.md)
Sign a plaintext message mm wallet sign message [signing.md](references/signing.md)
Sign EIP 712 typed data mm wallet sign typed data [signing.md](references/signing.md)
Send a raw EVM transaction mm wallet send transaction [transaction.md](references/transaction.md)
Transfer native tokens or ERC 20 tokens mm transfer [transfer.md](references/transfer.md)
List supported chains by the CLI mm chains list [chain.md](references/chain.md)
List pending wallet requests mm wallet requests list [polling.md](references/polling.md)
Watch a wallet polling id mm wallet requests watch [polling.md](references/polling.md)
Query spot or historical prices mm price ... [market data.md](references/market data.md)
Discover tokens, token networks, or token metadata mm token ... [market data.md](references/market data.md)
List perpetual markets mm perps markets [perps.md](references/perps.md)
Check perps account balance mm perps balance [perps.md](references/perps.md)
List open perpetual positions mm perps positions [perps.md](references/perps.md)
Get a quote for a perpetual order mm perps quote [perps.md](references/perps.md)
List resting perpetual orders mm perps orders [perps.md](references/perps.md)
Open a perpetual position mm perps open [perps.md](references/perps.md)
Close a perpetual position mm perps close [perps.md](references/perps.md)
Modify leverage, take profit, or stop loss mm perps modify [perps.md](references/perps.md)
Cancel a resting perps order mm perps cancel [perps.md](references/perps.md)
Deposit USDC into a perps venue mm perps deposit [perps.md](references/perps.md)
Withdraw USDC from a perps venue mm perps withdraw [perps.md](references/perps.md)
Transfer USDC between spot and perp accounts mm perps transfer [perps.md](references/perps.md)
List perpetual futures venues mm perps list venues [perps.md](references/perps.md)
List available DEXs for a venue mm perps dexs [perps.md](references/perps.md)
Set Predict trading mode mm predict mode [predict.md](references/predict.md)
One time Predict setup mm predict setup [predict.md](references/predict.md)
Create or refresh Predict credentials mm predict auth [predict.md](references/predict.md)
Repair Predict approvals mm predict approve [predict.md](references/predict.md)
Check Predict back end status and account setup mm predict status [predict.md](references/predict.md)
Check if Polymarket is geoblocked for your IP mm predict geoblock [predict.md](references/predict.md)
List prediction markets mm predict markets list [predict.md](references/predict.md)
Search prediction markets mm predict markets search [predict.md](references/predict.md)
Inspect a prediction market mm predict markets get [predict.md](references/predict.md)
List Polymarket events mm predict events list [predict.md](references/predict.md)
Inspect a Polymarket event mm predict events get [predict.md](references/predict.md)
List Polymarket event series mm predict series list [predict.md](references/predict.md)
Inspect a Polymarket event series mm predict series get [predict.md](references/predict.md)
List Polymarket tags mm predict tags list [predict.md](references/predict.md)
Inspect a Polymarket tag mm predict tags get [predict.md](references/predict.md)
Preview a prediction order cost mm predict quote [predict.md](references/predict.md)
Place a prediction market order mm predict place [predict.md](references/predict.md)
Cancel prediction orders mm predict cancel [predict.md](references/predict.md)
View prediction market positions mm predict positions [predict.md](references/predict.md)
View open prediction orders mm predict orders [predict.md](references/predict.md)
Show full Predict portfolio snapshot mm predict portfolio [predict.md](references/predict.md)
List redeemable winning positions mm predict redeem list [predict.md](references/predict.md)
Redeem winning positions mm predict redeem [predict.md](references/predict.md)
Check Predict deposit wallet balance mm predict balance [predict.md](references/predict.md)
Fund Predict deposit wallet mm predict deposit [predict.md](references/predict.md)
Withdraw pUSD from Predict deposit wallet mm predict withdraw [predict.md](references/predict.md)
Fetch prediction order book mm predict book [predict.md](references/predict.md)
Watch a Predict job mm predict watch [predict.md](references/predict.md)
List Predict trade or redeem history mm predict history [predict.md](references/predict.md)
Inspect Predict history for a specific market mm predict history get [predict.md](references/predict.md)
Look up a transaction by hash mm tx [tx history.md](references/tx history.md)
List recent transactions for the active wallet mm tx history [tx history.md](references/tx history.md)
Get a swap or bridge quote mm swap quote [swap.md](references/swap.md)
Execute a token swap or bridge mm swap execute [swap.md](references/swap.md)
Check swap or bridge status mm swap status [swap.md](references/swap.md)
Bridge tokens to another chain mm swap execute [swap.md](references/swap.md)
Pay an HTTP 402 / x402 paywalled request python3 scripts/x402 pay.py [x402.md](references/x402.md)
Pay an x402 gated MCP tool call python3 scripts/x402 pay.py [x402.md](references/x402.md)
List earn vaults and APYs mm earn markets [earn.md](references/earn.md)
View earn vault positions mm earn positions [earn.md](references/earn.md)
Supply tokens to an earn vault mm earn supply [earn.md](references/earn.md)
Withdraw tokens from an earn vault mm earn withdraw [earn.md](references/earn.md)
Workflows
CLI behavior lives in references/ . Repeatable patterns live in workflows/ . Load a workflow file when the user's request is a pattern, not a single command.
Pattern Workflow
First time setup and onboarding [onboarding.md](workflows/onboarding.md)
Login flow [login.md](workflows/login.md)
Troubleshooting decision tree [troubleshooting.md](workflows/troubleshooting.md)
Swap quote review execute flow [swap.md](workflows/swap.md)
Bridge quote review execute flow [bridge.md](workflows/bridge.md)
Open a perpetual position flow [perps open position.md](workflows/perps open position.md)
Close a perpetual position flow [perps close position.md](workflows/perps close position.md)
Modify a perpetual position flow [perps modify position.md](workflows/perps modify position.md)
Predict first time setup and credentials [predict setup.md](workflows/predict setup.md)
Deposit or withdraw pUSD from Predict wallet [predict funding.md](workflows/predict funding.md)
Search and browse prediction markets [predict markets.md](workflows/predict markets.md)
Quote and place a prediction order [predict place order.md](workflows/predict place order.md)
View or cancel Predict orders and positions [predict manage orders.md](workflows/predict manage orders.md)
View Predict portfolio and redeem winnings [predict portfolio.md](workflows/predict portfolio.md)
View Predict trade and redeem history [predict history.md](workflows/predict history.md)
Token discovery, prices, and market data [market data.md](workflows/market data.md)
Supply tokens to earn yield [earn supply.md](workflows/earn supply.md)
Withdraw tokens from an earn vault [earn withdraw.md](workflows/earn withdraw.md)
Pay an HTTP 402 (x402) paywalled request [x402 pay.md](workflows/x402 pay.md)
Pay an x402 gated MCP tool call [x402 mcp.md](workflows/x402 mcp.md)
Global Flags
Every mm command accepts these flags:
Flag Short Description
format f Output format: text , json , or toon . Defaults to text in TTY, json when piped
json Shorthand for format=json
toon Shorthand for format=toon
verbose v Show debug logs on stderr. Use for troubleshooting
Always use toon for command output unless the user explicitly requests a different format.
Preflight
Run