MCP Server - Genlook Documentation

Genlook ships a remote MCP server that exposes the Virtual Try-On API as tools your AI assistant can call directly: upload a photo, generate a try-on, and see the result right in the conversation.

https://mcp.genlook.app

No API key needed — the connector authenticates with OAuth. Sign in (or create an account) when your assistant prompts you; new accounts start with 5 free credits, and each generation costs 1 credit. Top up anytime at platform.genlook.app/topup.

Setup

Claude
Claude Code
ChatGPT
Cursor

Open claude.ai → Settings → Connectors
Click Add custom connector and paste https://mcp.genlook.app
Sign in with your Genlook account when prompted

claude mcp add --transport http genlook https://mcp.genlook.app

Then run /mcp inside Claude Code to complete the OAuth sign-in.

Settings → Apps & Connectors → enable Developer mode
Create a connector with https://mcp.genlook.app (OAuth)
Sign in with your Genlook account when prompted

Add to ~/.cursor/mcp.json (or via Settings → MCP → Add new MCP server):

{
  "mcpServers": {
    "genlook": {
      "url": "https://mcp.genlook.app"
    }
  }
}

Cursor handles the OAuth flow on first use.

Tools

The tools mirror the REST API:

Tool	REST equivalent	What it does
`upload_photo`	`POST /images/upload`	Upload a person photo (publicly accessible URL or base64). Returns an `imageId` to pass to `generate_try_on`; photos expire after the retention window.
`get_uploaded_photo`	—	Return the most recent non-expired upload (`imageId`, expiry, a preview link, and an inline preview when available) — reuse it across conversations without re-uploading.
`generate_try_on`	`POST /try-on`	Generate a try-on. A person photo is required — pass exactly one of `person_image_id` or `person_image_url`. The garment goes in `garments` (an array; exactly one for now, mirroring the REST API’s `products`). Waits for the result and returns the image.
`get_generation`	`GET /generations/:id`	Poll a generation by id; returns the image once `COMPLETED`.
`get_account`	`GET /account/credits`	Remaining credits and the top-up URL.

All image URLs passed to the tools must be publicly accessible — no login-gated, signed-for-someone-else, or private links.

Example prompts

“Here’s a dress I like: <image URL> — show me wearing it.”
“Use this photo of me from now on: <image URL>.”
“Try these sneakers on me, then compare with the previous pair.”
“How many try-on credits do I have left?”

Privacy & retention

Uploaded photos and generated images follow the account retention window (7 days by default), then are deleted automatically. The full-resolution result links returned by the tools stay valid for 7 days.

​Setup

​Tools

​Example prompts

​Privacy & retention

Setup

Tools

Example prompts

Privacy & retention