@sonisoft/now-sdk-ext-mcp 1.0.0

package/dist/tools/schema.js

@@ -0,0 +1,321 @@
+import { z } from "zod";
+import { SchemaDiscovery } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Registers the discover_table_schema tool on the MCP server.
+ *
+ * Discovers the full schema of a ServiceNow table including all fields,
+ * types, references, and optionally choice values, relationships,
+ * UI policies, and business rules.
+ */
+export function registerDiscoverTableSchemaTool(server) {
+    server.registerTool("discover_table_schema", {
+        title: "Discover Table Schema",
+        description: "Discover the full schema of a ServiceNow table including all fields, types, " +
+            "references, and optionally choice values, relationships, UI policies, and " +
+            "business rules.\n\n" +
+            "Returns the table name, label, parent class, and for each field: name, label, " +
+            "type, maxLength, mandatory, readOnly, referenceTable, and defaultValue.\n\n" +
+            "Key use cases:\n" +
+            "- Understand the structure of a table before querying or scripting against it\n" +
+            "- Discover reference fields to understand table relationships\n" +
+            "- Find choice values for dropdown fields\n" +
+            "- Review UI policies and business rules that affect the table",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias (e.g., " +
+                '"dev224436", "prod"). If not provided, falls back ' +
+                "to the SN_AUTH_ALIAS environment variable."),
+            table: z
+                .string()
+                .describe("The ServiceNow table name to discover (e.g., " +
+                '"incident", "sys_user", "cmdb_ci").'),
+            include_choices: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Include choice values for fields that have them (e.g., " +
+                "priority, state). Queries sys_choice."),
+            include_relationships: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Include relationship information extracted from reference fields."),
+            include_ui_policies: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Include UI policies defined on the table."),
+            include_business_rules: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Include business rules defined on the table."),
+        },
+    }, async ({ instance, table, include_choices, include_relationships, include_ui_policies, include_business_rules, }) => {
+        try {
+            const schema = await withConnectionRetry(instance, async (snInstance) => {
+                const discovery = new SchemaDiscovery(snInstance);
+                return await discovery.discoverTableSchema(table, {
+                    includeChoiceTables: include_choices,
+                    includeRelationships: include_relationships,
+                    includeUIPolicies: include_ui_policies,
+                    includeBusinessRules: include_business_rules,
+                });
+            });
+            const lines = [];
+            lines.push("=== Table Schema ===");
+            lines.push(`Table: ${schema.table}`);
+            lines.push(`Label: ${schema.label}`);
+            if (schema.superClass) {
+                lines.push(`Parent Class: ${schema.superClass}`);
+            }
+            lines.push(`Fields: ${schema.fields.length}`);
+            lines.push("");
+            // Fields
+            lines.push("=== Fields ===");
+            for (const field of schema.fields) {
+                lines.push("");
+                lines.push(`  ${field.name}`);
+                lines.push(`    Label: ${field.label}`);
+                lines.push(`    Type: ${field.internalType}`);
+                lines.push(`    Max Length: ${field.maxLength}`);
+                lines.push(`    Mandatory: ${field.mandatory}`);
+                lines.push(`    Read Only: ${field.readOnly}`);
+                if (field.referenceTable) {
+                    lines.push(`    Reference Table: ${field.referenceTable}`);
+                }
+                if (field.defaultValue) {
+                    lines.push(`    Default Value: ${field.defaultValue}`);
+                }
+            }
+            // Choice tables
+            if (schema.choiceTables && schema.choiceTables.length > 0) {
+                lines.push("");
+                lines.push("=== Choice Values ===");
+                for (const choiceTable of schema.choiceTables) {
+                    lines.push("");
+                    lines.push(`  Field: ${choiceTable.field}`);
+                    for (const choice of choiceTable.choices) {
+                        lines.push(`    ${choice.value} = ${choice.label}`);
+                    }
+                }
+            }
+            // Relationships
+            if (schema.relationships && schema.relationships.length > 0) {
+                lines.push("");
+                lines.push("=== Relationships ===");
+                for (const rel of schema.relationships) {
+                    lines.push(`  ${rel.name} -> ${rel.relatedTable} (${rel.type})`);
+                }
+            }
+            // UI Policies
+            if (schema.uiPolicies && schema.uiPolicies.length > 0) {
+                lines.push("");
+                lines.push("=== UI Policies ===");
+                for (const policy of schema.uiPolicies) {
+                    lines.push(`  ${policy.short_description || "(no description)"} [${policy.active ? "active" : "inactive"}] (sys_id: ${policy.sys_id})`);
+                }
+            }
+            // Business Rules
+            if (schema.businessRules && schema.businessRules.length > 0) {
+                lines.push("");
+                lines.push("=== Business Rules ===");
+                for (const rule of schema.businessRules) {
+                    lines.push(`  ${rule.name || "(no name)"} [when: ${rule.when}, ${rule.active ? "active" : "inactive"}] (sys_id: ${rule.sys_id})`);
+                }
+            }
+            lines.push("");
+            lines.push(`=== ${schema.fields.length} field(s) discovered ===`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error discovering table schema: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the explain_field tool on the MCP server.
+ *
+ * Gets a detailed explanation of a specific field on a table, including
+ * type, constraints, help text, and available choice values.
+ */
+export function registerExplainFieldTool(server) {
+    server.registerTool("explain_field", {
+        title: "Explain Field",
+        description: "Get detailed explanation of a specific field on a ServiceNow table, " +
+            "including type, constraints, help text, and available choice values.\n\n" +
+            "Use this to understand what a field does, what values it accepts, " +
+            "and how it is configured before reading or writing data.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias (e.g., " +
+                '"dev224436", "prod"). If not provided, falls back ' +
+                "to the SN_AUTH_ALIAS environment variable."),
+            table: z
+                .string()
+                .describe("The ServiceNow table name containing the field (e.g., " +
+                '"incident", "sys_user").'),
+            field: z
+                .string()
+                .describe("The field element name to explain (e.g., " +
+                '"state", "priority", "assigned_to").'),
+        },
+    }, async ({ instance, table, field }) => {
+        try {
+            const explanation = await withConnectionRetry(instance, async (snInstance) => {
+                const discovery = new SchemaDiscovery(snInstance);
+                return await discovery.explainField(table, field);
+            });
+            const lines = [];
+            lines.push("=== Field Explanation ===");
+            lines.push(`Field: ${explanation.field}`);
+            lines.push(`Table: ${explanation.table}`);
+            lines.push(`Label: ${explanation.label}`);
+            lines.push(`Type: ${explanation.type}`);
+            lines.push(`Max Length: ${explanation.maxLength}`);
+            lines.push(`Mandatory: ${explanation.mandatory}`);
+            lines.push(`Read Only: ${explanation.readOnly}`);
+            if (explanation.comments) {
+                lines.push(`Comments: ${explanation.comments}`);
+            }
+            if (explanation.help) {
+                lines.push(`Help: ${explanation.help}`);
+            }
+            if (explanation.referenceTable) {
+                lines.push(`Reference Table: ${explanation.referenceTable}`);
+            }
+            if (explanation.choices && explanation.choices.length > 0) {
+                lines.push("");
+                lines.push("=== Available Choices ===");
+                for (const choice of explanation.choices) {
+                    lines.push(`  ${choice.value} = ${choice.label}`);
+                }
+                lines.push("");
+                lines.push(`=== ${explanation.choices.length} choice(s) ===`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error explaining field: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the validate_catalog tool on the MCP server.
+ *
+ * Validates a catalog item's configuration, checking variables for
+ * duplicates, missing names, inactive mandatory vars, and UI policy issues.
+ */
+export function registerValidateCatalogTool(server) {
+    server.registerTool("validate_catalog", {
+        title: "Validate Catalog Configuration",
+        description: "Validate a catalog item's configuration on a ServiceNow instance. " +
+            "Checks variables for duplicates, missing names, inactive mandatory " +
+            "variables, and UI policy issues.\n\n" +
+            "Returns a valid/invalid flag, error and warning counts, and each " +
+            "issue with its severity, component, sys_id, description, and suggested fix.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias (e.g., " +
+                '"dev224436", "prod"). If not provided, falls back ' +
+                "to the SN_AUTH_ALIAS environment variable."),
+            catalog_item_sys_id: z
+                .string()
+                .describe("The sys_id of the catalog item to validate."),
+        },
+    }, async ({ instance, catalog_item_sys_id }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const discovery = new SchemaDiscovery(snInstance);
+                return await discovery.validateCatalogConfiguration(catalog_item_sys_id);
+            });
+            const lines = [];
+            lines.push("=== Catalog Validation Result ===");
+            lines.push(`Catalog Item: ${catalog_item_sys_id}`);
+            lines.push(`Valid: ${result.valid}`);
+            lines.push(`Errors: ${result.errors}`);
+            lines.push(`Warnings: ${result.warnings}`);
+            if (result.issues.length > 0) {
+                lines.push("");
+                lines.push("=== Issues ===");
+                for (const issue of result.issues) {
+                    lines.push("");
+                    lines.push(`  [${issue.severity.toUpperCase()}] ${issue.issue}`);
+                    lines.push(`    Component: ${issue.component}`);
+                    if (issue.sys_id) {
+                        lines.push(`    sys_id: ${issue.sys_id}`);
+                    }
+                    if (issue.fix) {
+                        lines.push(`    Fix: ${issue.fix}`);
+                    }
+                }
+            }
+            else {
+                lines.push("");
+                lines.push("No issues found. The catalog item configuration is valid.");
+            }
+            lines.push("");
+            lines.push(`=== ${result.issues.length} issue(s): ${result.errors} error(s), ${result.warnings} warning(s) ===`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error validating catalog configuration: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/tools/schema.js.map

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

package/dist/tools/scope.d.ts

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the get_current_scope tool on the MCP server.
+ *
+ * This tool retrieves the currently active application scope on the ServiceNow
+ * instance. It mirrors the behavior of the CLI's `scope get` command.
+ */
+export declare function registerGetCurrentScopeTool(server: McpServer): void;
+/**
+ * Registers the set_current_scope tool on the MCP server.
+ *
+ * This tool changes the active application scope on the ServiceNow instance.
+ * It validates the app exists, records the previous scope, performs the change,
+ * and verifies the result. It mirrors the behavior of the CLI's `scope set` command.
+ */
+export declare function registerSetCurrentScopeTool(server: McpServer): void;
+/**
+ * Registers the list_scoped_apps tool on the MCP server.
+ *
+ * This tool lists scoped applications (sys_app records) on the ServiceNow
+ * instance with optional filtering. It mirrors the behavior of the CLI's
+ * `scope list` command.
+ */
+export declare function registerListScopedAppsTool(server: McpServer): void;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/tools/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsEnE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoFnE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+FlE"}

package/dist/tools/scope.js

@@ -0,0 +1,226 @@
+import { z } from "zod";
+import { ScopeManager } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Registers the get_current_scope tool on the MCP server.
+ *
+ * This tool retrieves the currently active application scope on the ServiceNow
+ * instance. It mirrors the behavior of the CLI's `scope get` command.
+ */
+export function registerGetCurrentScopeTool(server) {
+    server.registerTool("get_current_scope", {
+        title: "Get Current Application Scope",
+        description: "Get the currently active application scope on the ServiceNow instance.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias to connect to. " +
+                "This is the alias configured via `snc configure` (e.g., " +
+                '"dev224436", "prod", "test"). The user will typically refer to ' +
+                "this by name when saying things like \"on my dev224436 instance\". " +
+                "If not provided, falls back to the SN_AUTH_ALIAS environment variable."),
+        },
+    }, async ({ instance }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const scopeManager = new ScopeManager(snInstance);
+                return await scopeManager.getCurrentApplication();
+            });
+            if (!result) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No current application scope found.",
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                "=== Current Application Scope ===",
+                `Name:    ${result.name}`,
+                `Sys ID:  ${result.sys_id}`,
+                `Scope:   ${result.scope || "(unknown)"}`,
+                `Version: ${result.version || "(unknown)"}`,
+                `Active:  ${result.active || "(unknown)"}`,
+            ];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting current scope: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the set_current_scope tool on the MCP server.
+ *
+ * This tool changes the active application scope on the ServiceNow instance.
+ * It validates the app exists, records the previous scope, performs the change,
+ * and verifies the result. It mirrors the behavior of the CLI's `scope set` command.
+ */
+export function registerSetCurrentScopeTool(server) {
+    server.registerTool("set_current_scope", {
+        title: "Set Current Application Scope",
+        description: "Change the active application scope. Validates the app exists, records " +
+            "previous scope, verifies the change. IMPORTANT: This changes the session's " +
+            "application context.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias to connect to. " +
+                "This is the alias configured via `snc configure` (e.g., " +
+                '"dev224436", "prod", "test"). The user will typically refer to ' +
+                "this by name when saying things like \"on my dev224436 instance\". " +
+                "If not provided, falls back to the SN_AUTH_ALIAS environment variable."),
+            app_sys_id: z
+                .string()
+                .describe("The sys_id of the application to set as the current scope. " +
+                "Must be a 32-character hexadecimal string (e.g., " +
+                '"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6").'),
+        },
+    }, async ({ instance, app_sys_id }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const scopeManager = new ScopeManager(snInstance);
+                return await scopeManager.setCurrentApplication(app_sys_id);
+            });
+            const lines = [
+                "=== Set Application Scope ===",
+                `Success:     ${result.success}`,
+                `Application: ${result.application}`,
+                `Scope:       ${result.scope || "(unknown)"}`,
+                `Sys ID:      ${result.sysId}`,
+                `Verified:    ${result.verified}`,
+            ];
+            if (result.previousScope) {
+                lines.push("", "--- Previous Scope ---", `Name:   ${result.previousScope.name || "(unknown)"}`, `Sys ID: ${result.previousScope.sys_id || "(unknown)"}`);
+            }
+            if (result.warnings.length > 0) {
+                lines.push("", "--- Warnings ---");
+                for (const warning of result.warnings) {
+                    lines.push(`  - ${warning}`);
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error setting current scope: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the list_scoped_apps tool on the MCP server.
+ *
+ * This tool lists scoped applications (sys_app records) on the ServiceNow
+ * instance with optional filtering. It mirrors the behavior of the CLI's
+ * `scope list` command.
+ */
+export function registerListScopedAppsTool(server) {
+    server.registerTool("list_scoped_apps", {
+        title: "List Scoped Applications",
+        description: "List scoped applications (sys_app records) on the instance with optional filtering.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias to connect to. " +
+                "This is the alias configured via `snc configure` (e.g., " +
+                '"dev224436", "prod", "test"). The user will typically refer to ' +
+                "this by name when saying things like \"on my dev224436 instance\". " +
+                "If not provided, falls back to the SN_AUTH_ALIAS environment variable."),
+            query: z
+                .string()
+                .optional()
+                .describe("An encoded query string to filter applications. Uses ServiceNow " +
+                "encoded query syntax (e.g., \"active=true^scopeSTARTSWITHx_\", " +
+                "\"nameLIKEhr\"). If omitted, all applications are returned."),
+            limit: z
+                .number()
+                .min(1)
+                .max(200)
+                .default(50)
+                .describe("Maximum number of applications to return. Defaults to 50, " +
+                "minimum 1, maximum 200."),
+        },
+    }, async ({ instance, query, limit }) => {
+        try {
+            const apps = await withConnectionRetry(instance, async (snInstance) => {
+                const scopeManager = new ScopeManager(snInstance);
+                return await scopeManager.listApplications({ encodedQuery: query, limit });
+            });
+            if (!apps || apps.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No scoped applications found matching the criteria.",
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `=== Scoped Applications (${apps.length} found) ===`,
+                "",
+            ];
+            for (let i = 0; i < apps.length; i++) {
+                const app = apps[i];
+                lines.push(`${i + 1}. ${app.name}`, `   Sys ID:  ${app.sys_id}`, `   Scope:   ${app.scope || "(unknown)"}`, `   Version: ${app.version || "(unknown)"}`, `   Active:  ${app.active || "(unknown)"}`, "");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing scoped applications: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=scope.js.map

package/dist/tools/scope.js.map

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

package/dist/tools/scriptsync.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the pull_script tool on the MCP server.
+ *
+ * Pulls a script from ServiceNow and saves it to a local file.
+ */
+export declare function registerPullScriptTool(server: McpServer): void;
+/**
+ * Registers the push_script tool on the MCP server.
+ *
+ * Pushes a local script file to ServiceNow.
+ */
+export declare function registerPushScriptTool(server: McpServer): void;
+//# sourceMappingURL=scriptsync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scriptsync.d.ts","sourceRoot":"","sources":["../../src/tools/scriptsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwF9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuF9D"}