monacloud-mcp 0.1.2 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # monacloud-mcp
 
-`monacloud-mcp` là MCP hợp nhất của MONA Cloud: cài một lần, đăng nhập một MONA Pass và dùng chung ví VND để quản lý MONA Cloud, provision VibeCloud, tích hợp MONA Pay và đọc catalog MONA Agent ngay trong Claude Code, Codex hoặc Cursor.
+`monacloud-mcp` là MCP hợp nhất của MONA Cloud: cài một lần, đăng nhập một MONA Pass và dùng chung ví VND để quản lý tài khoản, chạy app/VPS, tích hợp MONA Pay và đọc catalog MONA Agent ngay trong Claude Code, Codex hoặc Cursor.
 
 Human chỉ cần đăng ký, nạp tiền và cung cấp OTP/KYC khi bắt buộc. Các bước tạo tài nguyên, đọc trạng thái, cấu hình webhook, test và deploy được thiết kế để AI agent làm qua MCP.
 
@@ -8,7 +8,7 @@ Human chỉ cần đăng ký, nạp tiền và cung cấp OTP/KYC khi bắt bu
 
 - Node.js 20 trở lên.
 - Một MONA Pass có quyền dùng client `monacloud-mcp`.
-- MONA Pass, Billing, VibeCloud và MONA Pay đã được cấu hình theo môi trường triển khai.
+- MONA Pass, Billing, compute MONA Cloud và MONA Pay đã được cấu hình theo môi trường triển khai.
 
 ## Cài và đăng nhập
 
@@ -69,7 +69,7 @@ Tên tool dùng `snake_case` để giữ tương thích với prompt MONA Pay c
 | `cloud_ledger` | Ledger nạp/trừ/hoàn tiền có cursor |
 | `cloud_topup(amount)` | Tạo yêu cầu nạp, trả `qr_data_url` và hướng dẫn VietQR |
 | `cloud_usage(period)` | Usage theo tháng, có thể lọc sản phẩm |
-| `cloud_services` | Gom service VibeCloud, VA và webhook MONA Pay |
+| `cloud_services` | Gom VPS/database, VA và webhook MONA Pay |
 | `cloud_budget_set` / `cloud_budget_get` | Đặt và đọc budget theo product/project/token |
 | `cloud_token_limit` | Đặt spend limit cho PAT/token |
 | `cloud_open_console` | Trả URL console chung |
@@ -86,36 +86,50 @@ Tên tool dùng `snake_case` để giữ tương thích với prompt MONA Pay c
 
 Các tên cũ như `monapay_create_qr`, `monapay_link_bank_start`, `monapay_create_webhook` được giữ nguyên. `monapay_link` là adapter chuyển tiếp: đổi MONA Pass thành `client_id/client_secret` rồi cache kín ở `~/.config/monacloud/links.json`. Adapter này sẽ được bỏ khi MONA Pay nhận JWT MONA Pass trực tiếp.
 
-### VibeCloud
+### Compute MONA Cloud
 
 | Tool | Công dụng |
 |---|---|
-| `vibecloud_link` | Xác nhận direct MONA Pass; chỉ đổi sang `vc_live_*` nếu upstream còn ở chế độ cũ |
-| `vibecloud_create_vps` | Tạo LXC theo `package_slug` hoặc CPU/RAM/đĩa |
-| `vibecloud_create_database` | Tạo MongoDB, PostgreSQL hoặc MySQL |
-| `vibecloud_job_status` | Poll job tới trạng thái cuối, có timeout |
-| `vibecloud_list_services` | Liệt kê VPS/database |
-| `vibecloud_start` / `vibecloud_stop` / `vibecloud_rebuild` | Quản lý vòng đời service |
-| `vibecloud_prices` / `vibecloud_packages` | Đơn giá và gói cấu hình |
-| `vibecloud_agent_deploy` | Stub có cấu trúc cho runtime MONA Agent wave sau |
+| `cloud_link` | Xác nhận direct MONA Pass; chỉ đổi sang `vc_live_*` nếu upstream còn ở chế độ cũ |
+| `cloud_vps_create` | Tạo LXC theo `package_slug` hoặc CPU/RAM/đĩa |
+| `cloud_db_create` | Tạo MongoDB, PostgreSQL hoặc MySQL |
+| `cloud_job_status` | Poll job tới trạng thái cuối, có timeout |
+| `cloud_services_list` | Liệt kê VPS/database |
+| `cloud_service_start` / `cloud_service_stop` / `cloud_service_rebuild` | Quản lý vòng đời service |
+| `cloud_prices` / `cloud_packages` | Đơn giá và gói cấu hình |
+| `cloud_agent_deploy` | Stub có cấu trúc cho runtime MONA Agent wave sau |
 
-`vibecloud_stop` không bị chặn bởi số dư để người dùng luôn có thể hạn chế chi phí. Những lệnh tạo/start/rebuild đọc `GET /v1/balance` trước khi gọi VibeCloud.
+`cloud_service_stop` không bị chặn bởi số dư để người dùng luôn có thể hạn chế chi phí. Những lệnh tạo/start/rebuild thật đọc `GET /v1/balance` trước khi gọi compute MONA Cloud.
+
+## Thử 0đ bằng sandbox
+
+Truyền `sandbox: true` cho `cloud_vps_create`, `cloud_db_create`, `cloud_service_start`, `cloud_service_rebuild` hoặc `cloud_agent_deploy` để thử luồng mà không cần số dư ví. Có thể bật mặc định cho cả MCP process bằng `MONACLOUD_SANDBOX=1`; các alias `vibecloud_*` có cùng hành vi.
+
+Ở chế độ này MCP bỏ qua `GET /v1/balance`, tự gửi `X-Vibecloud-Sandbox: 1` đến compute API và bảo đảm response có `sandbox: true`. Ví dụ:
+
+```text
+cloud_vps_create({ app_name: "shop-demo", package_slug: "standard-2", sandbox: true })
+cloud_job_status({ job_id: "...", sandbox: true })
+cloud_services_list({ sandbox: true })
+```
+
+`cloud_job_status` tự tìm job sandbox theo ID mà không cần header. `cloud_services_list({ sandbox: true })` dùng khả năng `include_sandbox` của API để gộp service thật và sandbox. Sandbox không tạo hạ tầng thật, không trừ tiền và có thể bị dọn theo TTL của compute API. `cloud_agent_deploy` vẫn là stub cho đến khi runtime MONA Agent được phát hành, nhưng response sandbox được đánh dấu nhất quán.
 
 ### MONA Agent
 
 - `agent_templates_list`: ưu tiên catalog local tại `~/monacloud/templates`, sau đó URL cấu hình, cuối cùng catalog wave 1 tích hợp.
 - `agent_templates_get(template)`: trả các file `README.md`, `AGENTS.md`, `tools.json`, `deploy.md`, `CHECKLIST.md` và skill text.
-- `agent_deploy(template)`: dùng cùng slot runtime với `vibecloud_agent_deploy`; hiện trả `agent_runtime_pending` theo yêu cầu stub của wave này.
+- `agent_deploy(template)`: dùng cùng slot runtime với `cloud_agent_deploy`; hiện trả `agent_runtime_pending` theo yêu cầu stub của wave này.
 
 ## Resource và prompt
 
 - `monacloud://llms`: mô tả máy đọc của toàn stack MONA Cloud.
