create_incident
Create a new incident in ServiceNow by specifying key details such as short description, priority, impact, and assignment group for efficient issue tracking and resolution.
Instructions
Create a new incident in ServiceNow
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Implementation Reference
- The core handler function that executes the create_incident tool by posting data to the ServiceNow incident table 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)}", )
- Pydantic model defining the input 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:368-374 (registration)Registration of the create_incident tool in the tool definitions dictionary, mapping name to function, schema, return type, description, and serialization method."create_incident": ( create_incident_tool, CreateIncidentParams, str, "Create a new incident in ServiceNow", "str", ),
- src/servicenow_mcp/utils/tool_utils.py:131-132 (registration)Import and alias of the create_incident function as create_incident_tool for use in tool registration.create_incident as create_incident_tool, )