CLI Reference — MPPCash Docs

Installation

bash

npm install -g @mppcash/cli

# Verify installation
mppcash --version

Authentication

bash

# Set your operator API key
export MPPPAL_API_KEY="mppcash_live_..."

# Or configure via login
mppcash auth login

accounts

`mppcash accounts create`

bash

mppcash accounts create --name "research-agent-prod"

# Output:
# account_id:         acct_01j8k4x9p2qrst7yz
# handle:             @research-agent-prod.mppcash
# solana_address:     9xTz4KqR8mYvPn3SdFgHj6WbCeAuLo1XkQi5NtZpMwV
# usdc_token_account: 7mZp2VbQnXeYjLo9KrTzFdCgWqA3ShNkRi4UwPtMxHs
# status:             active

`mppcash accounts list`

bash

mppcash accounts list
mppcash accounts list --status paused
mppcash accounts list --json   # machine-readable JSON output

`mppcash accounts balance`

bash

mppcash accounts balance --account acct_01j8k4x9p2qrst7yz

# Output:
# Balance: 342.500000 USDC

policy

`mppcash policy set`

bash

mppcash policy set \
  --account acct_01j8k4x9p2qrst7yz \
  --max-single 500 \
  --max-daily 2000 \
  --categories inference,data \
  --require-memo

`mppcash policy pause / resume`

bash

# Immediately halt all transfers from account
mppcash policy pause --account acct_01j8k4x9p2qrst7yz

# Resume after investigation
mppcash policy resume --account acct_01j8k4x9p2qrst7yz

`mppcash policy get`

bash

mppcash policy get --account acct_01j8k4x9p2qrst7yz

transfers

`mppcash transfers list`

bash

mppcash transfers list --account acct_01j8k4x9p2qrst7yz
mppcash transfers list --account acct_01j8k4x9p2qrst7yz --last 24h
mppcash transfers list --account acct_01j8k4x9p2qrst7yz --status rejected

`mppcash transfers send`

bash

mppcash transfers send \
  --from acct_01j8k4x9p2qrst7yz \
  --to 9xTz4KqR8mYvPn3SdFgHj6WbCeAuLo1XkQi5NtZpMwV \
  --amount 50 \
  --memo "Invoice #1042" \
  --idempotency-key inv-1042

sessions

Inspect and manage active MPP sessions for an account.

`mppcash sessions list`

bash

mppcash sessions list --account acct_01j8k4x9p2qrst7yz

# Output:
# session_id             status    cap     used    provider
# sess_09r4u5w6x7yzab8cd active    $10.00  $3.42   api.inference.xyz
# sess_10s5v6w7x8zabc9de active    $5.00   $1.10   api.datasource.io

# Filter by status
mppcash sessions list --account acct_01j8k4x9p2qrst7yz --status active
mppcash sessions list --account acct_01j8k4x9p2qrst7yz --status settled --last 24h

`mppcash sessions close`

bash

# Close a specific session and trigger on-chain settlement
mppcash sessions close --session sess_09r4u5w6x7yzab8cd

# Output:
# Session sess_09r4u5w6x7yzab8cd closed.
# Settled: $3.42 USDC  |  Returned: $6.58 USDC
# Tx: 3kLmPqRsT9uVwXyZ2aBcDeFgHi4JkLmN5oPqRsTuV...

# Close all active sessions for an account
mppcash sessions close --account acct_01j8k4x9p2qrst7yz --all

Global flags

Flag	Description
`--json`	Output raw JSON. Useful for piping to `jq`.
`--api-key <key>`	Override the API key for this invocation.
`--no-color`	Disable colored output.