snow-flow 2.9.9 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/.mcp.json +13 -141
  2. package/.mcp.json.template +11 -25
  3. package/README.md +18 -0
  4. package/claude-flow +81 -0
  5. package/claude-flow.bat +18 -0
  6. package/claude-flow.config.json +20 -0
  7. package/claude-flow.ps1 +24 -0
  8. package/dist/agents/index.d.ts +3 -10
  9. package/dist/agents/index.js +10 -50
  10. package/dist/agents/queen-agent.d.ts +0 -2
  11. package/dist/agents/queen-agent.js +25 -42
  12. package/dist/cli.js +1 -1
  13. package/dist/mcp/servicenow-automation-mcp.js +10 -10
  14. package/dist/mcp/servicenow-deployment-mcp.js +1050 -169
  15. package/dist/mcp/servicenow-development-assistant-mcp.js +13 -65
  16. package/dist/mcp/servicenow-integration-mcp.js +10 -10
  17. package/dist/mcp/servicenow-machine-learning-mcp.js +15 -15
  18. package/dist/mcp/servicenow-operations-mcp.js +23 -23
  19. package/dist/mcp/servicenow-platform-development-mcp.js +9 -9
  20. package/dist/mcp/servicenow-reporting-analytics-mcp.js +11 -11
  21. package/dist/mcp/servicenow-security-compliance-mcp.js +11 -11
  22. package/dist/mcp/servicenow-update-set-mcp.js +9 -9
  23. package/dist/mcp/shared/reliable-memory-manager.d.ts +78 -0
  24. package/dist/mcp/shared/reliable-memory-manager.js +268 -0
  25. package/dist/mcp/snow-flow-mcp.js +341 -87
  26. package/dist/queen/agent-factory.d.ts +4 -2
  27. package/dist/queen/agent-factory.js +72 -25
  28. package/dist/services/tensorflow-ml-service.d.ts +105 -0
  29. package/dist/services/tensorflow-ml-service.js +456 -0
  30. package/dist/services/widget-deployment-service.d.ts +107 -0
  31. package/dist/services/widget-deployment-service.js +332 -0
  32. package/dist/utils/file-storage-fallback.d.ts +62 -0
  33. package/dist/utils/file-storage-fallback.js +289 -0
  34. package/dist/utils/mcp-singleton-enforcer.d.ts +36 -0
  35. package/dist/utils/mcp-singleton-enforcer.js +201 -0
  36. package/dist/utils/mcp-timeout-fix.d.ts +53 -0
  37. package/dist/utils/mcp-timeout-fix.js +221 -0
  38. package/memory/agents/README.md +31 -0
  39. package/memory/claude-flow-data.json +1 -1
  40. package/memory/sessions/README.md +1 -1
  41. package/package.json +4 -2
  42. package/src/agents/README.md +192 -0
  43. package/src/health/README.md +161 -0
  44. package/src/memory/README.md +240 -0
  45. package/src/queen/README.md +403 -0
  46. package/src/schemas/deployment.schema.json +58 -0
  47. package/src/schemas/flow.schema.json +79 -0
  48. package/src/schemas/widget.schema.json +72 -0
  49. package/src/templates/base/application.template.json +45 -0
  50. package/src/templates/base/business_rule.template.json +33 -0
  51. package/src/templates/base/script_include.template.json +18 -0
  52. package/src/templates/base/table.template.json +64 -0
  53. package/src/templates/base/widget.template.json +25 -0
  54. package/src/templates/patterns/composite.incident-management.template.json +140 -0
  55. package/src/templates/patterns/widget.dashboard.template.json +238 -0
  56. package/src/templates/patterns/widget.datatable.template.json +292 -0
  57. package/dist/mcp/servicenow-graph-memory-mcp.js +0 -728
  58. package/servicenow/widgets/openai_incident_classifier/client_controller.js +0 -284
  59. package/servicenow/widgets/openai_incident_classifier/server_script.js +0 -314
  60. package/servicenow/widgets/openai_incident_classifier/style.css +0 -354
  61. package/servicenow/widgets/openai_incident_classifier/template.html +0 -167
  62. package/servicenow/widgets/openai_incident_classifier/widget.json +0 -86
  63. package/test-ml-improvements.sh +0 -76
