servicenow-mcp-server 2.1.0

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "servicenow-mcp-server",
+  "version": "2.1.0",
+  "description": "Multi-instance ServiceNow MCP server with 40+ tools, natural language search, and local script development",
+  "main": "src/server.js",
+  "type": "module",
+  "mcpName": "io.github.happy-technologies-llc/mcp-servicenow-nodejs",
+  "bin": {
+    "servicenow-mcp-server": "./src/stdio-server.js"
+  },
+  "scripts": {
+    "dev": "nodemon src/server.js",
+    "start": "node src/server.js",
+    "stdio": "node src/stdio-server.js",
+    "inspector": "npx @modelcontextprotocol/inspector",
+    "extract-metadata": "node scripts/extract-table-metadata.js",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "axios": "^1.6.0",
+    "chokidar": "^4.0.3",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "nodemon": "^3.0.2"
+  },
+  "author": "Happy Technologies LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Happy-Technologies-LLC/mcp-servicenow-nodejs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Happy-Technologies-LLC/mcp-servicenow-nodejs/issues"
+  },
+  "homepage": "https://github.com/Happy-Technologies-LLC/mcp-servicenow-nodejs#readme",
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "servicenow",
+    "itsm",
+    "claude",
+    "ai",
+    "automation",
+    "rest-api",
+    "service-catalog",
+    "cmdb",
+    "workflow",
+    "flow-designer",
+    "update-set",
+    "multi-instance"
+  ]
+}

package/scripts/background_script_2025-09-29T20-19-35-101Z.js

@@ -0,0 +1,23 @@
+/**
+ * Background Script
+ * Created: 2025-09-29T20:19:35.102Z
+ * Description: Set Integration Governance Framework as current update set
+ *
+ * INSTRUCTIONS:
+ * 1. Copy the script below
+ * 2. Navigate to ServiceNow: System Definition → Scripts - Background
+ * 3. Paste the script
+ * 4. Click "Run script"
+ * 5. Verify output in the output panel
+ */
+
+var updateSetSysId = '3ddbc8edc3d432101fcbbd43e4013124';
+var gr = new GlideRecord('sys_update_set');
+if (gr.get(updateSetSysId)) {
+    gs.setUpdateSet(gr);
+    gs.print('✅ Update set changed to: ' + gr.name);
+} else {
+    gs.print('❌ Update set not found: ' + updateSetSysId);
+}
+
+// End of script

package/scripts/link_ui_policy_actions_2025-09-29T20-17-15-218Z.js

@@ -0,0 +1,90 @@
+/**
+ * Fix Script: link_ui_policy_actions
+ * Created: 2025-09-29T20:17:15.218Z
+ * Description: Link UI Policy Actions to their respective policies and variables
+ *
+ * INSTRUCTIONS:
+ * 1. Copy the entire script below
+ * 2. Navigate to ServiceNow: System Definition → Scripts - Background
+ * 3. Paste the script
+ * 4. Click "Run script"
+ * 5. Verify output in the output panel
+ * 
+ */
+
+// Map of UI Policy Action sys_id to configuration
+var actions = {
+  // Policy 1: Show Tier 1 API Fields
+  'a7ac4c21c31832101fcbbd43e40131e5': {
+    ui_policy: '379c8061c31832101fcbbd43e401310f',
+    catalog_variable: 'IO:387c4c21c31832101fcbbd43e4013199',
+    variable: 'api_offering'
+  },
+
+  // Policy 2: Show Custom Integration Fields
+  '27ac0461c31832101fcbbd43e401319f': {
+    ui_policy: '739c8061c31832101fcbbd43e40131eb',
+    catalog_variable: 'IO:457c4c21c31832101fcbbd43e40131cd',
+    variable: 'target_system'
+  },
+  '27ac0461c31832101fcbbd43e40131a4': {
+    ui_policy: '739c8061c31832101fcbbd43e40131eb',
+    catalog_variable: 'IO:017c4c21c31832101fcbbd43e40131d9',
+    variable: 'requested_integration_tier'
+  },
+  'ebac0461c31832101fcbbd43e40131b5': {
+    ui_policy: '739c8061c31832101fcbbd43e40131eb',
+    catalog_variable: 'IO:517c082dc3d432101fcbbd43e40131dd',
+    variable: 'tier_1_justification'
+  },
+
+  // Policy 3: Show Data Protection Fields
+  'ebac0461c31832101fcbbd43e40131ba': {
+    ui_policy: 'ccac8061c31832101fcbbd43e40131f2',
+    catalog_variable: 'IO:657c8c21c31832101fcbbd43e401313f',
+    variable: 'lawful_basis'
+  },
+  'fbac0461c31832101fcbbd43e40131bf': {
+    ui_policy: 'ccac8061c31832101fcbbd43e40131f2',
+    catalog_variable: 'IO:f57c8c21c31832101fcbbd43e4013159',
+    variable: 'data_retention_period'
+  },
+  'fbac0461c31832101fcbbd43e40131c4': {
+    ui_policy: 'ccac8061c31832101fcbbd43e40131f2',
+    catalog_variable: 'IO:fd7c8c21c31832101fcbbd43e4013173',
+    variable: 'third_party_sharing'
+  }
+};
+
+gs.print('\n========================================');
+gs.print('Linking UI Policy Actions');
+gs.print('========================================\n');
+
+var updateCount = 0;
+var failCount = 0;
+
+for (var sysId in actions) {
+  var gr = new GlideRecord('catalog_ui_policy_action');
+  if (gr.get(sysId)) {
+    gr.setValue('ui_policy', actions[sysId].ui_policy);
+    gr.setValue('catalog_variable', actions[sysId].catalog_variable);
+    gr.setValue('variable', actions[sysId].variable);
+    gr.update();
+    updateCount++;
+    gs.print('✅ Updated: ' + actions[sysId].variable + ' (' + sysId + ')');
+  } else {
+    failCount++;
+    gs.print('❌ NOT FOUND: ' + sysId);
+  }
+}
+
+gs.print('\n========================================');
+gs.print('Summary');
+gs.print('========================================');
+gs.print('✅ Successfully updated: ' + updateCount + ' actions');
+if (failCount > 0) {
+  gs.print('❌ Failed to update: ' + failCount + ' actions');
+}
+gs.print('========================================\n');
+
+// End of script

