Quick Start
Get up and running in 60 seconds.
npm install -g agenzo-token-cliInstall the CLI globally
agenzo-token-cli loginSign in with a magic link
agenzo-token-cli developers createCreate a developer identity
agenzo-token-cli keys createGenerate an API key (shown once)
agenzo-token-cli payment-methods addAdd a credit card with 3DS
agenzo-token-cli payment-tokens create --type vcn --amount 5000Issue a $50 virtual Visa card
agenzo-token-cli payment-tokens create --type network-tokenGet a network token + cryptogram
agenzo-token-cli payment-tokens create --type x402 --pay-to 0x... --amount 1000000Sign an x402 payment (1 USDC)
Full reference below β
Installation
Requires Node.js 18+. After installation, the `agenzo-token-cli` command is available globally.
added 42 packages in 3s
Authentication
Login
Sign in via magic link. Enter your email, then click the link in your inbox. If the email is not registered, you'll be prompted to create a new organization.
? Email: user@acme.com βΉ Magic link sent to user@acme.com β Waiting for verification... β Logged in as Acme Corp (org_01HZ...) Access token expires in 8 hours
Logout
Sign out and remove local credentials for the current organization.
β Logged out from Acme Corp Local credentials removed
Configuration
Set API host
Override the API host for local development or custom deployments. Default: https://agenzo-token.everonet.com
β API host updated Host http://localhost:3000
Show configuration
Display the current CLI configuration including API host, API path, and active organization.
API Host https://agenzo-token.everonet.com API Path /api/v3/agent-pay Active Org org_01HZ... (Acme Corp)
Organizations
View current organization
Display the name, ID, email, status, and timestamps of your current organization.
ID org_01HZ... Name Acme Corp Email admin@acme.com Status ACTIVE Created 2026-01-15 10:30:00 Updated 2026-04-20 14:22:00
Update organization
Update organization name (takes effect immediately) or email (requires verification via magic link).
β Organization updated Name New Name
βΉ Verification email sent to new@example.com Please click the link to confirm the email change
List organizations
List all locally logged-in organizations. The active one is marked with *.
ID Name Email Status * org_01HZ... Acme Corp admin@acme.com ACTIVE org_02AB... Beta Inc hello@beta.io ACTIVE
Switch organization
Switch the active organization. The target org must already be logged in locally.
β Switched to Beta Inc (org_02AB...)
Developers
Create a developer
Create a developer identity. You'll be prompted for a name and email, or pass them as flags: --name, --email.
? Developer name: My Agent ? Developer email: agent@acme.com β Developer created ID dev_01HZ... Name My Agent Email agent@acme.com Status ACTIVE
List developers
List all developers under the current organization.
ID Name Email Status dev_01HZ... My Agent agent@acme.com ACTIVE dev_02AB... Bot Alpha bot@acme.com ACTIVE
Get developer details
Show full details for a specific developer.
ID dev_01HZ... Name My Agent Email agent@acme.com Status ACTIVE Created 2026-02-10 09:15:00 Updated 2026-04-18 11:30:00
Update a developer
Update a developer's name or email.
? New name (leave blank to skip): Agent v2 β Developer updated Name Agent v2
API Keys
Create an API key
Generate an API key for a developer. The full key is shown only once β save it immediately. Flags: --developer, --name.
? Developer ID: dev_01HZ... ? Key name: production β API key created ID key_01HZ... Developer dev_01HZ... Name production Prefix dev_key_live_a1b2... Status ACTIVE β Save this key now. You will not see it again. Key dev_key_live_a1b2c3d4e5f6g7h8i9j0...
List API keys
List all API keys for a developer. Full key values are never shown.
ID Developer Name Prefix Status Last Used key_01HZ... dev_01HZ... production dev_key_live_a1b2... ACTIVE 2026-04-22 16:00 key_02AB... dev_01HZ... staging dev_key_live_x9y8... ACTIVE 2026-04-21 09:30
Get API key details
Show details for a specific API key (prefix, status, last used).
ID key_01HZ... Developer dev_01HZ... Name production Prefix dev_key_live_a1b2... Status ACTIVE Created 2026-03-01 08:00:00 Last Used 2026-04-22 16:00:00
Rotate an API key
Generate a new secret for an existing key. The old secret is immediately invalidated.
β API key rotated Developer dev_01HZ... Rotated 2026-04-22 17:00:00 β Save this key now. You will not see it again. Key dev_key_live_n3w5ecr3tk3y...
Disable an API key
Permanently disable an API key.
β API key disabled Developer dev_01HZ... Disabled 2026-04-22 17:05:00
Payment Methods
All payment-methods commands require an API key (--key flag or interactive prompt).
Add a payment method
Add a credit card. You'll be prompted for card number, expiry (MMYY), and CVV (masked input). After submission, complete 3DS verification via the email link. Flags: --key, --type (default: card), --email, --member.
? API Key: dev_key_live_a1b2... ? Payment type: card ? Email: user@acme.com ? Card number: 4242424242424242 ? Expiry (MMYY): 1226 ? CVV: *** β Payment method created (pending verification) ID pm_01HZ... Status PENDING Magic Link mlt_01HZ... Expires 2026-04-22 17:20:00 βΉ Check your email to complete 3DS verification
List payment methods
List all payment methods. Optionally filter by member.
ID Brand First Six Last Four Status pm_01HZ... Visa 424242 4242 ACTIVE pm_02AB... Mastercard 512345 6789 PENDING
Get payment method details
Show details for a payment method. Use this to poll for 3DS verification status (PENDING β ACTIVE or FAILED).
ID pm_01HZ... Type card Brand Visa First Six 424242 Last Four 4242 Exp 12/26 Status ACTIVE Member member_01 Created 2026-04-22 17:10:00
Disable a payment method
Disable a payment method and cascade-revoke all active payment tokens under it.
β Payment method disabled ID pm_01HZ... Tokens revoked: 3
Payment Tokens
All payment-tokens commands require an API key (--key flag or interactive prompt).
Create a VCN (Virtual Card)
Issue a one-time virtual Visa card. Amount is in cents (1β50000, i.e. $0.01β$500.00). Flags: --key, --payment-method, --member, --currency (default: USD).
β VCN created Token ID ptk_01HZ... Card 4242 **** **** 1234 Expiry 12/26 CVV *** Limit $50.00 Balance $50.00 Currency USD Status ACTIVE
Create a Network Token
Get a Visa/Mastercard network token with a one-time cryptogram. Flags: --key, --payment-method, --member.
β Network Token created Token ID ptk_01HZ... Brand Visa First Six 400000 Last Four 1234 ECI 05 Cryptogram AgAAAAAABk4DFkZGJhY2... Expiry 12/26 Value 4000001234567890 Status ACTIVE
Create an X402 Signature
Sign an EIP-712 payment backed by a credit card. Flags: --key, --payment-method, --member, --pay-to, --amount (USDC smallest unit), --nonce, --network (default: base), --deadline (Unix timestamp).
β X402 signature created Token ID ptk_01HZ... Pay To 0xabc...def Amount 1.000000 USDC Network base Deadline 2026-04-23 00:00:00 Signature eyJhbGciOiJFUzI1NiIs... Status ACTIVE βΉ Use the signature value in your X-PAYMENT header
List payment tokens
List all payment tokens. Optionally filter by --type (vcn, network-token, x402) and --member.
Token ID Type Status Member Summary ptk_01HZ... vcn ACTIVE member_01 **** 1234 | $50.00 ptk_02AB... network_token ACTIVE member_01 Visa | **** 7890 ptk_03CD... x402 CONFIRMED member_02 1.00 USDC | base
Get payment token details
Show full details for a payment token. Output format varies by token type.
Token ID ptk_01HZ... Type vcn Status ACTIVE Payment Method pm_01HZ... Member member_01 Created 2026-04-22 17:30:00 --- VCN Details --- Card **** 1234 Expiry 12/26 Limit $50.00 Balance $45.50 Currency USD
Revoke a payment token
Revoke an active payment token. For VCN: closes the card and settles with Evo. For X402: marks as revoked. Cannot revoke tokens already in a terminal state.
β Payment token revoked Token ID ptk_01HZ... Status REVOKED Revoked 2026-04-22 18:00:00
Global Options
--help, -hβ Show help for any command--version, -vβ Show CLI version--verboseβ Show detailed logs on error--key <api_key>β API key for runtime commands (payment-methods, payment-tokens)