Etchv
Local MCP server for invisible watermarking and detection of images, PDFs and video
- 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-serverAdd 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.RequiredETCHV_FILES_ROOTAbsolute path of an existing directory for input and output files.RequiredETCHV_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security