intruder-mcp

Instructions

    Snooze an issue and all its current and future occurrences.

    Args:
        issue_id: The ID of the issue to snooze
        reason: Reason for snoozing (required, must 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
    

Implementation Reference

• intruder_mcp/server.py:262-281 (handler)

  MCP tool handler and registration for 'snooze_issue'. Decorated with @mcp.tool() and implements the core logic by calling the API client's snooze_issue method.

  @mcp.tool()
  async def snooze_issue(issue_id: int, reason: str, details: Optional[str] = None, duration: Optional[int] = None, duration_type: Optional[str] = None) -> str:
      """
      Snooze an issue and all its current and future occurrences.
  
      Args:
          issue_id: The ID of the issue to snooze
          reason: Reason for snoozing (required, must 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_issue(issue_id, reason=reason, details=details, duration=duration, duration_type=duration_type)
      return result.get("message", str(result))

• intruder_mcp/enums.py:268-272 (schema)

  Pydantic schema model SnoozeIssueRequest used for input validation in the API client for snoozing issues.

  class SnoozeIssueRequest(BaseModel):
      details: Optional[str] = None
      duration: Optional[int] = None
      duration_type: Optional[str] = None  # Should match DurationTypeEnum if defined
      reason: IssueSnoozeReasonEnum

• intruder_mcp/api_client.py:291-293 (helper)

  Helper method in IntruderAPI class that performs the actual HTTP POST request to snooze an issue using the SnoozeIssueRequest schema.

  def snooze_issue(self, issue_id: int, reason: IssueSnoozeReasonEnum, details: Optional[str] = None, duration: Optional[int] = None, duration_type: Optional[str] = None) -> dict:
      data = SnoozeIssueRequest(details=details, duration=duration, duration_type=duration_type, reason=reason)
      return self.client.post(f"{self.base_url}/issues/{issue_id}/snooze/", json=data.dict(exclude_none=True)).json()

• intruder_mcp/enums.py:258-261 (schema)

  Enum defining valid reasons for snoozing an issue, used in SnoozeIssueRequest.

  class IssueSnoozeReasonEnum(str, Enum):
      ACCEPT_RISK = "ACCEPT_RISK"
      FALSE_POSITIVE = "FALSE_POSITIVE"
      MITIGATING_CONTROLS = "MITIGATING_CONTROLS"