GroupDocs.Watermark MCP server at a glance

An MCP server that gives AI agents the GroupDocs.Watermark engine as tools they can call

Illustration watermark

Brand and protect in one prompt

The agent chooses text, size, rotation and opacity from a plain request. GroupDocs.Watermark applies text or image watermarks to every page and can find and remove existing ones.

Local by design

Your AI client starts the server as a local process over stdio. It opens no ports, sends no telemetry, and reads and writes only the folder you configure, so contracts, records and internal documents never leave your machine.

Works with every MCP client

Use it from Claude Desktop, Claude Code, VS Code with GitHub Copilot, Visual Studio 2022, Cursor, Windsurf, Cline, JetBrains Rider and Codex CLI. One-click installs and ready-made configurations are available for each client.

Runs where your agent runs

GroupDocs.Watermark MCP server works on Windows, Linux and macOS, natively with .NET 10 or in Docker

VS Code
Docker
NuGet
Windows
Linux
macOS
Azure
Amazon

NuGet package

  • One command with the .NET 10 SDK, no install step
  • Windows, Linux and macOS
NuGet download

Docker image

  • Nothing to install besides Docker
  • linux/amd64 and linux/arm64, native dependencies bundled
Get the image

VS Code and GitHub Copilot

  • One-click install with a pre-filled configuration
  • Set your documents folder after install
Install in VS Code

Cursor

  • One-click install with a pre-filled configuration
  • Runs in evaluation mode until you add a license
Add to Cursor

Supported file formats

GroupDocs.Watermark MCP server works with the following file formats.

Microsoft Office & OpenDocument formats

  • Portable: PDF
  • Word: DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF
  • Excel: XLSX, XLS, XLT, XLTM, XLSB, XLSM
  • PowerPoint: PPTX, PPT, PPTM, POTX, POTM, PPSM, PPSX
  • OpenDocument: ODT, ODP, ODS

Images & Graphics

  • Popular image formats: BMP, JPG, JPEG, PNG
  • Multi-page images: GIF, WEBP, TIFF

Other

  • Outlook: EML, EMLX, MSG, OFT
  • Microsoft Visio: VSDX, VSTX, VSSX, VSDM, VSSM, VSTM, VSD, VDX, VSX, VTX, VSS, VST, VDW

What the MCP server can do

Add, find and remove text and image watermarks in 40+ formats

Feature icon

Text watermarks

The add_watermark tool stamps text with the font size and rotation you ask for.

Feature icon

Logo watermarks

The add_image_watermark tool places a logo or stamp image with adjustable opacity.

Feature icon

Find watermarks

The search_watermarks tool lists existing watermarks with their text and position.

Feature icon

Remove watermarks

The remove_watermarks tool deletes all watermarks, or only those matching a text filter.

Feature icon

Whole folders

Watermark every PDF in a folder with one prompt.

Feature icon

Per-recipient marks

Add the client name and date to each copy you send out.

Feature icon

40+ formats

Works with 40+ document and image formats, including PDF, DOCX, XLSX, PPTX, PNG and JPG.

Feature icon

Document info

The get_document_info tool returns type, page count and format properties.

Feature icon

Flexible licensing

Start in evaluation mode, then use a license file or metered keys. The get_license_status tool shows which one is active.

What you can ask your agent

Typical GroupDocs.Watermark MCP scenarios, each with the prompt that drives it

Watermark a whole folder

Stamp every document in a folder in one go. The agent lists the files it produced so nothing is missed. Step by step: guide and blog walkthrough.

Prompt

Add a diagonal CONFIDENTIAL watermark to every PDF in my documents folder,
then list the files you produced

Brand documents with a logo

Place the company logo on every page at the opacity you want, then adjust it in the same conversation. Step by step: guide and blog walkthrough.

Prompt

Put logo.png on every page of report.pdf at 30% opacity

Find and remove watermarks

Old DRAFT marks survive into final versions. The agent finds them, tells you what they say and removes only the ones you name. Step by step: guide and blog walkthrough.

Prompt

Does contract.pdf have a watermark, and what does it say?
Remove the DRAFT watermark but leave the company logo.

Run on-premise with Docker

For regulated environments, run the server inside your perimeter. Mount the documents folder and the license, and pin the image version for change control. Architecture and security model: on-premise deployment.

docker-compose.yml

services:
  groupdocs-watermark:
    image: ghcr.io/groupdocs-watermark/watermark-net-mcp:26.9.0
    volumes:
      - "/srv/documents:/data"
      - "/srv/licenses:/license:ro"
    environment:
      GROUPDOCS_MCP_STORAGE_PATH: /data
      GROUPDOCS_LICENSE_PATH: /license/GroupDocs.Total.lic
    stdin_open: true

Install in your AI client

Copy the configuration for your client, or use the one-click links at the top of the page

Register the server

Every client starts the server the same way. Set GROUPDOCS_MCP_STORAGE_PATH to the folder with your documents, then restart the client. Leave GROUPDOCS_LICENSE_PATH empty for evaluation mode. Configurations for Visual Studio 2022, Windsurf, Cline, JetBrains Rider and Codex CLI are in the installation guide.
{
  "mcpServers": {
    "groupdocs-watermark": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Watermark.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}
claude mcp add groupdocs-watermark \
  -e GROUPDOCS_MCP_STORAGE_PATH=/path/to/documents \
  -- dnx GroupDocs.Watermark.Mcp --yes
{
  "servers": {
    "groupdocs-watermark": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Watermark.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}
{
  "mcpServers": {
    "groupdocs-watermark": {
      "command": "dnx",
      "args": ["GroupDocs.Watermark.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}
docker run --rm -i \
  -v /path/to/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

Ready to get started?

Download GroupDocs.Watermark for free or get a trial license for full access!

Useful resources

Explore documentation, code samples, and community support to enhance your experience.

Temporary license tips

1
Sign up with your work email.
Free mail services are not allowed.
2
Use Get a temporary license button on the second step.
✕