agenzo-cli

The command-line entry point to the Agenzo platform — the standard interface Agents use to call it.

CLIs · Conventions · Commands · Authentication · Getting started · For AI Agents

agenzo-cli is the set of command-line tools for integrating with the Agenzo platform — the standard way developers and AI Agents manage payment methods, payment tokens, and merchant fulfillment.

CLIs

CLI	Package	Version	Binary	Auth	Status
admin-cli	@agenzo/admin-cli		agenzo-admin-cli	Bearer token	Implemented
token-cli	@agenzo/token-cli		agenzo-token-cli	API key	Implemented
merchant-cli	@agenzo/merchant-cli		agenzo-merchant-cli	API key	Implemented

• admin-cli — control plane: auth / config / orgs / developers / keys / accounts.
• token-cli — payment-methods (add payment method + 3DS) and payment-tokens (VCN / Network Token / X402).
• merchant-cli — merchant fulfillment: services (discover capabilities) and ride-elife (ride-hailing, the capability available today).

Conventions

• Output defaults to --format table; Agents and scripts pass --format json (or set AGENZO_FORMAT=json). In json mode stdout carries exactly one payload value — logs, prompts, and errors go to stderr.
• Every server-side write accepts --idempotency-key (caller-supplied; the CLI never auto-generates one). It is forwarded verbatim as the Idempotency-Key header.
• Secrets (Bearer tokens, the one-time API key) never touch stdout.
• Exit codes: 0 success · 1 business error (4xx) · 2 CLI below the required minimum version · 3 auth failure · 4 upstream / 5xx · 5 user cancel.

Command matrix

admin-cli (control plane / Bearer token)

Noun	Verbs
auth	login / logout
config	set-host / show / reset-host
orgs	get / list / switch / update
developers	create / list / get / update
keys	create / list / get / rotate / disable
accounts	get

token-cli (runtime plane / API key)

Noun	Verbs
payment-methods	add / list / get / disable
payment-tokens	create / list / get / revoke

merchant-cli (runtime plane / API key)

Noun	Verbs
ride-elife	quote / book / get / cancel / list-orders

Authentication

Plane	CLI	Auth
Control plane	agenzo-admin-cli	Bearer token (via auth login)
Runtime plane	agenzo-token-cli, agenzo-merchant-cli	API key (--api-key)

The default API host is https://agent.everonet.com (production). To use the test environment, run agenzo-admin-cli config set-host https://agent-dev.agenzo.com.

Getting started

Requires Node.js 22+. Install the CLIs from npm:

npm install -g @agenzo/admin-cli @agenzo/token-cli @agenzo/merchant-cli

Then sign in, create a developer, and mint an API key — after which the runtime CLIs work with --api-key:

agenzo-admin-cli auth login --email you@example.com               # sign in (magic link)
agenzo-admin-cli developers create --developer-name "my-bot" \
  --developer-email you@example.com --idempotency-key <key>
agenzo-admin-cli keys create --developer-id <dev_id> \
  --key-name "Prod Key" --scope token,merchant --idempotency-key <key>
# the one-time key is shown once — save it, then:
agenzo-token-cli payment-methods list --api-key <key>

See SKILL.md and the per-CLI guides below for the full onboarding flow and every command.

For AI Agents

Load SKILL.md into the agent context. It covers the end-to-end onboarding flow, the shared conventions, and links to the per-CLI guides:

• doc/admin-cli.md
• doc/token-cli.md
• doc/merchant-cli.md