How aartiq/servicenow-mcp works
NowAIKit connects AI clients to ServiceNow through an MCP server, with REST and agent-to-agent access as additional entry points. The principal flow is a client request routed to a domain tool, which uses the ServiceNow client to perform work against an instance and returns a result. The README also highlights prompts, reports, resources, setup, multi-instance support, and a desktop dashboard. The graph uses documented or excerpted relationships; unsampled feature modules are represented at supported paths without inferred call chains.
Main entry points: server.ts MCP server · tools/index.ts Tool router · client.ts ServiceNow client · api/index.ts REST API
Components 26
Client access
- MCP transports
src/transport/index.ts - HTTP server
src/transport/http-server.ts - REST API
src/api/index.ts - A2A tasks
src/a2a/task-manager.ts - CLI
src/cli/index.ts - Web dashboard
src/dashboard/index.ts
Server runtime
- MCP server
src/server.ts - ServiceNow client
src/servicenow/client.ts
ServiceNow capabilities
- Tool router
src/tools/index.ts - Core tools
src/tools/core.ts - ITSM and ITOM tools
src/tools/incident.ts - Automation tools
src/tools/flow.ts - Scripting tools
src/tools/script.ts - Reporting tools
src/tools/reporting.ts
Configuration and outputs
- Instance manager
src/servicenow/instances.ts - Prompt catalog
src/prompts/index.ts - MCP resources
src/resources/index.ts - Report generation
src/reports/index.ts - CLI configuration
src/cli/config-store.ts - Setup wizard
src/cli/setup.ts
Desktop dashboard
- Desktop main
desktop/main/index.ts - Server manager
desktop/main/server-manager.ts - Desktop UI
desktop/renderer/src/App.tsx
Other components
- AI client
- ServiceNow instance
- LLM provider
Connections 36
- AI client → MCP server: sends MCP requests
README.md - MCP server → MCP transports: connects transport
src/server.ts - MCP transports → HTTP server: starts HTTP
src/transport/index.ts - MCP server → Tool router: lists and executes
src/server.ts - MCP server → Prompt catalog: resolves prompts
src/server.ts - MCP server → MCP resources: reads resources
src/server.ts - MCP server → REST API: mounts routes
src/server.ts - MCP server → A2A tasks: mounts A2A
src/server.ts - REST API → Tool router: executes tools
src/api/index.ts - REST API → MCP resources: reads resources
src/api/index.ts - A2A tasks → Tool router: executes tool
src/a2a/task-manager.ts - Tool router → Core tools: dispatches calls
src/tools/index.ts - Tool router → ITSM and ITOM tools: dispatches calls
src/tools/index.ts - Tool router → Automation tools: dispatches calls
src/tools/index.ts - Tool router → Scripting tools: dispatches calls
src/tools/index.ts - Tool router → Reporting tools: dispatches calls
src/tools/index.ts - MCP server → Instance manager: gets client
src/server.ts - REST API → Instance manager: gets client
src/api/index.ts - A2A tasks → Instance manager: gets client
src/a2a/task-manager.ts - Instance manager → ServiceNow client: creates clients
src/servicenow/instances.ts - Core tools → ServiceNow client: uses client
- ITSM and ITOM tools → ServiceNow client: uses client
- Automation tools → ServiceNow client: uses client
- Scripting tools → ServiceNow client: uses client
- Reporting tools → ServiceNow client: uses client
- ServiceNow client → ServiceNow instance: queries and updates
README.md - CLI → Setup wizard: runs setup
src/cli/index.ts - Setup wizard → CLI configuration: writes settings
- Prompt catalog → CLI configuration: loads settings
src/prompts/index.ts - Reporting tools → Report generation: generates reports
- CLI → Report generation: uses report tools
src/cli/index.ts - Web dashboard → HTTP server: uses HTTP server
src/dashboard/index.ts - Desktop UI → Desktop main: uses desktop API
desktop/renderer/src/App.tsx - Desktop main → Server manager: delegates server control
desktop/main/index.ts - Server manager → MCP server: manages server process
desktop/main/server-manager.ts - LLM provider → CLI: answers direct-mode requests