valepara-mcp

MCP server for document watermarking. Add repeating text watermarks to images and PDFs programmatically via AI agents.

100% local — files never leave your machine.

Install

npx valepara-mcp

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "valepara": {
      "command": "npx",
      "args": ["-y", "valepara-mcp"]
    }
  }
}

Claude Code

claude mcp add valepara-mcp -- npx -y valepara-mcp

Tools

watermark-image

Add a repeating text watermark to an image (JPG, PNG, WebP).

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | imagePath | string | required | Path to source image | | outputPath | string | auto | Output path (defaults to {name}-watermarked.{ext}) | | text | string | "ONLY VALID FOR" | Watermark text | | opacity | number | 0.4 | Opacity (0-1) | | fontSize | number | 28 | Font size in px | | rotation | number | -30 | Angle in degrees | | color | string | "#ff0000" | Hex color | | spacing | number | 100 | Gap between repetitions in px | | wavy | boolean | false | Wavy text effect | | wavyAmplitude | number | 8 | Wave height in px | | wavyFrequency | number | 0.05 | Wave frequency |

Returns: watermarked file path + preview image.

watermark-pdf

Add a repeating text watermark to all pages of a PDF. Same parameters as watermark-image but with pdfPath instead of imagePath.

Returns: watermarked PDF file path.

detect-document

Detect document boundaries in a photo using edge detection.

| Parameter | Type | Description | |-----------|------|-------------| | imagePath | string | Path to photo containing a document |

Returns: 4 corner points (TL, TR, BR, BL) or null if no document found.

Examples

Watermark an ID photo:

Use watermark-image on /path/to/id.jpg with text "COPY - NOT VALID" and opacity 0.5

Watermark a contract PDF:

Use watermark-pdf on /path/to/contract.pdf with text "DRAFT" color "#888888" fontSize 48

Detect then watermark:

First detect-document on /path/to/photo.jpg, then watermark-image with the detected bounds

Privacy

This server runs entirely on your local machine. No files are uploaded, no data is sent to any external service. The watermarking happens in-process using Sharp (images) and pdf-lib (PDFs).

License

MIT