Skip to main content
Glama

AI Image Merge MCP

An MCP server for AI Image Merge. It exposes the product's real image-combination workflow to MCP clients such as Claude Desktop, Cursor, and other compatible agents.

Licensed under the MIT License.

Website: https://aiimagemerge.com

Tools

  • merge_images: submit exactly two public HTTPS JPG, PNG, or WebP URLs and receive a task id.

  • get_merge_status: poll a task and receive the generated image URL when it is ready.

The remote service downloads and validates the images, stores them under the authenticated user's storage path, reserves credits, and invokes the configured AI provider. The MCP server never contains an AI provider secret.

Related MCP server: Vertex AI Imagen MCP Server

Setup

  1. Sign in to AI Image Merge.

  2. Open Settings → API Keys and create a key.

  3. Configure the MCP client with:

{
  "mcpServers": {
    "ai-image-merge": {
      "command": "npx",
      "args": ["-y", "ai-image-merge-mcp"],
      "env": {
        "AI_IMAGE_MERGE_API_KEY": "sk-..."
      }
    }
  }
}

For a local checkout, replace the command with node and the absolute path to src/index.mjs.

Optional environment variable:

AI_IMAGE_MERGE_API_URL=https://aiimagemerge.com

Image requirements

The first version accepts two publicly reachable HTTPS image URLs. Each image must be JPG, PNG, or WebP and no larger than 10 MB. Private IPs, localhost, non-HTTPS URLs, and unsupported content types are rejected.

Development

Run the server directly:

AI_IMAGE_MERGE_API_KEY=sk-... node src/index.mjs

The process speaks newline-delimited JSON-RPC over stdio and keeps stdout reserved for MCP messages.

Run the local protocol smoke test with npm test.

Release and LobeHub listing

This directory is intended to become the root of a separate public GitHub repository, for example lingn/ai-image-merge-mcp. After creating that repository and publishing the package to npm, log in to LobeHub and publish the repository with the included manifest:

npm publish --access public
npx -y @lobehub/market-cli login
npx -y @lobehub/market-cli github connect
npx -y @lobehub/market-cli plugin publish https://github.com/lingn/ai-image-merge-mcp --dir /absolute/path/to/ai-image-merge-mcp

login and github connect open a browser and require the repository owner to complete authorization. The listing's homepage points to https://aiimagemerge.com.

Available Tools

2 tools
get_merge_statusGet image merge statusA

Check the status of an image merge task created by merge_images and return the generated image URL when it is ready. Website: https://aiimagemerge.com

ParametersJSON Schema
NameRequiredDescriptionDefault
taskIdYesThe task id returned by merge_images.

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of behavioral disclosure. It effectively communicates that this is a status-checking/read operation that returns the image URL only once the asynchronous merge is ready. It could add detail on in-progress or failed states, but the core async behavior is disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first sentence is compact, front-loaded, and informative. The second sentence adds a website URL that is not directly useful for invoking the tool correctly, so the description is not perfectly economical, but it remains short and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema and no annotations, so the description needs to cover the return behavior. It explains that the image URL is returned when ready, but it does not describe what the tool returns for pending or failed tasks, which is important for an agent trying to poll or handle errors.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the schema already explains that taskId is the id returned by merge_images. The description does not add meaningful new semantics beyond that, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Check'), names the resource ('status of an image merge task'), and ties the task to merge_images. It clearly distinguishes this polling tool from the creation-oriented sibling merge_images.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'created by merge_images' makes clear that merge_images must be called first, and 'when it is ready' implies polling behavior. However, it does not explicitly say 'use this tool after merge_images to poll until ready' or mention when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

merge_imagesMerge two images with AIA

Combine exactly two public JPG, PNG, or WebP image URLs into one AI-generated image. The call consumes credits from the configured AI Image Merge account and returns a task id for polling. Website: https://aiimagemerge.com

ParametersJSON Schema
NameRequiredDescriptionDefault
presetNoOptional merge intent.natural
promptYesDescribe how the two images should be combined.
imageUrlsYesExactly two publicly reachable HTTPS image URLs.
aspectRatioNoOptional output aspect ratio.auto

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the behavioral disclosure burden and does disclose two key traits: it consumes credits from the configured account and returns a task id for polling (async behavior). It does not mention failure modes or rate limits, but the most consequential side effects are surfaced.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is short and front-loaded, with the core action in the first sentence and behavioral details in the second. The website URL is slightly extraneous for an AI agent but does not undermine the overall conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description appropriately mentions the return value (task id for polling) and cost implication. Given the sibling get_merge_status exists, an agent can infer the next step, though a brief mention of checking status via that tool would make it fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline applies; all four parameters are already documented in the schema. The description adds only the 'public' and 'exactly two' constraints, which are also present in the schema, so it provides no significant meaning beyond it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action ('Combine exactly two public JPG, PNG, or WebP image URLs') and a clear result ('into one AI-generated image'). It does not explicitly name the sibling get_merge_status, but the note about returning a task id for polling signals the async workflow and helps differentiate it from status polling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear context is provided: the tool is for merging two public image URLs, with prerequisites explicitly mentioned (public, supported formats, exactly two). It omits explicit when-not-to-use guidance, but with only one sibling (a status poller), the usage context is sufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

A4.3/5.0
Disambiguation5/5

merge_images starts a new image merge task, while get_merge_status checks an existing task's status and retrieves the result. Their purposes are clearly distinct and there is no overlap that would confuse an agent.

Naming Consistency5/5

Both tool names follow a consistent verb_noun pattern: merge_images and get_merge_status. The verbs clearly indicate actions (merge/check) and the nouns describe the target resource.

Tool Count5/5

The server has exactly two operations needed for its narrow purpose: submitting a task and polling for its result. This is well-scoped and does not feel too thin or too heavy.

Completeness5/5

The tool set covers the full workflow from initiating an image merge to retrieving the generated image URL. There are no obvious missing operations for the stated purpose of merging two images via the AI Image Merge service.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lingn/ai-image-merge-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server