-- `monacloud://status`: health tổng hợp MONA Pass, Billing, VibeCloud và MONA Pay.
+- `monacloud://status`: health tổng hợp MONA Pass, Billing, compute MONA Cloud và MONA Pay.
 - Prompt `dung-app-ban-hang-monacloud`: chuỗi VPS → database → VA/QR → webhook → deploy, chỉ dừng để hỏi nạp tiền hoặc OTP bắt buộc.
 
 ## Spend guard và lỗi cho AI
 
-Trước lệnh VibeCloud có thể phát sinh tiền, MCP đọc ví chung. HTTP `402 insufficient_funds` và `402 budget_exceeded` được chuẩn hoá thành text JSON:
+Trước lệnh compute MONA Cloud thật có thể phát sinh tiền, MCP đọc ví chung. Sandbox bỏ qua bước này vì chi phí 0đ. HTTP `402 insufficient_funds` và `402 budget_exceeded` được chuẩn hoá thành text JSON:
 
 ```json
 {
@@ -136,9 +150,9 @@ Người dùng nói:
 
 Agent thực hiện:
 
-1. `cloud_whoami` → `cloud_balance` → `vibecloud_packages`.
+1. `cloud_whoami` → `cloud_balance` → `cloud_packages`.
 2. Nếu ví thiếu: `cloud_topup(200000)`, đưa QR cho người dùng và chờ xác nhận.
-3. `vibecloud_create_vps` + `vibecloud_create_database`, sau đó `vibecloud_job_status` cho từng job.
+3. `cloud_vps_create` + `cloud_db_create`, sau đó `cloud_job_status` cho từng job.
 4. `monapay_link` nếu adapter chuyển tiếp chưa có credential; `monapay_whoami` để kiểm tra VA.
 5. Nếu chưa có VA: bắt đầu nối ACB, hỏi người dùng OTP đúng hai điểm bắt buộc, không tự đoán.
 6. Agent viết endpoint webhook HMAC/idempotent, gọi `monapay_create_webhook`, `monapay_test_webhook`, `monapay_webhook_logs`.
@@ -153,16 +167,17 @@ Chi tiết dành riêng cho agent: [`docs/ai-agent.md`](docs/ai-agent.md).
 | `MONACLOUD_ISSUER` | `https://pass.monacloud.vn/realms/mona` | OIDC issuer |
 | `MONACLOUD_BILLING_URL` | `https://billing.monacloud.vn` | Billing/ví API |
 | `MONAPAY_API` | `https://api.monapay.vn` | MONA Pay API |
-| `VIBECLOUD_API` | `https://api.vibecloud.vn` | VibeCloud API |
+| `MONACLOUD_API` | `https://api.monacloud.vn` | Compute API của MONA Cloud |
 | `MONACLOUD_CONSOLE_URL` | `https://monacloud.vn/console` | URL trả cho bước human |
 | `MONACLOUD_TOKEN` | — | PAT/access token ưu tiên token store |
+| `MONACLOUD_SANDBOX` | — | Đặt `1` để mọi lệnh compute hỗ trợ sandbox chạy thử 0đ, không cần ví |
 | `MONACLOUD_CONFIG_DIR` | `~/.config/monacloud` | Token và link cache |
 | `MONACLOUD_TEMPLATES_DIR` | `~/monacloud/templates` | Catalog agent local |
 | `MONACLOUD_TEMPLATES_URL` | — | Catalog JSON từ xa, chỉ dùng khi local không có |
 | `MONAPAY_LINK_PATH` | `/api/v1/client/oauth/mona-id/link` | Endpoint adapter chuyển tiếp |
 | `VIBECLOUD_LINK_PATH` | `/api/auth/monaid/link` | Endpoint adapter cũ, chỉ gọi khi direct MONA Pass bị từ chối |
 
-`MONAPAY_CLIENT_ID` + `MONAPAY_CLIENT_SECRET` và `VIBECLOUD_API_TOKEN` chỉ là đường tương thích trong giai đoạn migrate. `logout` xoá cả token store lẫn linked credential cache; luồng đích là một MONA Pass.
+`VIBECLOUD_API`/`VIBECLOUD_API_URL`, `MONAPAY_CLIENT_ID` + `MONAPAY_CLIENT_SECRET` và `VIBECLOUD_API_TOKEN` chỉ là đường tương thích trong giai đoạn migrate. `logout` xoá cả token store lẫn linked credential cache; luồng đích là một MONA Pass.
 
 ## Phát triển offline
 

package/STATUS.md

@@ -1,16 +1,17 @@
-# STATUS — monacloud-mcp 0.1.0
+# STATUS — monacloud-mcp 0.2.1
 
-Updated: 2026-09-03 (Asia/Ho_Chi_Minh)
+Updated: 2026-09-04 (Asia/Ho_Chi_Minh)
 
 ## Hoàn thành
 
-- [x] Package Node 20 + TypeScript, ESM, stdio MCP; bin `monacloud-mcp`, version `0.1.0`.
+- [x] Package Node 20 + TypeScript, ESM, stdio MCP; bin `monacloud-mcp`, version `0.2.1`.
 - [x] OAuth device flow client `monacloud-mcp`, scope `offline_access`, token store private `0600`, refresh tự động; CLI `login`, `logout`, `whoami`.
 - [x] 10 tool `cloud_*`: identity, balance, ledger, topup VietQR, usage, services aggregation, budget, token limit và console URL.
 - [x] Import package `monapay-mcp` và re-export toàn bộ tool, không copy code. Dependency offline tại lần verify cuối là 0.5.5/47 tool (superset 24 tool yêu cầu); cộng `monapay_link` chuyển tiếp.
-- [x] 11 tool `vibecloud_*`: link, VPS, database, job poll, list, start/stop/rebuild, prices, packages và agent-deploy stub.
-- [x] 3 tool `agent_*`: list/get catalog local/remote/built-in và deploy qua cùng stub VibeCloud.
-- [x] Spend guard đọc billing balance trước create/start/rebuild; chuẩn hoá `402 insufficient_funds|budget_exceeded` thành `{code,message,next_step,request_id?}`. Stop luôn được phép.
+- [x] 11 tool compute tên mới `cloud_*`: link, VPS, database, job poll, list, start/stop/rebuild, prices, packages và agent-deploy stub.
+- [x] 11 alias kỹ thuật `vibecloud_*` vẫn gọi được cho client cũ, không xuất hiện trong README/hướng dẫn agent.
+- [x] 3 tool `agent_*`: list/get catalog local/remote/built-in và deploy qua cùng stub MONA Cloud.
+- [x] Spend guard đọc billing balance trước create/start/rebuild thật; `sandbox: true` hoặc `MONACLOUD_SANDBOX=1` bỏ qua Billing, gửi header compute và đánh dấu response. Stop luôn được phép.
 - [x] 2 resource đúng brief: `monacloud://llms`, `monacloud://status`.
 - [x] 1 prompt `dung-app-ban-hang-monacloud`: VPS → DB → VA/QR → webhook → deploy.
 - [x] Không log token; token và linked credential được lưu bằng atomic write, directory `0700`, file `0600`.
@@ -18,7 +19,7 @@ Updated: 2026-09-03 (Asia/Ho_Chi_Minh)
 - [x] `docs/ai-agent.md` mô tả zero-dashboard flow, OTP boundaries, idempotency, sandbox, deploy và definition of done.
 - [x] Test offline: stdio process thật + `tools/list` + `cloud_whoami` token giả; spend guard; 402; MONA Pay re-export; catalog/path validation.
 
