MCP.so
Sign In
U

Unmerge MCP Server

@Unmerge

Basic information

Transport

streamable-http

Authentication

API Key

Category

Media & Design

Author

Unmerge

About Unmerge MCP Server

Unmerge is a hosted MCP server that splits a flat image into separate transparent PNG layers, paid with Unmerge credits. It uses an API key sent as a bearer token and is listed in the official MCP Registry as app.unmerge/unmerge.

Connection details

https://unmerge.app/mcp

Setup

claude mcp add unmerge --transport http https://unmerge.app/mcp

Unmerge MCP Server tools

4

Split a flat image (PNG, JPG or WebP) into named transparent layers, with the hidden parts behind objects filled in. Costs 1 credit per layer returned (at most 17); the account needs at least 5 credits to start. Pass the image as a public https URL or as base64. Waits up to 50 seconds; if it is still processing, call get_layers later.

Status of a split. When ready, returns every layer with its name, position and a PNG download URL valid for one hour. Free.

For a split with status needs_credits: pay the extra credits owed (shown as credits.owed) so the layer files become available. Charges once even if called again.

Credits available on this Unmerge account. One credit is one layer returned.

Overview

What it is

Unmerge takes a flat image (a poster, screenshot or illustration) and splits it into separate transparent PNG layers that you can edit individually.

The MCP server lets an assistant start a split, fetch the resulting layers, unlock them and check your credit balance. Processing is paid with Unmerge credits. It is listed in the official MCP Registry as app.unmerge/unmerge.

Connect

  • Endpoint: https://unmerge.app/mcp (Streamable HTTP)
  • Authentication: an API key sent as Authorization: Bearer <key>

Claude Code:

claude mcp add unmerge --transport http https://unmerge.app/mcp

Other clients (mcpServers config):

{ "mcpServers": { "unmerge": { "type": "http", "url": "https://unmerge.app/mcp" } } }

Get an API key from your Unmerge account and send it as Authorization: Bearer <key>.

Tools

Read from the server's tools/list on 2026-11-08:

  • split_into_layers — Split a flat image (PNG, JPG or WebP) into named transparent layers, with the hidden parts behind objects filled in
  • get_layers — Status of a split
  • unlock_layers — For a split with status needs_credits: pay the extra credits owed (shown as credits.owed) so the layer files become available
  • get_credits — Credits available on this Unmerge account

Limits and notes

  • Splitting images costs Unmerge credits.
  • The endpoint answered a standard MCP initialize request when checked on 2026-11-08 (it returned 401 and asks for authorization, as expected for a signed-in service).

Sources: Unmerge MCP docs.

Frequently asked questions

1

What is the Unmerge remote MCP server?

The Unmerge remote MCP server is a hosted Model Context Protocol endpoint at https://unmerge.app/mcp, so AI assistants can connect to it without installing or running anything locally.

2

How do I connect to the Unmerge MCP server?

Add the endpoint https://unmerge.app/mcp to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

3

Does the Unmerge MCP server require authentication?

Yes. Unmerge requires an API key — check the official documentation for how to obtain one, then include it in your client's configuration.

4

Which transport does the Unmerge MCP server use?

Unmerge exposes a streamable-http endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments