mcp-dataverse 0.1.0

package/dist/tools/audit.tools.js

@@ -0,0 +1,163 @@
+import { z } from 'zod';
+const AUDIT_ACTION_NAMES = {
+    1: 'Create',
+    2: 'Update',
+    3: 'Delete',
+    4: 'Activate',
+    5: 'Deactivate',
+    11: 'Share',
+    12: 'Unshare',
+    13: 'Assign',
+    104: 'Access',
+};
+const AUDIT_ACTION_CODES = Object.fromEntries(Object.entries(AUDIT_ACTION_NAMES).map(([code, name]) => [name, Number(code)]));
+export const auditTools = [
+    {
+        name: 'dataverse_get_audit_log',
+        description: 'Retrieves audit log entries from Dataverse. Returns operation details, user info, and parsed change data for each entry. ' +
+            'At least one filter (recordId, entityLogicalName, userId, fromDate, or operations) is recommended to avoid large result sets. ' +
+            'Audit must be enabled on the environment and table — returns a clear error if auditing is disabled (HTTP 403).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                recordId: {
+                    type: 'string',
+                    description: 'GUID of a specific record to retrieve audit entries for',
+                },
+                entityLogicalName: {
+                    type: 'string',
+                    description: 'Logical name of the entity to filter audit entries (e.g., "account", "contact")',
+                },
+                userId: {
+                    type: 'string',
+                    description: 'GUID of the user who made the changes',
+                },
+                fromDate: {
+                    type: 'string',
+                    description: 'ISO 8601 date string — only return audit entries created on or after this date',
+                },
+                top: {
+                    type: 'number',
+                    description: 'Maximum number of audit entries to return (default: 50, max: 500)',
+                },
+                operations: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by operation names: "Create", "Update", "Delete", "Activate", "Deactivate", "Share", "Unshare", "Assign", "Access"',
+                },
+            },
+            required: [],
+        },
+    },
+];
+const AuditInput = z.object({
+    recordId: z.string().uuid().optional(),
+    entityLogicalName: z.string().min(1).optional(),
+    userId: z.string().uuid().optional(),
+    fromDate: z.string().datetime({ offset: true }).optional(),
+    top: z.number().positive().max(500).optional().default(50),
+    operations: z.array(z.string().min(1)).optional(),
+});
+function parseChangeData(raw) {
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+function mapAuditRecord(record) {
+    return {
+        auditId: record.auditid,
+        operation: record.operation,
+        operationName: AUDIT_ACTION_NAMES[record.operation] ?? `Unknown(${record.operation})`,
+        action: record.action,
+        actionName: AUDIT_ACTION_NAMES[record.action] ?? `Unknown(${record.action})`,
+        createdOn: record.createdon,
+        userId: record._userid_value,
+        userFullName: record.userid?.fullname ?? '',
+        userDomainName: record.userid?.domainname ?? '',
+        objectId: record._objectid_value,
+        objectTypeCode: record.objecttypecode,
+        changes: parseChangeData(record.changedata),
+    };
+}
+export async function handleAuditTool(name, args, client) {
+    switch (name) {
+        case 'dataverse_get_audit_log': {
+            const params = AuditInput.parse(args);
+            const filters = [];
+            if (params.recordId) {
+                filters.push(`_objectid_value eq ${params.recordId}`);
+            }
+            if (params.entityLogicalName) {
+                const escaped = params.entityLogicalName.replace(/'/g, "''");
+                filters.push(`objecttypecode eq '${escaped}'`);
+            }
+            if (params.userId) {
+                filters.push(`_userid_value eq ${params.userId}`);
+            }
+            if (params.fromDate) {
+                filters.push(`createdon ge ${params.fromDate}`);
+            }
+            if (params.operations?.length) {
+                const codes = params.operations
+                    .map((op) => AUDIT_ACTION_CODES[op])
+                    .filter((code) => code !== undefined);
+                if (codes.length > 0) {
+                    const orClauses = codes.map((c) => `action eq ${c}`).join(' or ');
+                    filters.push(`(${orClauses})`);
+                }
+            }
+            try {
+                const result = await client.query('audits', {
+                    select: [
+                        'auditid',
+                        'action',
+                        'operation',
+                        'createdon',
+                        '_objectid_value',
+                        'objecttypecode',
+                        'changedata',
+                        '_userid_value',
+                    ],
+                    ...(filters.length > 0 ? { filter: filters.join(' and ') } : {}),
+                    orderby: 'createdon desc',
+                    top: params.top,
+                    expand: 'userid($select=fullname,domainname)',
+                });
+                const entries = result.value.map(mapAuditRecord);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ entries, count: entries.length }, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (message.includes('403') || message.includes('Forbidden')) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    isError: true,
+                                    error: 'Audit log access denied (HTTP 403). Ensure auditing is enabled on the Dataverse environment and the target table, and that the authenticated user has sufficient privileges.',
+                                }),
+                            },
+                        ],
+                    };
+                }
+                throw error;
+            }
+        }
+        default:
+            throw new Error(`Unknown audit tool: ${name}`);
+    }
+}
+//# sourceMappingURL=audit.tools.js.map

