Guide
Unmark MCP Server
By Unmark editorial · Updated 16 August 2026
Connect Unmark to AI assistants via the Model Context Protocol (MCP). Remove Gemini watermarks, strip backgrounds, and poll Cloud jobs — all using your Unmark credits and Library. This is the chat connector, not the free Instant drop zone and not the repo skill.
Server URL
Use this URL when adding a custom connector in Claude or other hosted MCP clients:
https://mcp.unmark.ink/mcpClaude Connectors
Claude supports hosted MCP with OAuth — no API keys to paste. You sign in with the same Google account you use on unmark.ink.
- Open Claude → Settings → Connectors → Add custom connector.
- Name it Unmark and paste the MCP server URL (see below).
- Sign in with Google when Claude prompts you — this links your Unmark account.
- In chat, ask Claude to remove a watermark or background from a public image URL.
Example prompts
Hosted MCP cannot read files from Claude's upload sandbox. Always use a public image_url or an Unmark share link.
- “Remove the watermark from https://www.unmark.ink/s/abc123 using Unmark”
- “Remove the background from https://example.com/photo.png using Unmark”
- “Clean the Gemini sparkle from this share link: https://www.unmark.ink/s/xyz789”
Tools
remove_watermarkRemove the Gemini sparkle watermark. Pass image_url (public HTTPS) or a unmark.ink share link.
remove_backgroundRemove the image background. Same URL rules as remove_watermark.
get_job_statusCheck progress or fetch results for a Cloud job by job ID.
Image URLs & share links
- Public HTTPS URLs — direct links to PNG/JPEG/WebP files work best.
- Unmark share links —
https://www.unmark.ink/s/<job-id>resolves automatically to your Cloud job image. - Not supported in hosted MCP — local file paths (e.g. Claude upload paths like
/mnt/user-data/uploads/...) are only available in local stdio setups such as Cursor.
MCP vs Instant vs the agent skill
Instant is the no-account stills tool in the browser. Use it when you have one Gemini PNG and you want a download now. The agent skill is for Cursor, Claude Code, and Codex working on files already in a repo. MCP is for chat: you pass a public image URL or an Unmark share link, and Claude (or another client) calls Unmark Cloud.
Hosted MCP will not see a file you attached only inside Claude. Local stdio in Cursor can use env tokens and, in some setups, local paths — that is why the Cursor block below exists. If you only needed a sparkle off a still, skip this page and open Instant.
Cursor (local stdio)
For Cursor or other editors that run MCP as a local process, configure stdio transport and point at the unmark-mcp package in the repo. Local mode can use bearer tokens or session cookies for auth.
- Install Python 3.11+ and clone the unmark-mcp package from the repo (see README).
- Sign in on unmark.ink and copy your session cookie, or set UNMARK_BEARER_TOKEN for local dev.
- Add the server to Cursor MCP settings (stdio transport).
- Restart Cursor and invoke tools from the agent chat.
Example .cursor/mcp.json:
{
"mcpServers": {
"unmark": {
"command": "python",
"args": ["-m", "unmark_mcp.server"],
"env": {
"UNMARK_API_URL": "https://api.unmark.ink",
"UNMARK_BEARER_TOKEN": "<your-token-if-using-static-auth>"
}
}
}
}Connect Claude to Unmark
Copy the MCP URL into Claude Connectors, sign in with Google, and start cleaning images from chat.
https://mcp.unmark.ink/mcp
Common questions
Do I need a separate API key?
Not for Claude Connectors. Claude’s hosted MCP uses OAuth with the same Google account you use on Unmark — you sign in once when you add the connector. Local Cursor or other stdio setups can use a bearer token or a browser session cookie instead of OAuth. There is no second Unmark “MCP key” to buy. Cloud credits on your Unmark account are what the tools spend when they actually clean an image.
Why does Claude say it cannot read my upload?
Hosted MCP can only fetch public HTTPS image URLs or Unmark share links. Claude’s private upload paths (for example files under /mnt/user-data) are not visible to Unmark. Put the still on a public URL, share it from Library, or use the agent skill on a local file in Cursor. This is the most common setup miss — the connector is working; the image URL is not reachable.
Does MCP use Cloud credits?
Yes. remove_watermark, remove_background, and get_job_status call the same Cloud product as the website and the Chrome extension. Finished jobs show up in Library so you can download them in the browser too. Instant in the browser does not use MCP and does not need a connector — it is the no-account stills path. Use MCP when you want Claude or another client to trigger cleanup from chat.
Can a coding agent clean files in my repo?
Yes — that is the agent skill, not hosted MCP. Install from https://www.unmark.ink/skills so Cursor, Claude Code, or Codex can clean local stills as part of a larger task. MCP stays the chat connector for public URLs. Pick skill for repo files, MCP for “clean this https link,” and Instant for a one-off drop in the browser.
Need a repo workflow instead of chat tools? Install the Unmark skill. Need the web app? Open Unmark or see how to remove Gemini watermarks.