@prompteryx/mcp-server 1.0.1

package/dist/utils/node-config-loader.js

@@ -0,0 +1,105 @@
+/**
+ * Node Config → Zod Schema Converter
+ *
+ * Converts Prompteryx ParamDefinition objects from NODE_CONFIGS into
+ * Zod schemas suitable for MCP tool registration.
+ * Fetches configs from the platform API so the MCP server
+ * stays in sync without bundling the full config.
+ */
+import { z } from 'zod';
+/**
+ * Fetches integration node configs from the platform API.
+ * Falls back to empty array if unavailable.
+ */
+export async function fetchIntegrationConfigs(apiKey, apiUrl) {
+    try {
+        const res = await fetch(`${apiUrl}/api/v1/node-configs?category=integration`, {
+            headers: { 'X-API-Key': apiKey },
+        });
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        // The platform wraps responses as { success, data: { configs: [...] } };
+        // older builds returned { data: [...] } or { configs: [...] }. Accept all
+        // three and never hand a non-array to the caller (it .filter()s the result).
+        const body = data?.data ?? data;
+        const list = Array.isArray(body) ? body : (body?.configs ?? data?.configs ?? []);
+        return (Array.isArray(list) ? list : []);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Converts a ParamDefinition from NODE_CONFIGS into a Zod schema.
+ * Handles string, number, boolean, select, textarea, json, etc.
+ */
+export function paramDefToZod(name, def) {
+    const desc = def.description ?? def.label ?? def.displayName ?? name;
+    let schema;
+    switch (def.type) {
+        case 'select': {
+            const values = (def.options ?? []).map((o) => String(o.value));
+            if (values.length >= 2) {
+                schema = z.enum(values).describe(desc);
+            }
+            else if (values.length === 1) {
+                schema = z.literal(values[0]).describe(desc);
+            }
+            else {
+                schema = z.string().describe(desc);
+            }
+            break;
+        }
+        case 'number':
+            schema = z.number().describe(desc);
+            if (def.min !== undefined)
+                schema = schema.min(def.min);
+            if (def.max !== undefined)
+                schema = schema.max(def.max);
+            break;
+        case 'boolean':
+            schema = z.boolean().describe(desc);
+            break;
+        case 'json':
+            schema = z.any().describe(desc);
+            break;
+        case 'textarea':
+        case 'string':
+        default:
+            schema = z.string().describe(desc);
+            break;
+    }
+    if (!def.required) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+/**
+ * Builds a Zod object schema from an integration node's paramSchema.
+ * Filters out display-only params (notice, heading) and internal params.
+ */
+export function buildToolSchema(config) {
+    const shape = {};
+    const skipTypes = new Set(['notice', 'heading', 'divider', 'info']);
+    for (const [key, def] of Object.entries(config.paramSchema)) {
+        if (key.startsWith('_'))
+            continue;
+        if (skipTypes.has(def.type))
+            continue;
+        shape[key] = paramDefToZod(key, def);
+    }
+    // Always include credentialId so the user can pick which OAuth connection to use
+    if (config.credentials && config.credentials.length > 0) {
+        shape.credentialId = z.string().describe('ID of the OAuth credential to use (from your Prompteryx Connections)').optional();
+    }
+    return z.object(shape);
+}
+/**
+ * Generates a clean MCP tool name from a node type.
+ * e.g. "gmail-message-send" → "gmail_message_send"
+ */
+export function nodeTypeToToolName(type) {
+    return type.replace(/-/g, '_');
+}
+//# sourceMappingURL=node-config-loader.js.map

package/dist/utils/node-config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-config-loader.js","sourceRoot":"","sources":["../../src/utils/node-config-loader.ts"],"names":[],"mappings":"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"}

package/dist/utils/output-formatter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Output Formatter
+ *
+ * Converts NodeOutput and other execution results into MCP-compatible
+ * content blocks using the exact types the MCP SDK expects.
+ */
+type TextContent = {
+    type: 'text';
+    text: string;
+};
+type ImageContent = {
+    type: 'image';
+    data: string;
+    mimeType: string;
+};
+type McpContent = TextContent | ImageContent;
+export interface McpToolResult {
+    content: McpContent[];
+    isError?: boolean;
+    [key: string]: unknown;
+}
+interface NodeOutput {
+    json: Record<string, any>;
+    inputData?: {
+        json: Record<string, any>;
+    };
+    error?: {
+        message: string;
+        description?: string;
+    };
+}
+export declare function formatSuccess(data: Record<string, any>, extras?: Record<string, any>): McpToolResult;
+export declare function formatError(message: string, suggestion?: string, extras?: Record<string, any>): McpToolResult;
+export declare function formatNodeOutput(nodeOutput: NodeOutput | null, screenshotBase64?: string): McpToolResult;
+export declare function formatScreenshot(base64: string, url?: string, title?: string): McpToolResult;
+export {};
+//# sourceMappingURL=output-formatter.d.ts.map

package/dist/utils/output-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/output-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAClD,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,KAAK,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;IAC1C,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,CAMpG;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,CAQ7G;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,aAAa,CA4Bf;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAiB5F"}

package/dist/utils/output-formatter.js

@@ -0,0 +1,62 @@
+/**
+ * Output Formatter
+ *
+ * Converts NodeOutput and other execution results into MCP-compatible
+ * content blocks using the exact types the MCP SDK expects.
+ */
+export function formatSuccess(data, extras) {
+    const output = { success: true, ...data };
+    if (extras)
+        Object.assign(output, extras);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+    };
+}
+export function formatError(message, suggestion, extras) {
+    const output = { success: false, error: message };
+    if (suggestion)
+        output.suggestion = suggestion;
+    if (extras)
+        Object.assign(output, extras);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+        isError: true,
+    };
+}
+export function formatNodeOutput(nodeOutput, screenshotBase64) {
+    if (!nodeOutput) {
+        return formatError('Node produced no output');
+    }
+    if (nodeOutput.error) {
+        return formatError(nodeOutput.error.message, nodeOutput.error.description || 'Try using browser_screenshot to see the current page state.');
+    }
+    const content = [];
+    content.push({
+        type: 'text',
+        text: JSON.stringify({ success: true, data: nodeOutput.json }, null, 2),
+    });
+    if (screenshotBase64) {
+        content.push({
+            type: 'image',
+            data: screenshotBase64,
+            mimeType: 'image/png',
+        });
+    }
+    return { content };
+}
+export function formatScreenshot(base64, url, title) {
+    const content = [];
+    if (url || title) {
+        content.push({
+            type: 'text',
+            text: JSON.stringify({ success: true, url: url ?? '', title: title ?? '' }),
+        });
+    }
+    content.push({
+        type: 'image',
+        data: base64,
+        mimeType: 'image/png',
+    });
+    return { content };
+}
+//# sourceMappingURL=output-formatter.js.map

package/dist/utils/output-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-formatter.js","sourceRoot":"","sources":["../../src/utils/output-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,UAAU,aAAa,CAAC,IAAyB,EAAE,MAA4B;IACnF,MAAM,MAAM,GAAwB,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;IAC/D,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,UAAmB,EAAE,MAA4B;IAC5F,MAAM,MAAM,GAAwB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACvE,IAAI,UAAU;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/C,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAC7B,gBAAyB;IAEzB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,WAAW,CAChB,UAAU,CAAC,KAAK,CAAC,OAAO,EACxB,UAAU,CAAC,KAAK,CAAC,WAAW,IAAI,6DAA6D,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;KACxE,CAAC,CAAC;IAEH,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAY,EAAE,KAAc;IAC3E,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@prompteryx/mcp-server",
+  "version": "1.0.1",
+  "mcpName": "ai.prompteryx/mcp-server",
+  "description": "Prompteryx MCP Server -- Browser automation, AI agents, workflow execution, and 20+ integrations for any MCP client",
+  "author": "Prompteryx <support@prompteryx.ai>",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "prompteryx-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "browser-automation",
+    "playwright",
+    "prompteryx",
+    "ai-agent",
+    "workflow",
+    "gmail",
+    "slack",
+    "google-sheets"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "playwright-core": "^1.52.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}