A zero-dependency command-line client for AI agents, server automations and reseller systems. It uses the Avola API key created in your own account and returns predictable JSON for every command.
curl -fsSL https://avola.uk/agent/avola-agent.mjs \ -o avola-agent.mjs node avola-agent.mjs version
The CLI has no package dependencies and does not modify your system.
export AVOLA_API_KEY="avola_live_YOUR_KEY" node avola-agent.mjs doctor
Keep the key secret. Use an environment secret or secret manager. Do not place it in prompts, browser code or repositories.
| Command | Purpose |
|---|---|
services --search youtube | Read and filter the current service catalog. |
balance | Read the linked Avola account balance. |
order --service ID --link URL --request-id ID | Place an order. Use a unique request ID to prevent duplicate submissions. |
status ORDER_ID [ORDER_ID ...] | Read up to 100 order statuses. |
doctor | Verify the key, API connection, catalog and balance access. |
Every successful result is JSON on stdout. Every error is JSON on stderr with a non-zero exit code, so agents can reliably branch, retry or stop.
node avola-agent.mjs services --category "X / Twitter" node avola-agent.mjs status AVO20260714ABCD
The key can access only its linked Avola balance and orders. Responses do not expose supplier identities, supplier IDs, supplier rates, internal costs, credentials or admin notes.