Skip to content
nuez docs

Quickstart

This guide connects nuez to Claude Desktop as an MCP tool. By the end, you’ll be able to ask Claude to check your balance and send a payout from your nuez wallet.

Prefer to integrate directly with the REST API? See Authentication. Prefer the terminal? See the nuez CLI.

Prerequisites

Section titled “Prerequisites”
  • A nuez account and completed KYC (sign up with POST /v1/users against https://sandbox-api.nuez.app, or via the nuez CLI)
  • Claude Desktop installed (claude.ai/download)
  • A funded nuez wallet (you’ll do this in step 3)

  1. Create an account and get your API key

    Section titled “Create an account and get your API key”
    Terminal window
    curl -X POST https://sandbox-api.nuez.app/v1/users \
      -H "Content-Type: application/json" \
      -d '{
        "email": "you@example.com",
        "phone_e164": "+5491100000000",
        "password": "a-strong-password"
      }'

    The response includes default_api_key (starts with nz_) — this is your MCP credential — and onboarding_url, a link to the identity verification widget to complete KYC.

  2. Complete KYC

    Section titled “Complete KYC”

    Open onboarding_url in a browser and complete the identity verification widget. Until this finishes, every payout is denied by the policy engine with kyc_incomplete.

    Check status any time with GET /v1/onboarding/status (requires a JWT — see Authentication).

  3. Add nuez to Claude Desktop

    Section titled “Add nuez to Claude Desktop”

    Open your Claude Desktop config file:

    ~/Library/Application Support/Claude/claude_desktop_config.json

    Add the nuez MCP server — it’s a single POST /mcp endpoint, authenticated with your raw API key as a Bearer token (no JWT exchange needed for MCP):

    {
      "mcpServers": {
        "nuez": {
          "type": "http",
          "url": "https://sandbox-mcp.nuez.app/mcp",
          "headers": {
            "Authorization": "Bearer nz_YOUR_KEY_HERE"
          }
        }
      }
    }

    Save the file and restart Claude Desktop.

  4. Fund your wallet

    Section titled “Fund your wallet”

    Your nuez wallet has a CVU — a standard Argentine bank account identifier. Once KYC is done, transfer any amount to it from:

    • Any Argentine bank (Santander, Galicia, Brubank, etc.)
    • Mercado Pago
    • Ualá

    Ask Claude “What’s my nuez CVU?” (the get_cvu tool) to retrieve it, or call GET /v1/cvu directly.

  5. Send your first payout

    Section titled “Send your first payout”

    Open a new Claude conversation. You should see nuez in the tools list (🔧 icon).

    Try asking:

    “Check my nuez balance”

    Then:

    “Send $500 ARS to CBU 0000003100010000123456”

    If the amount is under your thresholds: Claude executes immediately via request_payout and shows you the payout ID and submitted status.

    If the amount trips a threshold: you’ll get a WhatsApp or Telegram message asking you to reply APPROVE:XXXXXX or REJECT:XXXXXX. Approve it and check status again — the payout attempt updates to approved then submitted.

What just happened

Section titled “What just happened”

Claude used the get_balance and request_payout MCP tools. Behind the scenes:

  1. nuez authenticated your API key directly against POST /mcp (no separate token exchange for MCP calls)
  2. The policy engine evaluated the amount against your KYC status, whitelist, absolute cap, and per-tx/daily/monthly limits — full rule order here
  3. If allowed, the payout was submitted to the bank rail and moved to submitted status
  4. If a signed webhook endpoint is configured (PUT /v1/webhook), payout.requested and payout.submitted events fired

Next steps

Section titled “Next steps”