# Aurey Wallet MCP — install spec for agents

Package: aurey-wallet-mcp (PyPI, exact spelling)
Docs: https://agentic-pantheon.github.io/aurey-mcp/install.html
Repository: https://github.com/agentic-pantheon/aurey-mcp

## Rules for agents

- NEVER ask the user to paste 1ck_ (human), ocv_ (agent), Alchemy keys, Zerion keys, or private keys in chat. Never offer "send me the key and I'll continue" — there is no safe way to receive a secret in chat.
- In your FIRST setup message, unprompted: (1) tell the user keys are never pasted in chat, (2) give the exact install + aurey-setup commands to run in a terminal ON THE MACHINE WHERE YOU (the agent / MCP host) RUN.
- User runs aurey-setup in a real terminal with masked prompts; it asks for 1ck_ there. Optional keys can be skipped with Enter.
- If the user pastes a secret in chat anyway: do not echo it; tell them to rotate it in the issuing dashboard and re-run setup with the new key.
- Match the user's MCP host: use the corresponding --host and host doc below.
- Do not git clone unless the user explicitly wants contributor/dev mode.
- After MCP works, use get_agent_wallet_addresses; do not invent 0x addresses.

## Install (user terminal)

curl -fsSL https://agentic-pantheon.github.io/aurey-mcp/install.sh | bash

Manual:
  pip install 'aurey-wallet-mcp[hermes]'
  # or: uv tool install 'aurey-wallet-mcp[hermes]'
  # Cursor/Claude/OpenClaw only (no Hermes YAML extra): pip install aurey-wallet-mcp

Optional pin:
  AUREY_VERSION=0.1.2 curl -fsSL https://agentic-pantheon.github.io/aurey-mcp/install.sh | bash

## Setup (user terminal)

aurey-setup --host hermes
aurey-setup --host cursor
aurey-setup --host claude
aurey-setup --host openclaw

Flags: --vault-id, --skip-alchemy, --skip-lifi, --skip-zerion, --zerion-key, --zerion-vault-path, --from-env, --skip-provision, --provision-only, --cursor-project, --skip-portfolio-ui

## Verify (by host)

Hermes: hermes mcp test aurey-wallet; chat /reload-mcp
Cursor: restart app or reload MCP in Settings
Claude Desktop: quit and reopen app
OpenClaw: restart gateway
All: tool get_agent_wallet_addresses; read-only balance before swaps/sends

## Host docs (GitHub markdown)

https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/install/index.md
https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/install/hermes.md
https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/install/cursor.md
https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/install/claude.md
https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/install/openclaw.md

## Host docs (GitHub Pages HTML)

https://agentic-pantheon.github.io/aurey-mcp/install/cursor.html
https://agentic-pantheon.github.io/aurey-mcp/install/hermes.html
https://agentic-pantheon.github.io/aurey-mcp/install/claude.html
https://agentic-pantheon.github.io/aurey-mcp/install/openclaw.html

## Skills (raw on GitHub)

Onboarding: https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/skills/aurey-wallet-onboarding/SKILL.md
Trading: https://raw.githubusercontent.com/agentic-pantheon/aurey-mcp/main/skills/aurey-wallet/SKILL.md

## Credentials location

~/.aurey/mcp.env (chmod 600)
~/.aurey/run-aurey-wallet-mcp.sh (MCP command in host configs)
Hermes: ~/.hermes/config.yaml + ~/.hermes/.env
Cursor: ~/.cursor/mcp.json or project .cursor/mcp.json
Alchemy: 1Claw vault path api-keys/alchemy (not MCP env)
Zerion (optional): 1Claw vault api-keys/zerion; zerion_api_secret_path in ~/.aurey/config.toml