Rank answers before tickets
Search caller-visible articles once per attempt, open only the selected result, and offer a consent-based incident after three unresolved attempts.
search_knowledgeget_knowledge_articlecreate_incident_from_knowledge
Open-source reference implementation
A stateless TypeScript MCP server that turns ServiceNow Knowledge, catalog ordering, request approvals, and incident management into secure, interactive experiences inside Copilot.
Capability surface
The model selects narrowly scoped tools. Each user-facing result carries structured data for a corresponding MCP App instead of verbose JSON or a replicated ServiceNow interface.
Search caller-visible articles once per attempt, open only the selected result, and offer a consent-based incident after three unresolved attempts.
search_knowledgeget_knowledge_articlecreate_incident_from_knowledgeSearch visible catalog items, render variable-aware forms, place a single order, or collect multiple items in a cart.
search_catalog_itemsget_catalog_item_formplace_order / submit_cartList caller-owned requests, inspect requested items, edit permitted fields, and remove individual lines.
list_user_ordersget_order_detailupdate_order_itemApprove or reject a pending request from the order-detail widget. The server verifies the approval belongs to the request before mutation.
approve_order_approvalreject_order_approvalCreate caller-attributed incidents, review activity, post customer-visible comments, and manage attachments.
report_incidentget_incident_detailadd_incident_attachmentRanked Knowledge, catalog browse/order, cart, requests, and incident experiences render natively in Copilot.
Configuration probes, readiness checks, repeatable demo fixtures, and a release command establish a clear operator boundary.
validate_servicenow_confignpm run release:autoOptional Copilot path
Use Work IQ Developer Tools to package, validate, provision, and share a Microsoft 365 Copilot plugin without replacing the existing declarative-agent and MCP Apps workflow.
The checked-in wiqd-plugin/ package adds an MCP connector and a ServiceNow self-service skill. It calls the same HTTPS endpoint, so the server continues to enforce Entra validation, OBO caller mapping, ServiceNow ACLs, and write-action confirmation.
sys_user.email and run the configuration probe before write actions.Identity and trust
The default production pattern validates the inbound Copilot token, exchanges it through Entra On-Behalf-Of, and presents a downstream token that ServiceNow maps to sys_user.
preferred_username resolves against sys_user.email, enforcing native ACLs and authorship.Secrets are referenced from Key Vault, deployment storage is private, and the Flex Function reaches Blob packages through VNet integration and a private endpoint.
Build and operate
The repository ships the application, Azure infrastructure, M365 agent package, repeatable tests, and policy-aware release automation as one versioned unit.
# Install and validate locally npm install npm run build npm test # Validate ServiceNow surfaces npm run preflight:readiness # Deploy through the human test boundary npm run release:auto -- \ --environment snowmcpwidg-dev # Prepare a repeatable approval demo npm run demo:seed npm run demo:verify
Repository anatomy
Runtime, ServiceNow integration, widgets, infrastructure, tenant packaging, and tests are separated so changes can stay narrow while contract parity remains enforced.
src/tools/One MCP tool per module and the central manifest drift guard.src/services/ServiceNow REST, token management, catalog, request, cart, and incident behavior.src/ui/widgets/Self-contained widget sources, host bridge, registry, and generated modules.infra/Azure Flex Consumption, identity, storage, networking, Key Vault, and monitoring.m365-agent/Declarative agent manifest, plugin snapshot, tool declarations, and ATK lifecycle.test/Behavior, auth, manifest parity, widget resources, and structured-content contracts.A tool change is complete only when runtime registration, Zod schema, minimal manifest, widget binding, tests, and M365 package snapshots agree.
npm run build npm test # v1.2.0 release validation 44 test files 412 tests passing 27 tools · 9 widgets