The pattern is submit then read back: submit_tryon_task takes user_img_url and cloth_img_url and returns a task, query_tryon_task reads it by task_id, so several can be queued and collected in one session. Both images have to be reachable URLs — nothing here uploads a local file — and the pair is the whole surface: no catalogue, no listing of past tasks, no cancel.
A two-tool server over HeyBeauty's virtual try-on service: one call submits the task, the other reads its result.
- A try-on task submitted from a user image URL and a cloth image URL, with a cloth description and cloth id alongside
- The task fetched back by task id
A HeyBeauty API key in HEYBEAUTY_API_KEY, and both images already hosted where the service can fetch them — the person photo and the garment are passed as URLs.
One command plus a key — npx -y heybeauty-mcp, then supply credentials
