Skip to content
ecommerceguide.
Explore ecommerceguide.

MCP server

HeyBeauty

MCP server for the HeyBeauty API that submits virtual clothing try-on tasks from a user image and garment image and queries their results.

Visit doc.heybeauty.ai (opens in a new tab)Compare alternativesView on GitHub (opens in a new tab)View on mcpmarket.com (opens in a new tab)
  • Third-party company
  • Runs locally
  • API key

Repository and documentation last checked Built from public product pages and documentation. SourcesClaim this listing

ecommerceguide summary

HeyBeauty is a third-party MCP server, built by chatmcp, that connects an AI client to the HeyBeauty virtual try-on API. Its tools submit a try-on task from a user image URL and a garment image URL, then query that task for results. It also exposes clothes as cloth:// resources and a tryon_cloth prompt. It runs locally over stdio via npx heybeauty-mcp, authenticated with a HeyBeauty API key, under an MIT licence.

Why it stands out

Third-party server published by chatmcp on npm, wrapping the HeyBeauty try-on API behind two MCP tools.

What HeyBeauty does

ecommerceguide editorial
  • Tools submit_tryon_task and query_tryon_task create and read try-on jobs
  • Runs locally over stdio, installed with npx -y heybeauty-mcp
  • Authentication by HEYBEAUTY_API_KEY environment variable in the client config
  • Setup steps documented for Claude Desktop on macOS and Windows
  • Exposes clothes as cloth:// resources with id, description and image URL
  • Includes a tryon_cloth prompt that returns a structured try-on prompt
  • TypeScript project, MIT licence, maintained by chatmcp, Dockerfile in repo

How ecommerce teams could use it

ecommerceguide editorial

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

  1. Apparel brand team experimenting with AI assistants for product imagery

    Testing garment previews by passing a model photo URL and a garment image URL to an assistant in Claude Desktop

    Intended outcomeThe server submits a try-on task through the HeyBeauty API and returns task details when queried

  2. Developer building a conversational shopping prototype

    Needing try-on calls available as MCP tools rather than hand-written API requests

    Intended outcomeInstalls the npm package locally, sets HEYBEAUTY_API_KEY and exposes submit and query tools to the client

Who it suits

ecommerceguide editorial

Best for

You hold a HeyBeauty API key and want its try-on submit and query calls available as MCP tools in a local client such as Claude Desktop.

Probably not for

You need a hosted endpoint, OAuth, a merchant-facing storefront widget or vendor-maintained support, since this is a community stdio server requiring a HeyBeauty API key.

Business size
Any stageInstallation is a local npm package with an API key, with no vendor-stated audience or pricing tiers.
Verticals
DTC apparel and fashion

Technical details

From the vendor's own pages

From the server's repository, documentation and MCP directory listings.

What an agent can do
Product content
Transport
stdio (local)
Authentication
API keyenv HEYBEAUTY_API_KEY: 'apply for HeyBeauty API Key' and paste into MCP client config.
Package
heybeauty-mcp (npm)
Language
JavaScript
Licence
MIT
Repository last updated
7 Jul 2025

Connect HeyBeauty

Third-party data

Setup documented for

Install command
npx -y heybeauty-mcp

Command as listed on the repository README, not tested by ecommerceguide. Check the official documentation (opens in a new tab) for configuration and credentials before running it.

Often used alongside

ecommerceguide editorial

Categories and use cases

Alternatives to HeyBeauty

Listings that share this one's category, platforms or use cases. Ordered by how many relationships they share, not by quality or payment.

View all MCP servers

Sources

ecommerceguide profiles are built from public product information and written for ecommerce teams. We do not test products, and paying never changes where a listing ranks.

Also listed on MCP Market.

See something incorrect? Report an update

View all MCP servers