How ivanbbaev/servicenow-mcp-ai works
servicenow-mcp-ai is an MCP server through which clients inspect and operate on ServiceNow instances. The principal workflow is a client tool request, package registration and dispatch, domain API work, then REST access to the selected instance; writes default to previews unless explicitly applied. Separate capabilities cover script and artifact intelligence, automation tracing, drift and update-set comparison, operations, and local documentation. Bootstrap and task wiring are evidenced in sampled source; domain coverage is based mainly on the README and file tree, so uncertain internal call links are omitted.
Main entry points: tools Domain tools · http.ts HTTP transport · server.ts MCP server · registry.ts Tool registry
Components 24
MCP interface
- MCP server
src/server.ts - Tool registry
src/mcp/registry.ts - Domain tools
src/tools - Resources and prompts
src/mcp/resources.ts
ServiceNow operations
- Table and metadata
src/api/table.ts - Catalog and change
src/api/catalog.ts - CMDB and imports
src/api/cmdb.ts - Attachments and batch
src/api/attachment.ts - Operations and history
src/api/ops.ts
Instance intelligence
- Script intelligence
src/api/scripts.ts - Flow tracing
src/api/flows.ts - Artifact reads
src/api/artifacts.ts - Usage and references
src/api/whereused.ts - Code checking
src/api/codecheck.ts - Drift and snapshots
src/api/compare.ts - Update sets
src/api/updatesets.ts - Knowledge and diagrams
src/api/document.ts
Runtime services
- Authentication
src/core/auth.ts - Profiles and config
src/core/config.ts - HTTP transport
src/core/http.ts - Write policy
src/core/policy.ts - Write journal
src/core/write-journal.ts
Other components
- MCP client
- ServiceNow instance
Connections 29
- MCP client → MCP server: sends requests
- MCP server → Tool registry: registers tools
- MCP server → Resources and prompts: registers
- Tool registry → Domain tools: dispatches calls
- Domain tools → Table and metadata: invokes operations
- Domain tools → Catalog and change: invokes operations
- Domain tools → CMDB and imports: invokes operations
- Domain tools → Attachments and batch: invokes operations
- Domain tools → Script intelligence: invokes intelligence
- Domain tools → Flow tracing: invokes tracing
- Domain tools → Artifact reads: invokes reads
- Domain tools → Usage and references: invokes search
- Domain tools → Code checking: invokes checks
- Domain tools → Drift and snapshots: invokes comparison
- Domain tools → Update sets: invokes operations
- Domain tools → Knowledge and diagrams: invokes generation
- Domain tools → Operations and history: invokes diagnostics
- Table and metadata → HTTP transport: requests data
- Catalog and change → HTTP transport: requests data
- CMDB and imports → HTTP transport: requests data
- Attachments and batch → HTTP transport: transfers files
- Script intelligence → HTTP transport: reads records
- Flow tracing → HTTP transport: reads records
- Operations and history → HTTP transport: reads records
- HTTP transport → Authentication: obtains credentials
- Authentication → Profiles and config: resolves profile
- HTTP transport → ServiceNow instance: REST requests
- Domain tools → Write policy: checks write mode
- Domain tools → Write journal: records writes