@mcp-consultant-tools/powerplatform-data 27.0.0 → 28.0.0-beta.4

package/build/tools/write-tools.js

@@ -0,0 +1,202 @@
+/**
+ * Write tools for powerplatform-data (4 tools)
+ * Require permission flags: POWERPLATFORM_ENABLE_CREATE, _UPDATE, _DELETE, _ACTIONS.
+ */
+import { z } from 'zod';
+export function registerWriteTools(server, ctx) {
+    server.tool("create-record", "Create a new record in Dataverse. Lookup fields accept both logical names (lowercase) and SchemaNames (mixed case) - the server automatically converts to the correct format. Requires POWERPLATFORM_ENABLE_CREATE=true.", {
+        entityNamePlural: z
+            .string()
+            .describe("The plural name of the entity (e.g., 'accounts', 'contacts', 'sic_applications')"),
+        data: z
+            .record(z.any())
+            .describe("Record data as JSON object. Field names must match logical names (e.g., {'name': 'Acme Corp', 'telephone1': '555-1234'}). " +
+            "For lookup fields, use '@odata.bind' syntax with either logical names or SchemaNames: {'si_titleid@odata.bind': '/si_titles(guid)'} or {'si_TitleId@odata.bind': '/si_titles(guid)'}. " +
+            "For polymorphic lookups, add entity suffix: {'si_customerid_contact@odata.bind': '/contacts(guid)'}. " +
+            "For option sets, use integer values."),
+    }, async ({ entityNamePlural, data }) => {
+        try {
+            ctx.checkCreateEnabled();
+            const service = ctx.pp;
+            const result = await service.createRecord(entityNamePlural, data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Record created successfully in ${entityNamePlural}\n\n` +
+                            `**Record ID:** ${result.id || result[Object.keys(result).find(k => k.endsWith('id')) || ''] || 'N/A'}\n\n` +
+                            `**Created Record:**\n\`\`\`json\n${JSON.stringify(result, null, 2)}\n\`\`\``,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error creating record:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Failed to create record: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("update-record", "Update an existing record in Dataverse. Lookup fields accept both logical names (lowercase) and SchemaNames (mixed case) - the server automatically converts to the correct format. Requires POWERPLATFORM_ENABLE_UPDATE=true.", {
+        entityNamePlural: z
+            .string()
+            .describe("The plural name of the entity (e.g., 'accounts', 'contacts', 'sic_applications')"),
+        recordId: z
+            .string()
+            .describe("The GUID of the record to update"),
+        data: z
+            .record(z.any())
+            .describe("Partial record data to update (only fields being changed). " +
+            "Field names must match logical names. " +
+            "For lookup fields, use '@odata.bind' syntax with either logical names or SchemaNames: {'si_titleid@odata.bind': '/si_titles(guid)'} or {'si_TitleId@odata.bind': '/si_titles(guid)'}. " +
+            "For option sets, use integer values."),
+    }, async ({ entityNamePlural, recordId, data }) => {
+        try {
+            ctx.checkUpdateEnabled();
+            const service = ctx.pp;
+            const result = await service.updateRecord(entityNamePlural, recordId, data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Record updated successfully in ${entityNamePlural}\n\n` +
+                            `**Record ID:** ${recordId}\n\n` +
+                            `**Updated Record:**\n\`\`\`json\n${JSON.stringify(result, null, 2)}\n\`\`\``,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error updating record:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Failed to update record: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("delete-record", "Delete a record from Dataverse. Requires POWERPLATFORM_ENABLE_DELETE=true. WARNING: This operation is permanent and cannot be undone.", {
+        entityNamePlural: z
+            .string()
+            .describe("The plural name of the entity (e.g., 'accounts', 'contacts', 'sic_applications')"),
+        recordId: z
+            .string()
+            .describe("The GUID of the record to delete"),
+        confirm: z
+            .boolean()
+            .optional()
+            .describe("Confirmation flag - must be true to proceed with deletion (safety check)"),
+    }, async ({ entityNamePlural, recordId, confirm }) => {
+        try {
+            ctx.checkDeleteEnabled();
+            // Require explicit confirmation for deletion
+            if (confirm !== true) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `⚠️  Delete operation requires explicit confirmation.\n\n` +
+                                `You are about to delete record **${recordId}** from **${entityNamePlural}**.\n\n` +
+                                `This operation is **permanent** and **cannot be undone**.\n\n` +
+                                `To proceed, call this tool again with \`confirm: true\`.`,
+                        },
+                    ],
+                };
+            }
+            const service = ctx.pp;
+            await service.deleteRecord(entityNamePlural, recordId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Record deleted successfully\n\n` +
+                            `**Entity:** ${entityNamePlural}\n` +
+                            `**Record ID:** ${recordId}\n\n` +
+                            `⚠️  This operation is permanent.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error deleting record:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Failed to delete record: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("execute-action", "Execute a Custom API or Action in Dataverse. Supports both unbound actions (not tied to any entity) and bound actions (tied to a specific record). Requires POWERPLATFORM_ENABLE_ACTIONS=true.", {
+        actionName: z
+            .string()
+            .describe("The unique name of the Custom API or Action to execute (e.g., 'new_MyCustomAction', 'WhoAmI', 'WinOpportunity'). " +
+            "For bound actions, do NOT include the 'Microsoft.Dynamics.CRM.' prefix - it will be added automatically."),
+        parameters: z
+            .record(z.any())
+            .optional()
+            .describe("Input parameters for the action as JSON object. Parameter names and types must match the action definition. " +
+            "Example: { 'Amount': 100, 'Description': 'Test' }. Leave empty for actions with no input parameters."),
+        boundTo: z
+            .object({
+            entityNamePlural: z.string().describe("The plural name of the entity (e.g., 'opportunities', 'accounts')"),
+            recordId: z.string().describe("The GUID of the record to bind the action to"),
+        })
+            .optional()
+            .describe("For bound actions only: specify the entity and record the action is bound to. " +
+            "Leave empty for unbound actions. Example: { entityNamePlural: 'opportunities', recordId: '12345678-...' }"),
+    }, async ({ actionName, parameters, boundTo }) => {
+        try {
+            ctx.checkActionsEnabled();
+            const service = ctx.pp;
+            const result = await service.executeAction(actionName, parameters, boundTo);
+            const boundInfo = boundTo
+                ? `\n**Bound To:** ${boundTo.entityNamePlural}(${boundTo.recordId})`
+                : '\n**Type:** Unbound action';
+            const paramsInfo = parameters && Object.keys(parameters).length > 0
+                ? `\n**Input Parameters:**\n\`\`\`json\n${JSON.stringify(parameters, null, 2)}\n\`\`\``
+                : '';
+            const responseInfo = result && Object.keys(result).length > 0
+                ? `\n**Response:**\n\`\`\`json\n${JSON.stringify(result, null, 2)}\n\`\`\``
+                : '\n**Response:** (no output parameters)';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Action executed successfully\n\n` +
+                            `**Action:** ${actionName}` +
+                            boundInfo +
+                            paramsInfo +
+                            responseInfo,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error executing action:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Failed to execute action: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=write-tools.js.map

package/build/tools/write-tools.js.map

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

package/build/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Service context shared between MCP server and CLI entry points.
+ * Uses lazy getters to initialize the PowerPlatformService on-demand.
+ */
+import type { PowerPlatformService } from './PowerPlatformService.js';
+export interface ServiceContext {
+    readonly pp: PowerPlatformService;
+    checkCreateEnabled(): void;
+    checkUpdateEnabled(): void;
+    checkDeleteEnabled(): void;
+    checkActionsEnabled(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAClC,kBAAkB,IAAI,IAAI,CAAC;IAC3B,kBAAkB,IAAI,IAAI,CAAC;IAC3B,kBAAkB,IAAI,IAAI,CAAC;IAC3B,mBAAmB,IAAI,IAAI,CAAC;CAC7B"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-consultant-tools/powerplatform-data",
-  "version": "27.0.0",
+  "version": "28.0.0-beta.4",
   "description": "MCP server for PowerPlatform data CRUD operations (operational use)",
   "type": "module",
   "main": "./build/index.js",