@sonisoft/now-sdk-ext-mcp 1.0.0

package/dist/tools/batch.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+import { BatchOperations } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Registers the batch_create_records tool on the MCP server.
+ *
+ * Creates multiple records across one or more tables in a single batch.
+ * Supports variable references between operations for chaining.
+ */
+export function registerBatchCreateRecordsTool(server) {
+    server.registerTool("batch_create_records", {
+        title: "Batch Create Records",
+        description: "Create multiple records across one or more ServiceNow tables in a single batch. " +
+            "Operations execute sequentially, supporting variable references between them: " +
+            "use `saveAs` to name an operation's result sys_id, then reference it in later " +
+            "operations with `${name}` in data values.\n\n" +
+            "Example: Create a parent record with saveAs='parent', then create a child " +
+            "record with caller_id set to '${parent}'.\n\n" +
+            "IMPORTANT: This creates records on the ServiceNow instance. Review the " +
+            "operations before executing.",
+        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."),
+            operations: z
+                .array(z.object({
+                table: z.string().describe("Target table name (e.g., 'incident')"),
+                data: z
+                    .record(z.unknown())
+                    .describe("Field data for the new record"),
+                saveAs: z
+                    .string()
+                    .optional()
+                    .describe("Key to save the created sys_id under. " +
+                    "Later operations can reference it via ${key}."),
+            }))
+                .describe("Ordered list of create operations to execute."),
+            transaction: z
+                .boolean()
+                .default(true)
+                .describe("When true (default), stops on first error. " +
+                "When false, continues past errors."),
+        },
+    }, async ({ instance, operations, transaction }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const batchOps = new BatchOperations(snInstance);
+                return await batchOps.batchCreate({ operations, transaction });
+            });
+            const lines = [];
+            lines.push("=== Batch Create Results ===");
+            lines.push(`Success: ${result.success}`);
+            lines.push(`Created: ${result.createdCount}/${operations.length}`);
+            lines.push(`Execution Time: ${result.executionTimeMs}ms`);
+            if (Object.keys(result.sysIds).length > 0) {
+                lines.push("");
+                lines.push("Saved sys_ids:");
+                for (const [key, sysId] of Object.entries(result.sysIds)) {
+                    lines.push(`  ${key}: ${sysId}`);
+                }
+            }
+            if (result.errors.length > 0) {
+                lines.push("");
+                lines.push("Errors:");
+                for (const err of result.errors) {
+                    lines.push(`  Operation ${err.operationIndex + 1} (${err.table}): ${err.error}`);
+                }
+            }
+            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 in batch create: ${message}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the batch_update_records tool on the MCP server.
+ *
+ * Updates multiple records across one or more tables in a single batch.
+ */
+export function registerBatchUpdateRecordsTool(server) {
+    server.registerTool("batch_update_records", {
+        title: "Batch Update Records",
+        description: "Update multiple records across one or more ServiceNow tables in a single batch. " +
+            "Each update specifies a table, sys_id, and the field data to update.\n\n" +
+            "IMPORTANT: This modifies records on the ServiceNow instance.",
+        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."),
+            updates: z
+                .array(z.object({
+                table: z.string().describe("Target table name"),
+                sysId: z.string().describe("sys_id of the record to update"),
+                data: z
+                    .record(z.unknown())
+                    .describe("Field data to update"),
+            }))
+                .describe("Ordered list of update operations to execute."),
+            stop_on_error: z
+                .boolean()
+                .default(false)
+                .describe("When true, stops on first error. " +
+                "When false (default), continues past errors."),
+        },
+    }, async ({ instance, updates, stop_on_error }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const batchOps = new BatchOperations(snInstance);
+                return await batchOps.batchUpdate({
+                    updates,
+                    stopOnError: stop_on_error,
+                });
+            });
+            const lines = [];
+            lines.push("=== Batch Update Results ===");
+            lines.push(`Success: ${result.success}`);
+            lines.push(`Updated: ${result.updatedCount}/${updates.length}`);
+            lines.push(`Execution Time: ${result.executionTimeMs}ms`);
+            if (result.errors.length > 0) {
+                lines.push("");
+                lines.push("Errors:");
+                for (const err of result.errors) {
+                    lines.push(`  Update ${err.updateIndex + 1} (${err.table}/${err.sysId}): ${err.error}`);
+                }
+            }
+            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 in batch update: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=batch.js.map

