@visa/cli 2.0.0-rc.10 → 2.0.0-rc.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -31,7 +31,7 @@ Add to your MCP client config:
31
31
  }
32
32
  ```
33
33
 
34
- Once connected, your assistant will have access to all payment tools. The first time you use a paid tool, you'll be prompted to log in and enroll a card.
34
+ Once connected, your assistant will have access to all payment tools. The first time you use a paid tool, you'll be prompted to log in and enroll a card — you'll get $1 in free credits to start.
35
35
 
36
36
  ---
37
37
 
@@ -47,7 +47,8 @@ visa-cli history # Recent transactions with amounts and any generated media
47
47
  visa-cli hud enable # Explicitly pin the Visa HUD below Claude Code input
48
48
  visa-cli hud disable # Remove the Visa HUD from Claude Code
49
49
  visa-cli statusline # Render the multi-line HUD Claude Code calls automatically
50
- visa-cli mcp # Start the MCP server
50
+ # MCP (stdio): run the bundled entrypoint (IDE configs use the same path — see getServerEntry in src/clients.ts)
51
+ # node "$(npm root -g)/@visa/cli/dist/mcp-server/index.js"
51
52
  ```
52
53
 
53
54
  ---
@@ -65,7 +66,7 @@ visa-cli status # verify you're logged in
65
66
 
66
67
  ## Card enrollment
67
68
 
68
- Cards are tokenized via VGS — your raw card number never touches Visa servers. `add_card` opens a hosted VGS Collect form in your browser.
69
+ Cards are tokenized via VGS — your raw card number never touches Visa servers. `add_card` opens a hosted VGS Collect form in your browser. You receive $1 in free credits on your first card enrollment.
69
70
 
70
71
  ```bash
71
72
  visa-cli add-card
@@ -75,6 +76,14 @@ Multiple cards can be enrolled. The first becomes the default; you can switch de
75
76
 
76
77
  ---
77
78
 
79
+ ## Credits & referrals
80
+
81
+ You receive **$1 in free credits** when you enroll your first card — enough for about 16 AI images. Credits are used automatically before your card is charged.
82
+
83
+ Share your referral link (visible in `get_status`) and you both get **$2 in free credits** when your referral enrolls a card.
84
+
85
+ ---
86
+
78
87
  ## Payments & Authentication
79
88
 
80
89
  Every paid tool call requires authentication. On macOS, this is Touch ID (or device password); on Windows and Linux, payments are server-verified with restricted spending limits. Your assistant will show you the amount and merchant before prompting. If you cancel, the payment is aborted — nothing is charged.
@@ -186,7 +195,7 @@ Both limits are enforced server-side. Authentication is always required per paym
186
195
  ## Troubleshooting
187
196
 
188
197
  **Touch ID prompt doesn't appear (macOS)**
189
- Make sure `visa-cli mcp` is running as a foreground process that has access to the macOS security framework. Running inside some sandboxed environments may prevent Touch ID. On Windows and Linux, biometric prompts are not used — payments are server-verified.
198
+ Make sure the MCP process (`node …/dist/mcp-server/index.js`) runs in a foreground TTY with access to the macOS security framework. Running inside some sandboxed environments may prevent Touch ID. On Windows and Linux, biometric prompts are not used — payments are server-verified.
190
199
 
191
200
  **"Not logged in" after `visa-cli login`**
192
201
  Restart the MCP server after logging in — your MCP client needs to reconnect to pick up the new session.