HeyBeauty MCP ServerFeatured

@chatmcp

About HeyBeauty MCP Server

HeyBeauty MCP Server for Virtual TryOn

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "heybeauty-mcp"
      ],
      "env": {
        "HEYBEAUTY_API_KEY": "your-heybeauty-api-key"
      }
    }
  }
}

Tools

Submit a tryon task with user image url and cloth image url

Query a tryon task with task id

Overview

What is HeyBeauty MCP Server?

This is a TypeScript-based MCP server that implements virtual try‑on using the HeyBeauty API. It provides resources, tools, and prompts for users who want to try on clothes virtually through an MCP client.

How to use HeyBeauty MCP Server?

Apply for a HeyBeauty API Key, then add the server configuration to your MCP client’s config file (e.g., Claude Desktop). Use the npx -y heybeauty-mcp command with the HEYBEAUTY_API_KEY environment variable, or run the built node server directly. Invoke the submit_tryon_task or query_tryon_task tools, or use the tryon_cloth prompt.

Key features of HeyBeauty MCP Server

Virtual try‑on via the HeyBeauty API
Resources: clothes with id, name, description, image URL, and metadata
Tools: submit try‑on tasks and query task info
Prompts: structured LLM prompt for try‑on
Supports cloth:// URIs for simple content access

Use cases of HeyBeauty MCP Server

E‑commerce: let users preview clothes on their own photos
Fashion apps: integrate virtual try‑on into AI‑powered shopping assistants
Content creation: generate try‑on descriptions for product listings

FAQ from HeyBeauty MCP Server

What do I need to use this server?

You need a HeyBeauty API Key (obtainable from their documentation) and an MCP client that can run the server (e.g., Claude Desktop).

How do I install and configure it?

Add the provided JSON configuration to your MCP client’s config file, set the HEYBEAUTY_API_KEY environment variable, and run the server via npx -y heybeauty-mcp or with the built Node.js script.

What tools are available?

Two tools: submit_tryon_task (accepts user image URL, cloth image URL, cloth ID, and cloth description) and query_tryon_task (accepts a task ID and returns the task info).

How can I debug the server?

Use the MCP Inspector by running npm run inspector in the project directory. This provides a URL with debugging tools for MCP servers communicating over stdio.

Frequently asked questions

What do I need to use this server?

You need a HeyBeauty API Key (obtainable from their documentation) and an MCP client that can run the server (e.g., Claude Desktop).

How do I install and configure it?

Add the provided JSON configuration to your MCP client’s config file, set the `HEYBEAUTY_API_KEY` environment variable, and run the server via `npx -y heybeauty-mcp` or with the built Node.js script.

What tools are available?

Two tools: `submit_tryon_task` (accepts user image URL, cloth image URL, cloth ID, and cloth description) and `query_tryon_task` (accepts a task ID and returns the task info).

How can I debug the server?

Use the MCP Inspector by running `npm run inspector` in the project directory. This provides a URL with debugging tools for MCP servers communicating over stdio.