@@ -66,7 +66,7 @@ class ServiceNowDevelopmentAssistantMCP {
66
66
  tools: [
67
67
  {
68
68
  name: 'snow_find_artifact',
69
- description: 'AUTONOMOUS artifact discovery - finds ServiceNow artifacts using natural language, searches memory first, then ServiceNow. NO MANUAL SEARCH NEEDED.',
69
+ description: 'Finds ServiceNow artifacts using natural language queries. Searches cached memory first for performance, then queries ServiceNow directly if needed.',
70
70
  inputSchema: {
71
71
  type: 'object',
72
72
  properties: {
@@ -78,7 +78,7 @@ class ServiceNowDevelopmentAssistantMCP {
78
78
  },
79
79
  {
80
80
  name: 'snow_edit_artifact',
81
- description: 'AUTONOMOUS artifact modification - edits ServiceNow artifacts using natural language, handles errors automatically, retries on failure. DIRECT MODIFICATION.',
81
+ description: 'Modifies ServiceNow artifacts using natural language instructions. Includes automatic error handling, retry logic, and validation of changes.',
82
82
  inputSchema: {
83
83
  type: 'object',
84
84
  properties: {
@@ -89,7 +89,7 @@ class ServiceNowDevelopmentAssistantMCP {
89
89
  },
90
90
  {
91
91
  name: 'snow_get_by_sysid',
92
- description: 'DIRECT sys_id lookup - get artifact by exact sys_id, much faster and more reliable than text search',
92
+ description: 'Retrieves artifacts by sys_id for precise, fast lookups. More reliable than text-based searches when sys_id is known.',
93
93
  inputSchema: {
94
94
  type: 'object',
95
95
  properties: {
@@ -101,7 +101,7 @@ class ServiceNowDevelopmentAssistantMCP {
101
101
  },
102
102
  {
103
103
  name: 'snow_edit_by_sysid',
104
- description: 'DIRECT sys_id edit - update specific fields of artifact by sys_id, much more reliable than text-based search',
104
+ description: 'Updates specific fields of an artifact using sys_id. Provides direct field-level modifications with validation.',
105
105
  inputSchema: {
106
106
  type: 'object',
107
107
  properties: {
@@ -115,7 +115,7 @@ class ServiceNowDevelopmentAssistantMCP {
115
115
  },
116
116
  {
117
117
  name: 'snow_analyze_artifact',
118
- description: 'AUTONOMOUS deep _analysis - intelligently indexes artifacts for optimal Claude understanding, stores in memory for future use. SELF-LEARNING SYSTEM.',
118
+ description: 'Performs comprehensive analysis of artifacts including dependencies, usage patterns, and optimization opportunities. Caches results for improved performance.',
119
119
  inputSchema: {
120
120
  type: 'object',
121
121
  properties: {
@@ -127,7 +127,7 @@ class ServiceNowDevelopmentAssistantMCP {
127
127
  },
128
128
  {
129
129
  name: 'snow_memory_search',
130
- description: 'Search indexed ServiceNow artifacts in memory',
130
+ description: 'Searches cached ServiceNow artifacts in local memory for instant results without API calls.',
131
131
  inputSchema: {
132
132
  type: 'object',
133
133
  properties: {
@@ -139,7 +139,7 @@ class ServiceNowDevelopmentAssistantMCP {
139
139
  },
140
140
  {
141
141
  name: 'snow_comprehensive_search',
142
- description: 'COMPREHENSIVE multi-table search - searches across all relevant ServiceNow tables for artifacts. Perfect for finding hard-to-locate items.',
142
+ description: 'Searches across multiple ServiceNow tables simultaneously to find artifacts. Includes inactive records and cross-table relationships.',
143
143
  inputSchema: {
144
144
  type: 'object',
145
145
  properties: {
@@ -151,7 +151,7 @@ class ServiceNowDevelopmentAssistantMCP {
151
151
  },
152
152
  {
153
153
  name: 'snow_sync_data_consistency',
154
- description: 'AUTONOMOUS data synchronization - fixes data consistency issues by refreshing cache, re-indexing artifacts, and validating sys_id mappings. AUTO-HEALING.',
154
+ description: 'Synchronizes cached data with ServiceNow, validates sys_id mappings, and repairs consistency issues. Includes automatic cache refresh and reindexing.',
155
155
  inputSchema: {
156
156
  type: 'object',
157
157
  properties: {
@@ -164,7 +164,7 @@ class ServiceNowDevelopmentAssistantMCP {
164
164
  },
165
165
  {
166
166
  name: 'snow_validate_live_connection',
167
- description: 'REAL-TIME connection validation - validates live ServiceNow connection, authentication, and permissions. Returns actual instance status and capabilities.',
167
+ description: 'Validates ServiceNow connection status, authentication tokens, and user permissions. Returns detailed diagnostics with response times.',
168
168
  inputSchema: {
169
169
  type: 'object',
170
170
  properties: {
@@ -175,7 +175,7 @@ class ServiceNowDevelopmentAssistantMCP {
175
175
  },
176
176
  {
177
177
  name: 'batch_deployment_validator',
178
- description: 'COMPREHENSIVE batch validation - validates multiple deployments simultaneously, checks dependencies, conflicts, and provides rollback recommendations.',
178
+ description: 'Validates multiple artifacts before deployment. Checks dependencies, identifies conflicts, and provides remediation recommendations.',
179
179
  inputSchema: {
180
180
  type: 'object',
181
181
  properties: {
@@ -186,23 +186,9 @@ class ServiceNowDevelopmentAssistantMCP {
186
186
  required: ['artifacts'],
187
187
  },
188
188
  },
189
- {
190
- name: 'deployment_rollback_manager',
191
- description: 'AUTOMATIC rollback management - monitors deployments, detects failures, and provides automatic rollback capabilities with detailed recovery steps.',
192
- inputSchema: {
193
- type: 'object',
194
- properties: {
195
- update_set_id: { type: 'string', description: 'Update Set sys_id to monitor/rollback' },
196
- action: { type: 'string', enum: ['monitor', 'rollback', 'validate_rollback'], description: 'Action to perform' },
197
- rollback_reason: { type: 'string', description: 'Reason for rollback (required for rollback action)' },
198
- create_backup: { type: 'boolean', description: 'Create backup before rollback', default: true },
199
- },
200
- required: ['update_set_id', 'action'],
201
- },
202
- },
203
189
  {
204
190
  name: 'snow_escalate_permissions',
205
- description: 'PERMISSION ESCALATION - Request temporary elevated permissions for complex development workflows. Handles admin role requirements automatically.',
191
+ description: 'Requests temporary elevated permissions for development operations. Manages role requirements and provides audit trail.',
206
192
  inputSchema: {
207
193
  type: 'object',
208
194
  properties: {
@@ -216,7 +202,7 @@ class ServiceNowDevelopmentAssistantMCP {
216
202
  },
217
203
  {
218
204
  name: 'snow_analyze_requirements',
219
- description: 'INTELLIGENT REQUIREMENT ANALYSIS - Auto-discovers dependencies, suggests existing components, creates dependency maps for complex objectives.',
205
+ description: 'Analyzes development requirements to identify dependencies, suggest reusable components, and create implementation roadmaps.',
220
206
  inputSchema: {
221
207
  type: 'object',
222
208
  properties: {
@@ -229,25 +215,9 @@ class ServiceNowDevelopmentAssistantMCP {
229
215
  required: ['objective'],
230
216
  },
231
217
  },
232
- {
233
- name: 'snow_smart_update_set',
234
- description: 'SMART UPDATE SET MANAGEMENT - Automatic artifact tracking, conflict detection, dependency validation, and rollback points.',
235
- inputSchema: {
236
- type: 'object',
237
- properties: {
238
- action: { type: 'string', enum: ['create', 'track', 'validate', 'conflict_check'], description: 'Update Set management action' },
239
- auto_track_related_artifacts: { type: 'boolean', description: 'Automatically track related artifacts', default: true },
240
- conflict_detection: { type: 'boolean', description: 'Enable conflict detection', default: true },
241
- dependency_validation: { type: 'boolean', description: 'Validate dependencies', default: true },
242
- rollback_points: { type: 'boolean', description: 'Create rollback points', default: true },
243
- update_set_name: { type: 'string', description: 'Name for new Update Set (required for create action)' },
244
- },
245
- required: ['action'],
246
- },
247
- },
248
218
  {
249
219
  name: 'snow_orchestrate_development',
250
- description: 'UNIFIED DEVELOPMENT ORCHESTRATION - Single command for complex workflows with auto-spawning agents, shared memory, and progress monitoring.',
220
+ description: 'Orchestrates complex development workflows with intelligent agent coordination, shared memory, and real-time progress tracking.',
251
221
  inputSchema: {
252
222
  type: 'object',
253
223
  properties: {
@@ -264,22 +234,6 @@ class ServiceNowDevelopmentAssistantMCP {
264
234
  required: ['objective'],
265
235
  },
266
236
  },
267
- {
268
- name: 'snow_resilient_deployment',
269
- description: 'RESILIENT DEPLOYMENT - Advanced error recovery with retry mechanisms, fallback strategies, checkpoints, and graceful degradation.',
270
- inputSchema: {
271
- type: 'object',
272
- properties: {
273
- artifacts: { type: 'array', items: { type: 'object' }, description: 'Artifacts to deploy' },
274
- retry_on_failure: { type: 'boolean', description: 'Enable automatic retry on failure', default: true },
275
- fallback_strategies: { type: 'array', items: { type: 'string', enum: ['global_scope', 'manual_approval', 'staged_deployment'] }, description: 'Fallback strategies' },
276
- checkpoint_restoration: { type: 'boolean', description: 'Enable checkpoint restoration', default: true },
277
- graceful_degradation: { type: 'boolean', description: 'Enable graceful degradation', default: true },
278
- max_retries: { type: 'number', description: 'Maximum retry attempts', default: 3 },
279
- },
280
- required: ['artifacts'],
281
- },
282
- },
283
237
  ],
284
238
  }));
285
239
  // Register tool handlers
@@ -312,18 +266,12 @@ class ServiceNowDevelopmentAssistantMCP {
312
266
  return await this.validateLiveConnection(args);
313
267
  case 'batch_deployment_validator':
314
268
  return await this.batchDeploymentValidator(args);
315
- case 'deployment_rollback_manager':
316
- return await this.deploymentRollbackManager(args);
317
269
  case 'snow_escalate_permissions':
318
270
  return await this.escalatePermissions(args);
319
271
  case 'snow_analyze_requirements':
320
272
  return await this.analyzeRequirements(args);
321
- case 'snow_smart_update_set':
322
- return await this.smartUpdateSet(args);
323
273
  case 'snow_orchestrate_development':
324
274
  return await this.orchestrateDevelopment(args);
325
- case 'snow_resilient_deployment':
326
- return await this.resilientDeployment(args);
327
275
  case 'snow_verify_artifact_searchable':
328
276
  return await this.verifyArtifactSearchable(args);
329
277
  case 'snow_generate_documentation':
@@ -33,7 +33,7 @@ class ServiceNowIntegrationMCP {
33
33
  tools: [
34
34
  {
35
35
  name: 'snow_create_rest_message',
36
- description: 'Create REST Message endpoints with dynamic discovery - NO hardcoded values',
36
+ description: 'Creates REST message endpoints for external API integrations. Supports various authentication types and profiles.',
37
37
  inputSchema: {
38
38
  type: 'object',
39
39
  properties: {
@@ -48,7 +48,7 @@ class ServiceNowIntegrationMCP {
48
48
  },
49
49
  {
50
50
  name: 'snow_create_rest_method',
51
- description: 'Create REST Method with dynamic parameter discovery',
51
+ description: 'Creates REST methods for API operations. Configures HTTP methods, endpoints, headers, and request bodies.',
52
52
  inputSchema: {
53
53
  type: 'object',
54
54
  properties: {
@@ -64,7 +64,7 @@ class ServiceNowIntegrationMCP {
64
64
  },
65
65
  {
66
66
  name: 'snow_create_transform_map',
67
- description: 'Create Transform Map with dynamic field discovery',
67
+ description: 'Creates transform maps for data migration between tables. Defines field mappings and transformation rules.',
68
68
  inputSchema: {
69
69
  type: 'object',
70
70
  properties: {
@@ -80,7 +80,7 @@ class ServiceNowIntegrationMCP {
80
80
  },
81
81
  {
82
82
  name: 'snow_create_field_map',
83
- description: 'Create Field Map with dynamic field discovery',
83
+ description: 'Creates field mappings within transform maps. Supports data transformation, coalescing, and default values.',
84
84
  inputSchema: {
85
85
  type: 'object',
86
86
  properties: {
@@ -96,7 +96,7 @@ class ServiceNowIntegrationMCP {
96
96
  },
97
97
  {
98
98
  name: 'snow_create_import_set',
99
- description: 'Create Import Set table with dynamic schema discovery',
99
+ description: 'Creates import set tables for staging external data. Supports CSV, XML, JSON, and Excel formats.',
100
100
  inputSchema: {
101
101
  type: 'object',
102
102
  properties: {
@@ -110,7 +110,7 @@ class ServiceNowIntegrationMCP {
110
110
  },
111
111
  {
112
112
  name: 'snow_create_web_service',
113
- description: 'Create Web Service with dynamic WSDL discovery',
113
+ description: 'Creates SOAP web service integrations from WSDL definitions. Configures authentication and namespace settings.',
114
114
  inputSchema: {
115
115
  type: 'object',
116
116
  properties: {
@@ -125,7 +125,7 @@ class ServiceNowIntegrationMCP {
125
125
  },
126
126
  {
127
127
  name: 'snow_create_email_config',
128
- description: 'Create Email Configuration with dynamic server discovery',
128
+ description: 'Creates email server configurations for SMTP, POP3, or IMAP. Configures ports, encryption, and authentication.',
129
129
  inputSchema: {
130
130
  type: 'object',
131
131
  properties: {
@@ -142,7 +142,7 @@ class ServiceNowIntegrationMCP {
142
142
  },
143
143
  {
144
144
  name: 'snow_discover_integration_endpoints',
145
- description: 'Discover all existing integration endpoints dynamically',
145
+ description: 'Discovers existing integration endpoints in the instance. Filters by type: REST, SOAP, LDAP, or EMAIL.',
146
146
  inputSchema: {
147
147
  type: 'object',
148
148
  properties: {
@@ -152,7 +152,7 @@ class ServiceNowIntegrationMCP {
152
152
  },
153
153
  {
154
154
  name: 'snow_test_integration',
155
- description: 'Test integration endpoint with dynamic validation',
155
+ description: 'Tests integration endpoints with sample data. Validates connectivity, authentication, and data transformation.',
156
156
  inputSchema: {
157
157
  type: 'object',
158
158
  properties: {
@@ -164,7 +164,7 @@ class ServiceNowIntegrationMCP {
164
164
  },
165
165
  {
166
166
  name: 'snow_discover_data_sources',
167
- description: 'Discover available data sources dynamically',
167
+ description: 'Discovers available data sources for integration. Identifies import sets, REST endpoints, and external databases.',
168
168
  inputSchema: {
169
169
  type: 'object',
170
170
  properties: {
@@ -115,7 +115,7 @@ class ServiceNowMachineLearningMCP {
115
115
  // Training tools
116
116
  {
117
117
  name: 'ml_train_incident_classifier',
118
- description: 'Train LSTM neural network on historical incident data with INTELLIGENT data selection. Snow-Flow automatically detects available data and uses the optimal amount (up to 5000) for best accuracy. Works WITHOUT PA/PI plugins - only needs incident table access!',
118
+ description: 'Trains LSTM neural networks on historical incident data with intelligent data selection. Automatically optimizes dataset size up to 5000 records for best accuracy. Works without PA/PI licenses.',
119
119
  inputSchema: {
120
120
  type: 'object',
121
121
  properties: {
@@ -173,7 +173,7 @@ class ServiceNowMachineLearningMCP {
173
173
  },
174
174
  {
175
175
  name: 'ml_train_change_risk',
176
- description: 'Train neural network to predict change implementation risks. Works WITHOUT PA/PI plugins - only needs change_request table access!',
176
+ description: 'Trains neural networks to predict change implementation risks based on historical change data. Works without PA/PI licenses.',
177
177
  inputSchema: {
178
178
  type: 'object',
179
179
  properties: {
@@ -190,7 +190,7 @@ class ServiceNowMachineLearningMCP {
190
190
  },
191
191
  {
192
192
  name: 'ml_train_anomaly_detector',
193
- description: 'Train autoencoder for anomaly detection in metrics. Works WITHOUT PA/PI plugins - uses standard table data!',
193
+ description: 'Trains autoencoder neural networks for anomaly detection in system metrics. Works without PA/PI licenses using standard table data.',
194
194
  inputSchema: {
195
195
  type: 'object',
196
196
  properties: {
@@ -209,7 +209,7 @@ class ServiceNowMachineLearningMCP {
209
209
  // Prediction tools
210
210
  {
211
211
  name: 'ml_classify_incident',
212
- description: 'Use neural network to classify and predict incident properties',
212
+ description: 'Classifies incidents and predicts properties using trained neural networks. Returns category, priority, and assignment recommendations.',
213
213
  inputSchema: {
214
214
  type: 'object',
215
215
  properties: {
@@ -230,7 +230,7 @@ class ServiceNowMachineLearningMCP {
230
230
  },
231
231
  {
232
232
  name: 'ml_predict_change_risk',
233
- description: 'Predict change risk using neural network',
233
+ description: 'Predicts implementation risk for change requests using trained neural networks. Provides risk scores and mitigation suggestions.',
234
234
  inputSchema: {
235
235
  type: 'object',
236
236
  properties: {
@@ -246,7 +246,7 @@ class ServiceNowMachineLearningMCP {
246
246
  },
247
247
  {
248
248
  name: 'ml_forecast_incidents',
249
- description: 'Forecast incident volume using LSTM neural network',
249
+ description: 'Forecasts future incident volumes using LSTM time series models. Supports category-specific predictions.',
250
250
  inputSchema: {
251
251
  type: 'object',
252
252
  properties: {
@@ -263,7 +263,7 @@ class ServiceNowMachineLearningMCP {
263
263
  },
264
264
  {
265
265
  name: 'ml_detect_anomalies',
266
- description: 'Detect anomalies using autoencoder neural network',
266
+ description: 'Detects anomalies in incident patterns, user behavior, or system performance using autoencoder models.',
267
267
  inputSchema: {
268
268
  type: 'object',
269
269
  properties: {
@@ -282,7 +282,7 @@ class ServiceNowMachineLearningMCP {
282
282
  // Model management
283
283
  {
284
284
  name: 'ml_model_status',
285
- description: 'Get status and performance metrics of ML models',
285
+ description: 'Retrieves status and performance metrics for all trained ML models including accuracy, loss, and usage statistics.',
286
286
  inputSchema: {
287
287
  type: 'object',
288
288
  properties: {
@@ -295,7 +295,7 @@ class ServiceNowMachineLearningMCP {
295
295
  },
296
296
  {
297
297
  name: 'ml_evaluate_model',
298
- description: 'Evaluate model performance on test data',
298
+ description: 'Evaluates model performance using test datasets. Returns accuracy, precision, recall, and F1 scores.',
299
299
  inputSchema: {
300
300
  type: 'object',
301
301
  properties: {
@@ -313,7 +313,7 @@ class ServiceNowMachineLearningMCP {
313
313
  // ServiceNow Native ML Integration
314
314
  {
315
315
  name: 'ml_performance_analytics',
316
- description: 'Access ServiceNow PA ML for KPI forecasting. REQUIRES Performance Analytics plugin license!',
316
+ description: 'Accesses ServiceNow Performance Analytics ML for KPI forecasting. Requires Performance Analytics plugin license.',
317
317
  inputSchema: {
318
318
  type: 'object',
319
319
  properties: {
@@ -335,7 +335,7 @@ class ServiceNowMachineLearningMCP {
335
335
  },
336
336
  {
337
337
  name: 'ml_predictive_intelligence',
338
- description: 'Use ServiceNow PI for 95%+ accuracy incident classification. REQUIRES Predictive Intelligence plugin license!',
338
+ description: 'Uses ServiceNow Predictive Intelligence for high-accuracy incident classification. Requires Predictive Intelligence plugin license.',
339
339
  inputSchema: {
340
340
  type: 'object',
341
341
  properties: {
@@ -361,7 +361,7 @@ class ServiceNowMachineLearningMCP {
361
361
  },
362
362
  {
363
363
  name: 'ml_agent_intelligence',
364
- description: 'Use Agent Intelligence for work assignment. REQUIRES Agent Intelligence plugin license!',
364
+ description: 'Uses Agent Intelligence for automated work assignment and routing. Requires Agent Intelligence plugin license.',
365
365
  inputSchema: {
366
366
  type: 'object',
367
367
  properties: {
@@ -386,7 +386,7 @@ class ServiceNowMachineLearningMCP {
386
386
  },
387
387
  {
388
388
  name: 'ml_process_optimization',
389
- description: 'ML-driven process optimization. REQUIRES Performance Analytics plugin license!',
389
+ description: 'Performs ML-driven process optimization and bottleneck analysis. Requires Performance Analytics plugin license.',
390
390
  inputSchema: {
391
391
  type: 'object',
392
392
  properties: {
@@ -408,7 +408,7 @@ class ServiceNowMachineLearningMCP {
408
408
  },
409
409
  {
410
410
  name: 'ml_virtual_agent_nlu',
411
- description: 'Virtual Agent NLU for intent/entity extraction. REQUIRES Virtual Agent plugin license!',
411
+ description: 'Provides Natural Language Understanding for intent and entity extraction. Requires Virtual Agent plugin license.',
412
412
  inputSchema: {
413
413
  type: 'object',
414
414
  properties: {
@@ -430,7 +430,7 @@ class ServiceNowMachineLearningMCP {
430
430
  },
431
431
  {
432
432
  name: 'ml_hybrid_recommendation',
433
- description: 'AUTO-SELECTS: Native ML (if licensed) OR TensorFlow.js. Works with or without plugins!',
433
+ description: 'Hybrid ML approach that automatically selects between native ServiceNow ML (if licensed) or TensorFlow.js for optimal results.',
434
434
  inputSchema: {
435
435
  type: 'object',
436
436
  properties: {
@@ -132,7 +132,7 @@ class ServiceNowOperationsMCP {
132
132
  // 🎯 UNIVERSAL TABLE QUERY - Works for ANY ServiceNow table!
133
133
  {
134
134
  name: 'snow_query_table',
135
- description: '🚀 Universal high-performance query tool for ANY ServiceNow table - optimized for memory efficiency. SMART DEFAULTS: 1000 records (5000 for ML training contexts)',
135
+ description: 'Universal query tool for any ServiceNow table. Optimized for performance with smart defaults: 1000 records normally, 5000 for ML training contexts. Supports count-only mode for memory efficiency.',
136
136
  inputSchema: {
137
137
  type: 'object',
138
138
  properties: {
@@ -147,12 +147,12 @@ class ServiceNowOperationsMCP {
147
147
  },
148
148
  limit: {
149
149
  type: 'number',
150
- description: '🎯 Maximum number of results. SMART DEFAULTS: 1000 (normal queries), 5000 (ML training contexts). Set higher for large ML datasets (10000+)',
150
+ description: 'Maximum number of results. Smart defaults: 1000 (normal queries), 5000 (ML training). Can be set higher for large datasets.',
151
151
  default: 1000
152
152
  },
153
153
  include_content: {
154
154
  type: 'boolean',
155
- description: '🎯 Include full record data (default: false for performance, only returns count)',
155
+ description: 'Include full record data. Default false for performance, returns count only. Set true for detailed results.',
156
156
  default: false
157
157
  },
158
158
  fields: {
@@ -181,7 +181,7 @@ class ServiceNowOperationsMCP {
181
181
  // Core Operational Queries (keeping for backwards compatibility)
182
182
  {
183
183
  name: 'snow_query_incidents',
184
- description: 'Advanced incident querying with filters and _analysis - optimized for performance',
184
+ description: 'Query incidents with advanced filtering and analysis capabilities. Optimized for performance with optional content inclusion.',
185
185
  inputSchema: {
186
186
  type: 'object',
187
187
  properties: {
@@ -196,7 +196,7 @@ class ServiceNowOperationsMCP {
196
196
  },
197
197
  include_content: {
198
198
  type: 'boolean',
199
- description: '🎯 Include full incident data (default: false for performance, only returns count)',
199
+ description: 'Include full incident data. Default false for performance, returns count only.',
200
200
  default: false
201
201
  },
202
202
  include__analysis: {
@@ -215,7 +215,7 @@ class ServiceNowOperationsMCP {
215
215
  },
216
216
  {
217
217
  name: 'snow_analyze_incident',
218
- description: 'Intelligent _analysis of a specific incident with auto-resolution suggestions',
218
+ description: 'Analyzes specific incidents with pattern recognition, similar incident matching, and automated resolution suggestions.',
219
219
  inputSchema: {
220
220
  type: 'object',
221
221
  properties: {
@@ -239,7 +239,7 @@ class ServiceNowOperationsMCP {
239
239
  },
240
240
  {
241
241
  name: 'snow_auto_resolve_incident',
242
- description: 'Attempt automated resolution of technical incidents',
242
+ description: 'Attempts automated resolution of technical incidents based on known patterns and previous solutions. Includes dry-run mode for safety.',
243
243
  inputSchema: {
244
244
  type: 'object',
245
245
  properties: {
@@ -258,7 +258,7 @@ class ServiceNowOperationsMCP {
258
258
  },
259
259
  {
260
260
  name: 'snow_query_requests',
261
- description: 'Query and analyze service requests',
261
+ description: 'Queries service requests with optional inclusion of request items and fulfillment details.',
262
262
  inputSchema: {
263
263
  type: 'object',
264
264
  properties: {
@@ -282,7 +282,7 @@ class ServiceNowOperationsMCP {
282
282
  },
283
283
  {
284
284
  name: 'snow_query_problems',
285
- description: 'Query and analyze problems with root cause _analysis',
285
+ description: 'Queries problem records with root cause analysis and optional inclusion of related incidents.',
286
286
  inputSchema: {
287
287
  type: 'object',
288
288
  properties: {
@@ -306,7 +306,7 @@ class ServiceNowOperationsMCP {
306
306
  },
307
307
  {
308
308
  name: 'snow_cmdb_search',
309
- description: 'Search and analyze Configuration Items (CMDB)',
309
+ description: 'Searches Configuration Management Database (CMDB) for configuration items with relationship mapping.',
310
310
  inputSchema: {
311
311
  type: 'object',
312
312
  properties: {
@@ -335,7 +335,7 @@ class ServiceNowOperationsMCP {
335
335
  },
336
336
  {
337
337
  name: 'snow_user_lookup',
338
- description: 'Lookup and analyze user information',
338
+ description: 'Retrieves user information including roles, groups, and permissions. Supports lookup by ID, email, or name.',
339
339
  inputSchema: {
340
340
  type: 'object',
341
341
  properties: {
@@ -359,7 +359,7 @@ class ServiceNowOperationsMCP {
359
359
  },
360
360
  {
361
361
  name: 'snow_operational_metrics',
362
- description: 'Get operational metrics and analytics',
362
+ description: 'Provides operational metrics and analytics including incident trends, resolution times, and performance indicators.',
363
363
  inputSchema: {
364
364
  type: 'object',
365
365
  properties: {
@@ -379,7 +379,7 @@ class ServiceNowOperationsMCP {
379
379
  },
380
380
  {
381
381
  name: 'snow_pattern__analysis',
382
- description: 'Analyze patterns in incidents, requests, and problems',
382
+ description: 'Analyzes patterns across incidents, requests, and problems to identify trends, common issues, and improvement opportunities.',
383
383
  inputSchema: {
384
384
  type: 'object',
385
385
  properties: {
@@ -400,7 +400,7 @@ class ServiceNowOperationsMCP {
400
400
  },
401
401
  {
402
402
  name: 'snow_knowledge_search',
403
- description: 'Search knowledge base articles with intelligent matching',
403
+ description: 'Searches knowledge base articles using intelligent matching algorithms. Links articles to incidents for resolution guidance.',
404
404
  inputSchema: {
405
405
  type: 'object',
406
406
  properties: {
@@ -423,7 +423,7 @@ class ServiceNowOperationsMCP {
423
423
  },
424
424
  {
425
425
  name: 'snow_predictive__analysis',
426
- description: 'Predictive _analysis for potential issues and trends',
426
+ description: 'Provides predictive analysis for incident volumes, system failures, and resource issues based on historical patterns.',
427
427
  inputSchema: {
428
428
  type: 'object',
429
429
  properties: {
@@ -445,7 +445,7 @@ class ServiceNowOperationsMCP {
445
445
  // Service Catalog Management
446
446
  {
447
447
  name: 'snow_catalog_item_manager',
448
- description: 'Manage service catalog items - create, update, configure variables and workflows',
448
+ description: 'Comprehensive service catalog management including item creation, variable configuration, workflow attachment, and lifecycle management.',
449
449
  inputSchema: {
450
450
  type: 'object',
451
451
  properties: {
@@ -540,7 +540,7 @@ class ServiceNowOperationsMCP {
540
540
  },
541
541
  {
542
542
  name: 'snow_catalog_item_search',
543
- description: 'Search for catalog items with intelligent matching and discovery',
543
+ description: 'Searches service catalog items with fuzzy matching and category filtering. Returns items with full variable and pricing details.',
544
544
  inputSchema: {
545
545
  type: 'object',
546
546
  properties: {
@@ -578,7 +578,7 @@ class ServiceNowOperationsMCP {
578
578
  },
579
579
  {
580
580
  name: 'snow_cleanup_test_artifacts',
581
- description: 'Clean up test artifacts while preserving Update Set audit trail',
581
+ description: 'Removes test artifacts (Test*, Mock*, Demo*) from ServiceNow while preserving Update Set history for audit compliance.',
582
582
  inputSchema: {
583
583
  type: 'object',
584
584
  properties: {
@@ -622,7 +622,7 @@ class ServiceNowOperationsMCP {
622
622
  // User and Group Management Tools
623
623
  {
624
624
  name: 'snow_create_user_group',
625
- description: 'Create a new user group in ServiceNow',
625
+ description: 'Creates user groups in ServiceNow with configurable hierarchy, managers, and types for access control and assignment management.',
626
626
  inputSchema: {
627
627
  type: 'object',
628
628
  properties: {
@@ -662,7 +662,7 @@ class ServiceNowOperationsMCP {
662
662
  },
663
663
  {
664
664
  name: 'snow_create_user',
665
- description: 'Create a new user in ServiceNow',
665
+ description: 'Creates new users in ServiceNow with complete profile information including department, manager, and initial credentials.',
666
666
  inputSchema: {
667
667
  type: 'object',
668
668
  properties: {
@@ -717,7 +717,7 @@ class ServiceNowOperationsMCP {
717
717
  },
718
718
  {
719
719
  name: 'snow_assign_user_to_group',
720
- description: 'Add a user to a group in ServiceNow',
720
+ description: 'Assigns users to groups for role-based access control and workflow assignments. Supports lookup by sys_id or username.',
721
721
  inputSchema: {
722
722
  type: 'object',
723
723
  properties: {
@@ -735,7 +735,7 @@ class ServiceNowOperationsMCP {
735
735
  },
736
736
  {
737
737
  name: 'snow_remove_user_from_group',
738
- description: 'Remove a user from a group in ServiceNow',
738
+ description: 'Removes users from groups to revoke access and update role assignments. Maintains audit trail of membership changes.',
739
739
  inputSchema: {
740
740
  type: 'object',
741
741
  properties: {
@@ -753,7 +753,7 @@ class ServiceNowOperationsMCP {
753
753
  },
754
754
  {
755
755
  name: 'snow_list_group_members',
756
- description: 'List all members of a group',
756
+ description: 'Lists all members of a specified group with filtering for active/inactive users. Returns user details and roles.',
757
757
  inputSchema: {
758
758
  type: 'object',
759
759
  properties: {