@sonisoft/now-sdk-ext-mcp 1.0.0

package/dist/tools/codesearch.js

@@ -0,0 +1,371 @@
+import { z } from "zod";
+import { CodeSearch } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Registers the code_search tool on the MCP server.
+ *
+ * Searches for code across a ServiceNow instance using the Code Search API.
+ * This is the primary tool for finding scripts, business rules, and other
+ * code artifacts on the platform.
+ */
+export function registerCodeSearchTool(server) {
+    server.registerTool("code_search", {
+        title: "Code Search",
+        description: "Search for code across a ServiceNow instance using the Code Search API. " +
+            "Finds matching scripts, business rules, script includes, and other code artifacts " +
+            "across the platform. Results include the record name, table, field, and matching " +
+            "line numbers with context.\n\n" +
+            "Code Search works through Search Groups, which define sets of tables and fields " +
+            "to search. There is typically a default search group. Use `list_code_search_groups` " +
+            "to discover available groups, and `list_code_search_tables` to see which tables " +
+            "a group covers.\n\n" +
+            "Key use cases:\n" +
+            "- Find scripts that reference a specific API, table, or pattern\n" +
+            "- Locate business rules, script includes, or UI scripts containing specific logic\n" +
+            "- Verify whether code has been deployed to an instance\n" +
+            "- Search within a specific application scope or 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."),
+            term: z
+                .string()
+                .describe("The search term to find in code. Searches across script fields " +
+                "in the tables defined by the search group."),
+            search_group: z
+                .string()
+                .optional()
+                .describe("The search group NAME to scope the search (e.g., " +
+                '"Default Code Search Group"). If omitted, the instance\'s ' +
+                "default search group is used. Use `list_code_search_groups` " +
+                "to discover available groups."),
+            table: z
+                .string()
+                .optional()
+                .describe("Specific table to search within (e.g., \"sys_script_include\"). " +
+                "Requires `search_group` to also be specified. Use " +
+                "`list_code_search_tables` to see available tables for a group."),
+            current_app: z
+                .string()
+                .optional()
+                .describe("Application scope to limit results to (e.g., \"x_myapp\"). " +
+                "When set, only results from this application scope are returned. " +
+                "Automatically sets search_all_scopes to false."),
+            search_all_scopes: z
+                .boolean()
+                .optional()
+                .describe("When false, limits results to files within the scope specified by " +
+                "`current_app`. Defaults to true (search all scopes)."),
+            limit: z
+                .number()
+                .optional()
+                .describe("Maximum number of results to return."),
+        },
+    }, async ({ instance, term, search_group, table, current_app, search_all_scopes, limit, }) => {
+        try {
+            const results = await withConnectionRetry(instance, async (snInstance) => {
+                const codeSearch = new CodeSearch(snInstance);
+                // If current_app is specified but search_all_scopes is not,
+                // default to false (matching searchInApp behavior)
+                const effectiveSearchAllScopes = current_app && search_all_scopes === undefined
+                    ? false
+                    : search_all_scopes;
+                return await codeSearch.search({
+                    term,
+                    search_group,
+                    table,
+                    current_app,
+                    search_all_scopes: effectiveSearchAllScopes,
+                    limit,
+                });
+            });
+            // Build output
+            const lines = [];
+            lines.push("=== Code Search Results ===");
+            const searchInfo = [`Search: "${term}"`];
+            if (search_group)
+                searchInfo.push(`Group: ${search_group}`);
+            if (table)
+                searchInfo.push(`Table: ${table}`);
+            if (current_app)
+                searchInfo.push(`App: ${current_app}`);
+            if (limit)
+                searchInfo.push(`Limit: ${limit}`);
+            lines.push(searchInfo.join(" | "));
+            lines.push("");
+            // Use the core library's formatter for result details
+            lines.push(CodeSearch.formatResultsAsText(results));
+            // Footer tips
+            if (!search_group) {
+                lines.push("");
+                lines.push("Tip: Use `list_code_search_groups` to discover available search groups, " +
+                    "then pass the group name as `search_group` to scope your search.");
+            }
+            if (results.length === 0) {
+                lines.push("");
+                lines.push("No matching code found. Try a different search term, or use " +
+                    "`list_code_search_tables` to verify which tables are being searched.");
+            }
+            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 searching code: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the list_code_search_groups tool on the MCP server.
+ *
+ * Lists available code search groups on a ServiceNow instance.
+ * Search groups define which tables and fields are included in code searches.
+ */
+export function registerListCodeSearchGroupsTool(server) {
+    server.registerTool("list_code_search_groups", {
+        title: "List Code Search Groups",
+        description: "List available code search groups on a ServiceNow instance. " +
+            "Search groups define which tables and fields are included when performing " +
+            "a code search. Each instance typically has a default search group, and " +
+            "additional groups can be created for specific use cases.\n\n" +
+            "Use the group `name` as the `search_group` parameter in `code_search`. " +
+            "Use the group `sys_id` when adding tables via `add_code_search_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."),
+            limit: z
+                .number()
+                .default(100)
+                .describe("Maximum number of search groups to return. Default is 100."),
+        },
+    }, async ({ instance, limit }) => {
+        try {
+            const groups = await withConnectionRetry(instance, async (snInstance) => {
+                const codeSearch = new CodeSearch(snInstance);
+                return await codeSearch.getSearchGroups({ limit });
+            });
+            const lines = [];
+            lines.push("=== Code Search Groups ===");
+            lines.push(`Found: ${groups.length} group(s)`);
+            if (groups.length === 0) {
+                lines.push("");
+                lines.push("No code search groups found on this instance.");
+            }
+            else {
+                groups.forEach((group, index) => {
+                    lines.push("");
+                    lines.push(`${index + 1}. ${group.name}`);
+                    lines.push(`   sys_id: ${group.sys_id}`);
+                    if (group.description) {
+                        const truncated = group.description.length > 120
+                            ? group.description.substring(0, 120) + "..."
+                            : group.description;
+                        lines.push(`   Description: ${truncated}`);
+                    }
+                });
+            }
+            lines.push("");
+            lines.push(`=== ${groups.length} group(s) found ===`);
+            lines.push("");
+            lines.push("Tip: Use the group name as `search_group` in `code_search`. " +
+                "Use the sys_id as `search_group` in `add_code_search_table`.");
+            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 code search groups: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the list_code_search_tables tool on the MCP server.
+ *
+ * Lists the tables associated with a code search group — these are the
+ * tables that get searched when using that group in a code search.
+ */
+export function registerListCodeSearchTablesTool(server) {
+    server.registerTool("list_code_search_tables", {
+        title: "List Code Search Tables",
+        description: "List the tables associated with a code search group. These are the tables " +
+            "and fields that are searched when performing a code search with that group.\n\n" +
+            "Use this to understand what a search group covers, or to identify if a " +
+            "specific table is missing and needs to be added via `add_code_search_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."),
+            search_group: z
+                .string()
+                .describe("The search group NAME (not sys_id) to list tables for. " +
+                "Use `list_code_search_groups` to find available group names."),
+        },
+    }, async ({ instance, search_group }) => {
+        try {
+            const tables = await withConnectionRetry(instance, async (snInstance) => {
+                const codeSearch = new CodeSearch(snInstance);
+                return await codeSearch.getTablesForSearchGroup(search_group);
+            });
+            const lines = [];
+            lines.push(`=== Tables in Search Group: ${search_group} ===`);
+            lines.push(`Found: ${tables.length} table(s)`);
+            if (tables.length === 0) {
+                lines.push("");
+                lines.push("No tables found in this search group. Use `add_code_search_table` to add tables.");
+            }
+            else {
+                tables.forEach((table, index) => {
+                    lines.push("");
+                    lines.push(`${index + 1}. ${table.name}${table.label ? ` (${table.label})` : ""}`);
+                });
+            }
+            lines.push("");
+            lines.push(`=== ${tables.length} table(s) found ===`);
+            if (tables.length > 0) {
+                lines.push("");
+                lines.push("Tip: Use `add_code_search_table` to add a table to this search group, " +
+                    "or pass a table name as `table` in `code_search` to search a specific table.");
+            }
+            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 code search tables: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the add_code_search_table tool on the MCP server.
+ *
+ * Adds a new table to an existing code search group, expanding what
+ * gets searched when using that group.
+ */
+export function registerAddCodeSearchTableTool(server) {
+    server.registerTool("add_code_search_table", {
+        title: "Add Code Search Table",
+        description: "Add a new table to an existing code search group, expanding what gets searched. " +
+            "After adding a table, code searches using that group will also search the " +
+            "specified fields on the new table.\n\n" +
+            "Requires the search group's sys_id (get it from `list_code_search_groups`) " +
+            "and the table name and fields to search.\n\n" +
+            "IMPORTANT: This modifies the code search configuration on the instance. " +
+            "Verify the table name and fields before adding.",
+        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 table name to add to the search group (e.g., " +
+                '"sys_script_include", "sys_ui_script"). Use `lookup_table` ' +
+                "to verify the table name exists."),
+            search_fields: z
+                .string()
+                .describe("Comma-separated field names to search on this table (e.g., " +
+                '"script,name", "script"). Use `lookup_columns` to find ' +
+                "available fields on the table."),
+            search_group: z
+                .string()
+                .describe("The sys_id of the target code search group. Get this from " +
+                "`list_code_search_groups`."),
+        },
+    }, async ({ instance, table, search_fields, search_group }) => {
+        try {
+            const record = await withConnectionRetry(instance, async (snInstance) => {
+                const codeSearch = new CodeSearch(snInstance);
+                return await codeSearch.addTableToSearchGroup({
+                    table,
+                    search_fields,
+                    search_group,
+                });
+            });
+            const lines = [];
+            lines.push("=== Code Search Table Added ===");
+            lines.push("");
+            lines.push(`Table: ${record.table}`);
+            lines.push(`Search Fields: ${record.search_fields}`);
+            lines.push(`sys_id: ${record.sys_id}`);
+            lines.push(`Search Group: ${search_group}`);
+            lines.push("");
+            lines.push("The table has been added to the search group. Code searches using " +
+                "this group will now include results from this table.");
+            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 adding code search table: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=codesearch.js.map

package/dist/tools/codesearch.js.map

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

package/dist/tools/discovery.d.ts

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the list_instance_tables tool on the MCP server.
+ *
+ * Lists tables on a ServiceNow instance with optional filtering by name prefix,
+ * scope, and extendability. Complements lookup_table which searches by name/label.
+ */
+export declare function registerListInstanceTablesTool(server: McpServer): void;
+/**
+ * Registers the list_plugins tool on the MCP server.
+ *
+ * Lists platform plugins on a ServiceNow instance.
+ */
+export declare function registerListPluginsTool(server: McpServer): void;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0HtE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkG/D"}

package/dist/tools/discovery.js

@@ -0,0 +1,204 @@
+import { z } from "zod";
+import { InstanceDiscovery } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Registers the list_instance_tables tool on the MCP server.
+ *
+ * Lists tables on a ServiceNow instance with optional filtering by name prefix,
+ * scope, and extendability. Complements lookup_table which searches by name/label.
+ */
+export function registerListInstanceTablesTool(server) {
+    server.registerTool("list_instance_tables", {
+        title: "List Instance Tables",
+        description: "List tables on a ServiceNow instance with optional filtering. Returns table name, " +
+            "label, parent class, scope, and whether the table is extendable.\n\n" +
+            "Unlike lookup_table (which searches by name or label keyword), this tool supports " +
+            "browsing with prefix filters, scope filters, and extendable-only mode. " +
+            "Use this to discover tables in a specific scope or browse tables by naming convention.",
+        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."),
+            name_prefix: z
+                .string()
+                .optional()
+                .describe('Filter tables whose name starts with this prefix (e.g., "cmdb_ci", ' +
+                '"x_myapp", "incident"). Case-sensitive.'),
+            scope: z
+                .string()
+                .optional()
+                .describe('Filter tables belonging to a specific application scope (e.g., "global", ' +
+                '"x_myapp_custom").'),
+            extendable_only: z
+                .boolean()
+                .optional()
+                .describe("When true, only return tables that can be extended."),
+            query: z
+                .string()
+                .optional()
+                .describe("An encoded query string for advanced filtering on sys_db_object."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .default(50)
+                .describe("Maximum number of tables to return. Default is 50."),
+            offset: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Offset for pagination (skip this many records)."),
+        },
+    }, async ({ instance, name_prefix, scope, extendable_only, query, limit, offset }) => {
+        try {
+            const tables = await withConnectionRetry(instance, async (snInstance) => {
+                const discovery = new InstanceDiscovery(snInstance);
+                return await discovery.listTables({
+                    namePrefix: name_prefix,
+                    scope,
+                    extendableOnly: extendable_only,
+                    query,
+                    limit,
+                    offset,
+                });
+            });
+            const lines = [];
+            lines.push("=== Instance Tables ===");
+            if (name_prefix)
+                lines.push(`Name Prefix: ${name_prefix}`);
+            if (scope)
+                lines.push(`Scope: ${scope}`);
+            if (extendable_only)
+                lines.push("Extendable Only: true");
+            lines.push(`Tables returned: ${tables.length}`);
+            if (tables.length === 0) {
+                lines.push("");
+                lines.push("No tables found matching the criteria.");
+            }
+            else {
+                for (const table of tables) {
+                    lines.push("");
+                    lines.push(`  ${table.name || "unknown"} — ${table.label || "no label"}`);
+                    if (table.super_class)
+                        lines.push(`    Extends: ${table.super_class}`);
+                    if (table.sys_scope)
+                        lines.push(`    Scope: ${table.sys_scope}`);
+                    if (table.is_extendable)
+                        lines.push(`    Extendable: ${table.is_extendable}`);
+                }
+            }
+            lines.push("");
+            lines.push(`=== ${tables.length} table(s) returned ===`);
+            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 tables: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the list_plugins tool on the MCP server.
+ *
+ * Lists platform plugins on a ServiceNow instance.
+ */
+export function registerListPluginsTool(server) {
+    server.registerTool("list_plugins", {
+        title: "List Plugins",
+        description: "List ServiceNow platform plugins on an instance. Returns plugin ID, name, " +
+            "version, and active status. Use to discover which plugins are installed/active " +
+            "or to find a specific plugin by name prefix.",
+        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."),
+            name_prefix: z
+                .string()
+                .optional()
+                .describe('Filter plugins whose name starts with this prefix (e.g., "com.snc", ' +
+                '"com.glide"). Case-sensitive.'),
+            active_only: z
+                .boolean()
+                .default(true)
+                .describe("When true (default), only return active plugins."),
+            query: z
+                .string()
+                .optional()
+                .describe("An encoded query string for advanced filtering on sys_plugins."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .default(50)
+                .describe("Maximum number of plugins to return. Default is 50."),
+        },
+    }, async ({ instance, name_prefix, active_only, query, limit }) => {
+        try {
+            const plugins = await withConnectionRetry(instance, async (snInstance) => {
+                const discovery = new InstanceDiscovery(snInstance);
+                return await discovery.listPlugins({
+                    namePrefix: name_prefix,
+                    activeOnly: active_only,
+                    query,
+                    limit,
+                });
+            });
+            const lines = [];
+            lines.push("=== Plugins ===");
+            if (name_prefix)
+                lines.push(`Name Prefix: ${name_prefix}`);
+            lines.push(`Active Only: ${active_only}`);
+            lines.push(`Plugins returned: ${plugins.length}`);
+            if (plugins.length === 0) {
+                lines.push("");
+                lines.push("No plugins found matching the criteria.");
+            }
+            else {
+                for (const plugin of plugins) {
+                    lines.push("");
+                    lines.push(`  ${plugin.id || plugin.sys_id} — ${plugin.name || "unnamed"}`);
+                    if (plugin.version)
+                        lines.push(`    Version: ${plugin.version}`);
+                    lines.push(`    Active: ${plugin.active ?? "unknown"}`);
+                }
+            }
+            lines.push("");
+            lines.push(`=== ${plugins.length} plugin(s) returned ===`);
+            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 plugins: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=discovery.js.map

package/dist/tools/discovery.js.map

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

package/dist/tools/execute-script.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the execute_script tool on the MCP server.
+ *
+ * This tool executes JavaScript on a ServiceNow instance via Scripts - Background
+ * (the /sys.scripts.do endpoint). It mirrors the behavior of the CLI's `exec` command.
+ */
+export declare function registerExecuteScriptTool(server: McpServer): void;
+//# sourceMappingURL=execute-script.d.ts.map

package/dist/tools/execute-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-script.d.ts","sourceRoot":"","sources":["../../src/tools/execute-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkHjE"}