monacloud-mcp 0.10.11 → 0.10.12

package/dist/domains.js

@@ -50,6 +50,71 @@ export function registerDomainTools(server, clients) {
         }
         return results;
     }));
+    server.registerTool('cloud_domain_tld_groups', {
+        annotations: toolAnnotationsForName('cloud_domain_tld_groups'),
+        title: 'Danh mục đuôi tên miền theo ngành',
+        description: 'Liệt kê các nhóm ngành của đuôi tên miền (Ăn uống, Công nghệ & AI, Quốc gia, Việt Nam...) kèm số lượng đuôi và khoảng giá VND mỗi nhóm. Gọi tool này TRƯỚC cloud_domain_tlds để biết slug ngành cần lọc. Không cần đăng nhập.',
+        inputSchema: z.object({}).strict(),
+    }, () => runTool(() => clients.vibecloudGuestOk('/api/domains/tlds/groups')));
+    server.registerTool('cloud_domain_tlds', {
+        annotations: toolAnnotationsForName('cloud_domain_tlds'),
+        title: 'Bảng giá đuôi tên miền',
+        description: 'Bảng giá đầy đủ các đuôi tên miền MONA Domain bán được, giá VND đã gồm VAT — giá năm đầu (price_vnd, đã tính khuyến mãi nếu registry đang chạy) và giá gia hạn mỗi năm (renew_vnd). Lọc theo ngành (group, lấy slug từ cloud_domain_tld_groups), theo từ khoá (q), hoặc theo ngân sách (max_price_vnd). Dùng khi người dùng hỏi "có những đuôi nào", "đuôi nào rẻ", "đuôi nào hợp ngành X". Đuôi .vn có needs_verification=true nghĩa là cần hồ sơ xác thực chủ thể. Không cần đăng nhập.',
+        inputSchema: z.object({
+            scope: z.enum(['popular', 'all']).optional()
+                .describe('popular = nhóm đuôi thông dụng (mặc định), all = toàn bộ danh sách.'),
+            group: z.string().max(40).optional()
+                .describe('Slug ngành từ cloud_domain_tld_groups (vd: "an-uong", "cong-nghe", "viet-nam").'),
+            q: z.string().max(40).optional().describe('Tìm trong tên đuôi và nhãn tiếng Việt (vd: "shop").'),
+            max_price_vnd: z.number().int().min(0).optional().describe('Chỉ lấy đuôi có giá năm đầu không quá số này.'),
+            sort: z.enum(['popular', 'price', 'tld']).optional().describe('Thứ tự sắp xếp. Mặc định popular.'),
+            limit: z.number().int().min(1).max(1000).optional().describe('Số dòng tối đa. Mặc định 200.'),
+            offset: z.number().int().min(0).optional().describe('Bỏ qua bao nhiêu dòng đầu, để lật trang.'),
+        }).strict(),
+    }, ({ scope, group, q, max_price_vnd, sort, limit, offset }) => runTool(() => {
+        const params = new URLSearchParams();
+        if (scope)
+            params.set('scope', scope);
+        if (group)
+            params.set('group', group);
+        if (q)
+            params.set('q', q);
+        if (max_price_vnd !== undefined)
+            params.set('max_price_vnd', String(max_price_vnd));
+        if (sort)
+            params.set('sort', sort);
+        if (limit !== undefined)
+            params.set('limit', String(limit));
+        if (offset !== undefined)
+            params.set('offset', String(offset));
+        const query = params.toString();
+        return clients.vibecloudGuestOk(`/api/domains/tlds${query ? `?${query}` : ''}`);
+    }));
+    server.registerTool('cloud_domain_suggest', {
+        annotations: toolAnnotationsForName('cloud_domain_suggest'),
+        title: 'Gợi ý tên miền còn trống',
+        description: 'Gợi ý những tên miền còn trống quanh một từ khoá, kèm giá VND đã gồm VAT. Từ khoá nhận tiếng Việt có dấu, tool tự bỏ dấu thành nhãn hợp lệ. Truyền industry (slug từ cloud_domain_tld_groups) để ưu tiên đuôi hợp ngành — vd quán cà phê sẽ ra .cafe và .coffee trước. Mọi kết quả đều đã tra trạng thái thật tại nhà đăng ký. Dùng khi tên người dùng muốn đã có người lấy, hoặc khi họ chưa nghĩ ra tên. Sau khi người dùng chọn thì gọi cloud_domain_buy (hoặc cloud_domain_reserve nếu chưa đăng nhập). Không cần đăng nhập.',
+        inputSchema: z.object({
+            keyword: z.string().min(1).max(63)
+                .describe('Tên muốn đặt hoặc từ khoá mô tả sản phẩm (vd: "Cà Phê Sạch", "myapp").'),
+            industry: z.string().max(40).optional()
+                .describe('Slug ngành từ cloud_domain_tld_groups để ưu tiên đuôi hợp ngành.'),
+            limit: z.number().int().min(1).max(30).optional().describe('Số gợi ý trả về. Mặc định 12.'),
+            max_price_vnd: z.number().int().min(0).optional().describe('Chặn trần giá năm đầu.'),
+            include_taken: z.boolean().optional().describe('true = giữ lại cả tên đã có người đăng ký.'),
+        }).strict(),
+    }, ({ keyword, industry, limit, max_price_vnd, include_taken }) => runTool(() => {
+        const params = new URLSearchParams({ keyword });
+        if (industry)
+            params.set('industry', industry);
+        if (limit !== undefined)
+            params.set('limit', String(limit));
+        if (max_price_vnd !== undefined)
+            params.set('max_price_vnd', String(max_price_vnd));
+        if (include_taken)
+            params.set('include_taken', 'true');
+        return clients.vibecloudGuestOk(`/api/domains/tlds/suggest?${params}`);
+    }));
     server.registerTool('cloud_domain_registrant_get', {
         annotations: toolAnnotationsForName('cloud_domain_registrant_get'),
         title: 'Xem thông tin chủ thể đăng ký tên miền',

package/dist/monapay.js

@@ -4,7 +4,7 @@ import { MonaPayClient } from 'monapay-mcp/dist/client.js';
 import { CloudError, errorResult } from './errors.js';
 // cloud_subscription_update có thể huỷ gia hạn / dừng máy (cancel_action=stop) → xếp destructive để agent hỏi lại trước khi gọi.
 const DESTRUCTIVE = /(?:^|_)(?:delete|remove|cancel|release|rotate|stop|destroy|reset|revoke|suspend)(?:_|$)|^cloud_subscription_update$/;
-const READ_ONLY = /(?:^|_)(?:list|get|status|search|balance|ledger|health|whoami|usage|services|quote|detect|wait|logs|stats|templates|tlds|prices|packages)(?:_|$)/;
+const READ_ONLY = /(?:^|_)(?:list|get|status|search|balance|ledger|health|whoami|usage|services|quote|detect|wait|logs|stats|templates|tlds|prices|packages|suggest|groups)(?:_|$)/;
 const IDEMPOTENT_WRITE = /(?:^|_)(?:set|update|attach)(?:_|$)/;
 /** Mechanical metadata shared by native tools and tools imported from monapay-mcp. */
 export function toolAnnotationsForName(name) {

package/dist/remote.js

@@ -1,12 +1,13 @@
 import { randomUUID } from "node:crypto";
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { mkdirSync, mkdtempSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
 import { join } from "node:path";
 import cors from "cors";
 import express from "express";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { ProxyOAuthServerProvider } from "@modelcontextprotocol/sdk/server/auth/providers/proxyProvider.js";
 import { mcpAuthRouter } from "@modelcontextprotocol/sdk/server/auth/router.js";
-import { createServer as createMcpServer } from "./server.js";
+import { createServer as createMcpServer, PKG_VERSION } from "./server.js";
 import { createAccessTokenVerifier } from "./remote-verify.js";
 const SCOPES = ["openid", "profile", "email", "offline_access", "vibecloud-api", "billing-api"];
 // Keycloak DCR chỉ nhận tên client scope thật (openid/profile/email là mặc định, gửi kèm sẽ bị policy "Allowed Client Scopes" từ chối).
@@ -206,7 +207,7 @@ export async function createRemoteServer(options) {
         res.set("Location", target.toString()).status(302).end();
     });
     app.get("/healthz", (_req, res) => {
-        res.json({ ok: true, version: process.env.npm_package_version ?? "0.10.10", sessions: sessions.size });
+        res.json({ ok: true, version: PKG_VERSION, sessions: sessions.size });
     });
     // RFC 9728 cho phép metadata theo path của resource (/.well-known/oauth-protected-resource/mcp) — Smithery/Claude thử URL này trước.
     app.get(["/.well-known/oauth-protected-resource", "/.well-known/oauth-protected-resource/mcp"], (_req, res) => {
@@ -308,7 +309,11 @@ export async function createRemoteServer(options) {
             sessionIdGenerator: randomUUID,
             onsessioninitialized: (id) => { pendingSessionId = id; },
         });
-        const env = { ...process.env, ...options.env, MONACLOUD_TOKEN: auth.token };
+        // Mỗi người dùng (sub MONA Pass) một thư mục cấu hình riêng: monapay_link ghi links.json, tuyệt đối không dùng chung
+        // ~/.config/monacloud của tiến trình (nếu dùng chung, credential MONA Pay của người này lọt sang phiên người khác).
+        const userDir = join(options.dataDir ?? mkdtempSync(join(tmpdir(), "mcp-remote-")), "users", auth.extra.sub.replace(/[^a-zA-Z0-9_-]/g, "_"));
+        mkdirSync(userDir, { recursive: true, mode: 0o700 });
+        const env = { ...process.env, ...options.env, MONACLOUD_TOKEN: auth.token, MONACLOUD_CONFIG_DIR: userDir };
         const server = createServer({ env });
         await server.connect(transport);
         await transport.handleRequest(req, res, req.body);

package/dist/server.d.ts

@@ -1,5 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Config } from './config.js';
+export declare const PKG_VERSION: string;
 export type ServerDependencies = {
     config?: Config;
     env?: NodeJS.ProcessEnv;

package/dist/server.js

@@ -5,7 +5,7 @@ import { readConfig } from './config.js';
 import { AuthManager } from './auth.js';
 import { CloudClients } from './clients.js';
 // serverInfo.version đọc từ package.json (từng hardcode 0.8.1 → client báo sai bản)
-const PKG_VERSION = (() => {
+export const PKG_VERSION = (() => {
     try {
         return String(createRequire(import.meta.url)('../package.json').version);
     }

package/docs/connectors-directory-submission.md

@@ -0,0 +1,48 @@
+# Nộp Claude Connectors Directory — bản điền sẵn (Mon dán vào portal)
+
+Portal: https://claude.ai/admin-settings/directory/submissions/new — **cần tài khoản Claude Team/Enterprise, vai Owner**. Cá nhân không có mục này. Tài liệu: https://claude.com/docs/connectors/building/submission
+
+Điều kiện kỹ thuật đã đạt (19/09/2026): server HTTPS `https://mcp.monacloud.vn/mcp` (Streamable HTTP) · OAuth 2.0 + PKCE + Dynamic Client Registration (`/.well-known/oauth-authorization-server`, `/register`) · 177 tool đều có `title` + `readOnlyHint`/`destructiveHint` (monacloud-mcp ≥ 0.10.11) · chính sách quyền riêng tư https://monacloud.vn/chinh-sach-quyen-rieng-tu (EN: https://monacloud.vn/en/privacy) · Smithery đã quét thành công (177 tool, 3 prompt, 2 resource).
+
+## 2. Connection
+- Server URL: `https://mcp.monacloud.vn/mcp` · Transport: Streamable HTTP · Universal URL (một URL cho mọi người dùng).
+
+## 4. Listing
+- Name (≤100): `MONA Cloud`
+- Tagline (≤55): `Domains .vn, deploy, Postgres, VietQR pay for Vietnam`
+- Description (≤2000, tiếng Anh):
+  MONA Cloud gives Claude the tools Vietnamese builders need to ship a product end to end. Search and buy .vn and 370+ international domains priced in VND with VAT, reserve a name for 30 minutes and pay by VietQR from any Vietnamese banking app, then point DNS and SSL at your app. Deploy the app you are working on to MONA Cloud (a Vercel-style host billed in VND), create Postgres, Auth and Storage bases (a Supabase-style backend), send transactional email with MONA Mail, and accept bank-transfer payments with MONA Pay, all from one MONA Pass account and one VND wallet. When the wallet runs low, Claude shows a VietQR code; you scan it and continue. MONA Cloud is operated by The MONA Group (Vietnam, since 2016, 14,000+ projects). Domain search and quotes work before you sign in; buying, deploying and paying use your MONA Pass login.
+- Categories: Developer Tools · Cloud & Infrastructure · Domains/Hosting · Payments (chọn 1–5 theo danh mục portal)
+- Documentation URL: https://monacloud.vn/docs/mcp-va-sdk (thêm: https://monadomain.vn/docs, https://github.com/themonagroup/monacloud-mcp/blob/main/docs/remote.md)
+- Privacy policy URL: https://monacloud.vn/en/privacy
+- Support contact: info@themona.global · hotline 1900 636 648
+- Icon: `~/mona-hub/brand/mona/monacloud/fav-monacloud.svg` (PNG 512: https://monadomain.vn/icon-512.png)
+- Slug: `mona-cloud`
+
+## 5. Use cases
+- Primary use cases: (1) buy and configure a .vn or international domain for the app being built, in VND; (2) deploy the current project and databases to MONA Cloud and manage them; (3) accept VietQR bank-transfer payments and send transactional email from the app.
+- Prerequisites: a free MONA Pass account (created on first login, Google/GitHub/email). Paid actions need VND in the wallet; Claude shows a VietQR to top up. .vn domains require the registrant's identity per Vietnamese law (Claude fills the form, the user verifies once).
+- Reads and writes data: both.
+
+## Example prompts (≥3, mỗi prompt đụng tool khác nhau)
+1. "Buy a domain for this app, prefer .vn, budget 800,000 VND." → cloud_domain_search → cloud_domain_reserve → cloud_domain_claim/cloud_domain_buy
+2. "Deploy this folder to MONA Cloud and give me the URL." → cloud_app_detect → cloud_app_create → cloud_app_status
+3. "Create a Postgres base for this project and put the connection string in .env." → cloud_base_create → cloud_base_credentials
+4. "Point mydomain.vn at the deployed app with SSL." → cloud_domain_attach → cloud_domain_dns_list
+5. "Check my wallet balance and top up 200,000 VND." → cloud_balance → cloud_topup → cloud_topup_status
+
+## 6. Company
+- The MONA Group (Công ty TNHH MONA MEDIA), https://mona.media — contact: Vy Nguyễn Khánh Hùng, mon@themona.global
+
+## 7. Authentication
+- OAuth 2.0 with **dynamic client registration** (RFC 7591) at `https://mcp.monacloud.vn/register`; authorization server metadata at `https://mcp.monacloud.vn/.well-known/oauth-authorization-server`; PKCE S256; refresh tokens (offline_access). Identity provider: MONA Pass (Keycloak) at pass.monacloud.vn.
+
+## 8. Data handling
+- Underlying API is our own (api.monacloud.vn, billing.monacloud.vn, MONA Pass). No personal health data. No sponsored content. Domain registration data is passed to the registrar/VNNIC as required by law (see privacy policy).
+
+## 9. Test & launch
+- Test account: tài khoản MONA Pass riêng cho reviewer — lấy trong `~/.config/mona/monapass-e2e.env` (user `mon+mcp-e2e@themona.global`). Trước khi nộp: nạp ví test ~200.000đ để reviewer chạy được tool có phí ở sandbox (`MONACLOUD_SANDBOX` không áp cho remote → nêu rõ tool nào tính tiền).
+- Steps for reviewer: Add custom connector → URL above → sign in with the test account → run `cloud_whoami`, `cloud_balance`, `cloud_domain_search` (q="monatest", tlds="vn,com"), `cloud_domain_reserve` (creates a 30-minute hold, no charge), `cloud_app_detect` on any folder.
+- Confirm: every tool exercised via `support/e2e-remote.mjs` + MCP Inspector (19/09/2026).
+
+## 10. Compliance — 7 xác nhận (đọc và tick trong portal).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monacloud-mcp",
-  "version": "0.10.11",
+  "version": "0.10.12",
   "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",