Server facts
heybeauty-mcp
Project
- Author
- chatmcp
- Repository
- github.com/chatmcp/heybeauty-mcp
- License
- MIT
- Category
- Design & Creative
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 19
- Last commit
- Data as of
Overview
Clothing records and try-on requests form the core of heybeauty-mcp, a TypeScript integration with the HeyBeauty API. It exposes garments as MCP resources under cloth:// URIs, with identifiers, names, descriptions, image URLs, and metadata. These resources use a plain-text MIME type. For task creation, submit_tryon_task requires URLs for both the user's image and the garment image, together with the garment's identifier and description. Submitted tasks are retained in the server's state, linking the clothing information to the request workflow.
A separate tool, query_tryon_task, accepts a task identifier and retrieves information about that task. The tryon_cloth prompt uses the same image and garment inputs as submission, but produces a structured prompt for an LLM. This gives MCP client users distinct interfaces for accessing clothing, submitting requests, looking up tasks, and preparing prompts. The server runs on Node.js and communicates through stdio. Setup requires a HeyBeauty API key, and the documentation includes client configuration guidance for Claude Desktop.
heybeauty-mcp setup notes
- heybeauty-mcp records stdio only; confirm a network transport upstream before planning remote access.