# groupdocs-watermark-mcp [Health: Active] **Category:** 💻 Developer Tools **Repository:** https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp **GitHub Stars:** 0 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/groupdocs-watermark-mcp ## Description MCP server for GroupDocs.Watermark — add and search document watermarks via AI agents. ## Claude Desktop Quick Installation Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client: ```json "mcpServers": { "groupdocs-watermark-mcp": { "url": "https://products.groupdocs.com/watermark" } } ``` ## Documentation & README # GroupDocs.Watermark MCP Server MCP server that exposes [GroupDocs.Watermark](https://products.groupdocs.com/watermark) as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents. [![NuGet](https://img.shields.io/nuget/v/GroupDocs.Watermark.Mcp?label=NuGet)](https://www.nuget.org/packages/GroupDocs.Watermark.Mcp) [![NuGet downloads](https://img.shields.io/nuget/dt/GroupDocs.Watermark.Mcp?label=downloads)](https://www.nuget.org/packages/GroupDocs.Watermark.Mcp) [![Docker pulls](https://img.shields.io/docker/pulls/groupdocs/watermark-net-mcp?label=docker%20pulls)](https://hub.docker.com/r/groupdocs/watermark-net-mcp) [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6f42c1)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.groupdocs-watermark/groupdocs-watermark-mcp) [![Integration tests](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/actions/workflows/integration.yml/badge.svg)](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/actions/workflows/integration.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) ## Installation [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF)](https://vscode.dev/redirect/mcp/install?name=groupdocs-watermark&config=%7B%22command%22%3A%22dnx%22%2C%22args%22%3A%5B%22GroupDocs.Watermark.Mcp%22%2C%22--yes%22%5D%2C%22env%22%3A%7B%22GROUPDOCS_MCP_STORAGE_PATH%22%3A%22%2Fpath%2Fto%2Fdocuments%22%2C%22GROUPDOCS_MCP_OUTPUT_PATH%22%3A%22%2Fpath%2Fto%2Fdocuments%22%2C%22GROUPDOCS_LICENSE_PATH%22%3A%22%22%7D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5)](https://insiders.vscode.dev/redirect/mcp/install?name=groupdocs-watermark&config=%7B%22command%22%3A%22dnx%22%2C%22args%22%3A%5B%22GroupDocs.Watermark.Mcp%22%2C%22--yes%22%5D%2C%22env%22%3A%7B%22GROUPDOCS_MCP_STORAGE_PATH%22%3A%22%2Fpath%2Fto%2Fdocuments%22%2C%22GROUPDOCS_MCP_OUTPUT_PATH%22%3A%22%2Fpath%2Fto%2Fdocuments%22%2C%22GROUPDOCS_LICENSE_PATH%22%3A%22%22%7D%7D&quality=insiders) [![Add to Cursor](https://img.shields.io/badge/Cursor-Add_MCP-111111)](https://cursor.com/en/install-mcp?name=groupdocs-watermark&config=eyJjb21tYW5kIjoiZG54IiwiYXJncyI6WyJHcm91cERvY3MuV2F0ZXJtYXJrLk1jcCIsIi0teWVzIl0sImVudiI6eyJHUk9VUERPQ1NfTUNQX1NUT1JBR0VfUEFUSCI6Ii9wYXRoL3RvL2RvY3VtZW50cyIsIkdST1VQRE9DU19NQ1BfT1VUUFVUX1BBVEgiOiIvcGF0aC90by9kb2N1bWVudHMiLCJHUk9VUERPQ1NfTElDRU5TRV9QQVRIIjoiIn19) [![Codex CLI setup](https://img.shields.io/badge/Codex_CLI-Setup-e5541b)](install/generated/codex.md) [![Windsurf setup](https://img.shields.io/badge/Windsurf-Setup-0e8a7d)](install/generated/windsurf.md) > One-click installs pre-fill every supported setting: edit the placeholder documents > folder after install (output defaults to the same folder); an empty > GROUPDOCS_LICENSE_PATH runs in evaluation mode - point it at your license to lift limits. > > **More clients** - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022, > Cursor, Windsurf, Cline, and JetBrains Rider live in [`install/generated/`](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp/blob/HEAD/install/generated/). Requires [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0). **Run directly with `dnx` (recommended — no install step):** ```bash dnx GroupDocs.Watermark.Mcp --yes ``` Pulls the latest stable release on every invocation. To pin to a specific version (recommended for shared configs and CI), append `@`: ```bash dnx GroupDocs.Watermark.Mcp@26.9.0 --yes ``` **Or install as a global dotnet tool:** ```bash dotnet tool install -g GroupDocs.Watermark.Mcp groupdocs-watermark-mcp ``` **Or run via Docker:** ```bash docker run --rm -i \ -v $(pwd)/documents:/data \ ghcr.io/groupdocs-watermark/watermark-net-mcp:latest ``` ## Native prerequisites The underlying GroupDocs engine uses `System.Drawing` (GDI+) for some operations. When you run the server **natively** (via `dnx` or the global dotnet tool) on Linux or macOS, install the native `libgdiplus` library first: | Platform | Setup | |---|---| | Windows | Nothing — GDI+ is built into the OS. | | Linux | `sudo apt-get install -y libgdiplus libfontconfig1 ttf-mscorefonts-installer` | | macOS | `brew install mono-libgdiplus` | | Docker | Nothing — the image already bundles `libgdiplus`. | Skipping this on Linux/macOS surfaces as `DllNotFoundException: libgdiplus` in the tool response. The simplest zero-setup option on Linux/macOS is the **Docker image**. ## Available MCP Tools | Tool | Description | |---|---| | `AddWatermark` | Adds a text watermark (Arial, configurable size + rotation) to a document and saves the watermarked file to storage | | `AddImageWatermark` | Adds an image watermark (logo, signature scan, stamp) to a document and saves the watermarked file. Configurable opacity + rotation | | `SearchWatermarks` | Finds existing watermarks (text + image) in a document and returns their details (type, text, page, position, size, rotation) as JSON | | `RemoveWatermarks` | Removes existing watermarks from a document and saves the cleaned copy. Optional text filter to remove only matching watermarks | | `GetDocumentInfo` | Returns the file type, page count, and per-page dimensions of a document as JSON — without modifying it | All tools support PDF, DOCX, XLSX, PPTX, PNG, JPG, VSDX, and 50+ more document and image formats. ## Example prompts for AI agents Copy any of these into Claude Desktop, Cursor, or GitHub Copilot Chat after the server is connected. The AI agent will pick the right tool and arguments automatically — file names are resolved against `GROUPDOCS_MCP_STORAGE_PATH`. 1. **Add a DRAFT text watermark**: *"Add a watermark with the text 'DRAFT' to report.pdf."* 2. **Stamp a logo image**: *"Use company-logo.png as an image watermark on every page of contract.docx, opacity 30%."* 3. **Inspect existing watermarks**: *"What watermarks does invoice.pdf contain?"* 4. **Strip old watermarks**: *"Remove all watermarks from final-draft.docx so I can ship it."* 5. **Inspect document structure**: *"How many pages does presentation.pptx have, and what are their dimensions?"* ## Licensing **The MCP server itself is MIT; the underlying GroupDocs.Watermark engine requires a license for production use.** Without one the server runs in **evaluation mode**: - The engine adds an extra evaluation watermark to processed output. - A single server process can load at most **10 documents**; further calls fail until the server restarts. There are two ways to license the server. **License file** — point `GROUPDOCS_LICENSE_PATH` at your `GroupDocs.Total.lic`. Works offline. **Metered (pay-per-use)** — set both `GROUPDOCS_METERED_PUBLIC_KEY` and `GROUPDOCS_METERED_PRIVATE_KEY`. You are billed for what you actually process, which suits AI agents well because their usage is bursty and hard to predict up front. If both a metered key pair and a license file are configured, **metered wins** and the file is ignored. > **Metered mode needs outbound connectivity.** Usage is reported to GroupDocs servers, so > air-gapped or firewalled deployments must allow that egress — or use a license file instead. Call the **`get_license_status`** tool at any time to see which mode is active, and — under metered — the consumed quantity and remaining credit. ### Keeping the private key out of your config The metered private key is a secret. MCP client configs are plain files on disk, and a project-scoped `.mcp.json` is committed by convention, so prefer, in order: 1. **Set the variables in your OS environment and leave them out of the config entirely.** An stdio MCP server inherits its client's environment, so this works in every client. On macOS note that an app launched from Finder does not inherit shell exports — use `launchctl setenv`, or launch the client from a terminal. 2. **Reference them indirectly** if your client supports it (Claude Code expands `${VAR}`; VS Code uses `${env:VAR}` and `${input:...}`). 3. **A literal value in a user-scoped config** (for example `~/.claude.json`) is acceptable for a single developer. 4. **Never** commit a literal key in a project-scoped `.mcp.json`. For Docker, forward the values without writing them into any file: ```bash docker run --rm -i \ -e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \ -v /path/to/documents:/data \ ghcr.io/groupdocs-watermark/watermark-net-mcp:latest ``` To lift the limits with a license file: - [Get a free 30-day temporary license](https://purchase.groupdocs.com/temporary-license/) - [Purchase a license](https://purchase.groupdocs.com/pricing/watermark/net) | [Product page](https://products.groupdocs.com/watermark/net/) ## Configuration | Variable | Description | Default | |---|---|---| | `GROUPDOCS_MCP_STORAGE_PATH` | Base folder for input and output files | current directory | | `GROUPDOCS_MCP_OUTPUT_PATH` | *(Optional)* separate folder for output files | `GROUPDOCS_MCP_STORAGE_PATH` | | `GROUPDOCS_LICENSE_PATH` | Path to GroupDocs license file. In evaluation mode, output documents may include an additional evaluation watermark alongside the user-requested one | (evaluation mode) | | `GROUPDOCS_METERED_PUBLIC_KEY` | Metered public key. Requires the private key too; takes precedence over the license file | (unset) | | `GROUPDOCS_METERED_PRIVATE_KEY` | Metered private key. **Secret** - see [Licensing](#licensing) | (unset) | ## Usage with Claude Desktop ```json { "mcpServers": { "groupdocs-watermark": { "type": "stdio", "command": "dnx", "args": ["GroupDocs.Watermark.Mcp", "--yes"], "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" } } } } ``` > To pin to a specific version, replace `"GroupDocs.Watermark.Mcp"` with > `"GroupDocs.Watermark.Mcp@26.9.0"` in `args`. Pinning is recommended for > shared / committed configs to avoid surprise upgrades. ## Usage with VS Code / GitHub Copilot NuGet.org generates a ready-to-use `mcp.json` snippet on the [package page](https://www.nuget.org/packages/GroupDocs.Watermark.Mcp). Copy it directly into your `.vscode/mcp.json`. Alternatively, add manually to `.vscode/mcp.json`: ```json { "inputs": [ { "type": "promptString", "id": "storage_path", "description": "Base folder for input and output files.", "password": false } ], "servers": { "groupdocs-watermark": { "type": "stdio", "command": "dnx", "args": ["GroupDocs.Watermark.Mcp", "--yes"], "env": { "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}" } } } } ``` > Same pinning rule as above — swap `"GroupDocs.Watermark.Mcp"` for > `"GroupDocs.Watermark.Mcp@26.9.0"` to lock to a specific release. ## Usage with Docker Compose ```bash cd docker docker compose up ``` Edit `docker/docker-compose.yml` to point volumes at your local documents folder. ## Documentation & guides Step-by-step deployment guides and a published-package integration test suite live in the companion repo [**GroupDocs.Watermark.Mcp.Tests**](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests): - [Install from NuGet](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/blob/master/how-to/01-install-from-nuget.md) — `dnx`, global tool, pinned vs always-latest - [Run via Docker](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/blob/master/how-to/02-run-via-docker.md) - [Verify on the MCP registry](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/blob/master/how-to/03-verify-mcp-registry.md) - [Use with Claude Desktop](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/blob/master/how-to/04-use-with-claude-desktop.md) - [Use with VS Code / GitHub Copilot](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/blob/master/how-to/05-use-with-vscode-copilot.md) - [Run the integration tests](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp.Tests/blob/master/how-to/06-run-integration-tests.md) That repo also exercises every advertised tool against the **published** NuGet artifact on Linux, macOS, and Windows in CI — so the snippets above are verified end-to-end on every release. ## License MIT — see [LICENSE](https://github.com/groupdocs-watermark/GroupDocs.Watermark.Mcp/blob/HEAD/LICENSE)