Skip to content
Last updated

MCP

The Model Context Protocol (MCP) is a lightweight, JSON‑based wrapper that enables client applications (e.g., Cursor, Copilot in VS Code, Claude for Desktop) to invoke the YouCam AI services without dealing with low‑level HTTP details.

Key benefits: By adding a single entry to MCP configuration JSON file and supplying your YouCam API key, any MCP‑compatible client (Cursor, Copilot in VS Code, Claude for Desktop) can instantly access the full suite of YouCam AI services - skin analysis, cloth virtual try‑on, hair styling, fashion rendering, and more functions. The client abstracts request formatting, authentication handling, and asynchronous polling, allowing developers to focus on workflow integration rather than low‑level API mechanics.

Integration Guide

1. Prerequisites

  • An MCP‑compatible client installed (Claude Desktop, Codex, Cursor, Copilot in VS Code, etc.).
  • Network access to the YouCam MCP servers, there are 3 categories:
    • https://mcp-api-01.makeupar.com/mcp/beauty
    • https://mcp-api-01.makeupar.com/mcp/fashion
    • https://mcp-api-01.makeupar.com/mcp/creators
  • A valid YouCam API key (see next Section).

The client itself already implements request/response serialization and polling logic; no additional code is required from the developer.

2. Obtaining an API Key

  1. Navigate to the API‑key console: https://yce.perfectcorp.com/api-console/en/api-keys/
  2. Create a new key or copy an existing one.
  3. Store the key securely (environment variable, secret manager, etc.).

Example environment variable (adjust for your deployment): YOUR_API_KEY=your‑api‑key

3. Configuring the MCP configuration JSON file

