ZeroPath MCP Server

Instructions

Archive a security issue to remove it from active view.

Args:
    issue_id: The ID of the issue to archive

Implementation Reference

• src/zeropath_mcp_server/server.py:225-252 (handler)

  The handler function for the 'archive_issue' tool. It validates the issue_id, makes an authenticated POST request to the ZeroPath API endpoint 'issues/archive', and returns success or error messages based on the response.

  @mcp.tool()
  def archive_issue(issue_id: str) -> str:
      """
      Archive a security issue to remove it from active view.
  
      Args:
          issue_id: The ID of the issue to archive
      """
      if not issue_id:
          return "Error: Issue ID is required"
  
      response, error = make_api_request(
          "issues/archive",
          {"issueId": issue_id}
      )
  
      if error:
          return error
  
      if response.status_code == 200:
          return f"Issue {issue_id} archived successfully"
      elif response.status_code == 401:
          return "Error: Unauthorized - check API credentials"
      elif response.status_code == 400:
          return f"Error: Bad request - {response.text}"
      else:
          return f"Error: API returned status {response.status_code}: {response.text}"

• src/zeropath_mcp_server/server.py:225-225 (registration)

  The @mcp.tool() decorator registers the archive_issue function as an MCP tool.

  @mcp.tool()

• src/zeropath_mcp_server/server.py:21-47 (helper)

  Helper function used by archive_issue to perform authenticated API requests to the ZeroPath service.

  def make_api_request(endpoint, payload=None, include_org=True):
      """Make authenticated API request to ZeroPath."""
      if not token_id or not token_secret:
          return None, "Error: Zeropath API credentials not found in environment variables"
  
      headers = {
          "X-ZeroPath-API-Token-Id": token_id,
          "X-ZeroPath-API-Token-Secret": token_secret,
          "Content-Type": "application/json"
      }
  
      if payload is None:
          payload = {}
  
      if include_org and org_id:
          payload["organizationId"] = org_id
  
      try:
          response = requests.post(
              f"{API_BASE_URL}/{endpoint}",
              headers=headers,
              json=payload
          )
          return response, None
      except Exception as e:
          return None, f"Error: {str(e)}"