| \n\nTool name\n\n | \n\nDescription\n\n |
|---|---|
| \n\n**sn\\_itsm\\_mcp\\_server.incident.get\\_details**\n\n | \n\nReturns incident fields for a given incident number. The response is role-aware: fulfillers \\(itil or sn\\_incident\\_read\\) receive the full record, including assignment, CI, and work notes. Requesters receive a reduced, customer-safe field set and comments-only activity for incidents they own, and a 404 response for incidents they don't own.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.incident.modify**\n\n | \n\nUpdates fields on an incident, including work notes, comments, assignee, and assignment group. Updates run through platform-native APIs with full business rule execution.\n\nThe tool is role-aware. Fulfillers \\(itil or sn\\_incident\\_write\\) can set any modifiable field with no ownership restriction. Requesters can perform only the following actions, and only on an incident they own: add a customer-visible comment, escalate the incident using the **escalate** and **escalation\\_reason** inputs \\(submitted as a standalone operation\\), or mark an active incident Resolved. A requester attempting any other field update receives a 403; a non-owned incident returns 404.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.incident.search\\_similar**\n\n | \n\nSearches for incidents similar to a given incident or natural language description using semantic search and returns ranked results.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.lookup\\_assignment\\_groups**\n\n | \n\nLooks up available assignment groups and individual assignees.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.lookup\\_users**\n\n | \n\nLooks up users in the system by name, role, or group membership.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server .incident.search\\_similar\\_kb**\n\n | \n\nSearches similar Knowledge Base \\(KB\\) articles based on the input query or details, to find existing content that has already documented the issue or its resolution.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server .incident.get\\_kb\\_details**\n\n | \n\nRetrieves details for a single published KB article using number or sys\\_id, that includes title, knowledge base, state, publish date, and full body text.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.incident.attach\\_kb**\n\n | \n\nLinks a knowledge base article to an incident as a related reference.\n\n |
| \n\nTool name\n\n | \n\nOperations\n\n | \n\nRole\n\n |
|---|---|---|
| \n\n**sn\\_itsm\\_mcp\\_server.change.lifecycle**\n\n | \n\n- create—Creates a change request from a model, template, or type\n- update—Updates fields, transitions state, or adds journal entries\n- calculate\\_risk—Runs the risk calculator and handles the assessment questionnaire flow\n- upsert\\_task—Creates or updates a change task\n- planned\\_outage—Creates a planned outage record for the change\n\n | \n\nitil\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.change.analyze**\n\n | \n\n- suggest\\_assignment\\_groups—Recommends assignment groups based on similar changes, team history, or keyword search\n- get\\_risk\\_and\\_impact\\_data—Retrieves the risk score and blast radius for a change\n- suggest\\_cis—Recommends configuration items to attach to the change, ranked by confidence score\n- suggest\\_models\\_and\\_templates—Retrieves available change models, standard templates, and custom templates\n\n | \n\nitil\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.change.query**\n\n | \n\n- read—Retrieves one or more change requests by number, including summaries\n- search—Retrieves paginated results using field-based queries, filters, or text search\n- similar\\_change\\_and\\_issues—Returns similar past changes with linked incidents and outages; requires incident-read access\n- aggregate\\_by—Returns grouped counts and statistics as cross-tab or independent breakdowns\n- get\\_state\\_info—Returns the current state, valid next transitions, and mandatory fields\n- check\\_schedules\\_and\\_conflicts—Checks for schedule and CI conflicts, with a freshness indicator\n- data\\_quality—Scores a change's data quality and provides improvement guidance\n\n | \n\nsn\\_change\\_read\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.change.relation**\n\n | \n\n- list\\_tasks—Lists change tasks associated with a change\n- list\\_affected\\_cis—Lists affected configuration items and impacted services\n- list\\_approvals—Returns pending approvals for the caller or all approvers on a change\n- list\\_incidents—Lists incidents fixed by or caused by the change, including incidents on affected configuration items\n- list\\_problems—Lists problems that the change resolves\n- list\\_outages—Lists outages linked to the change or to affected configuration items\n- list\\_change\\_policies—Lists change policies applied to the change, grouped by policy with first and last applied dates\n\n | \n\nsn\\_change\\_read\n\n |
| \n\nTool name\n\n | \n\nDescription\n\n |
|---|---|
| \n\n**sn\\_itsm\\_mcp\\_server.requester.create\\_incident**\n\n | \n\nGuides a requester through a multi-step workflow to create a new incident or request a catalog item. The workflow includes knowledge base deflection \\(searches for self-service articles\\), catalog item redirection \\(searches for matching service catalog items\\), duplicate detection \\(identifies similar open incidents by the requester\\), and incident creation with field review. Returns an incident number with portal link or a request item number depending on the path taken.**Note:** This tool uses the [Create incident AI agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/itsm-create-incident-ai-agent.md) as an MCP tool. To configure, see [Configure an AI agent as an MCP tool](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/configure-ai-agent-as-mcp-tool.md).\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.requester.check\\_status**\n\n | \n\nReturns the status and details of an incident or requested item \\(RITM\\) owned by the authenticated user. Accepts a ticket number or a natural language reference such as `my VPN ticket` or `my latest request`. For incidents, returns ticket number, short description, description, priority, urgency, impact, state, created by, and created on. For RITMs, returns the ticket number, approval status, state of the requested item, stage, estimated delivery, and whether the authenticated user is the requested-for user.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.request.modify**\n\n | \n\nAdds a customer-visible comment to a requested item \\(RITM\\) owned by the authenticated user. The comment is attributed to the authenticated requester. Incident numbers are rejected; use **sn\\_itsm\\_mcp\\_server.incident.modify** to comment on an incident. Closed or canceled requested items cannot be commented on.\n\n |
| \n\nTool name\n\n | \n\nDescription\n\n |
|---|---|
| \n\n**sn\\_itsm\\_mcp\\_server.oncall.on\\_call\\_lookup**\n\n | \n\nLooks up on-call coverage. - **who\\_is\\_on\\_call** — Identifies the current on-call engineers by assignment group or shift name, returning on-call member name and contact details.\n- **my\\_next\\_shift** — Returns the authenticated user's next or active on-call shift, including assignment group, shift name, shift times and responder level.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.oncall.timeoff\\_request**\n\n | \n\nRequests time off from an on-call shift and arranges coverage. Runs in two phases: - **analyze** — Performs a read-only check that identifies affected on-call groups, per-group PTO policy, coverage requirements, eligible cover personnel, and conflicting time-off requests for a proposed time window.\n- **create** — Submits the time-off request based on a user-confirmed coverage plan.\n\n **Important:** The request is submitted only after explicit user confirmation.\n\n |
| \n\nTool name\n\n | \n\nDescription\n\n |
|---|---|
| \n\n**sn\\_itsm\\_mcp\\_server.itsm\\_knowledge\\_graph**\n\n | \n\nAnswers structured natural language questions about ITSM data.Using this tool:\n\n- Get details on incidents or change requests that aren't in the **Closed Complete** state.\n- Get information on available request items and catalog items that are in **Active** state.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.get\\_session\\_timezone**\n\n | \n\nReturns the authenticated user's current session time zone and the current date and time in that time zone. Call this tool before interpreting any date and time values or relative date references in user input. No input parameters are required.\n\n |
| \n\n**sn\\_itsm\\_mcp\\_server.task\\_approval\\_decision**\n\n | \n\nApproves or rejects the caller's oldest pending approval for a change request or request item.\n\n |