YouCam (beta)

Show the signed-in user's current YouCam subscription plan, subscription status, and remaining credits in an MCP App. Use this tool when the user asks about their current plan, whether their subscription is active, or how many credits they have left. This tool calls the subscription and credit-balance APIs together. Do not use get-action-cost for account balance questions; get-action-cost explains how many credits actions cost.

get-account-status

Fetch a pending beauty-agent result for either the MCP App widget or a client without MCP Apps support. If an MCP App is visible, the assistant must not call this tool because the widget polls automatically. When no app is visible, call this tool only after beauty-knowledge returns status=processing, using its transaction_id and sessionId as session_id. Poll sequentially; never repeat the original beauty-knowledge request.

beauty-result

Internal helper for the widget to resolve a VTO input image file ID to a fresh URL.

vto-input-image-url

Return the current YouCam AI Agent credit costs as a plain-text Markdown table and explain that a paid plan is required for chat features. Call this tool when the user asks how many credits an action costs, about point consumption, action pricing, payment requirements, or whether YouCam chat is free. This tool takes no input and does not render a widget. Do not call beauty-knowledge for action-cost or pricing questions. For the signed-in user's current plan or remaining balance, use get-account-status instead.

get-action-cost

Return a static plain-text overview of the five capabilities supported by YouCam. Call this tool when the user asks what YouCam, this app, or this server can do, how it can help, or which features and capabilities it supports. Use this tool instead of beauty-knowledge for capability discovery. This tool takes no input and does not render a widget.

get-capabilities

Use this tool ONLY for: - image/photo generation or editing - beauty, fashion, outfit styling, personal appearance, makeup, skincare, hairstyle, or color analysis - image-based requests related to beauty, fashion, personal appearance, analysis, recommendations, or transformations, even when the user is only asking for advice or suggestions Use this tool when the user: - explicitly asks to generate, create, draw, render, or produce an image/photo - asks to edit, retouch, enhance, or transform an image/photo - uploads an image for editing, analysis, styling, beauty, fashion, outfit, makeup, hairstyle, skincare, facial-feature, appearance, or color advice - asks for beauty, fashion, outfit, makeup, skincare, hair, or appearance advice - asks for beauty/fashion product advice, including skincare, makeup, hair products, clothing, shoes, accessories, or outfit items Never use this tool for: - general discussion about GenAI, image generation, prompt engineering, AI image evaluation, image scoring, image ranking, or model evaluation, unless the user asks to actually generate/edit an image - consumer electronics, hardware, device model numbers, chips, specs, benchmarks, release dates, troubleshooting, or comparisons - programming, software development, servers, APIs, databases, AI systems, or technical support - general knowledge, web search, or anything unrelated to image/photo generation, photo editing, beauty, fashion, outfit styling, makeup, skincare, hairstyle, or personal appearance For one image, pass image_file directly. For multiple images, first call upload-beauty-file once per image, then pass the returned fileKey values via file_keys. Reuse the returned session_id to continue the same session. The first call may omit session_id. Do not paste uploaded file references into user_message.

beauty-knowledge

ChatGPT-only helper for uploading one ChatGPT-hosted image file and returning its fileKey and fileId. Use this tool only when ChatGPT file ID is available. This tool is not a final image editing or image generation tool. After every successful upload-file call, continue the same user request by calling beauty-knowledge with the returned fileKey in file_keys and fileId in file_ids at the same index. When handling multiple images, call this tool once per image first, then pass all returned values through matching beauty-knowledge.file_keys and beauty-knowledge.file_ids lists. Do not generate or edit images yourself after this tool.

upload-file