CLI commands
Human-run commands, separate from the MCP surface. Run them in any terminal.
hoodpocket (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 ~/.hoodpocket/wallet.json (chmod 600).
npx -y hoodpocket
hoodpocket address
Prints the pocket wallet's address. Use it to fund the wallet.
npx -y hoodpocket address
hoodpocket export-key
Prints the private key for backup, with a warning on stderr.
npx -y hoodpocket export-key
Human eyes only
Anyone with this key controls the pocket'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
| Path | Contents |
|---|---|
~/.hoodpocket/wallet.json | The pocket key (owner-only permissions) |
~/.hoodpocket/state.json | Trade history and budget tracking |
~/.hoodpocket/config.json | Optional guardrail config |
Set HOODPOCKET_HOME to relocate all of them.