Check render status

src/constants.ts

@@ -0,0 +1,3 @@
+import env from "./env";
+
+export const PLAINLY_APP_URL = env.PLAINLY_API_URL.replace("api.", "app.");

src/sdk/api/getRenderItem.ts

@@ -0,0 +1,13 @@
+import { AxiosResponse } from "axios";
+import { createAxiosInstance } from "../../axiosConfig";
+import { Render } from "../types";
+
+const api = createAxiosInstance();
+
+export const getRenderItem = async (renderingId: string): Promise<Render> => {
+  const response = await api.get<Render, AxiosResponse<Render>, void>(
+    `/api/v2/renders/${renderingId}`
+  );
+
+  return response.data;
+};

src/sdk/api/index.ts

@@ -1,3 +1,4 @@
 export * from "./listRenderableItems";
 export * from "./getRenderableItemDetails";
 export * from "./renderItem";
+export * from "./getRenderItem";

src/server.ts

@@ -4,6 +4,7 @@ import {
   registerListRenderableItems,
   registerGetRenderableItemDetails,
   registerRenderItem,
+  registerCheckRenderStatus,
 } from "./tools";
 
 export class PlainlyMcpServer {
@@ -21,6 +22,7 @@ export class PlainlyMcpServer {
     registerListRenderableItems(this.server);
     registerGetRenderableItemDetails(this.server);
     registerRenderItem(this.server);
+    registerCheckRenderStatus(this.server);
   }
 
   async start() {

src/tools/checkRenderStatus.ts

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getRenderItem } from "../sdk";
+import { PLAINLY_APP_URL } from "../constants";
+
+export function registerCheckRenderStatus(server: McpServer) {
+  const Input = {
+    renderId: z
+      .string()
+      .describe("The render ID returned from the `render_item` tool."),
+  };
+
+  const Output = {
+    // Status information
+    message: z
+      .string()
+      .describe("A human-readable message for the render status."),
+    renderId: z.string().describe("The render job ID."),
+    renderDetailsPageUrl: z
+      .string()
+      .optional()
+      .describe("URL to the render details page."),
+    state: z
+      .enum([
+        "PENDING",
+        "THROTTLED",
+        "QUEUED",
+        "IN_PROGRESS",
+        "DONE",
+        "FAILED",
+        "INVALID",
+        "CANCELLED",
+      ])
+      .describe("The current state of the render job."),
+    projectName: z
+      .string()
+      .optional()
+      .describe("Name of the project or design."),
+    templateName: z
+      .string()
+      .optional()
+      .describe("Name of the template or variant."),
+
+    // Success output
+    output: z
+      .string()
+      .optional()
+      .describe("The render output URL (only available when state is DONE)."),
+
+    // Error information
+    errorMessage: z.string().optional().describe("Error message, if any."),
+    errorSolution: z.string().optional().describe("Error solution, if any."),
+    errorDetails: z.any().optional().describe("Error details, if any."),
+  };
+
+  server.registerTool(
+    "check_render_status",
+    {
+      title: "Check Render Status",
+      description: `
+Check the status of a render job and optionally wait for completion.
+
+Use when:
+- You need to check the progress of a render job
+- You want to retrieve the final render output URL
+- You want to retrieve render error details if the job failed
+      `,
+      inputSchema: Input,
+      outputSchema: Output,
+    },
+    async ({ renderId }) => {
+      try {
+        const render = await getRenderItem(renderId);
+
+        // Handle successful completion
+        if (render.state === "DONE") {
+          return {
+            content: [],
+            structuredContent: {
+              message: "Render completed successfully.",
+              renderId: render.id,
+              renderDetailsPageUrl: `${PLAINLY_APP_URL}/dashboard/renders/${render.id}`,
+              state: render.state,
+              projectName: render.projectName,
+              templateName: render.templateName,
+              output: render.output,
+            },
+          };
+        }
+
+        if (render.state === "CANCELLED") {
+          return {
+            content: [],
+            structuredContent: {
+              message: "Render was cancelled.",
+              renderId: render.id,
+              state: render.state,
+              projectName: render.projectName,
+              templateName: render.templateName,
+            },
+          };
+        }
+
+        // Handle error states
+        if (render.state === "FAILED" || render.state === "INVALID") {
+          return {
+            content: [],
+            structuredContent: {
+              message: "Render failed.",
+              renderId: render.id,
+              state: render.state,
+              projectName: render.projectName,
+              templateName: render.templateName,
+              errorMessage: render.error.message,
+              errorDetails: JSON.stringify(render.error.details),
+            },
+            isError: true,
+          };
+        }
+
+        // Processing
+        return {
+          content: [],
+          structuredContent: {
+            message: "Render is processing. Please wait and check back later.",
+            renderId: render.id,
+            state: render.state,
+            projectName: render.projectName,
+            templateName: render.templateName,
+          },
+        };
+      } catch (err: any) {
+        return {
+          content: [],
+          structuredContent: {
+            message: "Render status could not be retrieved.",
+            renderId,
+            errorMessage: err.message || "Failed to check render status",
+            errorDetails: err,
+          },
+          isError: true,
+        };
+      }
+    }
+  );
+}

src/tools/index.ts

@@ -1,3 +1,4 @@
 export * from "./getRenderableItemDetails";
 export * from "./listRenderableItems";
 export * from "./renderItem";
+export * from "./checkRenderStatus";

src/tools/renderItem.ts

@@ -13,6 +13,7 @@ import {
   ProjectDesignNotFoundError,
   TemplateVariantNotFoundError,
 } from "./errors";
+import { PLAINLY_APP_URL } from "../constants";
 
 export function registerRenderItem(server: McpServer) {
   const Input = {
@@ -153,7 +154,7 @@ Use when:
         // Successful submission
         const output = {
           renderId: render.id,
-          renderDetailsPageUrl: `https://app.test.plainlyvideos.com/dashboard/renders/${render.id}`,
+          renderDetailsPageUrl: `${PLAINLY_APP_URL}/dashboard/renders/${render.id}`,
           projectDesignId: render.projectId,
           templateVariantId: render.templateId,
           projectDesignName: render.projectName,