monacloud-mcp 0.5.0 → 0.7.0

package/STATUS.md

@@ -10,7 +10,7 @@ Updated: 2026-09-14 (Asia/Ho_Chi_Minh)
 - Mô tả tool, instructions, resource, prompt, README và agent guide ghi Base **beta** = thay Supabase, chung account/ví MONA Cloud, khớp app deploy.
 - Package, binary và MCP handshake đã bump minor lên `0.5.0`; stdio có 145 tool.
 - `npm test` offline: **52 tests, 52 pass, 0 fail, 0 skip**, gồm TypeScript build và HTTP mock Base create/poll/sandbox/list/get/delete/credentials/aliases.
-- Không publish, không gọi API production. **Chờ Base provision-live để publish.**
+- ✅ **PUBLISHED npm `monacloud-mcp@0.5.0`** (2026-09-14, tag latest, acc rxathu9999) sau khi Base đạt provision-live + verified (base up ~4.5 phút, supabase-js chạy). MCP trỏ prod `https://api.monacloud.vn` (base_* live: /api/bases 401, capabilities có key `base`). Mon chốt "public mona base đi".
 
 CODEX DONE
 

package/dist/mail.js

@@ -22,7 +22,10 @@ const empty = z.object({}).strict();
 const events = z.enum([
     'email.sent', 'email.delivered', 'email.deferred', 'email.bounced',
     'email.complained', 'email.suppressed', 'email.failed', 'domain.verified',
+    'inbox.message',
 ]);
+const agentId = z.string().trim().min(1).max(64).regex(/^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$/, 'agent_id chỉ nhận chữ thường, số, dấu chấm, gạch dưới hoặc gạch nối.');
+const inboxMatch = z.string().trim().min(1).max(200).describe('otp để lấy mã, hoặc regex khớp nội dung/subject/from.');
 const status = z.enum(['queued', 'sent', 'delivered', 'deferred', 'bounced', 'complained', 'suppressed', 'failed', 'sandbox']);
 function idempotencyHeaders(key) {
     return { 'Idempotency-Key': key || `mcp-mail-${randomUUID()}` };
@@ -180,4 +183,79 @@ export function registerMailTools(server, clients, config) {
         description: 'Khi đánh giá khả năng giao thư, đọc tỷ lệ delivered và bounce theo thời gian. / Use to review email delivery statistics.',
         inputSchema: z.object({ from: dateOrTimestamp.optional(), to: dateOrTimestamp.optional() }).strict().refine((value) => !value.from || !value.to || Date.parse(value.from) <= Date.parse(value.to), 'Thời điểm from phải trước hoặc bằng to.'),
     }, (query) => runTool(() => clients.mail('/v1/stats', { query })));
