pryvy

pryvy

CLI and MCP server for Privy embedded wallets & auth.

Install

npm install -g pryvy

Or run directly:

npx pryvy --help

Setup

On first run with no arguments, pryvy prompts for your App ID and App Secret interactively. Or configure them explicitly:

pryvy configure app-id <your-app-id>
pryvy configure app-secret <your-app-secret>

You can also set them via environment variables:

export PRIVY_APP_ID=...
export PRIVY_APP_SECRET=...

Usage

# create a user with an email
pryvy users create --email [e-mail]

# create a user with an embedded ethereum wallet
pryvy users create --email [e-mail] --create-wallet ethereum

# list all users
pryvy users list

# create a standalone wallet
pryvy wallets create --chain-type ethereum

# check wallet balance
pryvy wallets get-balance <wallet-id> --asset usdc --chain base

# sign a message
pryvy signing personal-sign <wallet-id> --message "hello world"

# send a transaction
pryvy signing send-tx <wallet-id> \
  --caip2 eip155:1 --to 0x... --value 0x0

# set default output format
pryvy configure format json

Commands

Group	Commands
users	create, get, list, delete, search, add-metadata, pregenerate-wallets
wallets	create, get, list, get-balance, get-by-address, batch-create
signing	personal-sign, send-tx, sign-tx, sign-typed-data, sign-7702, sign-user-op, sol-sign-tx, sol-sign-message
transactions	get
policies	create, get, list, update, delete
configure	app-id, app-secret, format, show

All commands support --format toon|json|yaml|md|jsonl and --help.

Agent Setup

Give your AI agent (Claude Code, Amp, Cursor, Copilot, etc.) full access to Privy:

npx pryvy mcp add      # register as MCP server — gives agents direct tool access
npx pryvy skills add   # install skill files — gives agents context on available commands

That's it. Your agent can now run commands like "create a user with an email" or "sign a message with a wallet".

You can also run the MCP server directly in stdio mode:

pryvy --mcp

Development

bun install
bun run build        # tsc + chmod
bun run typecheck    # tsc --noEmit

Built with

incur — one CLI router that gives you a CLI, MCP server, and agent skills for free.

License

MIT