CLI Reference - NeoMPP Docs

Installation

bash

npm install -g @neompp/cli

# Verify installation
neompp --version

Authentication

bash

# Set your operator API key
export NEOMPP_API_KEY="neompp_live_..."

# Or configure via login
neompp auth login

accounts

`neompp accounts create`

bash

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

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

`neompp accounts list`

bash

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

`neompp accounts balance`

bash

neompp accounts balance --account acct_01j8k4x9p2qrst7yz

# Output:
# Balance: 342.500000 USDC

policy

`neompp policy set`

bash

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

`neompp policy pause / resume`

bash

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

# Resume after investigation
neompp policy resume --account acct_01j8k4x9p2qrst7yz

`neompp policy get`

bash

neompp policy get --account acct_01j8k4x9p2qrst7yz

transfers

`neompp transfers list`

bash

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

`neompp transfers send`

bash

neompp 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.

`neompp sessions list`

bash

neompp 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
neompp sessions list --account acct_01j8k4x9p2qrst7yz --status active
neompp sessions list --account acct_01j8k4x9p2qrst7yz --status settled --last 24h

`neompp sessions close`

bash

# Close a specific session and trigger on-chain settlement
neompp 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
neompp 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.