package/dist/tools/audit.tools.js.map

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

package/dist/tools/auth.tools.d.ts

@@ -0,0 +1,17 @@
+import type { DataverseClient } from '../dataverse/dataverse-client.js';
+export declare const authTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+}[];
+export declare function handleAuthTool(name: string, _args: unknown, client: DataverseClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=auth.tools.d.ts.map

package/dist/tools/auth.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.tools.d.ts","sourceRoot":"","sources":["../../src/tools/auth.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,eAAO,MAAM,SAAS;;;;;;;;GAUrB,CAAC;AAEF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiB7D"}

package/dist/tools/auth.tools.js

@@ -0,0 +1,30 @@
+export const authTools = [
+    {
+        name: 'dataverse_whoami',
+        description: 'Returns the current authenticated user context from Dataverse WhoAmI: userId, businessUnitId, organizationId, organizationName, and environmentUrl. Use this to verify authentication is working, retrieve the current user context, or obtain IDs needed for subsequent operations.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+];
+export async function handleAuthTool(name, _args, client) {
+    if (name === 'dataverse_whoami') {
+        const result = await client.whoAmI();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        userId: result.UserId,
+                        businessUnitId: result.BusinessUnitId,
+                        organizationId: result.OrganizationId,
+                        organizationName: result.OrganizationName,
+                        environmentUrl: result.EnvironmentUrl,
+                    }, null, 2),
+                }],
+        };
+    }
+    throw new Error(`Unknown auth tool: ${name}`);
+}
+//# sourceMappingURL=auth.tools.js.map

package/dist/tools/auth.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.tools.js","sourceRoot":"","sources":["../../src/tools/auth.tools.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,sRAAsR;QACnS,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,KAAc,EACd,MAAuB;IAEvB,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,cAAc,EAAE,MAAM,CAAC,cAAc;wBACrC,cAAc,EAAE,MAAM,CAAC,cAAc;wBACrC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;wBACzC,cAAc,EAAE,MAAM,CAAC,cAAc;qBACtC,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/tools/batch.tools.d.ts

@@ -0,0 +1,45 @@
+import type { DataverseClient } from '../dataverse/dataverse-client.js';
+export declare const batchTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            requests: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        method: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        url: {
+                            type: string;
+                            description: string;
+                        };
+                        body: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            useChangeset: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function handleBatchTool(name: string, args: unknown, client: DataverseClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=batch.tools.d.ts.map

package/dist/tools/batch.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.tools.d.ts","sourceRoot":"","sources":["../../src/tools/batch.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCtB,CAAC;AA8BF,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAc7D"}

package/dist/tools/batch.tools.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+export const batchTools = [
+    {
+        name: 'dataverse_batch_execute',
+        description: 'Executes multiple Dataverse operations in a single HTTP $batch request to reduce network round-trips and improve throughput. Accepts up to 1000 individual GET, POST, PATCH, or DELETE requests. Use for bulk creates, updates, or deletes that need to be grouped for performance. Set useChangeset=true to wrap all mutating operations (POST/PATCH/DELETE) in an atomic changeset — a failure rolls back ALL changeset operations. Individual per-operation results (status, body) are returned as an array in the same order as the input requests.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requests: {
+                    type: 'array',
+                    description: 'Array of batch requests to execute',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            method: {
+                                type: 'string',
+                                enum: ['GET', 'POST', 'PATCH', 'DELETE'],
+                                description: 'HTTP method',
+                            },
+                            url: {
+                                type: 'string',
+                                description: 'Relative URL (e.g., "accounts(guid)" or "contacts")',
+                            },
+                            body: {
+                                type: 'object',
+                                description: 'Request body for POST/PATCH operations',
+                            },
+                        },
+                        required: ['method', 'url'],
+                    },
+                },
+                useChangeset: {
+                    type: 'boolean',
+                    description: 'Wrap mutating operations (POST/PATCH/DELETE) in an atomic changeset. A failure rolls back ALL operations in the changeset. Defaults to false.',
+                },
+            },
+            required: ['requests'],
+        },
+    },
+];
+const BatchRequestItemSchema = z.object({
+    method: z.enum(['GET', 'POST', 'PATCH', 'DELETE']),
+    url: z.string().min(1)
+        .refine(v => !/[\r\n]/.test(v), { message: 'Batch URL must not contain CR or LF characters' })
+        .refine(v => !v.startsWith('http'), { message: 'Batch URL must be a relative path, not an absolute URL' })
+        .refine(v => !/(\.\.[\/\\])|(^\.\.$)/.test(v), { message: 'Batch URL must not contain path traversal sequences' }),
+    body: z.record(z.unknown()).optional(),
+});
+const BatchExecuteInput = z.object({
+    requests: z.array(BatchRequestItemSchema).min(1).max(1000),
+    useChangeset: z
+        .boolean()
+        .default(false)
+        .describe('Wrap mutating operations (POST/PATCH/DELETE) in an atomic changeset. A failure rolls back ALL operations in the changeset.'),
+});
+export async function handleBatchTool(name, args, client) {
+    if (name === 'dataverse_batch_execute') {
+        const { requests, useChangeset } = BatchExecuteInput.parse(args);
+        const batchRequests = requests.map(r => ({
+            method: r.method,
+            url: r.url,
+            body: r.body,
+        }));
+        const results = await client.batchExecute(batchRequests, useChangeset);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ results, count: results.length }, null, 2) }],
+        };
+    }
+    throw new Error(`Unknown batch tool: ${name}`);
+}
+//# sourceMappingURL=batch.tools.js.map