MCP clients read a JSON configuration file named mcp.json. Add an entry for the YouCam MCP server as shown below:

  • YouCam for Beauty & Skin Care
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  • YouCam for Fashion & Retail
{
  "mcpServers": {
    "youcam-fashion": {
      "url": "https://mcp-api-01.makeupar.com/mcp/fashion",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  • YouCam for Creators
{
  "mcpServers": {
    "youcam-creators": {
      "url": "https://mcp-api-01.makeupar.com/mcp/creators",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Configuration steps

StepAction
1. Setup MCP configuration JSON filePut the file in the root of your project or in the client‑specific configuration directory (refer to each client’s documentation).
2. Replace placeholderSubstitute YOUR_API_KEY with the value obtained in Section 2, or reference an environment variable (${YOUR_API_KEY}) if supported by the client.
3. Verify connectivityOpen the client UI and confirm that “YouCam API MCP” appears as a selectable service.

The configuration is static; any change to the key requires a client reload.


MCP Client Setup

Integration with Popular MCP‑Aware Clients

Claude Desktop

  1. Download and install Node.js and npm.

  2. Settings → Developer → Edit config → open claude_desktop_config.json file

  3. update the mcpServers section

  4. replace the YOUR_API_KEY part with your actual api key

{
  "mcpServers": {
    "youcam-beauty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-api-01.makeupar.com/mcp/beauty",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. File → Exit to restart claude desktop app

Cursor

  1. Open Settings → Tools & MCP → Add Custom MCP

  2. Add settings into mcp.json file

{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Navigate to Cursor Settings → Tools & MCP

  2. Enable or Disable the desired tools in 'Installed MCP Servers' section


Copilot in VS Code (Visual Studio Code)

Copilot in VS Code option 1:

  1. > MCP: Add Server

  2. choose HTTP

  3. enter the server url

  4. name the mcp server

  5. header setting: fill in the api token

Copilot in VS Code option 2:

  1. > MCP: Open User Configuration

  2. Update the youcam-beauty setting to mcp.json

{
    "servers": {
        "youcam-beauty": {
            "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
            "type": "http",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

MCP Capabilities

YouCam for Beauty & Skin Care

YouCam for Beauty & Skin Care includes the following tools for makeup, skincare analysis, facial enhancement, and appearance transformation:

  • YouCam for Beauty & Skin Care
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Face & Skin Analysis / Enhancement

Tool NameDescription
AI_Skin_AnalysisEvaluates skin concerns like wrinkles, pores, acne, oiliness, dark circles, texture, and hydration (HD & SD modes).
AI_Skin_simulationVisualizes before/after treatment progress for up to 10 skin concerns (radiance, acne, spots, etc.).
AI_Facial_Color_Tones_AnalyzerDetects facial skin tone, eye color, eyebrow color, lip color, and hair color.
AI_Aging_SimulationGenerates a series of photos showing how you look from youth to old age based on a single selfie.
AI_Face_Attributes_and_Ratio_AnalyzerAnalyzes facial structure, features (eyes, brows, lips, nose, cheekbones), and golden ratio proportions.
AI_Face_LiftAI-powered facial refinement for eye bags, cheeks, forehead, face shape, and mouth with natural results.
AI_Face_ReshapePixel-perfect control to reshape eyes, nose, lips, jawline, chin, and overall face structure.
AI_Fitzpatrick_Skin_Type_AnalysisClassifies skin into 6 Fitzpatrick types based on melanin levels and UV response.
AI_SmileTransforms neutral or sad expressions into natural-looking smiles (with or without teeth).
AI_Teeth_WhiteningAutomatically detects and brightens teeth with adjustable whitening intensity.

Hair Styling & Analysis

Tool NameDescription
AI_Hair_Style_Virtual_Try_OnTry on a wide variety of hairstyles (curly, long, buzz cut, etc.) using templates or reference images.
AI_Hair_Type_DetectionAnalyzes hair texture, thickness, and curl pattern across 9 clear types.
AI_Hair_Volume_Virtual_Try_OnInstantly add natural volume to fine or thinning hair in photos.
AI_Bangs_Filter_Virtual_Try_OnVirtually try on different bangs styles to see what suits your face best.
AI_Hair_Color_Virtual_Try_OnChange hair color using presets or custom palettes (full or ombre modes).
AI_Wavy_Hair_Virtual_Try_OnExperiment with wavy, curly, or ringlet hairstyles virtually.
AI_Hair_Density_DetectionAssesses and classifies hair density into 4 levels based on scalp visibility.
AI_Hair_Extension_Virtual_Try_OnVirtually try on long to extra-long hair extensions with natural blending.
AI_Hair_Frizziness_DetectionAnalyzes hair frizz levels using front, left, and right view photos.
AI_Hair_Length_DetectionMeasures and categorizes hair length into 5 distinct stages.

Body Reshaping & Fitness

Tool NameDescription
AI_Abs_FilterAdds realistic six-pack or vest-line abdominal definition to full/upper-body photos.
AI_Body_ReshapeSlims, reshapes, and enhances body proportions (waist, arms, thighs, chest, height, etc.).
AI_Breast_Augmentation_SimulatorNon-invasive AI visualization for bust contour enhancement with adjustable intensity.

Makeup & Virtual Try-On

Tool NameDescription
AI_Makeup_Virtual_Try_OnHyper-realistic virtual makeover with precise control over foundation, blush, eyeshadow, lips, etc.
AI_Makeup_TransferTransfers a complete makeup look from a reference photo onto your target selfie.
AI_Nail_Virtual_Try_OnVirtually try on nail polish colors, textures, designs, or press-on nails.
AI_Eye_Color_Lens_Virtual_Try_OnRealistic contact lens/eye color virtual simulation with opacity & blending controls.
AI_Look_Virtual_Try_OnApplies professionally designed beauty/facial looks instantly via templates.
AI_Beard_Style_GeneratorVirtually try on different men's beard styles (stubble, full, goatee, mustache, etc.).

Utilities, Templates & Task Management

Tool NameDescription
*_TemplatesLists predefined templates for bangs, beards, hair extensions, hairstyles, hair volume, and looks.
*_DetectionRuns detection/preprocessing tasks required before certain reshape/lift/whitening APIs.
File_UploadInteractive drag-and-drop widget for uploading images/videos directly from the browser.
Get_Running_Task_StatusChecks the status and retrieves results of previously initiated AI processing tasks.
Get_Upload_API_InfoReturns upload API endpoints and example requests/responses for specific task types.
Get_Feature_CostChecks unit consumption/cost pricing for each YouCam API feature.

YouCam for Fashion & Retail

The YouCam for Fashion & Retail includes the following API tools for fashion, accessory, and styling applications:

  • YouCam for Fashion & Retail
{
  "mcpServers": {
    "youcam-fashion": {
      "url": "https://mcp-api-01.makeupar.com/mcp/fashion",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Clothing & Fabrics

Tool NameDescription
AI_Clothes_Virtual_Try_OnVirtual fitting room that overlays outfits onto your photo. Supports full body, upper/lower body, shoes, outerwear, or auto-detection.
AI_Fabric_Virtual_Try_OnApplies realistic fabric textures and prints to images using predefined templates (e.g., silk, bold patterns).
AI_Fabric_Virtual_Try_On_TemplatesLists all available predefined fabric texture/style templates for use with the Fabric VTO tool.

Footwear

Tool NameDescription
AI_Shoes_Virtual_Try_OnHigh-fidelity AR shoe try-on that visualizes fit, style, and color on your feet. Requires explicit gender parameter.

Headwear & Scarves

Tool NameDescription
AI_Hat_Virtual_Try_OnHyper-realistic AR try-on for hats, caps, and headbands with precise alignment and style controls. Requires explicit gender parameter.
AI_Scarf_Virtual_Try_OnSimulates realistic scarf draping, folds, and pattern flow over outfits. Requires explicit gender parameter.

Jewelry & Accessories

Tool NameDescription
AI_Bracelet_Virtual_Try_OnAI-powered bracelet try-on from a single 2D image with adjustable placement, shadow, and lighting.
AI_Earrings_Virtual_Try_OnRealistic earring & virtual piercing simulator with dynamic lighting, occlusion handling, and ear-side selection.
AI_Necklace_Virtual_Try_OnAR necklace try-on featuring precise neck/clavicle tracking for luxurious, physically accurate placement.
AI_Ring_Virtual_Try_OnVirtual ring/engagement ring try-on with finger selection, knuckle positioning, and realistic shadow/lighting.
AI_Watch_Virtual_Try_OnAR watch visualization with strap alignment, case edge detection, and wrist placement controls.
AI_Bag_Virtual_Try_OnLuxury handbag/bag AR try-on that visualizes carry style, strap length, and outfit pairing. Requires explicit gender parameter.

Utilities & Task Management

Tool NameDescription
File_UploadInteractive drag-and-drop widget for uploading images/videos directly from the browser.
Get_Running_Task_StatusChecks the status and retrieves results of previously initiated AI processing tasks.
Get_Upload_API_InfoReturns upload API endpoints and example requests/responses for specific task types.
Get_Feature_CostChecks unit consumption/cost pricing for each YouCam API feature.

YouCam for Creators

The following AI-powered tools available in YouCam for Creators are grouped by their primary functionality:

  • YouCam for Creators
{
  "mcpServers": {
    "youcam-creators": {
      "url": "https://mcp-api-01.makeupar.com/mcp/creators",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

AI Image Generation & Enhancement

Tool NameDescription
AI_Image_Generator_Text_to_ImageGenerates high-quality images from text prompts with style/size controls and smart prompt rewriting.
AI_Image_Generator_Image_to_ImageTransforms or edits existing images using text instructions + up to 3 reference images for pose/style guidance.
AI_Photo_ColorizeInstantly colorizes black & white or faded photos into 4 unique vibrant versions (warm to cool tones).
AI_Color_CorrectionAuto-adjusts saturation, temperature, hue, exposure, and skin tones; outputs 4 professionally graded variations.
AI_Photo_EnhanceUpscales resolution (1x/2x/4x), fixes motion blur, removes pixelation, and sharpens facial/details clarity.
AI_Photo_LightingAI-powered brightening tool that recovers shadows, balances exposure, and enhances low-light photos naturally.
AI_Image_ExtenderContext-aware outpainting that seamlessly expands images to any custom ratio while preserving style & quality.

Background Manipulation

Tool NameDescription
AI_Photo_Background_RemovalHigh-precision AI subject isolation with clean edges; supports people, products, animals, cars, etc.
AI_Photo_Background_BlurApplies natural bokeh/background blur to make subjects pop; adjustable intensity (0–100).
AI_Photo_Background_Change & _TemplatesReplaces backgrounds using custom text prompts or predefined scenic templates after subject isolation.
AI_Video_Background_ReplaceSeamlessly swaps video backgrounds with reference images/videos; supports crop/stretch fitting modes.

Portrait, Avatar & Headshot Creation

Tool NameDescription
AI_Avatar_Generator & _TemplatesImage-to-image avatar creation that learns facial traits and applies artistic/stylized templates.
AI_Studio_Generator & _TemplatesTransforms casual selfies into studio-quality professional portraits with optimized lighting & composition.
AI_Headshot_Generator & _TemplatesGenerates polished LinkedIn/business/model headshots from standard photos using AI styling templates.

Face Swap & Object Editing

Tool NameDescription
AI_Face_Swap & AI_Face_Swap_Face_DetectionHyper-realistic photo face swapping supporting multiple faces, custom mapping, and skip logic.
AI_Video_Face_SwapAI-powered single-face video swap with adaptive lighting, expression tracking, and skin tone blending.
AI_Object_Removal_ProPrecision removal of unwanted objects/people using grayscale masks; preserves intricate background details.
AI_Video_Object_RemovalFrame-consistent removal of distracting elements from videos using a single reference mask frame.
AI_ReplaceAI inpainting that removes masked areas and generates new objects/textures based on custom prompts.

Video Generation & Enhancement

Tool NameDescription
AI_Video_Generator_Text_to_VideoCreates dynamic videos from text prompts with resolution, aspect ratio, duration, and negative prompt controls.
AI_Video_Generator_Image_to_VideoAnimates still images into realistic short videos using motion prompts & template optimization.
AI_Video_EnhancerAuto-fixes blur, sharpens edges, corrects exposure/brightness, reduces noise, and upscales low-res footage to HD.
AI_Video_Style_Transfer & _TemplatesApplies cinematic/AI filters (pop art, retro, anime, etc.) frame-by-frame for consistent stylized video output.

Utilities & Task Management

Tool NameDescription
File_UploadInteractive drag-and-drop widget for uploading images/videos directly from the browser.
Get_Running_Task_StatusChecks the status and retrieves results of previously initiated AI processing tasks.
Get_Upload_API_InfoReturns upload API endpoints and example requests/responses for specific task types.
Get_Feature_CostChecks unit consumption/cost pricing for each YouCam API feature.