+    // ── Hộp thư AI agent (nhận + đọc + trả lời) ─────────────────────────────
+    server.registerTool('mail_inbox_create', {
+        title: 'Tạo hộp thư agent',
+        description: 'Khi cần một địa chỉ email cho agent trực (đọc thư, trả lời), tạo hộp. Bỏ domain để dùng miền agent.monamail.vn (nhận ngay); truyền domain đã verify để có địa chỉ brand. / Use to create an inbox an AI agent can read and reply from.',
+        inputSchema: z.object({ agent_id: agentId, domain: domain.optional() }).strict(),
+    }, ({ agent_id, domain }) => runTool(() => clients.mail('/v1/inboxes', {
+        method: 'POST', body: domain ? { agent_id, domain } : { agent_id },
+    })));
+    server.registerTool('mail_inbox_list', {
+        title: 'Danh sách hộp agent',
+        description: 'Khi cần biết agent đang trực những hộp nào, liệt kê hộp còn hoạt động. / Use to list active agent inboxes.',
+        inputSchema: empty,
+    }, () => runTool(() => clients.mail('/v1/inboxes')));
+    server.registerTool('mail_inbox_get', {
+        title: 'Xem hộp agent',
+        description: 'Khi cần địa chỉ và trạng thái của một hộp, đọc chi tiết. / Use to read one inbox.',
+        inputSchema: z.object({ inbox_id: id }).strict(),
+    }, ({ inbox_id }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}`)));
+    server.registerTool('mail_inbox_delete', {
+        title: 'Xóa hộp agent',
+        description: 'Khi hộp không còn dùng, xóa mềm; thư cũ còn đọc tới hết retention. / Use to soft-delete an inbox.',
+        inputSchema: z.object({ inbox_id: id }).strict(),
+    }, ({ inbox_id }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}`, { method: 'DELETE' })));
+    server.registerTool('mail_inbox_messages', {
+        title: 'Thư trong hộp agent',
+        description: 'Khi trực hộp, liệt kê thư nhận; lọc seen=false để lấy thư chưa xử lý, phân trang bằng cursor. / Use to list messages an agent needs to handle.',
+        inputSchema: z.object({
+            inbox_id: id,
+            seen: z.boolean().optional().describe('false = chỉ thư chưa đọc.'),
+            since: timestamp.optional(),
+            limit: z.number().int().min(1).max(100).default(50),
+            cursor: z.string().min(1).max(255).optional(),
+        }).strict(),
+    }, ({ inbox_id, seen, since, limit, cursor }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}/messages`, {
+        query: { limit, cursor, since, ...(seen === undefined ? {} : { seen: String(seen) }) },
+    })));
+    server.registerTool('mail_inbox_message', {
+        title: 'Đọc thư trong hộp',
+        description: 'Khi cần nội dung đầy đủ, header và đính kèm của một thư, đọc chi tiết; lần đọc đầu đánh dấu đã xem. / Use to read a full inbox message before replying.',
+        inputSchema: z.object({ inbox_id: id, message_id: id }).strict(),
+    }, ({ inbox_id, message_id }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}/messages/${encodeURIComponent(message_id)}`)));
+    server.registerTool('mail_inbox_reply', {
+        title: 'Trả lời thư trong hộp',
+        description: 'Khi agent trả lời khách, gửi đúng thread (In-Reply-To, References) từ địa chỉ hộp; cần text hoặc html. Việc khó rút lại (hứa giá, chuyển tiền) thì báo người, đừng tự gửi. / Use to reply to an inbox message in-thread.',
+        inputSchema: z.object({ inbox_id: id, message_id: id, text: z.string().min(1).optional(), html: z.string().min(1).optional() })
+            .strict().refine((value) => value.text || value.html, 'Cần text hoặc html để trả lời.'),
+    }, ({ inbox_id, message_id, ...body }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}/messages/${encodeURIComponent(message_id)}/reply`, { method: 'POST', body })));
+    server.registerTool('mail_inbox_wait', {
+        title: 'Chờ thư trong hộp',
+        description: 'Khi cần chờ thư tới (ví dụ mã OTP hoặc thư khớp mẫu), chờ tối đa timeout giây; có thư khớp trả full nội dung + extracted_code, hết giờ trả 204. Gọi lại nếu cần chờ lâu hơn. / Use to wait for an OTP or a matching message.',
+        inputSchema: z.object({ inbox_id: id, match: inboxMatch, timeout: z.number().int().min(0).max(300).default(120) }).strict(),
+    }, ({ inbox_id, match, timeout }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}/wait`, {
+        query: { match, timeout },
+    })));
+    server.registerTool('mail_inbox_update', {
+        title: 'Cấu hình hộp agent',
+        description: 'Khi cần đặt cách hộp xử lý thư: mode redirect (tự forward thư về email chủ) | store (chỉ lưu) | ai (để AI trực), địa chỉ forward_to, chat Telegram nhận báo, hoặc bật/tắt hộp. / Use to configure an inbox: redirect-forward email, Telegram chat, mode, active.',
+        inputSchema: z.object({
+            inbox_id: id,
+            forward_to: email.optional().describe('Email chủ nhận bản forward khi mode=redirect.'),
+            mode: z.enum(['redirect', 'store', 'ai']).optional().describe('redirect=tự forward về forward_to · store=chỉ lưu · ai=để AI trực.'),
+            notify_telegram: z.string().max(64).optional().describe('chat_id Telegram nhận ping khi có thư.'),
+            active: z.boolean().optional(),
+        }).strict().refine((v) => Object.keys(v).length > 1, 'Cần ít nhất một trường để cập nhật.'),
+    }, ({ inbox_id, ...body }) => runTool(() => clients.mail(`/v1/inboxes/${encodeURIComponent(inbox_id)}`, { method: 'PATCH', body })));
+    server.registerTool('mail_inbox_batch', {
+        title: 'Tạo nhiều hộp agent',
+        description: 'Khi cần tạo nhiều địa chỉ một lần (ví dụ mỗi nhân viên một hộp), tạo hàng loạt trong quota gói; lỗi từng hộp không hủy cả batch. / Use to create many inboxes at once.',
+        inputSchema: z.object({
+            agent_ids: z.array(agentId).min(1).max(100),
+            domain: domain.optional(),
+            forward_to: email.optional(),
+            mode: z.enum(['redirect', 'store', 'ai']).optional(),
+        }).strict(),
+    }, (body) => runTool(() => clients.mail('/v1/inboxes/batch', { method: 'POST', body })));
 }

package/package.json

@@ -1,8 +1,33 @@
 {
   "name": "monacloud-mcp",
-  "version": "0.5.0",
-  "description": "Unified MCP server for MONA Cloud, MONA Pay and MONA Agent.",
+  "version": "0.7.0",
+  "description": "MCP server for MONA Cloud \u2014 deploy apps (Vercel alternative), Supabase-compatible Postgres/Auth/Storage bases (Supabase alternative), VND wallet, MONA Pay & Mail \u2014 for AI agents (Claude, Cursor, Codex) in Vietnam.",
   "license": "MIT",
+  "homepage": "https://monacloud.vn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/themonagroup/monacloud-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/themonagroup/monacloud-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mona-cloud",
+    "mona-base",
+    "supabase-alternative",
+    "vercel-alternative",
+    "vietnam",
+    "vnd",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "codex",
+    "postgres",
+    "deploy",
+    "vibecoder"
+  ],
   "type": "module",
   "bin": {
     "monacloud-mcp": "dist/index.js"