package/dist/tools/batch.tools.js.map

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

package/dist/tools/crud.tools.d.ts

@@ -0,0 +1,206 @@
+import type { DataverseClient } from '../dataverse/dataverse-client.js';
+export declare const crudTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description: string;
+            };
+            id: {
+                type: string;
+                description: string;
+            };
+            select: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            data?: never;
+            etag?: never;
+            confirm?: never;
+            alternateKey?: never;
+            alternateKeyValue?: never;
+            alternateKeys?: never;
+            mode?: never;
+            ownerType?: never;
+            ownerId?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description: string;
+            };
+            data: {
+                type: string;
+                description: string;
+            };
+            id?: never;
+            select?: never;
+            etag?: never;
+            confirm?: never;
+            alternateKey?: never;
+            alternateKeyValue?: never;
+            alternateKeys?: never;
+            mode?: never;
+            ownerType?: never;
+            ownerId?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description?: never;
+            };
+            id: {
+                type: string;
+                description: string;
+            };
+            data: {
+                type: string;
+                description: string;
+            };
+            etag: {
+                type: string;
+                description: string;
+            };
+            select?: never;
+            confirm?: never;
+            alternateKey?: never;
+            alternateKeyValue?: never;
+            alternateKeys?: never;
+            mode?: never;
+            ownerType?: never;
+            ownerId?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description?: never;
+            };
+            id: {
+                type: string;
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+            select?: never;
+            data?: never;
+            etag?: never;
+            alternateKey?: never;
+            alternateKeyValue?: never;
+            alternateKeys?: never;
+            mode?: never;
+            ownerType?: never;
+            ownerId?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description?: never;
+            };
+            alternateKey: {
+                type: string;
+                description: string;
+            };
+            alternateKeyValue: {
+                type: string;
+                description: string;
+            };
+            alternateKeys: {
+                type: string;
+                description: string;
+            };
+            data: {
+                type: string;
+                description: string;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            id?: never;
+            select?: never;
+            etag?: never;
+            confirm?: never;
+            ownerType?: never;
+            ownerId?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description: string;
+            };
+            id: {
+                type: string;
+                description: string;
+            };
+            ownerType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            ownerId: {
+                type: string;
+                description: string;
+            };
+            select?: never;
+            data?: never;
+            etag?: never;
+            confirm?: never;
+            alternateKey?: never;
+            alternateKeyValue?: never;
+            alternateKeys?: never;
+            mode?: never;
+        };
+        required: string[];
+    };
+})[];
+export declare function handleCrudTool(name: string, args: unknown, client: DataverseClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=crud.tools.d.ts.map

package/dist/tools/crud.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.tools.d.ts","sourceRoot":"","sources":["../../src/tools/crud.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwGrB,CAAC;AA8CF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqE7D"}