ServiceNow MCP Server

Instructions

Implementation Reference

• src/servicenow_mcp/tools/incident_tools.py:164-275 (handler)

  Main handler function for the 'update_incident' tool. Determines if incident_id is sys_id or number, queries for sys_id if needed, builds update payload from params, performs PUT request to ServiceNow incident table, returns IncidentResponse.

  def update_incident(
      config: ServerConfig,
      auth_manager: AuthManager,
      params: UpdateIncidentParams,
  ) -> IncidentResponse:
      """
      Update an existing incident in ServiceNow.
  
      Args:
          config: Server configuration.
          auth_manager: Authentication manager.
          params: Parameters for updating the incident.
  
      Returns:
          Response with the updated incident details.
      """
      # Determine if incident_id is a number or sys_id
      incident_id = params.incident_id
      if len(incident_id) == 32 and all(c in "0123456789abcdef" for c in incident_id):
          # This is likely a sys_id
          api_url = f"{config.api_url}/table/incident/{incident_id}"
      else:
          # This is likely an incident number
          # First, we need to get the sys_id
          try:
              query_url = f"{config.api_url}/table/incident"
              query_params = {
                  "sysparm_query": f"number={incident_id}",
                  "sysparm_limit": 1,
              }
  
              response = requests.get(
                  query_url,
                  params=query_params,
                  headers=auth_manager.get_headers(),
                  timeout=config.timeout,
              )
              response.raise_for_status()
  
              result = response.json().get("result", [])
              if not result:
                  return IncidentResponse(
                      success=False,
                      message=f"Incident not found: {incident_id}",
                  )
  
              incident_id = result[0].get("sys_id")
              api_url = f"{config.api_url}/table/incident/{incident_id}"
  
          except requests.RequestException as e:
              logger.error(f"Failed to find incident: {e}")
              return IncidentResponse(
                  success=False,
                  message=f"Failed to find incident: {str(e)}",
              )
  
      # Build request data
      data = {}
  
      if params.short_description:
          data["short_description"] = params.short_description
      if params.description:
          data["description"] = params.description
      if params.state:
          data["state"] = params.state
      if params.category:
          data["category"] = params.category
      if params.subcategory:
          data["subcategory"] = params.subcategory
      if params.priority:
          data["priority"] = params.priority
      if params.impact:
          data["impact"] = params.impact
      if params.urgency:
          data["urgency"] = params.urgency
      if params.assigned_to:
          data["assigned_to"] = params.assigned_to
      if params.assignment_group:
          data["assignment_group"] = params.assignment_group
      if params.work_notes:
          data["work_notes"] = params.work_notes
      if params.close_notes:
          data["close_notes"] = params.close_notes
      if params.close_code:
          data["close_code"] = params.close_code
  
      # Make request
      try:
          response = requests.put(
              api_url,
              json=data,
              headers=auth_manager.get_headers(),
              timeout=config.timeout,
          )
          response.raise_for_status()
  
          result = response.json().get("result", {})
  
          return IncidentResponse(
              success=True,
              message="Incident updated successfully",
              incident_id=result.get("sys_id"),
              incident_number=result.get("number"),
          )
  
      except requests.RequestException as e:
          logger.error(f"Failed to update incident: {e}")
          return IncidentResponse(
              success=False,
              message=f"Failed to update incident: {str(e)}",
          )

• src/servicenow_mcp/tools/incident_tools.py:34-51 (schema)

  Pydantic model defining input parameters for the update_incident tool, including required incident_id and optional fields for updating incident properties.

  class UpdateIncidentParams(BaseModel):
      """Parameters for updating an incident."""
  
      incident_id: str = Field(..., description="Incident ID or sys_id")
      short_description: Optional[str] = Field(None, description="Short description of the incident")
      description: Optional[str] = Field(None, description="Detailed description of the incident")
      state: Optional[str] = Field(None, description="State of the incident")
      category: Optional[str] = Field(None, description="Category of the incident")
      subcategory: Optional[str] = Field(None, description="Subcategory of the incident")
      priority: Optional[str] = Field(None, description="Priority of the incident")
      impact: Optional[str] = Field(None, description="Impact of the incident")
      urgency: Optional[str] = Field(None, description="Urgency of the incident")
      assigned_to: Optional[str] = Field(None, description="User assigned to the incident")
      assignment_group: Optional[str] = Field(None, description="Group assigned to the incident")
      work_notes: Optional[str] = Field(None, description="Work notes to add to the incident")
      close_notes: Optional[str] = Field(None, description="Close notes to add to the incident")
      close_code: Optional[str] = Field(None, description="Close code for the incident")

• src/servicenow_mcp/utils/tool_utils.py:375-381 (registration)

  Registration of the 'update_incident' tool in the central tool definitions dictionary, mapping name to (handler function alias, params schema, return type, description, serialization method).

  "update_incident": (
      update_incident_tool,
      UpdateIncidentParams,
      str,
      "Update an existing incident in ServiceNow",
      "str",
  ),

• src/servicenow_mcp/utils/tool_utils.py:140-141 (registration)

  Import of the update_incident handler aliased as update_incident_tool for use in tool registration.

      update_incident as update_incident_tool,
  )

• src/servicenow_mcp/tools/__init__.py:42-47 (registration)

  Re-export of update_incident function in tools package __init__ for convenient imports.

  from servicenow_mcp.tools.incident_tools import (
      add_comment,
      create_incident,
      list_incidents,
      resolve_incident,
      update_incident,