Sandbox

The Quickstart walks through the generic/programmatic path: register via POST /v1/users, complete the KYC widget, paste an API key into an MCP config. If you’re testing interactively against the sandbox dashboard at https://sandbox.nuez.app, there’s a faster path — no key to copy, no widget to fill in.

Note

Sandbox access is invite-only right now. You need an invitation email before you can log in.

1. Log in

   Go to sandbox.nuez.app and continue with GitHub or Google. If your email hasn’t accepted an invitation, you’ll get INVITATION_REQUIRED and won’t be able to continue. Request access instead via POST /v1/waitlist.

2. Verify your phone over WhatsApp

   Once logged in, the dashboard shows a WhatsApp verification card in place of a KYC form. Tap Verificar por WhatsApp to open WhatsApp with a pre-filled message, or scan the QR code shown alongside it if you’re not on a device with WhatsApp installed. Send the message as-is — no need to type anything.

   Behind the scenes, this is POST /v1/onboarding/whatsapp-link: a single-use wa.me deep link containing a random token, valid for 10 minutes. When you send the pre-filled message, nuez recognizes the link:<token> text via its WhatsApp webhook and marks your phone verified.

   Note

   GET /v1/onboarding-mode (no auth required) tells you which onboarding flow is live: {"mode": "sandbox", "whatsapp_verification_mode": "link", ...}. A code mode also exists (a 6-digit code sent to you instead of a deep link) but isn’t the sandbox default.

3. Onboarding finishes automatically

   As soon as your phone is verified, the dashboard calls POST /v1/onboarding/sandbox for you. This synthesizes a fixed KYC identity and submits it to the sandbox rail simulator, which auto-approves it in a couple of seconds — no real KYC data changes hands. You land with a funded test balance and an assigned CVU.

4. Connect your agent

   The dashboard’s Connect your agent card shows copy-paste snippets for Claude Code, Cursor, Codex, and OpenClaw — all OAuth, none of them need an API key:

   claude mcp add --transport http nuez https://sandbox-mcp.nuez.app/mcp

   Run /mcp afterward to complete the login in your browser — same account as the dashboard. See MCP Setup for the full discovery flow and the other clients’ snippets.

5. Try it

   Ask your agent:

   “Check my nuez balance”

   Then:

   “Transfer ARS 48.500 to expensas.consorcio.test”

   Under your threshold, it executes immediately. Over it, you’ll get a WhatsApp or Telegram message asking for approval.

What’s different from the generic flow

	Generic (Quickstart)	Sandbox dashboard
Sign up	POST /v1/users (email/password)	OAuth login (GitHub/Google), invite-only
Identity check	KYC widget, real-ish flow	WhatsApp phone verification, auto-approved
Connect an agent	Paste an API key into an MCP config	OAuth — log in once, no key
MCP host	Same host as the REST API in most deployments	sandbox-mcp.nuez.app, separate from sandbox-api.nuez.app in this environment

Both paths land you on the same wallet, policy engine, and MCP tool set — pick whichever matches how you’re testing. API keys still work against the sandbox MCP/REST hosts if you’d rather script it; see API keys.