@transcend-io/mcp-server-workflows 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# @transcend-io/mcp-server-workflows
+
+> **Alpha** — this package is under active development and has not yet been published to npm. APIs may change without notice.
+
+Transcend MCP Server for workflow configuration. Provides tools for listing workflows, email templates, and updating workflow settings.
+
+Requires **Node.js ≥ 22.12** (see `engines` in `package.json`).
+
+For local runs from this repository, copy [`secret.env.example`](../../../secret.env.example) to **`secret.env`** at the repo root (gitignored) and set your API key (see **Run from the monorepo**).
+
+## Install
+
+When the package is available on npm, install the CLI globally:
+
+```bash
+npm install -g @transcend-io/mcp-server-workflows
+```
+
+Until then, run from a checkout of this repository (see **Run from the monorepo** below).
+
+## Usage
+
+```bash
+# With TRANSCEND_API_KEY in the environment; from the monorepo use secret.env (see Run from the monorepo)
+TRANSCEND_API_KEY=your-api-key transcend-mcp-workflows
+```
+
+The process speaks MCP over **stdio** and is meant to be launched by an MCP client (for example Cursor or Claude Desktop), not used as an interactive shell.
+
+### MCP client configuration
+
+`npx` runs the package’s `transcend-mcp-workflows` binary (see `bin` in `package.json`).
+
+```json
+{
+  "mcpServers": {
+    "transcend-workflows": {
+      "command": "npx",
+      "args": ["-y", "@transcend-io/mcp-server-workflows"],
+      "env": {
+        "TRANSCEND_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+When developing in this repository, reuse the same variable names from root **`secret.env`** in the `env` block, or use your client’s env-file support if it has one.
+
+### Run from the monorepo
+
+1. **Credentials** — From the repository root, copy [`secret.env.example`](../../../secret.env.example) to **`secret.env`** and set `TRANSCEND_API_KEY` (and optional URL overrides).
+
+2. **Build and run** — `node ./dist/cli.mjs` matches the `transcend-mcp-workflows` `bin` (use `node` because `pnpm exec transcend-mcp-workflows` may not resolve this package’s own binary in a pnpm workspace):
+
+```bash
+# from the repository root
+pnpm exec turbo run build --filter="@transcend-io/mcp-server-workflows..."
+set -a && source ./secret.env && set +a
+pnpm -F @transcend-io/mcp-server-workflows exec node ./dist/cli.mjs
+```
+
+**Alternative:** `./scripts/mcp-run.sh ./packages/mcp/mcp-server-workflows/dist/cli.mjs` (sources `secret.env` when present; run after build).
+
+See [CONTRIBUTING.md](../../../CONTRIBUTING.md#mcp-servers) for workspace layout and `pnpm --filter` workflows.
+
+### Environment variables
+
+| Variable                | Required | Default                                    | Description       |
+| ----------------------- | -------- | ------------------------------------------ | ----------------- |
+| `TRANSCEND_API_KEY`     | Yes      | —                                          | Transcend API key |
+| `TRANSCEND_API_URL`     | No       | `https://multi-tenant.sombra.transcend.io` | Sombra API URL    |
+| `TRANSCEND_GRAPHQL_URL` | No       | `https://api.transcend.io`                 | GraphQL API URL   |
+
+**Monorepo:** keep these in root **`secret.env`** (from [`secret.env.example`](../../../secret.env.example)); see **Run from the monorepo**.
+
+## Tools
+
+- `workflows_list` — List workflows
+- `workflows_list_email_templates` — List email templates
+- `workflows_update_config` — Update workflow configuration
+
+## Related packages
+
+Also available as part of the unified [`@transcend-io/mcp-server`](../mcp-server/README.md) which includes all domains. See the [root README](../../../README.md#mcp-servers) for the full list.

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { n as getWorkflowTools, t as WorkflowsMixin } from "./graphql-BE3vRhqA.mjs";
+import { TranscendRestClient, createMCPServer } from "@transcend-io/mcp-server-core";
+//#region src/cli.ts
+createMCPServer({
+	name: "transcend-mcp-workflows",
+	version: "1.0.0",
+	getTools: getWorkflowTools,
+	createClients: (auth, sombraUrl, graphqlUrl) => ({
+		rest: new TranscendRestClient(auth, sombraUrl),
+		graphql: new WorkflowsMixin(auth, graphqlUrl)
+	})
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { createMCPServer, TranscendRestClient } from '@transcend-io/mcp-server-core';\n\nimport { WorkflowsMixin } from './graphql.js';\nimport { getWorkflowTools } from './tools/index.js';\n\ncreateMCPServer({\n  name: 'transcend-mcp-workflows',\n  version: '1.0.0',\n  getTools: getWorkflowTools,\n  createClients: (auth, sombraUrl, graphqlUrl) => ({\n    rest: new TranscendRestClient(auth, sombraUrl),\n    graphql: new WorkflowsMixin(auth, graphqlUrl),\n  }),\n});\n"],"mappings":";;;;AAMA,gBAAgB;CACd,MAAM;CACN,SAAS;CACT,UAAU;CACV,gBAAgB,MAAM,WAAW,gBAAgB;EAC/C,MAAM,IAAI,oBAAoB,MAAM,UAAU;EAC9C,SAAS,IAAI,eAAe,MAAM,WAAW;EAC9C;CACF,CAAC"}

package/dist/graphql-BE3vRhqA.mjs

@@ -0,0 +1,204 @@
+import { PaginationSchema, TranscendGraphQLBase, createListResult, createToolResult, defineTool, z } from "@transcend-io/mcp-server-core";
+//#region src/tools/workflows_list.ts
+const ListWorkflowsSchema = PaginationSchema.extend({ cursor: z.string().optional().describe("Pagination cursor from previous response (where supported)") });
+function createWorkflowsListTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "workflows_list",
+		description: "List all workflows configured in your organization. Note: API does not support cursor pagination (max ~100 results).",
+		category: "Workflows",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: ListWorkflowsSchema,
+		handler: async ({ limit, cursor }) => {
+			const result = await graphql.listWorkflows({
+				first: limit,
+				after: cursor
+			});
+			return createListResult(result.nodes, {
+				totalCount: result.totalCount,
+				hasNextPage: result.pageInfo?.hasNextPage
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/workflows_list_email_templates.ts
+const ListEmailTemplatesSchema = PaginationSchema.extend({
+	cursor: z.string().optional().describe("Pagination cursor from previous response (where supported)"),
+	offset: z.coerce.number().min(0).optional().default(0).describe("Number of results to skip (default: 0)")
+});
+function createWorkflowsListEmailTemplatesTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "workflows_list_email_templates",
+		description: "List all email templates used in workflows and communications. Note: API does not support cursor pagination (max ~100 results).",
+		category: "Workflows",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: ListEmailTemplatesSchema,
+		handler: async ({ limit, offset }) => {
+			const result = await graphql.listEmailTemplates({
+				first: limit,
+				offset
+			});
+			return createListResult(result.nodes, {
+				totalCount: result.totalCount,
+				hasNextPage: result.pageInfo?.hasNextPage
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/workflows_update_config.ts
+const UpdateWorkflowConfigSchema = z.object({
+	workflow_config_id: z.string().describe("ID of the workflow config to update (use workflows_list to find config IDs)"),
+	title: z.string().optional().describe("New title for the workflow"),
+	subtitle: z.string().optional().describe("New subtitle for the workflow"),
+	description: z.string().optional().describe("New description for the workflow"),
+	show_in_privacy_center: z.boolean().optional().describe("Whether to show this workflow in the Privacy Center")
+});
+function createWorkflowsUpdateConfigTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "workflows_update_config",
+		description: "Update the configuration for a workflow (title, subtitle, description, privacy center visibility)",
+		category: "Workflows",
+		readOnly: false,
+		confirmationHint: "Updates the workflow configuration",
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: UpdateWorkflowConfigSchema,
+		handler: async ({ workflow_config_id, title, subtitle, description, show_in_privacy_center }) => {
+			const updates = {};
+			if (title !== void 0) updates.title = title;
+			if (subtitle !== void 0) updates.subtitle = subtitle;
+			if (description !== void 0) updates.description = description;
+			if (show_in_privacy_center !== void 0) updates.showInPrivacyCenter = show_in_privacy_center;
+			return createToolResult(true, {
+				workflowConfig: await graphql.updateWorkflowConfig(workflow_config_id, updates),
+				message: "Workflow configuration updated successfully"
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/index.ts
+function getWorkflowTools(clients) {
+	return [
+		createWorkflowsListTool(clients),
+		createWorkflowsUpdateConfigTool(clients),
+		createWorkflowsListEmailTemplatesTool(clients)
+	];
+}
+//#endregion
+//#region src/graphql.ts
+var WorkflowsMixin = class extends TranscendGraphQLBase {
+	async listWorkflows(options) {
+		const data = await this.makeRequest(`
+      query ListWorkflows($first: Int) {
+        workflows(first: $first) {
+          nodes {
+            id
+            title {
+              defaultMessage
+            }
+          }
+          totalCount
+        }
+      }
+    `, { first: Math.min(options?.first || 50, 100) });
+		return {
+			nodes: data.workflows.nodes,
+			pageInfo: {
+				hasNextPage: data.workflows.nodes.length < data.workflows.totalCount,
+				hasPreviousPage: false
+			},
+			totalCount: data.workflows.totalCount
+		};
+	}
+	async updateWorkflowConfig(workflowConfigId, updates) {
+		const mutation = `
+      mutation UpdateWorkflowConfig($input: UpdateWorkflowConfigInput!) {
+        updateWorkflowConfig(input: $input) {
+          workflowConfig {
+            id
+            title {
+              defaultMessage
+            }
+            subtitle {
+              defaultMessage
+            }
+            description {
+              defaultMessage
+            }
+            showInPrivacyCenter
+          }
+        }
+      }
+    `;
+		const input = {
+			workflowConfigId,
+			...updates
+		};
+		const wc = (await this.makeRequest(mutation, { input })).updateWorkflowConfig.workflowConfig;
+		return {
+			id: wc.id,
+			title: wc.title?.defaultMessage || "",
+			subtitle: wc.subtitle?.defaultMessage || "",
+			description: wc.description?.defaultMessage || "",
+			showInPrivacyCenter: wc.showInPrivacyCenter
+		};
+	}
+	async listEmailTemplates(options) {
+		const data = await this.makeRequest(`
+      query ListTemplates($first: Int, $offset: Int) {
+        templates(first: $first, offset: $offset) {
+          nodes {
+            id
+            title
+            type
+            isRequired
+          }
+          totalCount
+        }
+      }
+    `, {
+			first: Math.min(options?.first || 50, 100),
+			offset: options?.offset || 0
+		});
+		const templates = data.templates.nodes.map((t) => ({
+			id: t.id,
+			name: t.title,
+			subject: "",
+			type: t.type,
+			locale: "",
+			isActive: t.isRequired,
+			createdAt: "",
+			updatedAt: ""
+		}));
+		return {
+			nodes: templates,
+			pageInfo: {
+				hasNextPage: templates.length < data.templates.totalCount,
+				hasPreviousPage: false
+			},
+			totalCount: data.templates.totalCount
+		};
+	}
+};
+//#endregion
+export { ListWorkflowsSchema as a, ListEmailTemplatesSchema as i, getWorkflowTools as n, UpdateWorkflowConfigSchema as r, WorkflowsMixin as t };
+
+//# sourceMappingURL=graphql-BE3vRhqA.mjs.map

package/dist/graphql-BE3vRhqA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-BE3vRhqA.mjs","names":[],"sources":["../src/tools/workflows_list.ts","../src/tools/workflows_list_email_templates.ts","../src/tools/workflows_update_config.ts","../src/tools/index.ts","../src/graphql.ts"],"sourcesContent":["import {\n  createListResult,\n  defineTool,\n  PaginationSchema,\n  z,\n  type ToolClients,\n} from '@transcend-io/mcp-server-core';\n\nimport type { WorkflowsMixin } from '../graphql.js';\n\nexport const ListWorkflowsSchema = PaginationSchema.extend({\n  cursor: z\n    .string()\n    .optional()\n    .describe('Pagination cursor from previous response (where supported)'),\n});\nexport type ListWorkflowsInput = z.infer<typeof ListWorkflowsSchema>;\n\nexport function createWorkflowsListTool(clients: ToolClients) {\n  const graphql = clients.graphql as WorkflowsMixin;\n  return defineTool({\n    name: 'workflows_list',\n    description:\n      'List all workflows configured in your organization. Note: API does not support cursor pagination (max ~100 results).',\n    category: 'Workflows',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: ListWorkflowsSchema,\n    handler: async ({ limit, cursor }) => {\n      const result = await graphql.listWorkflows({\n        first: limit,\n        after: cursor,\n      });\n\n      return createListResult(result.nodes, {\n        totalCount: result.totalCount,\n        hasNextPage: result.pageInfo?.hasNextPage,\n      });\n    },\n  });\n}\n","import {\n  createListResult,\n  defineTool,\n  PaginationSchema,\n  z,\n  type ToolClients,\n} from '@transcend-io/mcp-server-core';\n\nimport type { WorkflowsMixin } from '../graphql.js';\n\nexport const ListEmailTemplatesSchema = PaginationSchema.extend({\n  cursor: z\n    .string()\n    .optional()\n    .describe('Pagination cursor from previous response (where supported)'),\n  offset: z.coerce\n    .number()\n    .min(0)\n    .optional()\n    .default(0)\n    .describe('Number of results to skip (default: 0)'),\n});\nexport type ListEmailTemplatesInput = z.infer<typeof ListEmailTemplatesSchema>;\n\nexport function createWorkflowsListEmailTemplatesTool(clients: ToolClients) {\n  const graphql = clients.graphql as WorkflowsMixin;\n  return defineTool({\n    name: 'workflows_list_email_templates',\n    description:\n      'List all email templates used in workflows and communications. Note: API does not support cursor pagination (max ~100 results).',\n    category: 'Workflows',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: ListEmailTemplatesSchema,\n    handler: async ({ limit, offset }) => {\n      const result = await graphql.listEmailTemplates({\n        first: limit,\n        offset,\n      });\n\n      return createListResult(result.nodes, {\n        totalCount: result.totalCount,\n        hasNextPage: result.pageInfo?.hasNextPage,\n      });\n    },\n  });\n}\n","import { createToolResult, defineTool, z, type ToolClients } from '@transcend-io/mcp-server-core';\n\nimport type { WorkflowsMixin } from '../graphql.js';\n\nexport const UpdateWorkflowConfigSchema = z.object({\n  workflow_config_id: z\n    .string()\n    .describe('ID of the workflow config to update (use workflows_list to find config IDs)'),\n  title: z.string().optional().describe('New title for the workflow'),\n  subtitle: z.string().optional().describe('New subtitle for the workflow'),\n  description: z.string().optional().describe('New description for the workflow'),\n  show_in_privacy_center: z\n    .boolean()\n    .optional()\n    .describe('Whether to show this workflow in the Privacy Center'),\n});\nexport type UpdateWorkflowConfigInput = z.infer<typeof UpdateWorkflowConfigSchema>;\n\nexport function createWorkflowsUpdateConfigTool(clients: ToolClients) {\n  const graphql = clients.graphql as WorkflowsMixin;\n  return defineTool({\n    name: 'workflows_update_config',\n    description:\n      'Update the configuration for a workflow (title, subtitle, description, privacy center visibility)',\n    category: 'Workflows',\n    readOnly: false,\n    confirmationHint: 'Updates the workflow configuration',\n    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },\n    zodSchema: UpdateWorkflowConfigSchema,\n    handler: async ({\n      workflow_config_id,\n      title,\n      subtitle,\n      description,\n      show_in_privacy_center,\n    }) => {\n      const updates: {\n        title?: string;\n        subtitle?: string;\n        description?: string;\n        showInPrivacyCenter?: boolean;\n      } = {};\n\n      if (title !== undefined) {\n        updates.title = title;\n      }\n      if (subtitle !== undefined) {\n        updates.subtitle = subtitle;\n      }\n      if (description !== undefined) {\n        updates.description = description;\n      }\n      if (show_in_privacy_center !== undefined) {\n        updates.showInPrivacyCenter = show_in_privacy_center;\n      }\n\n      const result = await graphql.updateWorkflowConfig(workflow_config_id, updates);\n\n      return createToolResult(true, {\n        workflowConfig: result,\n        message: 'Workflow configuration updated successfully',\n      });\n    },\n  });\n}\n","import type { ToolDefinition, ToolClients } from '@transcend-io/mcp-server-core';\n\nimport { createWorkflowsListTool } from './workflows_list.js';\nimport { createWorkflowsListEmailTemplatesTool } from './workflows_list_email_templates.js';\nimport { createWorkflowsUpdateConfigTool } from './workflows_update_config.js';\n\nexport function getWorkflowTools(clients: ToolClients): ToolDefinition[] {\n  return [\n    createWorkflowsListTool(clients),\n    createWorkflowsUpdateConfigTool(clients),\n    createWorkflowsListEmailTemplatesTool(clients),\n  ];\n}\n","import {\n  TranscendGraphQLBase,\n  type EmailTemplate,\n  type ListOptions,\n  type PaginatedResponse,\n  type Workflow,\n  type WorkflowConfig,\n} from '@transcend-io/mcp-server-core';\n\nexport class WorkflowsMixin extends TranscendGraphQLBase {\n  async listWorkflows(options?: ListOptions): Promise<PaginatedResponse<Workflow>> {\n    const query = `\n      query ListWorkflows($first: Int) {\n        workflows(first: $first) {\n          nodes {\n            id\n            title {\n              defaultMessage\n            }\n          }\n          totalCount\n        }\n      }\n    `;\n    const data = await this.makeRequest<{ workflows: { nodes: Workflow[]; totalCount: number } }>(\n      query,\n      { first: Math.min(options?.first || 50, 100) },\n    );\n    return {\n      nodes: data.workflows.nodes,\n      pageInfo: {\n        hasNextPage: data.workflows.nodes.length < data.workflows.totalCount,\n        hasPreviousPage: false,\n      },\n      totalCount: data.workflows.totalCount,\n    };\n  }\n\n  async updateWorkflowConfig(\n    workflowConfigId: string,\n    updates: {\n      title?: string;\n      subtitle?: string;\n      description?: string;\n      showInPrivacyCenter?: boolean;\n    },\n  ): Promise<WorkflowConfig> {\n    const mutation = `\n      mutation UpdateWorkflowConfig($input: UpdateWorkflowConfigInput!) {\n        updateWorkflowConfig(input: $input) {\n          workflowConfig {\n            id\n            title {\n              defaultMessage\n            }\n            subtitle {\n              defaultMessage\n            }\n            description {\n              defaultMessage\n            }\n            showInPrivacyCenter\n          }\n        }\n      }\n    `;\n    const input = { workflowConfigId, ...updates };\n    const data = await this.makeRequest<{\n      updateWorkflowConfig: {\n        workflowConfig: {\n          id: string;\n          title: { defaultMessage: string } | null;\n          subtitle: { defaultMessage: string } | null;\n          description: { defaultMessage: string } | null;\n          showInPrivacyCenter: boolean;\n        };\n      };\n    }>(mutation, { input });\n    const wc = data.updateWorkflowConfig.workflowConfig;\n    return {\n      id: wc.id,\n      title: wc.title?.defaultMessage || '',\n      subtitle: wc.subtitle?.defaultMessage || '',\n      description: wc.description?.defaultMessage || '',\n      showInPrivacyCenter: wc.showInPrivacyCenter,\n    };\n  }\n\n  async listEmailTemplates(options?: ListOptions): Promise<PaginatedResponse<EmailTemplate>> {\n    const query = `\n      query ListTemplates($first: Int, $offset: Int) {\n        templates(first: $first, offset: $offset) {\n          nodes {\n            id\n            title\n            type\n            isRequired\n          }\n          totalCount\n        }\n      }\n    `;\n    const data = await this.makeRequest<{\n      templates: {\n        nodes: Array<{ id: string; title: string; type: string; isRequired: boolean }>;\n        totalCount: number;\n      };\n    }>(query, {\n      first: Math.min(options?.first || 50, 100),\n      offset: options?.offset || 0,\n    });\n    const templates: EmailTemplate[] = data.templates.nodes.map((t) => ({\n      id: t.id,\n      name: t.title,\n      subject: '',\n      type: t.type,\n      locale: '',\n      isActive: t.isRequired,\n      createdAt: '',\n      updatedAt: '',\n    }));\n    return {\n      nodes: templates,\n      pageInfo: {\n        hasNextPage: templates.length < data.templates.totalCount,\n        hasPreviousPage: false,\n      },\n      totalCount: data.templates.totalCount,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,44 @@
+import { EmailTemplate, ListOptions, PaginatedResponse, ToolClients, ToolDefinition, TranscendGraphQLBase, Workflow, WorkflowConfig, z } from "@transcend-io/mcp-server-core";
+
+//#region src/tools/index.d.ts
+declare function getWorkflowTools(clients: ToolClients): ToolDefinition[];
+//#endregion
+//#region src/graphql.d.ts
+declare class WorkflowsMixin extends TranscendGraphQLBase {
+  listWorkflows(options?: ListOptions): Promise<PaginatedResponse<Workflow>>;
+  updateWorkflowConfig(workflowConfigId: string, updates: {
+    title?: string;
+    subtitle?: string;
+    description?: string;
+    showInPrivacyCenter?: boolean;
+  }): Promise<WorkflowConfig>;
+  listEmailTemplates(options?: ListOptions): Promise<PaginatedResponse<EmailTemplate>>;
+}
+//#endregion
+//#region src/tools/workflows_list.d.ts
+declare const ListWorkflowsSchema: z.ZodObject<{
+  limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ListWorkflowsInput = z.infer<typeof ListWorkflowsSchema>;
+//#endregion
+//#region src/tools/workflows_list_email_templates.d.ts
+declare const ListEmailTemplatesSchema: z.ZodObject<{
+  limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  cursor: z.ZodOptional<z.ZodString>;
+  offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strip>;
+type ListEmailTemplatesInput = z.infer<typeof ListEmailTemplatesSchema>;
+//#endregion
+//#region src/tools/workflows_update_config.d.ts
+declare const UpdateWorkflowConfigSchema: z.ZodObject<{
+  workflow_config_id: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  subtitle: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  show_in_privacy_center: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type UpdateWorkflowConfigInput = z.infer<typeof UpdateWorkflowConfigSchema>;
+//#endregion
+export { type ListEmailTemplatesInput, ListEmailTemplatesSchema, type ListWorkflowsInput, ListWorkflowsSchema, type UpdateWorkflowConfigInput, UpdateWorkflowConfigSchema, WorkflowsMixin, getWorkflowTools };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/tools/index.ts","../src/graphql.ts","../src/tools/workflows_list.ts","../src/tools/workflows_list_email_templates.ts","../src/tools/workflows_update_config.ts"],"mappings":";;;iBAMgB,gBAAA,CAAiB,OAAA,EAAS,WAAA,GAAc,cAAA;;;cCG3C,cAAA,SAAuB,oBAAA;EAC5B,aAAA,CAAc,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,iBAAA,CAAkB,QAAA;EA4BhE,oBAAA,CACJ,gBAAA,UACA,OAAA;IACE,KAAA;IACA,QAAA;IACA,WAAA;IACA,mBAAA;EAAA,IAED,OAAA,CAAQ,cAAA;EA0CL,kBAAA,CAAmB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,iBAAA,CAAkB,aAAA;AAAA;;;cC9EhE,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;KAMpB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,mBAAA;;;cCNnC,wBAAA,EAAwB,CAAA,CAAA,SAAA;;;;;KAYzB,uBAAA,GAA0B,CAAA,CAAE,KAAA,QAAa,wBAAA;;;cClBxC,0BAAA,EAA0B,CAAA,CAAA,SAAA;;;;;;;KAY3B,yBAAA,GAA4B,CAAA,CAAE,KAAA,QAAa,0BAAA"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as ListWorkflowsSchema, i as ListEmailTemplatesSchema, n as getWorkflowTools, r as UpdateWorkflowConfigSchema, t as WorkflowsMixin } from "./graphql-BE3vRhqA.mjs";
+export { ListEmailTemplatesSchema, ListWorkflowsSchema, UpdateWorkflowConfigSchema, WorkflowsMixin, getWorkflowTools };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@transcend-io/mcp-server-workflows",
+  "version": "0.1.0",
+  "description": "Transcend MCP Server — Workflows tools.",
+  "homepage": "https://github.com/transcend-io/tools/tree/main/packages/mcp/mcp-server-workflows",
+  "license": "Apache-2.0",
+  "author": "Transcend Inc.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/transcend-io/tools.git",
+    "directory": "packages/mcp/mcp-server-workflows"
+  },
+  "bin": {
+    "transcend-mcp-workflows": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "@transcend-io/source": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check:exports": "attw --pack . --ignore-rules cjs-resolves-to-esm",
+    "check:publint": "publint --level warning --strict --pack pnpm"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "catalog:",
+    "@transcend-io/mcp-server-core": "workspace:*",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "catalog:",
+    "@types/node": "catalog:",
+    "publint": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}