monacloud-mcp 0.8.1 → 0.10.0

package/README.md

@@ -6,7 +6,7 @@ Human đăng ký MONA Pass một lần, duyệt chi phí, thêm DNS khi cần, q
 
 ## 0.8.1 — luật nạp ví đứng đầu instructions
 
-Codex chỉ chắc chắn đọc 512 ký tự đầu của `instructions` MCP, nên luật "ví thiếu → AI tự gọi `cloud_topup`, in QR, không bảo mở console" được đưa lên đầu; mô tả hệ và APP_FLOW đặt sau. Kiểm thử 17/09: Claude Code (sonnet) và Gemini (Antigravity CLI) tự gọi `cloud_topup` và in QR khi người dùng nói "ví hết tiền, nạp 50k"; Codex `exec` cần cho phép gọi MCP (mặc định chặn approval) rồi cũng làm được.
+Codex chỉ chắc chắn đọc 512 ký tự đầu của `instructions` MCP, nên luật "ví thiếu → AI tự gọi `cloud_topup`, in QR, không bảo mở console" được đưa lên đầu; mô tả hệ và APP_FLOW đặt sau. Kiểm thử 17/09: Claude Code (sonnet) và Gemini (Antigravity CLI) tự gọi `cloud_topup` và in QR khi người dùng nói "ví hết tiền, nạp 50k"; Codex chạy headless (`codex exec`) mặc định chặn mọi lời gọi MCP theo approval policy; thêm `--approve-for-me` thì Codex cũng tự gọi `cloud_topup` và in QR (kiểm 17/09). Codex tương tác thì duyệt lời gọi tool như bình thường.
 
 ## 0.8.0 — Nạp ví ngay trong terminal
 
