Reference

CLI commands

Human-run commands for the wallet address, key backup, and the files on disk.

Human-run commands, separate from the MCP surface. Run them in any terminal.

pouch-rwa (no arguments)

Starts the MCP server on stdio. This is what your MCP client runs. On first start without an existing wallet, a fresh key is generated and stored at ~/.pouch/wallet.json (chmod 600).

npx -y pouch-rwa

pouch-rwa address

Prints the pouch wallet's address. Use it to fund the wallet.

npx -y pouch-rwa address

pouch-rwa export-key

Prints the private key for backup, with a warning on stderr.

npx -y pouch-rwa export-key

Human eyes only

Anyone with this key controls the pouch's funds. Store it in a password manager. Never paste it into a chat with an AI agent, and never commit it anywhere.

Files on disk

PathContents
~/.pouch/wallet.jsonThe pouch key (owner-only permissions)
~/.pouch/state.jsonTrade history and budget tracking
~/.pouch/config.jsonOptional guardrail config

Set POUCH_HOME to relocate all of them.

On this page