-Tổng tool với dependency được chuẩn bị trong handoff tại lần verify cuối: **72**.
+Tổng tool với dependency được chuẩn bị trong handoff tại lần verify cuối: **83** (gồm 11 alias tương thích).
 
 ## Gate đã chạy
 
@@ -27,7 +28,7 @@ $ node_modules/.bin/tsc -p tsconfig.json
 exit 0, không có diagnostic
 
 $ node --test
-tests 7, pass 7, fail 0
+tests 13, pass 13, fail 0
 ```
 
 Không chạy `npm install`; toàn bộ build/test dùng `node_modules` có sẵn và không gọi Internet.
@@ -35,12 +36,19 @@ Không chạy `npm install`; toàn bộ build/test dùng `node_modules` có sẵ
 ## Boundary chuyển tiếp đã ghi rõ
 
 - `monapay_link` mặc định gọi `/api/v1/client/oauth/mona-id/link`; đổi bằng `MONAPAY_LINK_PATH` nếu upstream chốt path khác. Adapter cache client credential và sẽ bị bỏ khi MONA Pay nhận JWT trực tiếp.
-- `vibecloud_link` thử Bearer MONA Pass trực tiếp trước; chỉ khi upstream trả 401/403 mới gọi adapter `/api/auth/monaid/link` (đổi bằng `VIBECLOUD_LINK_PATH`). Tool nghiệp vụ luôn giữ nguyên tên.
-- `vibecloud_agent_deploy` và `agent_deploy` là stub được brief yêu cầu tới khi runtime MONA Agent được phát hành; response không báo thành công giả.
+- `cloud_link` thử Bearer MONA Pass trực tiếp trước; chỉ khi upstream trả 401/403 mới gọi adapter `/api/auth/monaid/link` (đổi bằng `VIBECLOUD_LINK_PATH`). Alias kỹ thuật cũ vẫn hoạt động.
+- `cloud_agent_deploy` và `agent_deploy` là stub được brief yêu cầu tới khi runtime MONA Agent được phát hành; response không báo thành công giả.
+- Compute API mặc định là `https://api.monacloud.vn`; `MONACLOUD_API` là env chính, `VIBECLOUD_API`/`VIBECLOUD_API_URL` vẫn được nhận để tương thích.
 - Chưa chạy smoke production vì phiên này offline và không được cấp token/endpoint production. Unit/integration local đã phủ wire contract chính.
 
 CODEX DONE
 
+## Đổi tên compute VibeCloud → MONA Cloud (04/09)
+
+- Tên người đọc và 11 tool chính đã chuyển sang MONA Cloud / `cloud_*`; VibeCloud chỉ còn trong alias và định danh kỹ thuật tương thích.
+- Resource `monacloud://llms`, prompt dựng app, README và `docs/ai-agent.md` chỉ hướng dẫn tên mới.
+- Package, MCP server và binary version đồng bộ `0.2.1`; build và test được ghi ở gate mới bên trên.
+
 ## QC Claude (03/09 tối) — ZERO-DASHBOARD TEST LOCAL: PASS
 - Build tsc sạch · `node --test` 7/7 · stdio thật: **72 tool** (cloud 10 · monapay 48 · vibecloud 11 · agent 3), 2 resource, 1 prompt.
 - E2E thật với Keycloak local (`MONACLOUD_ISSUER=http://127.0.0.1:8180/realms/mona`) + billing (`MONACLOUD_BILLING_URL=http://127.0.0.1:8191`): `monacloud-mcp login` → mã thiết bị → đăng nhập + màn "Cấp quyền" của MONA ID → `token.json` 0600 → `cloud_whoami` (userinfo thật) → `cloud_balance` 0đ (ví JIT) → `cloud_ledger` → `cloud_budget_get`. **Một token, không chạm dashboard.** *(Log 03/09 giữ tên cũ; tên hiện tại: MONA Pass.)*

package/dist/clients.d.ts

@@ -20,11 +20,18 @@ export declare class CloudClients {
     budgetGet(): Promise<unknown>;
     tokenLimit(spendLimitVnd: number, period: string, tokenId?: string): Promise<unknown>;
     spendGuard(): Promise<JsonObject>;
+    sandboxEnabled(requested?: boolean): boolean;
     private vibecloudToken;
     vibecloud<T = unknown>(path: string, options?: {
         method?: string;
         body?: unknown;
+        query?: Record<string, string | number | undefined>;
+        headers?: Record<string, string>;
     }): Promise<T>;
+    guardedVibecloud(path: string, options?: {
+        method?: string;
+        body?: unknown;
+    }, requestedSandbox?: boolean): Promise<unknown>;
     vibecloudLink(): Promise<JsonObject>;
     monapayLink(): Promise<JsonObject>;
     prices(): Promise<unknown>;

package/dist/clients.js

@@ -69,6 +69,9 @@ export class CloudClients {
         }
         return current;
     }
+    sandboxEnabled(requested = false) {
+        return requested || this.auth.env.MONACLOUD_SANDBOX === '1';
+    }
     async vibecloudToken() {
         if (this.auth.env.VIBECLOUD_API_TOKEN)
             return this.auth.env.VIBECLOUD_API_TOKEN;
@@ -86,9 +89,19 @@ export class CloudClients {
             fetchImpl: this.fetchImpl,
         });
     }
