add_image_watermark

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Watermark MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-watermark -- dnx GroupDocs.Watermark.Mcp --yes
Folders, licensing and more →

add_image_watermark places an image — a logo, a stamp, a scanned signature — onto the document, with opacity and rotation. The watermark source can be PNG, JPG, and similar. Example prompt: “Put our logo on every page at 30% opacity”.

Tool description (as the AI agent sees it):

Adds an image watermark (e.g. company logo, signature scan, stamp) to a document and saves the watermarked file. Supports PDF, DOCX, XLSX, PPTX, PNG, JPG, and 50+ more document and image formats as the target. The watermark source image can be PNG, JPG, BMP, or TIFF, resolved from the same storage as the target. Call this tool whenever the user asks to add an image / logo / stamp watermark, or to overlay an image on a document. Do NOT pre-check whether files exist — just pass the filenames the user provided. Returns a saved-path message (‘Added image watermark from “” to “”’) and the download URL or storage path. On failure, the response text starts with ‘Image watermarking failed for’ followed by the underlying exception type, message, and inner-exception chain.

Parameters

NameTypeRequiredDescription
fileobjectyesThe document — see FileInput shape
watermarkImageobjectyesImage file to use as the watermark — resolved from the same storage as file. — FileInput shape
opacitynumbernoOpacity 0.0 (fully transparent) to 1.0 (opaque). Default 0.5.
rotationintegernoRotation angle in degrees (default 0)
passwordstringnoPassword for protected target documents

Example call

{
  "name": "add_image_watermark",
  "arguments": {
    "file": {
      "filePath": "report.pdf"
    },
    "watermarkImage": {
      "filePath": "logo.png"
    },
    "opacity": 0.3
  }
}

Result

A saved-path message naming the watermarked file.

opacity is the parameter that decides whether this reads as branding or as vandalism: low values (0.2-0.4) sit behind the content; high values dominate the page. Both the document and the watermark image are resolved from your storage folder by name, like any other FileInput.

On failure the text starts with Image watermark failed for, followed by the exception type and message.

Example prompts

  • “Put our logo on every page of this report at 30% opacity.”
  • “Add the approved stamp image to the signed contract.”
  • “Brand these slides with the company mark.”