SkyeNet-MCP-ACE

ServiceNow Background Script Execution for AI Agents - A Model Context Protocol (MCP) server that enables AI agents to execute server-side JavaScript directly on ServiceNow instances with context bloat reduction features.

🚀 Quick Start

Prerequisites

• Node.js 20+ (system-wide installation recommended)

• ServiceNow instance with API access

• Root/sudo access for system-wide installation

Installation

Configuration

Create your ServiceNow credentials file:

Required environment variables:

Codex Integration

Add to your Codex configuration (/etc/codex/config.toml):

🛠️ Available Tools

1. execute_background_script

Execute server-side JavaScript directly on ServiceNow instances.

Parameters:

• script (string): The JavaScript code to execute

• quiet (boolean, optional): Ultra-minimal response mode

Example:

2. execute_table_operation

Perform CRUD operations on ServiceNow tables with context bloat reduction.

Parameters:

• operation (string): GET, POST, PUT, DELETE

• table (string): Table name (e.g., 'sys_user', 'incident')

• sys_id (string, optional): Record sys_id for specific operations

• sys_ids (array, optional): Multiple sys_ids for batch operations

• fields (array, optional): Specific fields to retrieve

• query (string, optional): Encoded query string

• limit (number, optional): Maximum records to return

• strict_fields (boolean, optional): Enable strict field validation

• response_mode (string, optional): 'minimal' for reduced response size

Examples:

3. execute_updateset_operation

Manage ServiceNow Update Sets with context bloat reduction.

Parameters:

• operation (string): recent, contents, set_working, get_working

• update_set_sys_id (string, optional): Update Set sys_id

• response_mode (string, optional): 'minimal' for reduced response size

• quiet (boolean, optional): Ultra-minimal response mode

Examples:

🔧 Context Bloat Reduction Features

Minimal Mode

• Table API: Truncates large fields, limits records, removes redundant data

• Update Sets: Limits to 5 records, compact summaries, flattened structure

• Background Scripts: Truncates output, removes verbose logging

Quiet Mode

• Ultra-minimal responses: Only success/failure status

• No verbose output: Essential information only

• Reduced token usage: 90%+ reduction in response size

Response Size Examples

• Standard Table API: ~15KB

• Minimal Table API: ~700 bytes

• Quiet Update Set: ~300 bytes

• Minimal Update Set: ~2.6KB

🔄 Maintenance

Update Installation

Clean Reinstall

🚨 Troubleshooting

Server Won't Start

Codex Timeout Issues

Permission Issues

📊 Project Structure

🎯 Key Features

• Context Bloat Reduction: Minimal and quiet modes for AI agents

• Bulletproof Deployment: Handles all edge cases automatically

• Multi-User Compatibility: Works for all users system-wide

• Comprehensive Verification: Tests all scenarios

• ServiceNow Integration: Direct API access with error handling

• Update Set Management: Full lifecycle support

• Table Operations: CRUD with field validation

🔒 Security

• Credential Management: Separate from MCP-Connect

• Field Validation: Prevents injection attacks

• Error Handling: Secure error responses

• System-wide Installation: Proper permissions

📈 Performance

• Response Times: < 3 seconds for most operations

• Memory Usage: Optimized for AI agent interactions

• Token Efficiency: 90%+ reduction in context bloat

• Reliability: Bulletproof deployment ensures stability

For detailed deployment instructions, see the bulletproof deployment script comments.