snooze_occurrence
Snooze a specific occurrence of an issue by specifying issue ID, occurrence ID, and reason (ACCEPT_RISK, FALSE_POSITIVE, or MITIGATING_CONTROLS). Optionally set a duration and details.
Instructions
Snooze a specific occurrence of an issue.
Args:
issue_id: The ID of the issue
occurrence_id: The ID of the occurrence to snooze
reason: Reason for snoozing (required, must be one of ACCEPT_RISK, FALSE_POSITIVE, MITIGATING_CONTROLS)
details: Optional details for the snooze
duration: Optional duration for the snooze (in seconds)
duration_type: Optional duration type (e.g., 'days', 'hours')
The reasons mean:
- ACCEPT_RISK - Risk accepted for the issue and all of its occurrences
- FALSE_POSITIVE - False positive - issue and all occurrences have been verified as not exploitable
- MITIGATING_CONTROLS - Mitigating controls are in place
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_id | Yes | ||
| occurrence_id | Yes | ||
| reason | Yes | ||
| details | No | ||
| duration | No | ||
| duration_type | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- intruder_mcp/server.py:288-307 (handler)MCP tool handler function that snoozes a specific occurrence of an issue. Decorated with @mcp.tool() and named 'snooze_occurrence'. Accepts issue_id, occurrence_id, reason, details, duration, and duration_type. Delegates to api.snooze_occurrence() and returns the result message.
@mcp.tool() async def snooze_occurrence(issue_id: int, occurrence_id: int, reason: str, details: Optional[str] = None, duration: Optional[int] = None, duration_type: Optional[str] = None) -> str: """ Snooze a specific occurrence of an issue. Args: issue_id: The ID of the issue occurrence_id: The ID of the occurrence to snooze reason: Reason for snoozing (required, must be one of ACCEPT_RISK, FALSE_POSITIVE, MITIGATING_CONTROLS) details: Optional details for the snooze duration: Optional duration for the snooze (in seconds) duration_type: Optional duration type (e.g., 'days', 'hours') The reasons mean: - ACCEPT_RISK - Risk accepted for the issue and all of its occurrences - FALSE_POSITIVE - False positive - issue and all occurrences have been verified as not exploitable - MITIGATING_CONTROLS - Mitigating controls are in place """ result = api.snooze_occurrence(issue_id, occurrence_id, reason=reason, details=details, duration=duration, duration_type=duration_type) return result.get("message", str(result)) - intruder_mcp/server.py:288-288 (registration)The tool is registered inline via the @mcp.tool() decorator on line 288 in server.py, where mcp is a FastMCP instance.
@mcp.tool() - intruder_mcp/api_client.py:329-331 (helper)API client method that sends the POST request to snooze an occurrence. Constructs a SnoozeOccurrenceRequest and posts to /issues/{issue_id}/occurrences/{occurrence_id}/snooze/.
def snooze_occurrence(self, issue_id: int, occurrence_id: int, reason: OccurrencesSnoozeReasonEnum, details: Optional[str] = None, duration: Optional[int] = None, duration_type: Optional[str] = None) -> dict: data = SnoozeOccurrenceRequest(details=details, duration=duration, duration_type=duration_type, reason=reason) return self.client.post(f"{self.base_url}/issues/{issue_id}/occurrences/{occurrence_id}/snooze/", json=data.dict(exclude_none=True)).json() - intruder_mcp/enums.py:324-328 (schema)Pydantic BaseModel schema for the snooze occurrence request payload. Contains optional details, duration, duration_type, and required reason field of type OccurrencesSnoozeReasonEnum.
class SnoozeOccurrenceRequest(BaseModel): details: Optional[str] = None duration: Optional[int] = None duration_type: Optional[str] = None # Should match DurationTypeEnum if defined reason: OccurrencesSnoozeReasonEnum - intruder_mcp/enums.py:269-272 (schema)Enum defining valid snooze reasons for occurrences: ACCEPT_RISK, FALSE_POSITIVE, MITIGATING_CONTROLS.
class OccurrencesSnoozeReasonEnum(str, Enum): ACCEPT_RISK = "ACCEPT_RISK" FALSE_POSITIVE = "FALSE_POSITIVE" MITIGATING_CONTROLS = "MITIGATING_CONTROLS"