package/scripts/set_update_set_Integration_Governance_Framework_2025-09-29T19-47-06-790Z.js

@@ -0,0 +1,30 @@
+/**
+ * Fix Script: Set Current Update Set
+ * Update Set: Integration Governance Framework
+ * Update Set sys_id: 83f8cca9c3d432101fcbbd43e4013173
+ * Created: 2025-09-29T19:47:06.792Z
+ *
+ * INSTRUCTIONS:
+ * 1. Copy the entire script below
+ * 2. Navigate to ServiceNow: System Definition → Scripts - Background
+ * 3. Paste the script
+ * 4. Click "Run script"
+ * 5. Verify output shows: "Update set changed to: Integration Governance Framework"
+ * 6. Delete this file after successful execution
+ *
+ * ALTERNATIVE: Set manually via UI
+ * 1. Navigate to: System Update Sets → Local Update Sets
+ * 2. Find update set: Integration Governance Framework
+ * 3. Click "Make this my current set"
+ */
+
+var updateSetSysId = '83f8cca9c3d432101fcbbd43e4013173';
+var gr = new GlideRecord('sys_update_set');
+if (gr.get(updateSetSysId)) {
+    gs.setUpdateSet(gr);
+    gs.info('✅ Update set changed to: ' + gr.name);
+} else {
+    gs.error('❌ Update set not found: ' + updateSetSysId);
+}
+
+// End of script

package/scripts/set_update_set_Integration_Governance_Framework_2025-09-29T19-59-33-152Z.js

@@ -0,0 +1,30 @@
+/**
+ * Fix Script: Set Current Update Set
+ * Update Set: Integration Governance Framework
+ * Update Set sys_id: 3ddbc8edc3d432101fcbbd43e4013124
+ * Created: 2025-09-29T19:59:33.155Z
+ *
+ * INSTRUCTIONS:
+ * 1. Copy the entire script below
+ * 2. Navigate to ServiceNow: System Definition → Scripts - Background
+ * 3. Paste the script
+ * 4. Click "Run script"
+ * 5. Verify output shows: "Update set changed to: Integration Governance Framework"
+ * 6. Delete this file after successful execution
+ *
+ * ALTERNATIVE: Set manually via UI
+ * 1. Navigate to: System Update Sets → Local Update Sets
+ * 2. Find update set: Integration Governance Framework
+ * 3. Click "Make this my current set"
+ */
+
+var updateSetSysId = '3ddbc8edc3d432101fcbbd43e4013124';
+var gr = new GlideRecord('sys_update_set');
+if (gr.get(updateSetSysId)) {
+    gs.setUpdateSet(gr);
+    gs.info('✅ Update set changed to: ' + gr.name);
+} else {
+    gs.error('❌ Update set not found: ' + updateSetSysId);
+}
+
+// End of script

package/scripts/set_update_set_current_2025-09-29T20-16-59-675Z.js

