Connect agents

hoodpocket is a standard MCP stdio server, so it works with any MCP-capable client. The server command is always the same:

npx -y hoodpocket

Claude Code

claude mcp add hoodpocket -- npx -y hoodpocket

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "hoodpocket": {
      "command": "npx",
      "args": ["-y", "hoodpocket"]
    }
  }
}

Settings → MCP → Add new MCP server, or .cursor/mcp.json:

{
  "mcpServers": {
    "hoodpocket": {
      "command": "npx",
      "args": ["-y", "hoodpocket"]
    }
  }
}

Any client that launches stdio MCP servers works the same way: command npx, arguments -y hoodpocket.

All optional:

Variable	Purpose
`HOODPOCKET_PRIVATE_KEY`	Bring your own key. Takes precedence over the local keystore.
`HOODPOCKET_HOME`	Where wallet, state, and config live. Default `~/.hoodpocket`
`HOODPOCKET_CONFIG`	Explicit path to a config file

A good first prompt to confirm everything works:

Check my hoodpocket portfolio and limits.

If the wallet is new, the agent will report it is unfunded and give you the address to send ETH to.