ServiceNow MCP Server

Instructions

Implementation Reference

• src/servicenow_mcp/tools/incident_tools.py:89-156 (handler)

  The handler function that executes the create_incident tool logic, constructing the incident data and making a POST request to the ServiceNow API.

  def create_incident(
      config: ServerConfig,
      auth_manager: AuthManager,
      params: CreateIncidentParams,
  ) -> IncidentResponse:
      """
      Create a new incident in ServiceNow.
  
      Args:
          config: Server configuration.
          auth_manager: Authentication manager.
          params: Parameters for creating the incident.
  
      Returns:
          Response with the created incident details.
      """
      api_url = f"{config.api_url}/table/incident"
  
      # Build request data
      data = {
          "short_description": params.short_description,
      }
  
      if params.description:
          data["description"] = params.description
      if params.caller_id:
          data["caller_id"] = params.caller_id
      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
  
      # Make request
      try:
          response = requests.post(
              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 created successfully",
              incident_id=result.get("sys_id"),
              incident_number=result.get("number"),
          )
  
      except requests.RequestException as e:
          logger.error(f"Failed to create incident: {e}")
          return IncidentResponse(
              success=False,
              message=f"Failed to create incident: {str(e)}",
          )

• src/servicenow_mcp/tools/incident_tools.py:19-32 (schema)

  Pydantic BaseModel defining the input schema/parameters for the create_incident tool.

  class CreateIncidentParams(BaseModel):
      """Parameters for creating an incident."""
  
      short_description: str = Field(..., description="Short description of the incident")
      description: Optional[str] = Field(None, description="Detailed description of the incident")
      caller_id: Optional[str] = Field(None, description="User who reported 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")

• src/servicenow_mcp/utils/tool_utils.py:318-324 (registration)

  Registration of the create_incident tool in the get_tool_definitions dictionary, specifying the handler function alias, input schema, return type hint, description, and serialization method.

  "create_incident": (
      create_incident_tool,
      CreateIncidentParams,
      str,
      "Create a new incident in ServiceNow",
      "str",
  ),