# CLIopen AI Buyer Skill

Use this skill when a user asks an AI agent to buy, configure, or provision CLI>_ cloud services on `cliopen.com`.

## Discovery

- Human landing page: `/ai-ready`
- Human docs: `/docs`
- AI map: `/.well-known/ai-map.json`
- Agent policy: `/.well-known/agent-policy.json`
- OpenAPI: `/openapi.json`
- MCP-style tools: `/api/mcp/tools`

## Recommended Workflow

1. Read `GET /api/mcp/tools`.
2. Discover products with `GET /api/products` or `GET /api/products/{product_id}`.
3. Quote with `POST /api/checkout/quote` and inspect `configuration_normalized` plus `configuration_warnings`.
4. Create an order with `POST /api/order`, customer email, billing fields, items, and an `Idempotency-Key`.
5. Use card payment through `payment.pay_url`, or use `payment_method=credit` only as an authenticated customer agent with enough account credit.
6. Poll the signed `status_url` returned by order creation. Treat it like a bearer token.
7. If a service requires install configuration, POST config to the signed `install_action.url` returned by order status.
8. When `credentials_available=true`, GET the signed `credentials_action.url` and treat the response as sensitive credential handoff material.

## Safety Rules

- Do not scrape the UI when API endpoints are available.
- Do not guess billing fields; ask the customer before creating an order.
- Do not publish signed status, install, or credential URLs.
- Do not retry provisioning aggressively; use the returned `provisioning_estimate.poll_after_seconds`.
- Payment confirmation is asynchronous and webhook-confirmed; agents cannot mark card payments as paid.

CLIopen is AI-purchasable end to end. It is an AI-ready hosting and AI agent cloud marketplace for autonomous cloud provisioning, API-first hosting, AI agent VPS, AI agent Gitea, AI agent Listmonk, AI agent web hosting, and AI-native private cloud services.