How do I install Unmerge?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Unmerge need an API key?

No required environment variable is listed on this record.

What transport does Unmerge use?

Unmerge runs locally over stdio.

When was Unmerge last checked?

Last checked 2026-10-27. Remote MCP server and agent skill for Unmerge: split a flat image into transparent PNG layers.

Unmerge MCP server

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Unmerge MCP server and agent skill

Unmerge splits a flat image into separate transparent PNG layers, with the hidden parts behind objects filled in. This repository holds the connection details for its remote MCP server and an Agent Skill that teaches an agent to use it. The service itself is hosted; there is nothing to install or run.

MCP endpoint: https://unmerge.app/mcp (Streamable HTTP)
Auth: Authorization: Bearer <key>. Create a key at unmerge.app/account/api (needs a confirmed email).
Registry name: app.unmerge/unmerge in the official MCP Registry
Docs: MCP · HTTP API

Connect

Put the key in an environment variable first:

export UNMERGE_API_KEY=um_...

Claude Code

claude mcp add --transport http unmerge https://unmerge.app/mcp --header "Authorization: Bearer $UNMERGE_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "unmerge": {
      "url": "https://unmerge.app/mcp",
      "headers": { "Authorization": "Bearer um_..." }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.unmerge]
url = "https://unmerge.app/mcp"
bearer_token_env_var = "UNMERGE_API_KEY"

Tools

Tool	What it does	Cost
`split_into_layers`	Split a PNG, JPG or WebP (https URL or base64) into named layers. Optional `prompt` says what to separate. Waits up to 50 seconds.	1 credit per layer returned, at most 17; needs 5 credits to start
`get_layers`	Status of a split; when ready, each layer's name, position and a PNG link valid for one hour	Free
`unlock_layers`	For status `needs_credits`: pay the credits owed so the files become available	The credits owed, once
`get_credits`	Credits left on the account	Free

Listing tools works without a key; calling one needs it.

Pricing

The same credits as the website: one credit is one layer returned. See unmerge.app/pricing.

Agent skill

skills/unmerge/SKILL.md follows the Agent Skills format. Install it with

npx skills add unmerge-app/unmerge-mcp

or copy the folder into your agent's skills directory (for Claude Code, ~/.claude/skills/unmerge/). It uses the MCP tools when they are connected and the HTTP API with curl otherwise.

Support

[email protected]

License

The files in this repository are MIT licensed. The Unmerge service has its own terms.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Unmerge?

Does Unmerge need an API key?

What transport does Unmerge use?

When was Unmerge last checked?

Documentation

Unmerge MCP server and agent skill

Connect

Tools

Pricing

Agent skill

Support

License