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

package/build/index.d.ts

@@ -1,9 +1,19 @@
 #!/usr/bin/env node
+/**
+ * @mcp-consultant-tools/powerplatform-data
+ *
+ * MCP server for PowerPlatform/Dataverse data CRUD operations.
+ * Entry point: MCP server startup + backward-compatible registerPowerplatformDataTools().
+ */
 import { PowerPlatformService } from './PowerPlatformService.js';
 /**
- * Register powerplatform-data tools with an MCP server
+ * Register powerplatform-data tools with an MCP server.
+ * Backward-compatible API for the meta package.
  * @param server - MCP server instance
  * @param service - Optional pre-initialized PowerPlatformService (for testing)
  */
 export declare function registerPowerplatformDataTools(server: any, service?: PowerPlatformService): void;
+export { PowerPlatformService } from './PowerPlatformService.js';
+export type { PowerPlatformConfig } from './PowerPlatformService.js';
+export type { ServiceContext } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,2BAA2B,CAAC;AAEtF;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,oBAAoB,QA2qBzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAMH,OAAO,EAAE,oBAAoB,EAAuB,MAAM,2BAA2B,CAAC;AA6DtF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAGhG;AAGD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/build/index.js

@@ -1,16 +1,20 @@
 #!/usr/bin/env node
+/**
+ * @mcp-consultant-tools/powerplatform-data
+ *
+ * MCP server for PowerPlatform/Dataverse data CRUD operations.
+ * Entry point: MCP server startup + backward-compatible registerPowerplatformDataTools().
+ */
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
 import { pathToFileURL } from 'node:url';
 import { realpathSync } from 'node:fs';
 import { createMcpServer, createEnvLoader } from '@mcp-consultant-tools/core';
 import { PowerPlatformService } from './PowerPlatformService.js';
+import { registerAllTools } from './tools/index.js';
 /**
- * Register powerplatform-data tools with an MCP server
- * @param server - MCP server instance
- * @param service - Optional pre-initialized PowerPlatformService (for testing)
+ * Build a ServiceContext with lazy service initialization.
  */