@@ -0,0 +1,24 @@
+/**
+ * Fix Script: set_update_set_current
+ * Created: 2025-09-29T20:16:59.676Z
+ * Description: Set Integration Governance Framework as current update set
+ *
+ * INSTRUCTIONS:
+ * 1. Copy the entire script below
+ * 2. Navigate to ServiceNow: System Definition → Scripts - Background
+ * 3. Paste the script
+ * 4. Click "Run script"
+ * 5. Verify output in the output panel
+ * 6. Delete this file after successful execution
+ */
+
+var updateSetSysId = '3ddbc8edc3d432101fcbbd43e4013124';
+var gr = new GlideRecord('sys_update_set');
+if (gr.get(updateSetSysId)) {
+    gs.setUpdateSet(gr);
+    gs.print('✅ Update set changed to: ' + gr.name);
+} else {
+    gs.print('❌ Update set not found: ' + updateSetSysId);
+}
+
+// End of script

package/scripts/test_sys_dictionary_403.js

@@ -0,0 +1,85 @@
+/**
+ * Test Script: Diagnose sys_dictionary 403 Error
+ *
+ * Run this in ServiceNow: System Definition → Scripts - Background
+ * This will help identify WHY admin is getting 403
+ */
+
+// Test 1: Can we create via GlideRecord (server-side)?
+gs.info('=== Test 1: Create via GlideRecord ===');
+try {
+  var gr = new GlideRecord('sys_dictionary');
+  gr.initialize();
+  gr.name = 'incident';
+  gr.element = 'u_test_field_' + gs.nowDateTime();
+  gr.column_label = 'Test Field ' + gs.nowDateTime();
+  gr.internal_type = 'string';
+  gr.max_length = 40;
+
+  var sysId = gr.insert();
+  if (sysId) {
+    gs.info('✅ SUCCESS: Created via GlideRecord: ' + sysId);
+
+    // Clean up
+    gr.get(sysId);
+    gr.deleteRecord();
+    gs.info('✅ Cleaned up test record');
+  } else {
+    gs.error('❌ FAILED: Could not create via GlideRecord');
+  }
+} catch(e) {
+  gs.error('❌ EXCEPTION in GlideRecord: ' + e.message);
+}
+
+// Test 2: Check current user roles
+gs.info('=== Test 2: Current User Roles ===');
+var userRoles = gs.getUser().getRoles();
+gs.info('Current user: ' + gs.getUserName());
+gs.info('Has admin role: ' + gs.getUser().hasRole('admin'));
+gs.info('Has security_admin role: ' + gs.getUser().hasRole('security_admin'));
+gs.info('Has personalize_dictionary role: ' + gs.getUser().hasRole('personalize_dictionary'));
+gs.info('All roles: ' + userRoles);
+
+// Test 3: Check ACLs on sys_dictionary
+gs.info('=== Test 3: ACLs on sys_dictionary ===');
+var acl = new GlideRecord('sys_security_acl');
+acl.addQuery('name', 'sys_dictionary');
+acl.query();
+gs.info('Found ' + acl.getRowCount() + ' ACLs for sys_dictionary');
+while (acl.next()) {
+  gs.info('ACL: ' + acl.operation + ' - Roles: ' + acl.roles);
+}
+
+// Test 4: Check if update set is needed
+gs.info('=== Test 4: Current Update Set ===');
+var updateSet = gs.getUpdateSet();
+gs.info('Current update set: ' + updateSet.name + ' (' + updateSet.sys_id + ')');
+
+// Test 5: Try with elevated privileges
+gs.info('=== Test 5: Test with setCanWriteToSystemFields ===');
+var grAdmin = new GlideRecordSecure('sys_dictionary');
+grAdmin.setWorkflow(false);
+grAdmin.initialize();
+grAdmin.name = 'incident';
+grAdmin.element = 'u_admin_test_' + gs.nowDateTime();
+grAdmin.column_label = 'Admin Test';
+grAdmin.internal_type = 'string';
+grAdmin.max_length = 40;
+
+try {
+  var adminSysId = grAdmin.insert();
+  if (adminSysId) {
+    gs.info('✅ SUCCESS with GlideRecordSecure: ' + adminSysId);
+    grAdmin.get(adminSysId);
+    grAdmin.deleteRecord();
+  } else {
+    gs.error('❌ FAILED with GlideRecordSecure');
+  }
+} catch(e) {
+  gs.error('❌ EXCEPTION with GlideRecordSecure: ' + e.message);
+}
+
+gs.info('=== Diagnosis Complete ===');
+gs.info('If Test 1 succeeded: 403 is REST API ACL issue, not server-side restriction');
+gs.info('If Test 1 failed: System-level restriction (contact ServiceNow admin)');
+gs.info('Check roles in Test 2 - ensure admin/personalize_dictionary present');