@nexdoc/mcp-server 0.1.1 → 0.2.1

package/README.md

@@ -28,7 +28,9 @@ Model Context Protocol server for [NexDoc Design](https://www.nexdoc.design).
 
 ## Tools
 
-`create_design`, `update_design`, `check_run`, `refresh_preview`, `wait_for_run`, `list_runs`, `export_design`, `publish_design`, `unpublish_design`, `list_formats`, `get_balance`
+`create_design`, `update_design`, `check_run`, `refresh_preview`, `wait_for_run`, `notify_run_email`, `list_runs`, `export_design`, `publish_design`, `unpublish_design`, `list_formats`, `get_balance`
+
+`create_design` / `update_design` accept `notify_email: true` to email the account owner when the run finishes. `notify_run_email` does the same for a run that already started; if that run is already done, the tool returns a `warning` and no email is sent.
 
 ## Develop
 

package/dist/client.d.ts

@@ -12,6 +12,7 @@ export type RunCreated = {
     run_id: string;
     status: string;
     created_at: string;
+    notify_email?: boolean;
 };
 export type RunStatus = {
     run_id: string;
@@ -37,6 +38,7 @@ export declare function createRunJson(jobId: string, body: {
         file_id: string;
     }>;
     webhook_url?: string;
+    notify_email?: boolean;
 }): Promise<RunCreated>;
 export declare function createRunMultipart(jobId: string, opts: {
     format?: string;
@@ -44,6 +46,7 @@ export declare function createRunMultipart(jobId: string, opts: {
     content?: string;
     contentPath?: string;
     assetPaths?: string[];
+    notify_email?: boolean;
 }): Promise<RunCreated>;
 export declare function getRun(jobId: string, runId: string): Promise<RunStatus>;
 export declare function listRuns(jobId: string): Promise<{
@@ -54,6 +57,7 @@ export declare function exportDesign(jobId: string, format: "pdf" | "html", runI
 export declare function publishDesign(jobId: string, runId?: string): Promise<Record<string, unknown>>;
 export declare function unpublishDesign(jobId: string): Promise<Record<string, unknown>>;
 export declare function getPreviewLink(jobId: string): Promise<Record<string, unknown>>;
+export declare function requestRunEmail(jobId: string, runId: string): Promise<Record<string, unknown>>;
 export declare function getBalance(): Promise<Record<string, unknown>>;
 export declare function waitForRun(jobId: string, runId: string, opts?: {
     timeoutSec?: number;

package/dist/client.js

@@ -79,6 +79,8 @@ export async function createRunMultipart(jobId, opts) {
                         : "application/octet-stream";
         form.append("files", new Blob([buf], { type }), name);
     }
+    if (opts.notify_email)
+        form.set("notify_email", "true");
     return request("POST", `/v1/jobs/${jobId}/runs`, { form });
 }
 export async function getRun(jobId, runId) {
@@ -103,6 +105,9 @@ export async function unpublishDesign(jobId) {
 export async function getPreviewLink(jobId) {
     return request("GET", `/v1/jobs/${jobId}/viewer/session`);
 }
+export async function requestRunEmail(jobId, runId) {
+    return request("POST", `/v1/jobs/${jobId}/runs/${runId}/notify-email`, { json: {} });
+}
 export async function getBalance() {
     return request("GET", "/v1/credits");
 }

package/dist/tools.js

@@ -43,6 +43,10 @@ export function registerTools(server) {
             .optional()
             .describe("If true, poll until terminal status before returning"),
         timeout_sec: z.number().optional().describe("Wait timeout seconds (default 900)"),
+        notify_email: z
+            .boolean()
+            .optional()
+            .describe("If true, email the account owner when the run finishes (completed, failed, or cancelled). Use when you cannot poll for the full duration."),
     }, async (args) => {
         try {
             let jobId = args.job_id;
@@ -58,11 +62,13 @@ export function registerTools(server) {
                     content: args.content,
                     contentPath: args.content_path,
                     assetPaths: args.asset_paths,
+                    notify_email: args.notify_email,
                 })
                 : await api.createRunJson(jobId, {
                     format: args.format,
                     instructions: args.instructions,
                     content: args.content ?? "",
+                    notify_email: args.notify_email,
                 });
             if (args.wait) {
                 const final = await api.waitForRun(jobId, created.run_id, {
@@ -70,7 +76,13 @@ export function registerTools(server) {
                 });
                 return ok({ job_id: jobId, run: final });
             }
-            return ok({ job_id: jobId, run_id: created.run_id, status: created.status, created_at: created.created_at });
+            return ok({
+                job_id: jobId,
+                run_id: created.run_id,
+                status: created.status,
+                created_at: created.created_at,
+                notify_email: created.notify_email ?? false,
+            });
         }
         catch (err) {
             return fail(err);
@@ -83,12 +95,17 @@ export function registerTools(server) {
         content: z.string().optional(),
         wait: z.boolean().optional(),
         timeout_sec: z.number().optional(),
+        notify_email: z
+            .boolean()
+            .optional()
+            .describe("If true, email the account owner when the run finishes. Use when you cannot poll for the full duration."),
     }, async (args) => {
         try {
             const created = await api.createRunJson(args.job_id, {
                 format: args.format,
                 instructions: args.instructions,
                 content: args.content ?? "",
+                notify_email: args.notify_email,
             });
             if (args.wait) {
                 const final = await api.waitForRun(args.job_id, created.run_id, {
@@ -121,6 +138,17 @@ export function registerTools(server) {
             return fail(err);
         }
     });
+    server.tool("notify_run_email", "Request an email when an in-progress run finishes (completed, failed, or cancelled). Emails the authenticated account. If the run is already terminal, returns a warning and does not send.", {
+        job_id: z.string(),
+        run_id: z.string(),
+    }, async (args) => {
+        try {
+            return ok(await api.requestRunEmail(args.job_id, args.run_id));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
     server.tool("wait_for_run", "Poll a run until completed, failed, or cancelled (or timeout).", {
         job_id: z.string(),
         run_id: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexdoc/mcp-server",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "NexDoc Design MCP server — create, update, export, and publish designs via API key (stdio) or OAuth (HTTP).",
   "type": "module",
   "bin": {