How do I install the heybeauty mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `HEYBEAUTY_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Heybeauty MCP Server

HeyBeauty Virtual TryOn

Local serverstdioTypeScript

What is the Heybeauty MCP Server?

HeyBeauty Virtual TryOn.

What Heybeauty MCP does

This is a TypeScript-based MCP server that implements virtual tryon using HeyBeauty API. It demonstrates core MCP concepts by providing:

Practical notes

Maintained by chatmcp, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
submit_tryon_task	Submit a tryon task
query_tryon_task	Query a tryon task

How to install the Heybeauty MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
HEYBEAUTY_API_KEY	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Heybeauty MCP to submit tryon task.”
“Use Heybeauty MCP to query tryon task.”
“Use Heybeauty MCP to Resources.”

Frequently asked questions

HeyBeauty Virtual TryOn Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.