Quick start with MONA Cloud

What do you need for the first five minutes?

An email address, your application repository and an AI tool are enough to start learning the flow. Five minutes does not include payment processing or a complete production deployment.

Open the console, register with MONA Pass and follow account verification. Use the wallet for VietQR top-ups; check the recipient and amount before paying. The September 4 snapshot reports a merchant configuration blocker, so do not pay without a valid QR.

How do you connect your agent?

npx monacloud init
npx -y monacloud-mcp login

Use the MCP setup, read prices with cloud_prices and create a simulated resource with cloud_vps_create. CLI monacloud 0.3.1 also provides deploy for public Git repositories; see the app example below.

How do you test with curl?

Set your token locally, never in chat. The sandbox header keeps this request simulated.

export MONACLOUD_API="https://api.monacloud.vn"
export MONACLOUD_TOKEN="<your-token>"

curl -sS -X POST "$MONACLOUD_API/api/lxc" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN" \
  -H "X-Vibecloud-Sandbox: 1" \
  -H "Content-Type: application/json" \
  -d '{"app_name":"app-demo","cpu":1,"ram_gb":1,"disk_gb":10}'

export JOB_ID="<id-tra-ve-khi-tao>"
curl -sS "$MONACLOUD_API/api/jobs/$JOB_ID" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN"

Replace the example job ID with the returned id. Sandbox finishes at done; real provisioning finishes at succeeded. Read result.service_id and inspect the service before revealing credentials.

When can you create real resources?

Read pricing and confirm the wallet balance. After approval, remove X-Vibecloud-Sandbox: 1 from the create request; it now creates billable infrastructure.

For a self-managed VPS, use the separate credentials endpoint with X-Confirm: reveal, deploy over SSH and test the real URL. For public Git apps, use /api/apps as shown below. Never SSH to sandbox addresses in 10.99.x.x.

How do you deploy a public Git repository?

Use CLI monacloud 0.3.1 with MCP monacloud-mcp 0.3.2:

npx monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile --sandbox
npx monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile

The first command simulates deployment; the second asks for cost approval. Alternatively use MCP cloud_app_create or POST /api/apps. The host is billed hourly or monthly; apps have no extra charge. Sample HTTPS URL uses Let’s Encrypt. Deleting and recreating the sample on an existing host took 31 seconds. Private repositories are being opened through GitHub App. See the full walkthrough.

Deploy my public repository with cloud_app_create. Inspect cloud_app_list, cloud_app_host_list, cloud_plan_list, cloud_prices and cloud_balance. Simulate a new host with sandbox=true, report the cost and wait for approval before a real deploy. Poll the job, inspect cloud_app_get/cloud_app_logs and test HTTPS. Keep secrets out of chat.