Quickstart

This guide connects nuez to Claude Desktop as an MCP tool. By the end, you’ll be able to ask Claude to transfer funds from your nuez wallet.

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

Prerequisites

• A nuez account (sign up at nuez.app)
• Claude Desktop installed (claude.ai/download)
• A funded nuez wallet (you’ll do this in step 3)

---

1. Get your API key

   Go to your nuez dashboard and create a new API key.

   Set:

   • Threshold: 5000 (transfers under $5,000 ARS execute automatically; above that, you’ll get a WhatsApp confirmation)
   • Scopes: transfer:write, balance:read, transactions:read

   Copy the key — it starts with nz_sk_live_ (or nz_sk_test_ for sandbox).

   Caution

   API keys are shown once. Store it securely — you can’t retrieve it later, only revoke and regenerate.

2. Add nuez to Claude Desktop

   Open your Claude Desktop config file:

   macOS

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

   Windows

   %APPDATA%\Claude\claude_desktop_config.json

   Add the nuez MCP server:

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

   Save the file and restart Claude Desktop.

3. Fund your wallet

   Your nuez wallet has a CVU — a standard Argentine bank account identifier. Transfer any amount to it from:

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

   You’ll find your CVU in the nuez dashboard under Wallet.

   Funds arrive instantly via Transferencias 3.0.

4. Run your first transfer

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

   Try asking:

   “Check my nuez balance”

   Then:

   “Transfer $500 to CVU 0000003100010000123456 with description ‘test’”

   If the amount is under your threshold: Claude executes immediately and shows you the transaction ID.

   If the amount is over your threshold: You’ll get a WhatsApp message. Approve it and Claude will confirm the result.

---

What just happened

Claude used the nuez.balance and nuez.transfer MCP tools. Behind the scenes:

1. nuez received the tool call with your API key
2. The policy engine checked the amount against your threshold
3. The transfer was sent over Transferencias 3.0 via BIND
4. A signed webhook was fired (Claude received the result through the MCP response)

Next steps

• Policy engine — understand thresholds, scopes, and allowlists
• nuez.transfer reference — full parameter reference for the transfer tool
• REST API authentication — integrate without MCP