@@ -150,6 +150,24 @@ Mỗi tool có alias `vibecloud_base_*` cùng schema và handler. Cần DB/Supab
 
 `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.
 
+### MONA Domain — tên miền cho app (monadomain.vn)
+
+AI tra tên, báo giá VND đã VAT, hỏi chủ thể, mua .vn/.com bằng ví MONA Cloud rồi trỏ DNS + SSL vào app. Tra giá **không cần đăng nhập**; người dùng chưa có tài khoản vẫn mua được trong phiên bằng đường giữ chỗ → quét QR → bấm claim (đăng nhập MONA Pass 1 bước = tạo ví = mua).
+
+| Tool | Công dụng |
+|---|---|
+| `cloud_domain_search` | Còn trống + giá theo TLD; **guest gọi được** |
+| `cloud_domain_reserve` | Giữ chỗ 30' không trừ tiền; hỏi email + sđt (+ opt-in ưu đãi); trả QR đúng giá + `claim_url` + `claim_token`/`guest_token` |
+| `cloud_domain_reserve_status` | reserved / paid / claimed / expired + `next_step` |
+| `cloud_domain_claim` | Đăng nhập Pass → nhận reservation, kéo tiền về ví, mua ngay (idempotent) |
+| `cloud_domain_reserve_release` | Nhả chỗ khi chưa có tiền vào |
+| `cloud_domain_registrant_get` / `cloud_domain_registrant_set` | Chủ thể đăng ký (.vn cá nhân cần CCCD, tổ chức cần MST) |
+| `cloud_domain_buy` | Mua thẳng bằng ví khi đã đăng nhập; 402 → `cloud_topup` in QR |
+| `cloud_domain_verify_start` / `cloud_domain_verify_status` / `cloud_domain_wait` | Hồ sơ .vn + chờ active |
+| `cloud_domain_dns_*` / `cloud_domain_ns_set` / `cloud_domain_attach` / `cloud_domain_health` | DNS, NS, gắn app, sức khoẻ |
+
+Giữ chỗ chỉ khoá tên trong hệ MONA Cloud (`hold_scope=monacloud`), không giữ ở registry — tên đẹp thì trả sớm. Không gọi registrar tới khi tiền vào và có tài khoản nhận. Prompt `mua-ten-mien-monacloud(keyword?, app_id?)` dẫn trọn luồng.
+
 ### MONA Mail
 
 MONA Mail là dịch vụ gửi email giao dịch cho phần mềm và AI agent của người Việt: một API, trả VND, không cần thẻ, thuộc nhóm MONA Cloud của The MONA Group.

package/dist/clients.d.ts

@@ -44,6 +44,18 @@ export declare class CloudClients {
         headers?: Record<string, string>;
         timeoutMs?: number;
     }): Promise<T>;
+    /**
+     * Gọi endpoint MONA Cloud mở cho guest (spec monadomain §12: search/reserve/status không cần Pass).
+     * Có token trên máy thì vẫn gửi (để backend ghi lead + gắn chủ); chưa login thì đi ẩn danh
+     * hoặc dùng guest_token của reservation — KHÔNG ném login_required.
+     */
+    vibecloudGuestOk<T = unknown>(path: string, options?: {
+        method?: string;
+        body?: unknown;
+        query?: Record<string, string | number | undefined>;
+        headers?: Record<string, string>;
+        guestToken?: string;
+    }): Promise<T>;
     guardedVibecloud(path: string, options?: {
         method?: string;
         body?: unknown;

package/dist/clients.js

@@ -222,6 +222,29 @@ export class CloudClients {
             fetchImpl: this.fetchImpl,
         });
     }
+    /**
+     * Gọi endpoint MONA Cloud mở cho guest (spec monadomain §12: search/reserve/status không cần Pass).
+     * Có token trên máy thì vẫn gửi (để backend ghi lead + gắn chủ); chưa login thì đi ẩn danh
+     * hoặc dùng guest_token của reservation — KHÔNG ném login_required.
+     */
+    async vibecloudGuestOk(path, options = {}) {
+        const { guestToken, ...rest } = options;
+        let token;
+        try {
+            token = await this.vibecloudToken();
+        }
+        catch (error) {
+            if (!(error instanceof CloudError) || error.code !== 'login_required')
+                throw error;
+            token = guestToken;
+        }
+        return requestJson(`${this.config.vibecloudApi}${path}`, {
+            timeoutMs: 30_000,
+            ...rest,
+            token,
+            fetchImpl: this.fetchImpl,
+        });
+    }
     async guardedVibecloud(path, options = {}, requestedSandbox = false, requiredVnd) {
         const sandbox = this.sandboxEnabled(requestedSandbox);
         if (!sandbox)

package/dist/domains.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CloudClients } from './clients.js';
+export declare function registerDomainTools(server: McpServer, clients: CloudClients): void;

package/dist/domains.js

@@ -0,0 +1,273 @@
+import { z } from 'zod';
+import { runTool } from './errors.js';
+const domainName = z.string().trim().toLowerCase()
+    .min(3).max(253)
+    .describe('Tên miền đầy đủ (vd: example.vn) hoặc chỉ tên chưa có đuôi (vd: example).');
+const objectId = z.string().regex(/^[a-f0-9]{24}$/i, 'Cần ID 24 ký tự hex.');
+const registrantSchema = z.object({
+    owner_type: z.enum(['individual', 'organization']).optional()
+        .describe('individual = cá nhân (mặc định), organization = tổ chức/doanh nghiệp.'),
+    fullname: z.string().min(2).max(200).describe('Họ và tên đầy đủ (hoặc tên doanh nghiệp nếu organization).'),
+    email: z.string().email().describe('Email liên hệ.'),
+    phone: z.string().min(8).max(20).describe('Số điện thoại.'),
+    address: z.string().min(5).max(500).describe('Địa chỉ liên hệ.'),
+    province: z.string().max(100).optional().describe('Tỉnh/thành phố.'),
+    ward: z.string().max(100).optional().describe('Phường/xã.'),
+    country: z.string().max(10).optional().describe('Mã quốc gia, mặc định VN.'),
+    cccd: z.string().min(12).max(12).optional()
+        .describe('Số CCCD (12 số) — bắt buộc khi đăng ký tên miền .vn cá nhân.'),
+    dob: z.string().max(20).optional().describe('Ngày sinh định dạng DD/MM/YYYY — cá nhân .vn.'),
+    gender: z.enum(['male', 'female', '']).optional().describe('Giới tính — cá nhân .vn.'),
+    org_name: z.string().max(300).optional().describe('Tên tổ chức/doanh nghiệp — bắt buộc khi organization.'),
+    tax_code: z.string().max(20).optional().describe('Mã số thuế — bắt buộc khi organization.'),
+    representative: z.string().max(200).optional().describe('Họ tên người đại diện — bắt buộc khi organization.'),
+}).strict();
+export function registerDomainTools(server, clients) {
+    server.registerTool('cloud_domain_search', {
+        title: 'Tìm kiếm + báo giá tên miền',
+        description: 'Kiểm tra tên miền còn trống và xem giá mua (VND, đã VAT). KHÔNG cần đăng nhập MONA Pass — gọi được ngay cả khi người dùng chưa có tài khoản; dùng trước khi mua/giữ chỗ để biết available/price.',
+        inputSchema: z.object({
+            q: z.string().min(1).max(253).describe('Tên miền hoặc từ khoá (vd: "myapp" hoặc "myapp.vn").'),
+            tlds: z.string().max(200).optional().describe('Đuôi muốn tìm, phân cách phẩy (vd: "vn,com"). Mặc định: vn,com.'),
+            years: z.number().int().min(1).max(10).optional().describe('Số năm đăng ký. Mặc định 1.'),
+        }).strict(),
+    }, ({ q, tlds, years }) => runTool(async () => {
+        const params = new URLSearchParams({ q });
+        if (tlds)
+            params.set('tlds', tlds);
+        if (years)
+            params.set('years', String(years));
+        return clients.vibecloudGuestOk(`/api/domains/search?${params}`);
+    }));
+    server.registerTool('cloud_domain_registrant_get', {
+        title: 'Xem thông tin chủ thể đăng ký tên miền',
+        description: 'Lấy thông tin chủ thể (registrant) đã lưu. Cần dữ liệu này để mua tên miền.',
+        inputSchema: z.object({}).strict(),
+    }, () => runTool(() => clients.vibecloud('/api/domains/registrant')));
+    server.registerTool('cloud_domain_registrant_set', {
+        title: 'Cập nhật thông tin chủ thể đăng ký tên miền',
+        description: 'Lưu thông tin chủ thể để đăng ký tên miền. HỎI NGƯỜI DÙNG cung cấp NGAY TRONG PHIÊN: họ tên, email, điện thoại, địa chỉ. Tên miền .vn cá nhân cần thêm CCCD 12 số + ngày sinh (DD/MM/YYYY) + giới tính; .vn tổ chức cần org_name + tax_code (MST) + representative. Lưu 1 lần, tái dùng cho các domain sau. Không tự bịa dữ liệu — thiếu trường nào thì hỏi đúng trường đó.',
+        inputSchema: registrantSchema,
+    }, (args) => runTool(() => clients.vibecloud('/api/domains/registrant', {
+        method: 'PUT',
+        body: args,
+    })));
+    server.registerTool('cloud_domain_buy', {
+        title: 'Mua tên miền',
+        description: [
+            'Mua tên miền và trừ ví VND — làm trọn trong phiên, không bảo người dùng mở web. Trước khi gọi:',
+            '1. cloud_domain_search để xem giá + còn trống.',
+            '2. Hỏi người dùng xác nhận chính tả tên miền (vd: "Đăng ký example.vn nhé?") → spelling_confirmed. WHOIS không sửa được sau khi mua.',
+            '3. Hỏi duyệt chi phí (giá từ search).',
+            '4. cloud_domain_registrant_set để lưu thông tin chủ thể (hỏi người dùng ngay trong phiên); .vn cần CCCD/MST.',
+            'Khi gọi mà trả 402 insufficient_balance → gọi cloud_topup, IN NGUYÊN KHỐI qr_ascii (QR VietQR) cho người dùng quét bằng app ngân hàng NGAY trong terminal, chờ cloud_topup_status=paid rồi gọi lại cloud_domain_buy. Không bảo người dùng mở console để nạp.',
+            'Kết quả có suggested_next → gợi ý người dùng deploy app lên MONA Cloud (cloud_app_create) và gắn domain (cloud_domain_attach).',
+            '.vn sau khi mua ở trạng thái pending_verification → dùng cloud_domain_verify_start (link eKYC/bản khai) rồi cloud_domain_wait.',
+            'sandbox=true: giả lập 0đ, không mua thật.',
+        ].join(' '),
+        inputSchema: z.object({
+            name: domainName,
+            years: z.number().int().min(1).max(10).optional().describe('Số năm đăng ký. Mặc định 1.'),
+            spelling_confirmed: z.boolean()
+                .describe('true = người dùng đã xác nhận chính tả tên miền; false = chặn, không mua.'),
+            registrant_id: objectId.optional().describe('ID registrant (lấy từ cloud_domain_registrant_get). Để trống → dùng registrant mặc định.'),
+            sandbox: z.boolean().optional().describe('sandbox=true: mô phỏng 0đ, không gọi MONA Host.'),
+        }).strict(),
+    }, ({ name, years, spelling_confirmed, registrant_id, sandbox }) => runTool(async () => {
+        const body = { name, spelling_confirmed };
+        if (years)
+            body.years = years;
+        if (registrant_id)
+            body.registrant_id = registrant_id;
+        return clients.guardedVibecloud('/api/domains', { method: 'POST', body }, sandbox === true);
+    }));
+    // --- Guest → reserve → claim (spec monadomain §12): mua TRƯỚC khi có tài khoản ---------------
+    server.registerTool('cloud_domain_reserve', {
+        title: 'Giữ chỗ tên miền + QR trả tiền (không cần tài khoản)',
+        description: [
+            'Giữ chỗ tên miền 30 phút cho người dùng CHƯA có MONA Pass (hoặc chưa login trên máy này) — không trừ tiền, không đăng ký thật, chỉ khoá tên trong hệ MONA Cloud.',
+            'Dùng khi người dùng muốn mua ngay trong phiên mà không muốn "đi đăng ký" trước: bạn đã dựng app, chọn tên, chỉ cần người bấm.',
+            'Bắt buộc hỏi người dùng: tên miền (xác nhận chính tả → spelling_confirmed), email, số điện thoại (kênh nhận link claim + hoá đơn). Hỏi thêm 1 câu nhẹ: "nhận thông báo ưu đãi MONA Cloud không?" → marketing_consent; không tick thì để false.',
+            'Nếu người dùng đã đưa đủ thông tin chủ thể (.vn cần CCCD/MST) thì gửi luôn ở registrant — lúc claim khỏi hỏi lại.',
+            'Kết quả: payment.qr_url (QR VietQR đúng số tiền) + claim_url + claim_token + guest_token (giữ lại để gọi cloud_domain_reserve_status). Đưa QR cho người dùng quét NGAY; tiền vào → hệ giữ cho reservation này. Sau đó người dùng mở claim_url: đăng nhập/đăng ký MONA Pass (Google/GitHub/email, 1 bước) → hệ tự lấy tiền + mua + tạo ví. Nếu người dùng ĐÃ có Pass trên máy này thì gọi thẳng cloud_domain_claim.',
+            'Giữ chỗ chỉ trong hệ MONA Cloud (hold_scope=monacloud) — người ngoài vẫn có thể đăng ký tên đó ở registry khác trong 30 phút; nói rõ điều này nếu tên đẹp.',
+        ].join(' '),
+        inputSchema: z.object({
+            name: domainName,
+            years: z.number().int().min(1).max(10).optional().describe('Số năm đăng ký. Mặc định 1.'),
+            email: z.string().email().describe('Email người dùng — nhận claim_url + hoá đơn.'),
+            phone: z.string().min(8).max(20).describe('Số điện thoại người dùng.'),
+            spelling_confirmed: z.boolean().describe('true = người dùng đã xác nhận chính tả tên miền.'),
+            marketing_consent: z.boolean().optional().describe('true CHỈ KHI người dùng đồng ý nhận thông báo ưu đãi MONA Cloud. Mặc định false.'),
+            registrant: registrantSchema.optional().describe('Thông tin chủ thể nếu đã hỏi được đủ trong phiên (tuỳ chọn).'),
+            context: z.string().max(500).optional().describe('Ngữ cảnh ngắn (vd: "Cursor dựng shop Next.js") — giúp MONA hỗ trợ đúng.'),
+            sandbox: z.boolean().optional().describe('sandbox=true: giả lập, không tạo QR thật.'),
+        }).strict(),
+    }, ({ sandbox, ...body }) => runTool(() => clients.vibecloudGuestOk('/api/domains/reserve', {
+        method: 'POST',
+        body,
+        ...(clients.sandboxEnabled(sandbox === true) ? { headers: { 'X-Vibecloud-Sandbox': '1' } } : {}),
+    })));
+    server.registerTool('cloud_domain_reserve_status', {
+        title: 'Trạng thái giữ chỗ tên miền',
+        description: 'Xem reservation đã nhận tiền chưa / đã claim chưa / còn hạn không. Guest truyền claim_token (hoặc guest_token) nhận từ cloud_domain_reserve; chủ reservation đã login thì không cần. Đọc next_step trong kết quả để biết bước kế.',
+        inputSchema: z.object({
+            reservation_id: objectId.describe('ID reservation từ cloud_domain_reserve.'),
+            claim_token: z.string().min(16).max(128).optional().describe('claim_token hoặc guest_token từ cloud_domain_reserve (bắt buộc khi chưa login).'),
+        }).strict(),
+    }, ({ reservation_id, claim_token }) => runTool(() => clients.vibecloudGuestOk(`/api/domains/reserve/${encodeURIComponent(reservation_id)}`, { query: claim_token ? { t: claim_token } : undefined, guestToken: claim_token })));
+    server.registerTool('cloud_domain_claim', {
+        title: 'Nhận reservation về tài khoản + mua (claim = đăng ký = trả tiền)',
+        description: [
+            'Gắn reservation vào MONA Pass đang đăng nhập, kéo tiền đã chuyển (nếu có) về ví rồi MUA ngay. Cần đăng nhập (monacloud-mcp login) — lần đầu đăng nhập MONA Cloud tự tạo hồ sơ + ví, không có form đăng ký riêng.',
+            'Idempotent: gọi lại khi trả 402 (ví chưa đủ → cloud_topup hoặc chờ tiền QR vào) hoặc 422 registrant_required (→ cloud_domain_registrant_set rồi claim lại; tiền vẫn nằm trong ví).',
+            'Kết quả như cloud_domain_buy (order id, status, suggested_next).',
+        ].join(' '),
+        inputSchema: z.object({
+            reservation_id: objectId.describe('ID reservation từ cloud_domain_reserve.'),
+            claim_token: z.string().min(16).max(128).describe('claim_token từ cloud_domain_reserve (hoặc tham số t trong claim_url).'),
+            registrant_id: objectId.optional().describe('ID registrant muốn dùng (mặc định: registrant của user hoặc từ reservation).'),
+            marketing_consent: z.boolean().optional().describe('true nếu người dùng đồng ý nhận ưu đãi lúc này.'),
+        }).strict(),
+    }, ({ reservation_id, ...body }) => runTool(() => clients.vibecloud(`/api/domains/reserve/${encodeURIComponent(reservation_id)}/claim`, { method: 'POST', body })));
+    server.registerTool('cloud_domain_reserve_release', {
+        title: 'Nhả chỗ tên miền đã giữ',
+        description: 'Huỷ reservation chưa nhận tiền (người dùng đổi ý / chọn tên khác). Đã có tiền vào thì không huỷ được — dùng cloud_domain_claim.',
+        inputSchema: z.object({
+            reservation_id: objectId,
+            claim_token: z.string().min(16).max(128).optional().describe('Bắt buộc khi chưa login.'),
+        }).strict(),
+    }, ({ reservation_id, claim_token }) => runTool(() => clients.vibecloudGuestOk(`/api/domains/reserve/${encodeURIComponent(reservation_id)}`, { method: 'DELETE', query: claim_token ? { t: claim_token } : undefined, guestToken: claim_token })));
+    server.registerTool('cloud_domain_list', {
+        title: 'Danh sách tên miền đã import/mua',
+        description: 'Liệt kê tên miền đã đưa vào MONA Cloud (import + mua). sandbox=true → xem domain sandbox.',
+        inputSchema: z.object({
+            sandbox: z.boolean().optional().describe('true → hiện domain sandbox.'),
+        }).strict(),
+    }, ({ sandbox }) => runTool(async () => {
+        const headers = sandbox ? { 'X-Vibecloud-Sandbox': '1' } : undefined;
+        return clients.vibecloud('/api/domains', { headers });
+    }));
+    server.registerTool('cloud_domain_verify_start', {
+        title: 'Bắt đầu nộp hồ sơ .vn',
+        description: 'Sinh bản khai đã điền sẵn và link upload hồ sơ .vn. Dùng sau khi mua tên miền .vn (status=pending_verification).',
+        inputSchema: z.object({
+            id: objectId.describe('Order ID trả về khi cloud_domain_buy.'),
+        }).strict(),
+    }, ({ id }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(id)}/verify`, {
+        method: 'POST',
+    })));
+    server.registerTool('cloud_domain_verify_status', {
+        title: 'Trạng thái hồ sơ .vn',
+        description: 'Kiểm tra trạng thái duyệt hồ sơ đăng ký .vn (profile_status từ MONA Host).',
+        inputSchema: z.object({
+            id: objectId.describe('Order ID của tên miền .vn.'),
+        }).strict(),
+    }, ({ id }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(id)}/verify`)));
+    server.registerTool('cloud_domain_health', {
+        title: 'Kiểm tra sức khoẻ tên miền',
+        description: 'Kiểm tra hạn đăng ký, trạng thái hồ sơ, NS, SSL và cảnh báo tên miền đã mua.',
+        inputSchema: z.object({
+            id: objectId.describe('Order ID tên miền cần kiểm tra.'),
+        }).strict(),
+    }, ({ id }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(id)}/health`)));
+    server.registerTool('cloud_domain_wait', {
+        title: 'Chờ tên miền active',
+        description: 'Long-poll cho đến khi tên miền chuyển sang active/failed (mặc định timeout=60s). Dùng sau cloud_domain_buy để chờ MONA Host xử lý.',
+        inputSchema: z.object({
+            id: objectId.describe('Order ID cần chờ.'),
+            timeout: z.number().int().min(5).max(300).optional().describe('Timeout giây. Mặc định 60.'),
+        }).strict(),
+    }, ({ id, timeout }) => runTool(async () => {
+        const params = timeout ? `?timeout=${timeout}` : '';
+        return clients.vibecloud(`/api/domains/${encodeURIComponent(id)}/wait${params}`);
+    }));
+    server.registerTool('cloud_domain_webhook_set', {
+        title: 'Đăng ký webhook tên miền',
+        description: 'Đăng ký URL nhận sự kiện domain.status_changed (ký HMAC). Mỗi user 1 webhook; gọi lại để cập nhật.',
+        inputSchema: z.object({
+            url: z.string().url().refine((v) => v.startsWith('https://'), 'Cần URL HTTPS.'),
+            secret: z.string().min(8).max(256).describe('Chuỗi bí mật để xác minh chữ ký HMAC.'),
+        }).strict(),
+    }, ({ url, secret }) => runTool(() => clients.vibecloud('/api/domains/webhook', {
+        method: 'PUT',
+        body: { url, secret },
+    })));
+    server.registerTool('cloud_domain_attach', {
+        title: 'Gắn tên miền vào ứng dụng',
+        description: [
+            'Gắn tên miền vào app đã deploy. Tên miền .vn chưa active vẫn gọi được — attach đặt trước, server tự hoàn tất sau khi hồ sơ được duyệt và gửi webhook domain.status_changed.',
+            'Dùng cloud_app_list để lấy app_id; domain_id là ID của domain row (từ cloud_domain_list).',
+        ].join(' '),
+        inputSchema: z.object({
+            domain_id: objectId.describe('Domain ID (từ cloud_domain_list).'),
+            app_id: objectId.describe('App ID cần gắn vào.'),
+            sandbox: z.boolean().optional(),
+        }).strict(),
+    }, ({ domain_id, app_id, sandbox }) => runTool(async () => {
+        const headers = sandbox ? { 'X-Vibecloud-Sandbox': '1' } : undefined;
+        return clients.vibecloud(`/api/domains/${encodeURIComponent(domain_id)}/attach`, {
+            method: 'POST',
+            body: { app_id },
+            headers,
+        });
+    }));
+    const recordSchema = {
+        type: z.enum(['A', 'AAAA', 'CNAME', 'MX', 'TXT', 'SRV', 'NS']).describe('Loại bản ghi.'),
+        name: z.string().min(1).max(253).describe('Tên bản ghi ("@" cho gốc, "www", "api"...).'),
+        data: z.string().min(1).max(2048).describe('Giá trị (IP cho A, hostname cho CNAME, nội dung cho TXT...).'),
+        ttl: z.number().int().min(60).max(86400).optional().describe('TTL giây (mặc định để trống).'),
+        priority: z.number().int().min(0).max(65535).optional().describe('Ưu tiên (MX/SRV).'),
+    };
+    server.registerTool('cloud_domain_dns_list', {
+        title: 'Xem bản ghi DNS của tên miền',
+        description: 'Liệt kê bản ghi DNS (A/CNAME/MX/TXT...) của tên miền đăng ký tại MONA Cloud. domain_id lấy từ cloud_domain_list.',
+        inputSchema: z.object({ domain_id: objectId }).strict(),
+    }, ({ domain_id }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(domain_id)}/records`)));
+    server.registerTool('cloud_domain_dns_add', {
+        title: 'Thêm bản ghi DNS',
+        description: 'Thêm 1 bản ghi DNS. Vd trỏ web: type=A, name=@, data=<IP>. Trỏ www: type=CNAME, name=www, data=<domain>. AI làm trọn, không cần mở dashboard.',
+        inputSchema: z.object({ domain_id: objectId, ...recordSchema }).strict(),
+    }, ({ domain_id, ...record }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(domain_id)}/records`, { method: 'POST', body: record })));
+    server.registerTool('cloud_domain_dns_update', {
+        title: 'Sửa bản ghi DNS',
+        description: 'Sửa 1 bản ghi DNS theo record_id (lấy từ cloud_domain_dns_list).',
+        inputSchema: z.object({ domain_id: objectId, record_id: z.string().min(1).max(128), ...recordSchema }).strict(),
+    }, ({ domain_id, record_id, ...record }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(domain_id)}/records/${encodeURIComponent(record_id)}`, { method: 'PUT', body: record })));
+    server.registerTool('cloud_domain_dns_delete', {
+        title: 'Xoá bản ghi DNS',
+        description: 'Xoá 1 bản ghi DNS theo record_id.',
+        inputSchema: z.object({ domain_id: objectId, record_id: z.string().min(1).max(128) }).strict(),
+    }, ({ domain_id, record_id }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(domain_id)}/records/${encodeURIComponent(record_id)}`, { method: 'DELETE' })));
+    server.registerTool('cloud_domain_ns_set', {
+        title: 'Đổi nameserver (NS) của tên miền',
+        description: 'Đổi NS cho tên miền (≥2). Vd giữ DNS ở MONA: ns1.mona.host, ns2.mona.host. Hoặc chuyển sang Cloudflare/nhà khác. AI làm hoàn toàn.',
+        inputSchema: z.object({
+            domain_id: objectId,
+            ns_list: z.array(z.string().min(3).max(253)).min(2).max(6).describe('Danh sách hostname NS, tối thiểu 2.'),
+        }).strict(),
+    }, ({ domain_id, ns_list }) => runTool(() => clients.vibecloud(`/api/domains/${encodeURIComponent(domain_id)}/ns`, { method: 'PATCH', body: { ns_list } })));
+    server.registerPrompt('mua-ten-mien-monacloud', {
+        title: 'Mua tên miền cho app — làm trọn trong phiên (gợi ý, hỏi info, bắn QR, mua)',
+        description: 'AI tự tra + báo giá + hỏi thông tin chủ thể + nạp ví bằng QR trong terminal + mua + xác thực .vn, không bảo người dùng mở web.',
+        argsSchema: {
+            keyword: z.string().optional(),
+            app_id: z.string().optional(),
+        },
+    }, ({ keyword, app_id }) => ({ messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Mua giúp tôi tên miền${keyword ? ` quanh "${keyword}"` : ''} bằng MONA Cloud, làm trọn ngay trong phiên này, đừng bảo tôi mở web:
+1. cloud_domain_search để tìm tên còn trống + báo giá VND (ưu tiên .vn và .com; nói rõ giá đã gồm VAT).
+2. Hỏi tôi chọn tên nào và XÁC NHẬN CHÍNH TẢ (WHOIS không sửa được sau khi mua).
+3. cloud_domain_registrant_set: HỎI TÔI thông tin chủ thể ngay trong phiên — họ tên, email, điện thoại, địa chỉ; nếu là .vn cá nhân hỏi thêm CCCD 12 số + ngày sinh + giới tính (tổ chức: tên công ty + MST + người đại diện). Đừng tự bịa.
+4. Kiểm ví bằng cloud_balance. Nếu thiếu tiền, gọi cloud_topup rồi IN NGUYÊN KHỐI qr_ascii (QR VietQR) cho tôi quét bằng app ngân hàng ngay trong terminal; chờ cloud_topup_status=paid.
+5. cloud_domain_buy (spelling_confirmed=true) — trừ ví, mua thật.
+   ⚠️ Nếu tôi CHƯA có tài khoản MONA Pass / tool trả login_required: KHÔNG bảo tôi đi đăng ký trước. Dùng cloud_domain_reserve (hỏi email + sđt, hỏi 1 câu "nhận ưu đãi MONA Cloud không?") → đưa tôi QR trong payment để quét trả tiền ngay + claim_url để tôi bấm đăng nhập 1 bước (Google/GitHub/email) → hệ tự tạo ví + mua. Theo dõi bằng cloud_domain_reserve_status; nếu tôi đã login trên máy này thì gọi cloud_domain_claim.
+6. Nếu là .vn: cloud_domain_verify_start đưa tôi link eKYC/bản khai (chụp CCCD + chân dung / ký), rồi cloud_domain_wait tới khi active.
+7. ${app_id ? `Gắn vào app ${app_id} bằng cloud_domain_attach` : 'Gợi ý tôi deploy app lên MONA Cloud (cloud_app_create) rồi gắn domain bằng cloud_domain_attach'} — trỏ DNS + SSL tự động.
+Trả VND, không cần thẻ quốc tế, không mở dashboard.`,
+                },
+            }] }));
+}

package/dist/server.js

@@ -11,6 +11,7 @@ import { registerMailTools } from './mail.js';
 import { APP_FLOW, createVps, registerComputeTools } from './compute.js';
 import { pollJob } from './jobs.js';
 import { registerBaseTools } from './base.js';
+import { registerDomainTools } from './domains.js';
 import { presentTopup } from './qr.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 để chạy app/VPS, thu tiền MONA Pay và dùng các sản phẩm MONA. Base beta thay Supabase bằng cloud_base_*, chung account/ví MONA Cloud và khớp app deploy. Dùng mail_* để gửi email giao dịch (MONA Mail). MONA Mail là dịch vụ gửi email giao dịch cho phần mềm và AI agent của người Việt: một API, trả VND, không cần thẻ, thuộc nhóm MONA Cloud của The MONA Group.';
 const SANDBOX_DESCRIPTION = 'sandbox=true: thử 0đ, không cần ví';
@@ -317,6 +318,7 @@ export function createServer(dependencies = {}) {
     registerComputeTools(server, clients);
     registerBaseTools(server, clients);
     registerMailTools(server, clients, config);
+    registerDomainTools(server, clients);
     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. Deploy dự án: cloud_app_detect rồi cloud_app_create(local_dir), sandbox trước nếu chưa có host.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monacloud-mcp",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "MCP server for MONA Cloud — deploy apps (Vercel alternative), Supabase-compatible Postgres/Auth/Storage bases (Supabase alternative), VND wallet, MONA Pay & Mail — for AI agents (Claude, Cursor, Codex) in Vietnam.",
   "license": "MIT",
   "homepage": "https://monacloud.vn",