package/dist/tools/batch.js.map

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

package/dist/tools/cmdb.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the get_cmdb_relationships tool on the MCP server.
+ *
+ * Returns direct (single-level) upstream and/or downstream relationships for a CI.
+ */
+export declare function registerGetCmdbRelationshipsTool(server: McpServer): void;
+/**
+ * Registers the traverse_cmdb_graph tool on the MCP server.
+ *
+ * Performs a multi-level BFS traversal of the CMDB relationship graph.
+ */
+export declare function registerTraverseCmdbGraphTool(server: McpServer): void;
+//# sourceMappingURL=cmdb.d.ts.map

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

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

package/dist/tools/cmdb.js

@@ -0,0 +1,199 @@
+import { z } from "zod";
+import { CMDBRelationships } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry } from "../common/connection.js";
+/**
+ * Registers the get_cmdb_relationships tool on the MCP server.
+ *
+ * Returns direct (single-level) upstream and/or downstream relationships for a CI.
+ */
+export function registerGetCmdbRelationshipsTool(server) {
+    server.registerTool("get_cmdb_relationships", {
+        title: "Get CMDB Relationships",
+        description: "Get direct relationships of a CMDB Configuration Item (CI). Returns upstream, " +
+            "downstream, or both relationship directions. Use this for impact analysis, " +
+            "dependency mapping, and understanding CI topology.\n\n" +
+            "Provide the CI sys_id (from cmdb_ci or any CI class table). Optionally filter " +
+            "by relationship type (e.g., 'Depends on::Used by', 'Contains::Contained by').",
+        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."),
+            ci_sys_id: z
+                .string()
+                .describe("The sys_id of the Configuration Item to get relationships for."),
+            direction: z
+                .enum(["upstream", "downstream", "both"])
+                .default("both")
+                .describe('Relationship direction: "upstream" (parents/dependencies), ' +
+                '"downstream" (children/dependents), or "both". Default is "both".'),
+            relation_type: z
+                .string()
+                .optional()
+                .describe('Filter by relationship type name (e.g., "Depends on::Used by", ' +
+                '"Contains::Contained by"). If omitted, returns all relationship types.'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(1000)
+                .default(100)
+                .describe("Maximum number of relationships to return. Default is 100."),
+        },
+    }, async ({ instance, ci_sys_id, direction, relation_type, limit }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const cmdb = new CMDBRelationships(snInstance);
+                return await cmdb.getRelationships({
+                    ciSysId: ci_sys_id,
+                    direction,
+                    relationType: relation_type,
+                    limit,
+                });
+            });
+            const lines = [];
+            lines.push("=== CMDB Relationships ===");
+            if (result.ci) {
+                lines.push(`CI: ${result.ci.name || result.ci.sys_id} (${result.ci.sys_class_name || "unknown class"})`);
+            }
+            lines.push(`Direction: ${direction}`);
+            if (relation_type)
+                lines.push(`Relation Type Filter: ${relation_type}`);
+            lines.push(`Relationships found: ${result.relationships?.length ?? 0}`);
+            if (result.relationships && result.relationships.length > 0) {
+                for (const rel of result.relationships) {
+                    lines.push("");
+                    lines.push(`--- Relationship ---`);
+                    lines.push(JSON.stringify(rel, null, 2));
+                }
+            }
+            else {
+                lines.push("");
+                lines.push("No relationships found.");
+            }
+            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 CMDB relationships: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Registers the traverse_cmdb_graph tool on the MCP server.
+ *
+ * Performs a multi-level BFS traversal of the CMDB relationship graph.
+ */
+export function registerTraverseCmdbGraphTool(server) {
+    server.registerTool("traverse_cmdb_graph", {
+        title: "Traverse CMDB Graph",
+        description: "Traverse the CMDB relationship graph starting from a Configuration Item using " +
+            "breadth-first search. Returns all nodes (CIs) and edges (relationships) discovered " +
+            "up to the specified depth.\n\n" +
+            "Use this for deep impact analysis, service mapping, and understanding the full " +
+            "dependency chain of a CI. Max depth is 5, max nodes is 1000.",
+        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."),
+            ci_sys_id: z
+                .string()
+                .describe("The sys_id of the root Configuration Item to start traversal from."),
+            direction: z
+                .enum(["upstream", "downstream", "both"])
+                .default("both")
+                .describe('Traversal direction: "upstream", "downstream", or "both". Default is "both".'),
+            max_depth: z
+                .number()
+                .int()
+                .min(1)
+                .max(5)
+                .default(2)
+                .describe("Maximum traversal depth (1-5). Higher depth discovers more of the graph " +
+                "but makes more API calls. Default is 2."),
+            relation_type: z
+                .string()
+                .optional()
+                .describe("Filter traversal to only follow this relationship type."),
+            max_nodes: z
+                .number()
+                .int()
+                .min(1)
+                .max(1000)
+                .default(200)
+                .describe("Maximum number of nodes to visit. Traversal stops when this limit is " +
+                "reached. Default is 200, max is 1000."),
+        },
+    }, async ({ instance, ci_sys_id, direction, max_depth, relation_type, max_nodes, }) => {
+        try {
+            const result = await withConnectionRetry(instance, async (snInstance) => {
+                const cmdb = new CMDBRelationships(snInstance);
+                return await cmdb.traverseGraph({
+                    ciSysId: ci_sys_id,
+                    direction,
+                    maxDepth: max_depth,
+                    relationType: relation_type,
+                    maxNodes: max_nodes,
+                });
+            });
+            const lines = [];
+            lines.push("=== CMDB Graph Traversal ===");
+            if (result.rootCI) {
+                lines.push(`Root CI: ${result.rootCI.name || result.rootCI.sys_id} (${result.rootCI.sys_class_name || "unknown"})`);
+            }
+            lines.push(`Direction: ${direction}`);
+            lines.push(`Max Depth: ${max_depth}`);
+            lines.push(`Nodes discovered: ${result.nodes?.length ?? 0}`);
+            lines.push(`Edges discovered: ${result.edges?.length ?? 0}`);
+            lines.push(`API calls made: ${result.apiCallCount ?? 0}`);
+            if (result.truncated) {
+                lines.push(`WARNING: Traversal was truncated — ${result.truncationReason || "limit reached"}`);
+            }
+            if (result.nodes && result.nodes.length > 0) {
+                lines.push("");
+                lines.push("--- Nodes ---");
+                for (const node of result.nodes) {
+                    lines.push(`  [depth=${node.depth}] ${node.name || node.sysId} (${node.className || "unknown"}) — ${node.sysId}`);
+                }
+            }
+            if (result.edges && result.edges.length > 0) {
+                lines.push("");
+                lines.push("--- Edges ---");
+                for (const edge of result.edges) {
+                    lines.push(`  ${edge.parentSysId} --[${edge.typeName || "related"}]--> ${edge.childSysId}`);
+                }
+            }
+            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 traversing CMDB graph: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=cmdb.js.map

package/dist/tools/cmdb.js.map

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

package/dist/tools/codesearch.d.ts

@@ -0,0 +1,31 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.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 declare function registerCodeSearchTool(server: McpServer): void;
+/**
+ * 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 declare function registerListCodeSearchGroupsTool(server: McpServer): void;
+/**
+ * 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 declare function registerListCodeSearchTablesTool(server: McpServer): void;
+/**
+ * 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 declare function registerAddCodeSearchTableTool(server: McpServer): void;
+//# sourceMappingURL=codesearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codesearch.d.ts","sourceRoot":"","sources":["../../src/tools/codesearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgK9D;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6FxE;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0FxE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+FtE"}