HeyBeauty MCP Server
About
Perform virtual try-ons using the HeyBeauty API.
Details
- License
- MIT
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HeyBeauty MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
submit_tryon_task
Submit a tryon task with user image url and cloth image url
query_tryon_task
Query a tryon task with task id
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"heybeauty mcp server": {
"heybeauty-mcp": {
"command": "npx",
"args": [
"-y",
"heybeauty-mcp"
],
"env": {
"HEYBEAUTY_API_KEY": "your-heybeauty-api-key"
}
}
}
}
}McpServers
{
"heybeauty-mcp": {
"command": "npx",
"args": [
"-y",
"heybeauty-mcp"
],
"env": {
"HEYBEAUTY_API_KEY": "your-heybeauty-api-key"
}
}
}This is a TypeScript-based MCP server that implements virtual tryon using HeyBeauty API. It demonstrates core MCP concepts by providing:
- Resources representing clothes with URIs and metadata
- Tools for submit tryon task and query task info.
- Prompts for tryon cloth.
add the server config to MCP Client config file
{ "mcpServers": { "heybeauty-mcp": { "command": "npx", "args": ["-y", "heybeauty-mcp"], "env": { "HEYBEAUTY_API_KEY": "your_heybeauty_api_key" } } } }
- List and access clothes viacloth://URIs
- Each cloth has a id, name, description, image url and metadata
- Plain text mime type for simple content access
- submit_tryon_task- Submit a tryon task
- Takes user image url, cloth image url, cloth id and cloth description as required parameters
- Stores tryon task in server state
- Takes task id as required parameter
- Returns tryon task info
- tryon_cloth- Tryon cloth
- Takes user image url, cloth image url, cloth id and cloth description as required parameters
- Returns structured prompt for LLM tryon
- cloth://- URI for clothes
- Each cloth has a id, name, description, image url and metadata
To use with Claude Desktop, add the server config:
On MacOS:~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "heybeauty-mcp": { "command": "node", "args": ["/path/to/heybeauty-mcp/build/index.js"] }, "env": { "HEYBEAUTY_API_KEY": "your_heybeauty_api_key" } } }
Follow this document toget HeyBeauty API Key.
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using theMCP Inspector, which is available as a package script:
The Inspector will provide a URL to access debugging tools in your browser.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
