Skip to main content

Quickstart

Two commands. No keys to manage.

1. Connect your agent

claude mcp add hoodpocket -- npx -y hoodpocket

On first run, hoodpocket generates a fresh pocket wallet automatically and stores it at ~/.hoodpocket/wallet.json with owner-only file permissions. The key never leaves your machine and is never shown to the agent.

Using another MCP client? Any client that speaks stdio works with the command npx -y hoodpocket. See Connect agents.

2. Fund the pocket

Get the wallet address:

npx -y hoodpocket address

Or simply ask your agent, "what's my portfolio?". It will reply with the address and tell you the wallet needs funding.

Send ETH to that address on Robinhood Chain (chain id 4663). ETH covers both gas and trading. USDG is optional if you want the agent to trade stock tokens, which quote against USDG.

Fund it like a pocket

Only send what you are comfortable letting an agent trade. The whole point of the pocket model is that the worst case is bounded.

3. Trade

Ask your agent something like:

Search for CASHCAT, verify which one is real, and buy $10 worth with ETH if the price looks fair.

The agent will search, run the tier check (there are at least four fake CASHCATs), quote the real one, and execute inside your limits.

Default guardrails

These apply out of the box, no config needed:

RuleDefault
Daily USD budget (rolling 24h)$1,000
Official tier, max per trade$500
Established tier, max per trade$100
Unknown tierblocked

To change them, see Guardrails and config.

Back up the key

npx -y hoodpocket export-key

Run this yourself in a terminal and store the output somewhere safe. Never paste the key into a chat with an AI agent.