-export function registerPowerplatformDataTools(server, service) {
+function createServiceContext(service) {
     let ppService = service || null;
     function getPowerPlatformService() {
         if (!ppService) {
@@ -34,562 +38,46 @@ export function registerPowerplatformDataTools(server, service) {
         }
         return ppService;
     }
-    // Permission check functions
-    function checkCreateEnabled() {
-        if (process.env.POWERPLATFORM_ENABLE_CREATE !== 'true') {
-            throw new Error('Create operations are disabled. Set POWERPLATFORM_ENABLE_CREATE=true to enable.');
-        }
-    }
-    function checkUpdateEnabled() {
-        if (process.env.POWERPLATFORM_ENABLE_UPDATE !== 'true') {
-            throw new Error('Update operations are disabled. Set POWERPLATFORM_ENABLE_UPDATE=true to enable.');
-        }
-    }
-    function checkDeleteEnabled() {
-        if (process.env.POWERPLATFORM_ENABLE_DELETE !== 'true') {
-            throw new Error('Delete operations are disabled. Set POWERPLATFORM_ENABLE_DELETE=true to enable.');
-        }
-    }
-    function checkActionsEnabled() {
-        if (process.env.POWERPLATFORM_ENABLE_ACTIONS !== 'true') {
-            throw new Error('Action execution is disabled. Set POWERPLATFORM_ENABLE_ACTIONS=true to enable.');
-        }
-    }
-    // Tool registrations
-    // Read-only query tools (no permission flags required)
-    server.tool("query-records", "Query Dataverse records using an OData filter expression. Use the 'select' parameter to limit returned columns and reduce response size. No permission flag required (read-only).", {
-        entityNamePlural: z
-            .string()
-            .describe("The plural name of the entity (e.g., 'accounts', 'contacts', 'sic_applications')"),
-        filter: z
-            .string()
-            .describe("OData filter expression (e.g., \"name eq 'Acme Corp'\", \"createdon gt 2024-01-01\", \"statecode eq 0\")"),
-        select: z
-            .array(z.string())
-            .optional()
-            .describe("List of column names to return (e.g., ['name', 'accountid', 'statuscode']). Omit to return all columns (not recommended for large entities)."),
-        maxRecords: z
-            .number()
-            .optional()
-            .describe("Maximum number of records to retrieve (default: 50, max: 5000)"),
-    }, async ({ entityNamePlural, filter, select, maxRecords }) => {
-        try {
-            const service = getPowerPlatformService();
-            const result = await service.queryRecords(entityNamePlural, filter, maxRecords || 50, select);
-            const recordsStr = JSON.stringify(result, null, 2);
-            let message = `📋 Retrieved ${result.returnedCount} records from '${entityNamePlural}' with filter '${filter}'`;
-            if (result.hasMore) {
-                message += `\n⚠️ More records available - increase maxRecords (currently ${result.requestedMax}) to retrieve more`;
+    return {
+        get pp() { return getPowerPlatformService(); },
+        checkCreateEnabled() {
+            if (process.env.POWERPLATFORM_ENABLE_CREATE !== 'true') {
+                throw new Error('Create operations are disabled. Set POWERPLATFORM_ENABLE_CREATE=true to enable.');
             }
-            if (select && select.length > 0) {
-                message += `\nColumns: ${select.join(', ')}`;
+        },
+        checkUpdateEnabled() {
+            if (process.env.POWERPLATFORM_ENABLE_UPDATE !== 'true') {
+                throw new Error('Update operations are disabled. Set POWERPLATFORM_ENABLE_UPDATE=true to enable.');
             }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `${message}:\n\n\`\`\`json\n${recordsStr}\n\`\`\``,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            console.error("Error querying records:", error);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Failed to query records: ${error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get-record", "Get a specific Dataverse record by entity name and ID. Use this to retrieve a record before updating/deleting or to validate changes after operations. No permission flag required (read-only).", {
-        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 retrieve"),
-    }, async ({ entityNamePlural, recordId }) => {
-        try {
-            const service = getPowerPlatformService();
-            const record = await service.getRecord(entityNamePlural, recordId);
-            const recordStr = JSON.stringify(record, null, 2);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `📋 Record from '${entityNamePlural}' with ID '${recordId}':\n\n\`\`\`json\n${recordStr}\n\`\`\``,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            console.error("Error getting record:", error);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Failed to get record: ${error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    // Metadata discovery tools (read-only, essential for CRUD operations)
-    server.tool("get-entity-metadata", "Get metadata about a Dataverse entity including EntitySetName (plural name for API), PrimaryIdAttribute, PrimaryNameAttribute, and other key properties. Essential for discovering the correct EntitySetName to use in CRUD operations. No permission flag required (read-only).", {
-        entityLogicalName: z
-            .string()
-            .describe("The logical name of the entity (e.g., 'account', 'contact', 'ste_transaction')"),
-    }, async ({ entityLogicalName }) => {
-        try {
-            const service = getPowerPlatformService();
-            const metadata = await service.getEntityMetadata(entityLogicalName);
-            // Extract the most useful properties for CRUD operations
-            const summary = {
-                LogicalName: metadata.LogicalName,
-                EntitySetName: metadata.EntitySetName,
-                PrimaryIdAttribute: metadata.PrimaryIdAttribute,
-                PrimaryNameAttribute: metadata.PrimaryNameAttribute,
-                DisplayName: metadata.DisplayName?.UserLocalizedLabel?.Label,
-                DisplayCollectionName: metadata.DisplayCollectionName?.UserLocalizedLabel?.Label,
-                SchemaName: metadata.SchemaName,
-                LogicalCollectionName: metadata.LogicalCollectionName,
-                IsCustomEntity: metadata.IsCustomEntity,
-                MetadataId: metadata.MetadataId
-            };
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `📋 Entity Metadata for '${entityLogicalName}':\n\n` +
-                            `**EntitySetName (for API):** \`${summary.EntitySetName}\`\n` +
-                            `**Primary ID Attribute:** \`${summary.PrimaryIdAttribute}\`\n` +
-                            `**Primary Name Attribute:** \`${summary.PrimaryNameAttribute}\`\n\n` +
-                            `**Full Details:**\n\`\`\`json\n${JSON.stringify(summary, null, 2)}\n\`\`\`\n\n` +
-                            `**Usage:** Use \`${summary.EntitySetName}\` as the entityNamePlural parameter for query-records, create-record, update-record, delete-record tools.`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            console.error("Error getting entity metadata:", error);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Failed to get entity metadata: ${error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get-lookup-target", "Get the target entity information for a lookup field. Returns the SchemaName (for @odata.bind syntax) and EntitySetName needed to set lookup values. Essential for setting lookup fields in create/update operations. No permission flag required (read-only).", {
-        entityLogicalName: z
-            .string()
-            .describe("The logical name of the entity containing the lookup (e.g., 'ste_transaction')"),
-        lookupAttributeName: z
-            .string()
-            .describe("The logical name of the lookup attribute (e.g., 'ste_categoryid', 'parentaccountid')"),
-    }, async ({ entityLogicalName, lookupAttributeName }) => {
-        try {
-            const service = getPowerPlatformService();
-            // Get the lookup attribute details including SchemaName
-            const attribute = await service.getEntityAttribute(entityLogicalName, lookupAttributeName);
-            if (!attribute.Targets || attribute.Targets.length === 0) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `❌ Attribute '${lookupAttributeName}' on entity '${entityLogicalName}' is not a lookup field or has no targets.`,
-                        },
-                    ],
-                    isError: true,
-                };
+        },
+        checkDeleteEnabled() {
+            if (process.env.POWERPLATFORM_ENABLE_DELETE !== 'true') {
+                throw new Error('Delete operations are disabled. Set POWERPLATFORM_ENABLE_DELETE=true to enable.');
             }
-            // Get SchemaName from the attribute (proper casing for @odata.bind)
-            const lookupSchemaName = attribute.SchemaName;
-            const isPolymorphic = attribute.Targets.length > 1;
-            // Get metadata for all target entities
-            const targetResults = await Promise.all(attribute.Targets.map(async (targetEntity) => {
-                try {
-                    const targetMetadata = await service.getEntityMetadata(targetEntity);
-                    // For polymorphic lookups, the navigation property is SchemaName_targetLogicalName
-                    // For simple lookups, it's just the SchemaName
-                    const bindingPropertyName = isPolymorphic
-                        ? `${lookupSchemaName}_${targetEntity}`
-                        : lookupSchemaName;
-                    return {
-                        LogicalName: targetEntity,
-                        EntitySetName: targetMetadata.EntitySetName,
-                        PrimaryIdAttribute: targetMetadata.PrimaryIdAttribute,
-                        DisplayName: targetMetadata.DisplayName?.UserLocalizedLabel?.Label,
-                        BindingPropertyName: bindingPropertyName
-                    };
-                }
-                catch (err) {
-                    return {
-                        LogicalName: targetEntity,
-                        EntitySetName: `${targetEntity}s`, // fallback guess
-                        BindingPropertyName: isPolymorphic ? `${lookupSchemaName}_${targetEntity}` : lookupSchemaName,
-                        error: 'Could not fetch metadata'
-                    };
-                }
-            }));
-            const primaryTarget = targetResults[0];
-            // Build response with lookup attribute info
-            let responseText = `📋 Lookup Target for '${lookupAttributeName}' on '${entityLogicalName}':\n\n`;
-            responseText += `## Lookup Attribute\n`;
-            responseText += `| Property | Value |\n`;
-            responseText += `|----------|-------|\n`;
-            responseText += `| **SchemaName** | \`${lookupSchemaName}\` |\n`;
-            responseText += `| **LogicalName** | \`${lookupAttributeName}\` |\n`;
-            responseText += `| **Polymorphic** | ${isPolymorphic ? 'Yes' : 'No'} |\n\n`;
-            responseText += `## Target Entity\n`;
-            responseText += `| Property | Value |\n`;
-            responseText += `|----------|-------|\n`;
-            responseText += `| **Entity** | \`${primaryTarget.LogicalName}\` |\n`;
-            responseText += `| **EntitySetName** | \`${primaryTarget.EntitySetName}\` |\n`;
-            responseText += `| **Primary ID** | \`${primaryTarget.PrimaryIdAttribute}\` |\n\n`;
-            responseText += `## Usage\n\n`;
-            responseText += `**To set this lookup, use:**\n`;
-            responseText += `\`\`\`json\n{\n  "${primaryTarget.BindingPropertyName}@odata.bind": "/${primaryTarget.EntitySetName}(<record-guid>)"\n}\n\`\`\`\n\n`;
-            responseText += `⚠️ **Important:** The \`@odata.bind\` syntax requires the **SchemaName** (mixed case: \`${lookupSchemaName}\`), NOT the LogicalName (lowercase: \`${lookupAttributeName}\`).\n\n`;
-            if (isPolymorphic) {
-                responseText += `## Polymorphic Lookup Targets\n\n`;
-                responseText += `This lookup can reference ${targetResults.length} different entity types. Use the appropriate binding property for each:\n\n`;
-                responseText += `| Target Entity | Binding Property | EntitySetName |\n`;
-                responseText += `|---------------|------------------|---------------|\n`;
-                for (const target of targetResults) {
-                    responseText += `| \`${target.LogicalName}\` | \`${target.BindingPropertyName}@odata.bind\` | \`${target.EntitySetName}\` |\n`;
-                }
-                responseText += `\n**Example for each target:**\n`;
-                for (const target of targetResults) {
-                    responseText += `\`\`\`json\n// To set ${target.LogicalName}:\n{"${target.BindingPropertyName}@odata.bind": "/${target.EntitySetName}(<guid>)"}\n\`\`\`\n`;
-                }
+        },
+        checkActionsEnabled() {
+            if (process.env.POWERPLATFORM_ENABLE_ACTIONS !== 'true') {
+                throw new Error('Action execution is disabled. Set POWERPLATFORM_ENABLE_ACTIONS=true to enable.');
             }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: responseText,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            console.error("Error getting lookup target:", error);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Failed to get lookup target: ${error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    server.tool("get-flow-runs", "Get the run history for a specific Power Automate flow using the Management API. " +
-        "Returns run status, timestamps, trigger info, and error details for failed runs. " +
-        "Use this to investigate flow failures during incident triage. No permission flag required (read-only).", {
-        flowId: z.string().describe("GUID of the flow (workflowid)"),
-        status: z.string().optional().describe("Filter by status: Succeeded, Failed, Running, Waiting, Cancelled"),
-        startedAfter: z.string().optional().describe("Only return runs started after this date (ISO 8601 format, e.g., '2026-01-21T00:00:00Z')"),
-        startedBefore: z.string().optional().describe("Only return runs started before this date (ISO 8601 format)"),
-        maxRecords: z.number().optional().describe("Maximum number of runs to return (default: 50, max: 250)")
-    }, async ({ flowId, status, startedAfter, startedBefore, maxRecords }) => {
-        try {
-            const service = getPowerPlatformService();
-            const result = await service.getFlowRuns(flowId, {
-                status,
-                startedAfter,
-                startedBefore,
-                maxRecords: maxRecords || 50,
-            });
-            // Calculate success/failure stats
-            const stats = (result.runs || []).reduce((acc, run) => {
-                if (run.status === 'Succeeded')
-                    acc.succeeded++;
-                else if (run.status === 'Failed' || run.status === 'Faulted' || run.status === 'TimedOut')
-                    acc.failed++;
-                else if (run.status === 'Running' || run.status === 'Waiting')
-                    acc.inProgress++;
-                else if (run.status === 'Cancelled')
-                    acc.cancelled++;
-                else
-                    acc.other++;
-                return acc;
-            }, { succeeded: 0, failed: 0, inProgress: 0, cancelled: 0, other: 0 });
-            // Build summary for failed runs
-            const failedRuns = result.runs.filter((r) => r.status === 'Failed' || r.error);
-            const failedSummary = failedRuns.length > 0
-                ? `\n\nFailed Runs (${failedRuns.length}):\n` + failedRuns.map((r) => `  - ${r.runId}: ${r.error?.message || 'Unknown error'} (${r.startTime})`).join('\n')
-                : '';
-            const resultStr = JSON.stringify(result, null, 2);
-            return {
-                content: [{
-                        type: "text",
-                        text: `Found ${result.totalCount} flow runs for flow ${flowId}${result.hasMore ? ' (more available)' : ''}:\n\nStats:\n- Succeeded: ${stats.succeeded}\n- Failed: ${stats.failed}\n- In Progress: ${stats.inProgress}\n- Cancelled: ${stats.cancelled}\n- Other: ${stats.other}${failedSummary}\n\nFilters Applied: ${JSON.stringify(result.filterApplied)}\n\n${resultStr}`
-                    }]
-            };
-        }
-        catch (error) {
-            console.error("Error getting flow runs:", error);
-            return {
-                content: [{
-                        type: "text",
-                        text: `❌ Failed to get flow runs: ${error.message}`
-                    }],
-                isError: true
-            };
-        }
-    });
-    server.tool("get-flow-run-details", "Get detailed information about a specific flow run, including action-level outputs and error messages. " +
-        "Use this after get-flow-runs to investigate why a specific run failed. " +
-        "Returns trigger details, action statuses, and detailed error messages for each action. " +
-        "NOTE: Requires Environment Maker role or flow co-owner permissions (uses Management API).", {
-        flowId: z.string().describe("GUID of the flow (workflowid)"),
-        runId: z.string().describe("GUID of the flow run (from get-flow-runs results)")
-    }, async ({ flowId, runId }) => {
-        try {
-            const service = getPowerPlatformService();
-            const result = await service.getFlowRunDetails(flowId, runId);
-            // Build action summary
-            const actions = result.actions || {};
-            const actionList = Object.entries(actions).map(([name, action]) => {
-                const status = action.status || 'unknown';
-                const error = action.error ? ` - Error: ${JSON.stringify(action.error)}` : '';
-                return `  - ${name}: ${status}${error}`;
-            }).join('\n');
-            const summary = result.actionsSummary || {};
-            const statusText = `Status: ${result.status}\nStart: ${result.startTime}\nEnd: ${result.endTime || 'N/A'}`;
-            const triggerText = result.trigger ? `\n\nTrigger: ${result.trigger.name} (${result.trigger.status})` : '';
-            const actionsText = actionList ? `\n\nActions (${summary.total || 0} total, ${summary.failed || 0} failed):\n${actionList}` : '';
-            const resultStr = JSON.stringify(result, null, 2);
-            return {
-                content: [{
-                        type: "text",
-                        text: `Flow Run Details for ${flowId} / ${runId}:\n\n${statusText}${triggerText}${actionsText}\n\nFull Details:\n${resultStr}`
-                    }]
-            };
-        }
-        catch (error) {
-            console.error("Error getting flow run details:", error);
-            const envDebug = `[DEBUG: POWERPLATFORM_ENVIRONMENT_ID=${process.env.POWERPLATFORM_ENVIRONMENT_ID || 'NOT SET'}]`;
-            return {
-                content: [{
-                        type: "text",
-                        text: `❌ Failed to get flow run details: ${error.message}\n\n${envDebug}`
-                    }],
-                isError: true
-            };
-        }
-    });
-    // Data modification tools (require permission flags)
-    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 {
-            checkCreateEnabled();
-            const service = getPowerPlatformService();
-            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 {
-            checkUpdateEnabled();
-            const service = getPowerPlatformService();
-            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 {
-            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 = getPowerPlatformService();
-            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 {
-            checkActionsEnabled();
-            const service = getPowerPlatformService();
-            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,
-            };
-        }
-    });
-    console.error(`✅ powerplatform-data tools registered (${9} tools)`);
+        },
+    };
 }
-// CLI entry point (standalone execution)
-// Uses realpathSync to resolve symlinks created by npx
+/**
+ * Register powerplatform-data tools with an MCP server.
+ * Backward-compatible API for the meta package.
+ * @param server - MCP server instance
+ * @param service - Optional pre-initialized PowerPlatformService (for testing)
+ */
+export function registerPowerplatformDataTools(server, service) {
+    const ctx = createServiceContext(service);
+    registerAllTools(server, ctx);
+}
+// Backward-compatible exports
+export { PowerPlatformService } from './PowerPlatformService.js';
+/**
+ * Standalone CLI server (when run directly)
+ * Uses realpathSync to resolve symlinks created by npx
+ */
 if (import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
     const loadEnv = createEnvLoader();
     loadEnv();
@@ -604,6 +92,6 @@ if (import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
         console.error('Failed to start powerplatform-data MCP server:', error);
         process.exit(1);
     });
-    console.error('powerplatform-data MCP server running');
+    console.error('@mcp-consultant-tools/powerplatform-data server running on stdio');
 }
 //# sourceMappingURL=index.js.map