Skip to content
MCP server

Etchv

Local MCP server for invisible watermarking and detection of images, PDFs and video

Runs locallyStatus and history
Pricing
Free trial
Platforms
CLI, API, self-hosted
Runs
Locally
Version
1.6.0
Listing updated
2 days ago

About Etchv

Etchv is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ETCHV_API_KEYEtchv API key with the scopes your workflow needs.Required
  • ETCHV_FILES_ROOTAbsolute path of an existing directory for input and output files.Required
  • ETCHV_API_BASE_URLOptional HTTPS API origin. Defaults to https://api.etchv.com.

Tools this server provides (28)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free trial, from $19 a month

7-day trial with 200 credits, no card; Launch $19/mo, Growth $49, Scale $99, Business $499

Prices change. Check etchv.com before you buy.

Etchv 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 to Etchv

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security