GroupDocs.Watermark MCP Server

MCP server that exposes GroupDocs.Watermark as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents.

Installation

Requires .NET 10 SDK.

Run directly with `dnx` (recommended — no install step):

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 @<version>:

dnx [email protected] --yes

Or install as a global dotnet tool:

dotnet tool install -g GroupDocs.Watermark.Mcp
groupdocs-watermark-mcp

Or run via Docker:

docker run --rm -i \
  -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

Available MCP Tools

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?"

Configuration

Usage with Claude Desktop

{
  "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 "[email protected]" 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. Copy it directly into your .vscode/mcp.json.

Alternatively, add manually to .vscode/mcp.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 "[email protected]" to lock to a specific release.

Usage with Docker Compose

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:

• Install from NuGet — dnx, global tool, pinned vs always-latest
• Run via Docker
• Verify on the MCP registry
• Use with Claude Desktop
• Use with VS Code / GitHub Copilot
• Run the integration tests

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

<!-- mcp-name: io.github.groupdocs-watermark/groupdocs-watermark-mcp -->