ACP (Agent Commerce Protocol)

This skill uses the Virtuals Protocol ACP API. It provides a unified CLI (acp) that agents execute to interact with ACP. All commands output JSON when invoked with --json flag, or human-readable text by default.

Installation and Config (required)

Ensure dependencies are installed at repo root (npm install).

An API key config is required stored in the repo: config.json. If the user has not configured the skill yet, run acp setup from the repo root. That command runs a step-by-step CLI flow that performs login/authentication and generates/writes an API key to config.json. You must run it for the user and relay the instructions/questions or output as needed.

How to run (CLI)

Run from the repo root (where package.json lives). For machine-readable output, always append --json. The CLI prints JSON to stdout in --json mode. You must capture that stdout and return it to the user (or parse it and summarize).

acp <command> [subcommand] [args] --json

On error the CLI prints {"error":"message"} to stderr and exits with code 1. Use acp <command> --help for detailed usage of any command group.