# Etchv

> Etchv is an MCP server for design and media. Local MCP server for invisible watermarking and detection of images, PDFs and video. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $19 a month
- **Platforms:** CLI, API, self-hosted
- **Website:** https://etchv.com/docs/mcp
- **Repository:** https://github.com/etchv-labs/mcp-server
- **MCP Registry name:** io.github.etchv-labs/mcp-server
- **Categories:** design and media, security
- **Listing updated:** 2026-11-14

## About

A watermark is embedded invisibly, so no logo or text shows, and detection later returns a watermark ID that is a fingerprint of the data you attached, not the original JSON. The aim is to connect a copy back to the delivery or generation record you keep. Documents stay editable, PDF text stays selectable, and video keeps its codec and supported audio.

Beyond single files, a batch tool watermarks up to 100 files at once, with filename templates for per-file data and an idempotency key so retries resume the same batch. Share links let each recipient open their own watermarked copy and report who opened it. Assets, storage destinations and webhooks can also be managed. Each tool needs specific API key scopes, so a key can be limited.

The server runs locally over stdio with Node.js 24 or later, an API key and a files folder named in ETCHV_FILES_ROOT; there is no hosted MCP URL. Credits are spent per image, PDF page or 24 video frames, and a detection check costs one credit.

## Features

- **Invisible watermarking:** Embed data in images, PDFs, Office files and video without visible marks.
- **Detection:** Check any file and get the watermark ID back.
- **Batch watermarking:** Process up to 100 files with per-file data templates.
- **Per-recipient share links:** Each recipient opens their own watermarked copy with open tracking.
- **Scoped keys:** Tools map to separate API key scopes.
- **Local file root:** Input and output stay inside one configured folder.

## Good for

- Watermark every contract PDF before delivery with the recipient's name
- Check whether a leaked video carries an Etchv mark
- Share a board pack so each reader gets a traceable copy
- Mark AI-generated images with a generation record

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env ETCHV_API_KEY='<ETCHV_API_KEY>' --env ETCHV_FILES_ROOT='<ETCHV_FILES_ROOT>' -- npx -y @etchv-labs/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@etchv-labs/mcp-server"
      ],
      "env": {
        "ETCHV_API_KEY": "<ETCHV_API_KEY>",
        "ETCHV_FILES_ROOT": "<ETCHV_FILES_ROOT>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@etchv-labs/mcp-server"
      ],
      "env": {
        "ETCHV_API_KEY": "<ETCHV_API_KEY>",
        "ETCHV_FILES_ROOT": "<ETCHV_FILES_ROOT>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@etchv-labs/mcp-server"
      ],
      "env": {
        "ETCHV_API_KEY": "<ETCHV_API_KEY>",
        "ETCHV_FILES_ROOT": "<ETCHV_FILES_ROOT>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@etchv-labs/mcp-server"
      ],
      "env": {
        "ETCHV_API_KEY": "<ETCHV_API_KEY>",
        "ETCHV_FILES_ROOT": "<ETCHV_FILES_ROOT>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@etchv-labs/mcp-server"
      ],
      "env": {
        "ETCHV_API_KEY": "<ETCHV_API_KEY>",
        "ETCHV_FILES_ROOT": "<ETCHV_FILES_ROOT>"
      }
    }
  }
}
```

## Tools

- `check_api_key`: Show organization ID, key ID and scopes; uses no credits.
- `watermark_media`: Watermark a file, sync or async.
- `detect_media`: Detect a watermark in a file.
- `create_upload`: Create an upload session with a signed upload URL.
- `get_job`: Read job status.
- `get_job_result`: Collect a finished job result.
- `watermark_batch`: Watermark up to 100 local files in one batch.
- `get_batch`: Follow a batch.
- `download_batch`: Save each batch result or the batch zip.
- `list_assets`: List assets.
- `get_asset`: Inspect an asset.
- `download_asset`: Download or link to an asset.
- `update_asset`: Rename or replace asset metadata.
- `delete_asset`: Delete an asset.
- `create_link`: Share a source asset so each recipient opens their own watermarked copy.
- `list_links`: List links.
- `get_link`: Read a link with each recipient's opens.
- `revoke_link`: Stop new opens and downloads of a link.
- `delete_link`: Delete a link.
- `remove_link_recipient`: Remove one recipient with their opens, downloads and copies.
- `list_storage_destinations`: Inspect customer storage destinations.
- `list_storage_deliveries`: List storage deliveries.
- `get_storage_delivery`: Read one storage delivery.
- `verify_storage_destination`: Test a bucket.
- `store_asset`: Deliver a result to storage.
- `retry_storage_delivery`: Retry a storage delivery.
- `list_webhooks`: Inspect webhook endpoints.
- `list_webhook_deliveries`: Inspect webhook deliveries.

## FAQ

### Is there a hosted MCP URL?

No. The docs say clients that only support remote servers cannot connect.

### What does it cost?

Plans run from Launch at $19 a month (250 credits) up to Business at $499; a seven-day trial gives 200 credits without a card.

### Does detection return my original data?

No, it returns a watermark ID that is a digest of the data.

### What do I need to run it?

Node.js 24 or later, an Etchv API key and an existing media folder.

### Is Etchv free?

Etchv is a paid product with a free trial. Paid plans start at $19 a month.

### How do I add Etchv to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env ETCHV_API_KEY='<ETCHV_API_KEY>' --env ETCHV_FILES_ROOT='<ETCHV_FILES_ROOT>' -- npx -y @etchv-labs/mcp-server

### What are the best alternatives to Etchv?

The closest alternatives to Etchv are REA, HyperFrames by HeyGen, ffmpeg-skill, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/etchv