+    async guardedVibecloud(path, options = {}, requestedSandbox = false) {
+        const sandbox = this.sandboxEnabled(requestedSandbox);
+        if (!sandbox)
+            await this.spendGuard();
+        const result = await this.vibecloud(path, {
+            ...options,
+            ...(sandbox ? { headers: { 'X-Vibecloud-Sandbox': '1' } } : {}),
+        });
+        return sandbox ? { ...asObject(result), sandbox: true } : result;
+    }
     async vibecloudLink() {
         if (this.auth.env.VIBECLOUD_API_TOKEN) {
-            return { linked: true, product: 'vibecloud', mode: 'legacy_env', next_step: 'Dùng các tool vibecloud_*.' };
+            return { linked: true, product: 'vibecloud', mode: 'legacy_env', next_step: 'Dùng các tool cloud_*.' };
         }
         const monaIdToken = await this.auth.accessToken();
         try {
@@ -100,7 +113,7 @@ export class CloudClients {
                 linked: true,
                 product: 'vibecloud',
                 mode: 'direct_mona_id',
-                next_step: 'VibeCloud đã nhận MONA Pass trực tiếp; không cần cache vc_live token.',
+                next_step: 'MONA Cloud đã nhận MONA Pass trực tiếp; không cần cache vc_live token.',
             };
         }
         catch (error) {
@@ -117,7 +130,7 @@ export class CloudClients {
         const data = asObject(unwrapData(value));
         const token = pickString([data, root], ['api_token', 'access_token', 'token', 'vibecloud_token']);
         if (!token) {
-            throw new CloudError('invalid_link_response', 'VibeCloud không trả automation token sau khi liên kết.', 'Kiểm tra endpoint chuyển tiếp MONA Pass của VibeCloud rồi gọi lại vibecloud_link.');
+            throw new CloudError('invalid_link_response', 'MONA Cloud không trả automation token sau khi liên kết.', 'Kiểm tra endpoint chuyển tiếp MONA Pass của MONA Cloud rồi gọi lại cloud_link.');
         }
         const expiresIn = Number(data.expires_in ?? root.expires_in);
         const links = await readLinks(this.config);
@@ -127,7 +140,7 @@ export class CloudClients {
             linked_at: new Date().toISOString(),
         };
         await writeLinks(this.config, links);
-        return { linked: true, product: 'vibecloud', next_step: 'Dùng các tool vibecloud_* bằng cùng MONA Pass.' };
+        return { linked: true, product: 'vibecloud', next_step: 'Dùng các tool cloud_* bằng cùng MONA Pass.' };
     }
     async monapayLink() {
         const value = await requestJson(`${this.config.monapayApi}${this.config.monapayLinkPath}`, {

package/dist/config.js

@@ -8,7 +8,7 @@ export function readConfig(env = process.env) {
         issuer: cleanBaseUrl(env.MONACLOUD_ISSUER || 'https://pass.monacloud.vn/realms/mona'),
         billingUrl: cleanBaseUrl(env.MONACLOUD_BILLING_URL || 'https://billing.monacloud.vn'),
         monapayApi: cleanBaseUrl(env.MONAPAY_API || env.MONAPAY_BASE_URL || 'https://api.monapay.vn'),
-        vibecloudApi: cleanBaseUrl(env.VIBECLOUD_API || env.VIBECLOUD_API_URL || 'https://api.vibecloud.vn'),
+        vibecloudApi: cleanBaseUrl(env.MONACLOUD_API || env.VIBECLOUD_API || env.VIBECLOUD_API_URL || 'https://api.monacloud.vn'),
         consoleUrl: cleanBaseUrl(env.MONACLOUD_CONSOLE_URL || 'https://monacloud.vn/console'),
         clientId: env.MONACLOUD_CLIENT_ID || 'monacloud-mcp',
         scope: env.MONACLOUD_SCOPE || 'openid profile email product billing-api offline_access',

package/dist/index.js

@@ -22,7 +22,7 @@ async function main() {
         return;
     }
     if (command === '--version' || command === '-v') {
-        console.log('0.1.0');
+        console.log('0.2.1');
         return;
     }
     if (command === '--help' || command === '-h' || command === 'help') {

package/dist/server.js

@@ -8,8 +8,10 @@ import { errorResult, runTool, textResult, toAgentError } from './errors.js';
 import { requestJson, unwrapData } from './http.js';
 import { createMonaPayClient, importedMonaPayTools, normalizeImportedResult } from './monapay.js';
 import { TemplateCatalog } from './templates.js';
-const ENTITY = 'MONA Cloud là hệ công cụ cho vibecoder Việt Nam: một MONA Pass, một ví VND và một MCP để deploy VibeCloud, thu tiền MONA Pay và chạy các sản phẩm MONA.';
-const TERMINAL_JOBS = new Set(['succeeded', 'failed', 'cancelled']);
+const ENTITY = 'MONA Cloud là hệ công cụ cho vibecoder Việt Nam: một MONA Pass, một ví VND và một MCP để chạy app/VPS, thu tiền MONA Pay và dùng các sản phẩm MONA.';
+const TERMINAL_JOBS = new Set(['done', 'succeeded', 'failed', 'cancelled']);
+const SANDBOX_DESCRIPTION = 'sandbox=true: thử 0đ, không cần ví';
+const sandboxSchema = z.boolean().optional().describe(SANDBOX_DESCRIPTION);
 const asObject = (value) => (value && typeof value === 'object' ? value : {});
 function collection(value) {
     const data = unwrapData(value);
@@ -29,6 +31,7 @@ const sizingSchema = {
     cpu: z.number().int().min(1).max(16).optional(),
     ram_gb: z.number().int().min(1).max(64).optional(),
     disk_gb: z.number().int().min(10).max(1000).optional(),
+    sandbox: sandboxSchema,
 };
 const provisionSchema = z.object(sizingSchema).superRefine((value, context) => {
     const dimensions = [value.cpu, value.ram_gb, value.disk_gb];
@@ -41,28 +44,34 @@ const provisionSchema = z.object(sizingSchema).superRefine((value, context) => {
         context.addIssue({ code: 'custom', message: 'Cần package_slug hoặc đủ cpu, ram_gb và disk_gb.' });
     }
 });
-function agentRuntimeStub(template) {
+function agentRuntimeStub(template, sandbox = false) {
     return {
         status: 'not_available',
         code: 'agent_runtime_pending',
         template,
-        message: 'Runtime MONA Agent trên VibeCloud chưa được phát hành; tool này là slot wave kế tiếp theo brief.',
-        next_step: 'Dùng agent_templates_get để lấy nội dung template và triển khai thủ công, hoặc thử lại khi VibeCloud bật runtime agent.',
+        message: 'Runtime MONA Agent trên MONA Cloud chưa được phát hành; tool này là slot wave kế tiếp theo brief.',
+        next_step: 'Dùng agent_templates_get để lấy nội dung template và triển khai thủ công, hoặc thử lại khi MONA Cloud bật runtime agent.',
+        ...(sandbox ? { sandbox: true } : {}),
     };
 }
-async function pollJob(clients, jobId, wait, intervalSeconds, timeoutSeconds) {
+async function pollJob(clients, jobId, wait, intervalSeconds, timeoutSeconds, sandbox) {
     let result = await clients.vibecloud(`/api/jobs/${encodeURIComponent(jobId)}`);
     if (!wait)
-        return result;
+        return sandbox ? { ...asObject(result), sandbox: true } : result;
     const deadline = Date.now() + timeoutSeconds * 1000;
     while (!TERMINAL_JOBS.has(String(asObject(result).status || '')) && Date.now() < deadline) {
         await delay(intervalSeconds * 1000);
         result = await clients.vibecloud(`/api/jobs/${encodeURIComponent(jobId)}`);
     }
     if (!TERMINAL_JOBS.has(String(asObject(result).status || ''))) {
-        return { ...asObject(result), polling: 'timeout', next_step: `Gọi lại vibecloud_job_status với job_id=${jobId}.` };
+        return {
+            ...asObject(result),
+            ...(sandbox ? { sandbox: true } : {}),
+            polling: 'timeout',
+            next_step: `Gọi lại cloud_job_status với job_id=${jobId}.`,
+        };
     }
-    return result;
+    return sandbox ? { ...asObject(result), sandbox: true } : result;
 }
 async function providerHealth(name, url, fetchImpl) {
     const started = Date.now();
@@ -81,7 +90,7 @@ export function createServer(dependencies = {}) {
     const auth = new AuthManager(config, env, fetchImpl);
     const clients = new CloudClients(config, auth, fetchImpl);
     const catalog = new TemplateCatalog(config, fetchImpl);
-    const server = new McpServer({ name: 'monacloud-mcp', version: '0.1.0' }, { instructions: `${ENTITY}\nDùng cloud_* cho tài khoản/ví, vibecloud_* cho hạ tầng, monapay_* cho thu tiền và agent_* cho catalog. Không bao giờ yêu cầu mật khẩu sản phẩm. Chỉ dừng hỏi người dùng khi cần nạp tiền, OTP ngân hàng hoặc KYC bắt buộc.` });
+    const server = new McpServer({ name: 'monacloud-mcp', version: '0.2.1' }, { instructions: `${ENTITY}\nDùng cloud_* cho tài khoản, ví và hạ tầng; monapay_* cho thu tiền; agent_* cho catalog. Không bao giờ yêu cầu mật khẩu sản phẩm. Chỉ dừng hỏi người dùng khi cần nạp tiền, OTP ngân hàng hoặc KYC bắt buộc.` });
     server.registerTool('cloud_whoami', {
         title: 'Tài khoản MONA Cloud',
         description: 'Xác minh MONA Pass hiện tại. / Return the current MONA Pass profile.',
@@ -119,7 +128,7 @@ export function createServer(dependencies = {}) {
     }, ({ period, product }) => runTool(() => clients.usage(period, product)));
     server.registerTool('cloud_services', {
         title: 'Mọi dịch vụ đang chạy',
-        description: 'Gom service VibeCloud cùng tài khoản ảo và webhook MONA Pay.',
+        description: 'Gom VPS/database MONA Cloud cùng tài khoản ảo và webhook MONA Pay.',
     }, () => runTool(async () => {
         const [vibecloud, monapay] = await Promise.all([
             clients.vibecloud('/api/services')
@@ -177,66 +186,129 @@ export function createServer(dependencies = {}) {
         title: 'Liên kết MONA Pay chuyển tiếp',
         description: 'Tạm đổi MONA Pass thành client credential MONA Pay và cache cục bộ; bỏ khi MONA Pay nhận JWT trực tiếp.',
     }, () => runTool(() => clients.monapayLink()));
+    server.registerTool('cloud_link', {
+        title: 'Liên kết MONA Cloud chuyển tiếp',
+        description: 'Xác nhận compute MONA Cloud nhận MONA Pass trực tiếp; chỉ đổi thành vc_live token khi upstream còn ở chế độ cũ.',
+    }, () => runTool(() => clients.vibecloudLink()));
     server.registerTool('vibecloud_link', {
-        title: 'Liên kết VibeCloud chuyển tiếp',
-        description: 'Xác nhận VibeCloud nhận MONA Pass trực tiếp; chỉ đổi thành vc_live token khi upstream còn ở chế độ cũ.',
+        title: 'Alias cũ của cloud_link',
+        description: 'Alias tương thích; dùng cloud_link cho tích hợp mới.',
     }, () => runTool(() => clients.vibecloudLink()));
+    server.registerTool('cloud_vps_create', {
+        title: 'Tạo VPS MONA Cloud',
+        description: `Kiểm tra ví chung rồi tạo LXC VPS; trả job_id để poll. ${SANDBOX_DESCRIPTION}.`,
+        inputSchema: provisionSchema,
+    }, (body) => runTool(async () => {
+        const { sandbox, ...payload } = body;
+        return clients.guardedVibecloud('/api/lxc', { method: 'POST', body: payload }, sandbox);
+    }));
     server.registerTool('vibecloud_create_vps', {
-        title: 'Tạo VPS VibeCloud',
-        description: 'Kiểm tra ví chung rồi tạo LXC VPS; trả job_id để poll.',
+        title: 'Alias cũ của cloud_vps_create',
+        description: `Alias tương thích; dùng cloud_vps_create cho tích hợp mới. ${SANDBOX_DESCRIPTION}.`,
         inputSchema: provisionSchema,
     }, (body) => runTool(async () => {
-        await clients.spendGuard();
-        return clients.vibecloud('/api/lxc', { method: 'POST', body });
+        const { sandbox, ...payload } = body;
+        return clients.guardedVibecloud('/api/lxc', { method: 'POST', body: payload }, sandbox);
+    }));
+    const databaseSchema = provisionSchema.extend({ engine: z.enum(['mongodb', 'postgresql', 'mysql']).default('mongodb') });
+    server.registerTool('cloud_db_create', {
+        title: 'Tạo database MONA Cloud',
+        description: `Kiểm tra ví chung rồi tạo MongoDB/PostgreSQL/MySQL; trả job_id để poll. ${SANDBOX_DESCRIPTION}.`,
+        inputSchema: databaseSchema,
+    }, (body) => runTool(async () => {
+        const { sandbox, ...payload } = body;
+        return clients.guardedVibecloud('/api/databases', { method: 'POST', body: payload }, sandbox);
     }));
     server.registerTool('vibecloud_create_database', {
-        title: 'Tạo database VibeCloud',
-        description: 'Kiểm tra ví chung rồi tạo MongoDB/PostgreSQL/MySQL; trả job_id để poll.',
-        inputSchema: provisionSchema.extend({ engine: z.enum(['mongodb', 'postgresql', 'mysql']).default('mongodb') }),
+        title: 'Alias cũ của cloud_db_create',
+        description: `Alias tương thích; dùng cloud_db_create cho tích hợp mới. ${SANDBOX_DESCRIPTION}.`,
+        inputSchema: databaseSchema,
     }, (body) => runTool(async () => {
-        await clients.spendGuard();
-        return clients.vibecloud('/api/databases', { method: 'POST', body });
+        const { sandbox, ...payload } = body;
+        return clients.guardedVibecloud('/api/databases', { method: 'POST', body: payload }, sandbox);
     }));
+    const jobStatusSchema = {
+        job_id: z.string().min(1),
+        wait: z.boolean().default(true),
+        interval_sec: z.number().int().min(1).max(30).default(3),
+        timeout_sec: z.number().int().min(1).max(600).default(180),
+        sandbox: sandboxSchema,
+    };
+    server.registerTool('cloud_job_status', {
+        title: 'Theo dõi job MONA Cloud',
+        description: 'Đọc job thật hoặc sandbox theo ID; API tự nhận diện sandbox nên không cần header.',
+        inputSchema: jobStatusSchema,
+    }, ({ job_id, wait, interval_sec, timeout_sec, sandbox }) => runTool(() => pollJob(clients, job_id, wait, interval_sec, timeout_sec, clients.sandboxEnabled(sandbox))));
     server.registerTool('vibecloud_job_status', {
-        title: 'Theo dõi job VibeCloud',
-        description: 'Đọc một job; mặc định poll tới succeeded/failed/cancelled hoặc timeout.',
-        inputSchema: {
-            job_id: z.string().min(1),
-            wait: z.boolean().default(true),
-            interval_sec: z.number().int().min(1).max(30).default(3),
-            timeout_sec: z.number().int().min(1).max(600).default(180),
-        },
-    }, ({ job_id, wait, interval_sec, timeout_sec }) => runTool(() => pollJob(clients, job_id, wait, interval_sec, timeout_sec)));
+        title: 'Alias cũ của cloud_job_status',
+        description: 'Alias tương thích; dùng cloud_job_status cho tích hợp mới. Job sandbox được tự nhận diện, không cần header.',
+        inputSchema: jobStatusSchema,
+    }, ({ job_id, wait, interval_sec, timeout_sec, sandbox }) => runTool(() => pollJob(clients, job_id, wait, interval_sec, timeout_sec, clients.sandboxEnabled(sandbox))));
+    server.registerTool('cloud_services_list', {
+        title: 'Danh sách service MONA Cloud',
+        description: 'Liệt kê VPS/database; sandbox=true gộp cả service thử 0đ bằng API, không cần header.',
+        inputSchema: { sandbox: sandboxSchema },
+    }, ({ sandbox }) => runTool(() => clients.vibecloud('/api/services', {
+        query: clients.sandboxEnabled(sandbox) ? { include_sandbox: 1 } : undefined,
+    })));
     server.registerTool('vibecloud_list_services', {
-        title: 'Danh sách service VibeCloud',
-        description: 'Liệt kê VPS và database của MONA Pass hiện tại.',
-    }, () => runTool(() => clients.vibecloud('/api/services')));
+        title: 'Alias cũ của cloud_services_list',
+        description: 'Alias tương thích; dùng cloud_services_list cho tích hợp mới. sandbox=true gộp service thử 0đ, không cần header.',
+        inputSchema: { sandbox: sandboxSchema },
+    }, ({ sandbox }) => runTool(() => clients.vibecloud('/api/services', {
+        query: clients.sandboxEnabled(sandbox) ? { include_sandbox: 1 } : undefined,
+    })));
     for (const action of ['start', 'stop', 'rebuild']) {
-        server.registerTool(`vibecloud_${action}`, {
-            title: `${action} service VibeCloud`,
+        const name = `cloud_service_${action}`;
+        server.registerTool(name, {
+            title: `${action} service MONA Cloud`,
             description: action === 'stop'
-                ? 'Dừng VPS/database VibeCloud; luôn cho phép dừng để người dùng hạn chế chi phí.'
-                : `${action} VPS/database VibeCloud. Lệnh có thể phát sinh chi phí và kiểm tra ví trước.`,
-            inputSchema: { service_id: z.string().min(1) },
-        }, ({ service_id }) => runTool(async () => {
+                ? 'Dừng VPS/database MONA Cloud; luôn cho phép dừng để người dùng hạn chế chi phí.'
+                : `${action} VPS/database MONA Cloud. Lệnh có thể phát sinh chi phí và kiểm tra ví trước. ${SANDBOX_DESCRIPTION}.`,
+            inputSchema: { service_id: z.string().min(1), sandbox: sandboxSchema },
+        }, ({ service_id, sandbox }) => runTool(async () => {
+            const path = `/api/services/${encodeURIComponent(service_id)}/${action}`;
             if (action !== 'stop')
-                await clients.spendGuard();
-            return clients.vibecloud(`/api/services/${encodeURIComponent(service_id)}/${action}`, { method: 'POST' });
+                return clients.guardedVibecloud(path, { method: 'POST' }, sandbox);
+            return clients.vibecloud(path, { method: 'POST' });
+        }));
+        server.registerTool(`vibecloud_${action}`, {
+            title: `Alias cũ của ${name}`,
+            description: `Alias tương thích; dùng ${name} cho tích hợp mới.${action === 'stop' ? '' : ` ${SANDBOX_DESCRIPTION}.`}`,
+            inputSchema: { service_id: z.string().min(1), sandbox: sandboxSchema },
+        }, ({ service_id, sandbox }) => runTool(async () => {
+            const path = `/api/services/${encodeURIComponent(service_id)}/${action}`;
+            if (action !== 'stop')
+                return clients.guardedVibecloud(path, { method: 'POST' }, sandbox);
+            return clients.vibecloud(path, { method: 'POST' });
         }));
     }
-    server.registerTool('vibecloud_prices', {
-        title: 'Bảng giá VibeCloud',
+    server.registerTool('cloud_prices', {
+        title: 'Bảng giá MONA Cloud',
         description: 'Đọc đơn giá giờ hiện hành.',
     }, () => runTool(() => clients.prices()));
-    server.registerTool('vibecloud_packages', {
-        title: 'Gói cấu hình VibeCloud',
+    server.registerTool('vibecloud_prices', {
+        title: 'Alias cũ của cloud_prices',
+        description: 'Alias tương thích; dùng cloud_prices cho tích hợp mới.',
+    }, () => runTool(() => clients.prices()));
+    server.registerTool('cloud_packages', {
+        title: 'Gói cấu hình MONA Cloud',
         description: 'Liệt kê package_slug và cấu hình CPU/RAM/đĩa.',
     }, () => runTool(() => clients.packages()));
+    server.registerTool('vibecloud_packages', {
+        title: 'Alias cũ của cloud_packages',
+        description: 'Alias tương thích; dùng cloud_packages cho tích hợp mới.',
+    }, () => runTool(() => clients.packages()));
+    server.registerTool('cloud_agent_deploy', {
+        title: 'Deploy MONA Agent trên MONA Cloud',
+        description: `Slot runtime agent wave kế tiếp; hiện trả trạng thái stub rõ ràng. ${SANDBOX_DESCRIPTION}.`,
+        inputSchema: { template: z.string().regex(/^[a-z0-9][a-z0-9-]{0,79}$/), sandbox: sandboxSchema },
+    }, ({ template, sandbox }) => runTool(() => agentRuntimeStub(template, clients.sandboxEnabled(sandbox))));
     server.registerTool('vibecloud_agent_deploy', {
-        title: 'Deploy MONA Agent trên VibeCloud',
-        description: 'Slot runtime agent wave kế tiếp; hiện trả trạng thái stub rõ ràng.',
-        inputSchema: { template: z.string().regex(/^[a-z0-9][a-z0-9-]{0,79}$/) },
-    }, ({ template }) => runTool(() => agentRuntimeStub(template)));
+        title: 'Alias cũ của cloud_agent_deploy',
+        description: `Alias tương thích; dùng cloud_agent_deploy cho tích hợp mới. ${SANDBOX_DESCRIPTION}.`,
+        inputSchema: { template: z.string().regex(/^[a-z0-9][a-z0-9-]{0,79}$/), sandbox: sandboxSchema },
+    }, ({ template, sandbox }) => runTool(() => agentRuntimeStub(template, clients.sandboxEnabled(sandbox))));
     server.registerTool('agent_templates_list', {
         title: 'Catalog MONA Agent',
         description: 'Đọc template từ thư mục local, URL catalog hoặc catalog wave 1 tích hợp.',
@@ -248,7 +320,7 @@ export function createServer(dependencies = {}) {
     }, ({ template }) => runTool(() => catalog.get(template)));
     server.registerTool('agent_deploy', {
         title: 'Dùng ngay MONA Agent template',
-        description: 'Gọi cùng runtime với vibecloud_agent_deploy.',
+        description: 'Gọi cùng runtime với cloud_agent_deploy.',
         inputSchema: { template: z.string().regex(/^[a-z0-9][a-z0-9-]{0,79}$/) },
     }, ({ template }) => runTool(() => agentRuntimeStub(template)));
     const imported = importedMonaPayTools(config, env, fetchImpl);
@@ -279,17 +351,17 @@ export function createServer(dependencies = {}) {
     }, async (uri) => ({ contents: [{
                 uri: uri.href,
                 mimeType: 'text/plain',
-                text: `${ENTITY}\n\nHuman chỉ đăng ký MONA Pass, nạp tiền và cung cấp OTP/KYC bắt buộc. AI dùng MCP làm phần còn lại.\n\n- cloud_*: tài khoản, ví, ledger, usage, budget, dịch vụ.\n- vibecloud_*: VPS, database, job, start/stop/rebuild, giá/gói.\n- monapay_*: nối ngân hàng, checkout/QR, giao dịch, webhook và email.\n- agent_*: catalog và deploy template.\n\nConsole: ${config.consoleUrl}\nVibeCloud: https://vibecloud.vn\nMONA Pay: https://monapay.vn\n`,
+                text: `${ENTITY}\n\nHuman chỉ đăng ký MONA Pass, nạp tiền và cung cấp OTP/KYC bắt buộc. AI dùng MCP làm phần còn lại.\n\n- cloud_*: tài khoản, ví, ledger, usage, budget, VPS, database, job, vòng đời service và giá/gói.\n- monapay_*: nối ngân hàng, checkout/QR, giao dịch, webhook và email.\n- agent_*: catalog và deploy template.\n\nMONA Cloud: https://monacloud.vn\nCompute API: https://api.monacloud.vn\nMONA Pay: https://monapay.vn\n`,
             }] }));
     server.registerResource('monacloud-status', 'monacloud://status', {
         title: 'Trạng thái hệ MONA Cloud',
-        description: 'Health tổng hợp của MONA Pass, billing, VibeCloud và MONA Pay.',
+        description: 'Health tổng hợp của MONA Pass, billing, compute MONA Cloud và MONA Pay.',
         mimeType: 'application/json',
     }, async (uri) => {
         const members = await Promise.all([
             providerHealth('mona-id', `${config.issuer}/.well-known/openid-configuration`, fetchImpl),
             providerHealth('billing', `${config.billingUrl}/v1/healthz`, fetchImpl),
-            providerHealth('vibecloud', `${config.vibecloudApi}/api/prices`, fetchImpl),
+            providerHealth('monacloud-compute', `${config.vibecloudApi}/api/prices`, fetchImpl),
             providerHealth('monapay', `${config.monapayApi}/health`, fetchImpl),
         ]);
         return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify({ checked_at: new Date().toISOString(), members }, null, 2) }] };
@@ -305,7 +377,7 @@ export function createServer(dependencies = {}) {
                 role: 'user',
                 content: {
                     type: 'text',
-                    text: `Dựng app bán hàng ${app_name || 'của tôi'} bằng ${framework || 'stack phù hợp'} trên MONA Cloud theo đúng thứ tự:\n1. Gọi cloud_whoami, cloud_balance, vibecloud_packages và vibecloud_prices. Nếu thiếu tiền, gọi cloud_topup rồi dừng để người dùng quét VietQR.\n2. Gọi vibecloud_create_vps và vibecloud_create_database; poll từng job bằng vibecloud_job_status tới succeeded.\n3. Gọi monapay_link nếu MONA Pay còn ở lớp chuyển tiếp. Gọi monapay_whoami; nếu chưa có VA, nối ngân hàng bằng chuỗi monapay_link_bank_start → HỎI OTP → verify → notification_register → HỎI OTP lần 2 → verify. Không tự đoán OTP.\n4. Viết endpoint webhook có HMAC và idempotency theo transaction_code; đăng ký bằng monapay_create_webhook, bắn monapay_test_webhook và đọc monapay_webhook_logs.\n5. Tích hợp monapay_create_checkout hoặc monapay_create_qr vào app, chỉ giao hàng sau CHECKOUT_PAID.\n6. Deploy code lên VPS vừa tạo, kiểm tra health và báo URL/credential cần lưu. Không yêu cầu người dùng mở dashboard ngoài bước nạp tiền/OTP bắt buộc.`,
+                    text: `Dựng app bán hàng ${app_name || 'của tôi'} bằng ${framework || 'stack phù hợp'} trên MONA Cloud theo đúng thứ tự:\n1. Gọi cloud_whoami, cloud_balance, cloud_packages và cloud_prices. Nếu thiếu tiền, gọi cloud_topup rồi dừng để người dùng quét VietQR.\n2. Gọi cloud_vps_create và cloud_db_create; poll từng job bằng cloud_job_status tới succeeded.\n3. Gọi monapay_link nếu MONA Pay còn ở lớp chuyển tiếp. Gọi monapay_whoami; nếu chưa có VA, nối ngân hàng bằng chuỗi monapay_link_bank_start → HỎI OTP → verify → notification_register → HỎI OTP lần 2 → verify. Không tự đoán OTP.\n4. Viết endpoint webhook có HMAC và idempotency theo transaction_code; đăng ký bằng monapay_create_webhook, bắn monapay_test_webhook và đọc monapay_webhook_logs.\n5. Tích hợp monapay_create_checkout hoặc monapay_create_qr vào app, chỉ giao hàng sau CHECKOUT_PAID.\n6. Deploy code lên VPS vừa tạo, kiểm tra health và báo URL/credential cần lưu. Không yêu cầu người dùng mở dashboard ngoài bước nạp tiền/OTP bắt buộc.`,
                 },
             }] }));
     return server;

package/dist/templates.js

@@ -7,7 +7,7 @@ const BUILTIN = [
     { slug: 'sales-chot-don', name: 'Sales chốt đơn', description: 'Tư vấn, báo giá, tạo QR MONA Pay và xác nhận tiền vào.', products: ['MONA Pay', 'MONA AI'] },
     { slug: 'ke-toan-hddt', name: 'Kế toán HĐĐT', description: 'Đọc tiền vào, phát hành hoá đơn điện tử và nhắc công nợ.', products: ['MONA Pay', 'monahddt', 'MONA Mail'] },
     { slug: 'content-seo', name: 'Content SEO', description: 'Viết và đăng bài theo voice thương hiệu, có gate QC.', products: ['MONA AI'] },
-    { slug: 'noi-bo-kin', name: 'Nội bộ kín', description: 'Trợ lý đọc tài liệu công ty, dữ liệu không rời server.', products: ['VibeCloud', 'MONA Base', 'Ollama'] },
+    { slug: 'noi-bo-kin', name: 'Nội bộ kín', description: 'Trợ lý đọc tài liệu công ty, dữ liệu không rời server.', products: ['MONA Cloud', 'MONA Base', 'Ollama'] },
     { slug: 'tro-giang-academy', name: 'Trợ giảng Academy', description: 'Trợ giảng cho academy của giảng viên.', products: ['mona.academy', 'MONA AI'] },
 ];
 const allowedSlug = /^[a-z0-9][a-z0-9-]{0,79}$/;
@@ -111,7 +111,7 @@ export class TemplateCatalog {
             ...template,
             source: 'built-in-wave-1-catalog',
             status: 'catalog_only',
-            next_step: 'Catalog runtime chưa được phát hành; dùng vibecloud_agent_deploy để kiểm tra trạng thái triển khai.',
+            next_step: 'Catalog runtime chưa được phát hành; dùng cloud_agent_deploy để kiểm tra trạng thái triển khai.',
         };
     }
 }

package/docs/ai-agent.md

@@ -5,7 +5,7 @@ Tài liệu này dành cho Claude, Codex, Cursor và agent dùng Model Context P
 ## Quy tắc vận hành
 
 1. Bắt đầu bằng `cloud_whoami`. Nếu nhận `login_required`, yêu cầu người dùng chạy `monacloud-mcp login`; không hỏi username hoặc password trong chat.
-2. Trước khi provision, đọc `cloud_balance`, `vibecloud_packages` và `vibecloud_prices`.
+2. Trước khi provision thật, đọc `cloud_balance`, `cloud_packages` và `cloud_prices`. Với `sandbox: true`, không cần đọc hoặc nạp ví.
 3. Khi cần nạp, gọi `cloud_topup`; đưa nguyên `qr_data_url`, số tiền, nội dung và hạn thanh toán cho người dùng. Chỉ tiếp tục sau khi `cloud_balance` phản ánh tiền vào.
 4. Với OTP ngân hàng, dừng đúng sau `monapay_link_bank_start` và `monapay_notification_register`. Hỏi người dùng mã vừa nhận; không suy đoán, brute-force hoặc ghi OTP vào source/log.
 5. Mọi endpoint webhook phải xác minh HMAC, chống replay theo timestamp và idempotent theo `transaction_code`.
@@ -26,10 +26,10 @@ Không in hoặc copy token vào source, issue, log, output tool hay nội dung
 
 ### Adapter chuyển tiếp
 
-MONA Pay và VibeCloud có thể chưa nhận JWT MONA Pass trực tiếp tại thời điểm wave 1:
+MONA Pay và compute MONA Cloud có thể chưa nhận JWT MONA Pass trực tiếp tại thời điểm wave 1:
 
 - gọi `monapay_link` một lần để nhận/cache `client_id/client_secret` MONA Pay;
-- gọi `vibecloud_link` để xác nhận direct MONA Pass; tool chỉ nhận/cache `vc_live_*` khi upstream từ chối JWT và còn bật adapter cũ;
+- gọi `cloud_link` để xác nhận direct MONA Pass; tool chỉ nhận/cache `vc_live_*` khi upstream từ chối JWT và còn bật adapter cũ;
 - linked credential nằm ở `~/.config/monacloud/links.json`, mode `0600`;
 - không gọi link lại ở mỗi request;
 - khi upstream nhận JWT trực tiếp, bỏ adapter mà không đổi tên tool nghiệp vụ.
@@ -43,8 +43,8 @@ Nếu tài khoản MONA Pay cũ cần OTP email để link, trả quyền điề
 ```text
 cloud_whoami
 cloud_balance
-vibecloud_packages
-vibecloud_prices
+cloud_packages
+cloud_prices
 ```
 
 Chọn `package_slug` nếu có thể. Chỉ dùng custom sizing khi cần; không gửi đồng thời `package_slug` và `cpu/ram_gb/disk_gb`.
@@ -60,14 +60,14 @@ Giữ cùng idempotency key khi retry cùng một yêu cầu nạp.
 ### 2. Tạo compute và database
 
 ```text
-vibecloud_create_vps({ app_name: "shop-demo", package_slug: "standard-2" })
-vibecloud_create_database({ app_name: "shop-demo", engine: "postgresql", package_slug: "standard-2" })
+cloud_vps_create({ app_name: "shop-demo", package_slug: "standard-2" })
+cloud_db_create({ app_name: "shop-demo", engine: "postgresql", package_slug: "standard-2" })
 ```
 
 Mỗi response là job. Dùng:
 
 ```text
-vibecloud_job_status({ job_id: "...", wait: true, interval_sec: 3, timeout_sec: 180 })
+cloud_job_status({ job_id: "...", wait: true, interval_sec: 3, timeout_sec: 180 })
 ```
 
 Chỉ dùng `result`/credential khi trạng thái `succeeded`. Với `failed`, đọc `error`; sửa nguyên nhân rồi mới retry. Không đưa database password vào commit hoặc response công khai.
@@ -130,7 +130,7 @@ Deploy source lên VPS từ credential của job, đưa database connection stri
 
 ## Spend guard
 
-`vibecloud_create_vps`, `vibecloud_create_database`, `vibecloud_start` và `vibecloud_rebuild` đọc `GET /v1/balance` trước khi gọi sản phẩm. Upstream vẫn là nguồn quyết định cuối và có thể trả:
+`cloud_vps_create`, `cloud_db_create`, `cloud_service_start` và `cloud_service_rebuild` đọc `GET /v1/balance` trước khi gọi sản phẩm thật. Upstream vẫn là nguồn quyết định cuối và có thể trả:
 
 ```json
 {
@@ -140,13 +140,28 @@ Deploy source lên VPS từ credential của job, đưa database connection stri
 }
 ```
 
-hoặc `budget_exceeded`. Khi gặp hai code này, không retry. Gọi `cloud_topup`, `cloud_budget_get` hoặc yêu cầu user tăng budget. `vibecloud_stop` luôn được phép vì chặn stop có thể làm tăng rủi ro chi phí.
+hoặc `budget_exceeded`. Khi gặp hai code này, không retry. Gọi `cloud_topup`, `cloud_budget_get` hoặc yêu cầu user tăng budget. `cloud_service_stop` luôn được phép vì chặn stop có thể làm tăng rủi ro chi phí.
+
+## Thử 0đ bằng sandbox
+
+Thêm `sandbox: true` khi gọi `cloud_vps_create`, `cloud_db_create`, `cloud_service_start`, `cloud_service_rebuild` hoặc `cloud_agent_deploy`. Có thể đặt `MONACLOUD_SANDBOX=1` để bật cho toàn bộ MCP process. Alias `vibecloud_*` tương ứng hoạt động giống hệt.
+
+```text
+cloud_vps_create({ app_name: "shop-demo", package_slug: "standard-2", sandbox: true })
+cloud_db_create({ app_name: "shop-demo", engine: "postgresql", package_slug: "standard-2", sandbox: true })
+cloud_job_status({ job_id: "...", sandbox: true })
+cloud_services_list({ sandbox: true })
+```
+
+Với lệnh tạo/start/rebuild sandbox, MCP không gọi Billing, tự gửi `X-Vibecloud-Sandbox: 1`, và response có `sandbox: true`. `cloud_job_status` tra job theo ID mà không cần header; trạng thái `done` là terminal hợp lệ của sandbox. `cloud_services_list({ sandbox: true })` dùng `include_sandbox=1`, cũng không cần header, để gộp service thật và sandbox.
+
+Sandbox không gọi Proxmox, không cấp IP thật, không trừ tiền và có TTL do compute API quản lý. Chỉ chuyển sang lệnh thật khi người dùng yêu cầu rõ ràng. `cloud_agent_deploy` hiện vẫn trả `agent_runtime_pending`; sandbox chỉ đánh dấu response nhất quán, không giả vờ đã deploy.
 
 ## Catalog MONA Agent
 
 `agent_templates_list` trả nguồn catalog và danh sách slug. `agent_templates_get` trả toàn bộ file text cần để agent build local. Không tự nối path từ input ngoài; chỉ dùng slug đã trả.
 
-`agent_deploy` và `vibecloud_agent_deploy` hiện là stub có chủ đích, trả `agent_runtime_pending`; không giả vờ đã provision. Khi nhận code này, có thể đọc template và triển khai thủ công hoặc báo rõ runtime hosted chưa được bật.
+`agent_deploy` và `cloud_agent_deploy` hiện là stub có chủ đích, trả `agent_runtime_pending`; không giả vờ đã provision. Khi nhận code này, có thể đọc template và triển khai thủ công hoặc báo rõ runtime hosted chưa được bật.
 
 ## Resource hữu ích
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "monacloud-mcp",
-  "version": "0.1.2",
-  "description": "Unified MCP server for MONA Cloud, MONA Pay, VibeCloud and MONA Agent.",
+  "version": "0.2.1",
+  "description": "Unified MCP server for MONA Cloud, MONA Pay and MONA Agent.",
   "license": "MIT",
   "type": "module",
   "bin": {