Serveur MCP

Photo AI Studio

com.photoaistudio/photo-ai-studio
Design et création Médias et contenu Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Uploads images and generates or edits AI photos, creates videos, browses visual themes, and manages generated-operation history and credits.

browse_themes
Browse photo themes
Browse the photo themes available for generation, optionally filtered by gender category or a keyword. Returns the theme slugs that generate_photo expects. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Search themes by name or keyword'}, 'gender': {'enum': ['male', 'female', 'groups', 'pets', 'product'], 'type': 'string', 'description': 'Filter themes by gender category'}}, 'additionalProperties': False}
create_video
Create a video
Create an AI video. Costs 500 credits for a video, or 100 credits for a product_holder image. Types: - image_to_video: animate an image (image_url, prompt) - ugc: a spokesperson video from a script (script, voice_id) - product_holder: a person presenting a product (product_image_url) Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Schéma d’entrée
{'type': 'object', 'required': ['type'], 'properties': {'type': {'enum': ['image_to_video', 'ugc', 'product_holder'], 'type': 'string', 'description': 'Type of video to create'}, 'gender': {'type': 'string', 'description': 'UGC model gender'}, 'prompt': {'type': 'string', 'description': 'Animation prompt, required for image_to_video'}, 'script': {'type': 'string', 'description': 'UGC script, up to 150 characters'}, 'emotion': {'type': 'string', 'description': 'UGC emotion, default neutral'}, 'duration': {'type': 'number', 'description': 'Duration in seconds, default 4'}, 'language': {'type': 'string', 'description': 'UGC language, default English'}, 'voice_id': {'type': 'string', 'description': 'Voice ID for UGC'}, 'image_url': {'type': 'string', 'description': 'CDN URL of the image to animate'}, 'resolution': {'type': 'string', 'description': 'Video resolution, default 720p'}, 'output_type': {'enum': ['image', 'video'], 'type': 'string', 'description': 'product_holder output: image costs 100 credits, video costs 500'}, 'aspect_ratio': {'type': 'string', 'description': 'Output aspect ratio'}, 'person_prompt': {'type': 'string', 'description': 'Person description for product_holder'}, 'wait_for_result': {'type': 'boolean', 'description': 'Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos.'}, 'person_image_url': {'type': 'string', 'description': 'Person image for product_holder'}, 'product_image_url': {'type': 'string', 'description': 'Product image, required for product_holder'}}, 'additionalProperties': False}
edit_image
Edit a photo
Edit a photo with one of 19 AI operations. Credit costs: remove_background 10, replace_background 3, everything else 100. Operations and their required arguments: - remove_background (image_url) - replace_background (image_url, prompt) - retouch (image_url, prompt) - skin (image_url) - hair (image_url, plus hairstyle or reference_image_url) - makeup (image_url) - age (image_url, target_age) - expression (image_url, target_expression) - body_type (image_url, target_body_type) - eye_color (image_url, target_eye_color) - color_correction (image_url) - custom (image_url, prompt) - clothes (image_url, clothes_image_url) - try_on (image_url, clothes_image_url) - product (image_url, product_image_url) - upscale (image_url) - restore (image_url) - face_swap (source_image_url, target_image_url) - extend (image_url) Every image argument must be a CDN URL from upload_image. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Schéma d’entrée
{'type': 'object', 'required': ['operation'], 'properties': {'prompt': {'type': 'string', 'description': 'Text prompt for replace_background, retouch, and custom'}, 'hairstyle': {'type': 'string', 'description': 'Target hairstyle for the hair operation'}, 'image_url': {'type': 'string', 'description': 'CDN URL of the image to edit, required for every operation except face_swap'}, 'operation': {'enum': ['remove_background', 'replace_background', 'retouch', 'skin', 'hair', 'makeup', 'age', 'expression', 'body_type', 'eye_color', 'color_correction', 'custom', 'clothes', 'try_on', 'product', 'upscale', 'restore', 'face_swap', 'extend'], 'type': 'string', 'description': 'The edit operation to perform'}, 'hair_color': {'type': 'string', 'description': 'Target hair color for the hair operation'}, 'num_images': {'type': 'number', 'description': 'Number of variations for try_on (1-4)'}, 'target_age': {'type': 'number', 'description': 'Target age for the age operation'}, 'wait_for_result': {'type': 'boolean', 'description': 'Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos.'}, 'source_image_url': {'type': 'string', 'description': 'Source face image for face_swap'}, 'target_body_type': {'type': 'string', 'description': 'Target body type'}, 'target_eye_color': {'type': 'string', 'description': 'Target eye color'}, 'target_image_url': {'type': 'string', 'description': 'Target image for face_swap'}, 'clothes_image_url': {'type': 'string', 'description': 'Clothes image for clothes and try_on'}, 'product_image_url': {'type': 'string', 'description': 'Product image for the product operation'}, 'target_expression': {'type': 'string', 'description': 'Target expression, for example "happy"'}, 'reference_image_url': {'type': 'string', 'description': 'Reference image for hair or custom'}}, 'additionalProperties': False}
generate_photo
Generate AI photos
Generate AI photos from face images, using a preset theme or a custom prompt. Costs 100 credits per photo. Upload the face photos with upload_image first, and find theme slugs with browse_themes. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Schéma d’entrée
{'type': 'object', 'required': ['images', 'gender'], 'properties': {'type': {'enum': ['themed', 'custom'], 'type': 'string', 'description': 'themed uses a preset style, custom uses your prompt'}, 'style': {'type': 'string', 'description': 'Style override, for example "realistic"'}, 'gender': {'enum': ['male', 'female', 'groups', 'pets', 'product'], 'type': 'string', 'description': 'Gender category for theme selection'}, 'images': {'type': 'array', 'items': {'type': 'string'}, 'description': 'CDN URLs of face photos (1-9), from upload_image'}, 'prompt': {'type': 'string', 'description': 'Custom prompt, required when type is custom'}, 'category': {'type': 'string', 'description': 'Theme slug from browse_themes, required when type is themed'}, 'num_images': {'type': 'number', 'description': 'Number of variations to generate (1-4)'}, 'aspect_ratio': {'enum': ['1:1', '2:3', '3:2', '16:9', '9:16'], 'type': 'string', 'description': 'Output aspect ratio'}, 'wait_for_result': {'type': 'boolean', 'description': 'Wait up to 55 seconds for the result before returning. Defaults to false: the tool returns a prediction_id immediately and you poll get_prediction, which is the reliable pattern for photos and videos.'}}, 'additionalProperties': False}
get_account
Account and credit balance
Get the connected Photo AI Studio account: credit balance, total predictions, and membership date. Check this before generating, because every photo costs credits. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_api_capabilities
API capabilities
Explain how an agent actually calls Photo AI Studio: connecting over MCP, the unauthenticated discovery endpoints, the REST fulfillment API, and how to buy credits.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_prediction
Check an operation
Check an operation started by generate_photo, edit_image, or create_video. Returns the state and, once finished, the result URL. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['prediction_id'], 'properties': {'prediction_id': {'type': 'string', 'description': 'The prediction_id returned when the operation started'}}, 'additionalProperties': False}
get_pricing
Get pricing
Get Photo AI Studio credit-package and subscription pricing, plus the credit cost per generated photo.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_service_overview
Service overview
Get an overview of Photo AI Studio: what it does, when to use it, best-fit use cases, and the key links agents need (llms.txt content).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_photo_themes
List photo themes
List Photo AI Studio photo theme categories (professional headshots, dating, wedding, graduation, and many more) with the URL of each category page.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_predictions
List past operations
List past generations, edits, and videos, with paging and an optional state filter. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'page': {'type': 'number', 'description': 'Page number, default 1'}, 'limit': {'type': 'number', 'description': 'Items per page, default 20, maximum 100'}, 'state': {'enum': ['pending', 'succeeded', 'failed'], 'type': 'string', 'description': 'Filter by state'}}, 'additionalProperties': False}
upload_image
Upload an image
Upload an image to the Photo AI Studio CDN and get back a URL. generate_photo, edit_image, and create_video all take CDN URLs, so start here. Accepts a public image URL or base64 data, up to 10 MB. Requires a connected Photo AI Studio account. Calling this tool starts the sign-in flow.
Accès externe
Schéma d’entrée
{'type': 'object', 'properties': {'image_url': {'type': 'string', 'description': 'Public URL of the image to upload'}, 'image_base64': {'type': 'string', 'description': 'Base64-encoded image data, raw or as a data URI. Use this when the image is not already on the web.'}}, 'additionalProperties': False}
Ajouté
list_predictions
17 September 2026 12:36
Ajouté
get_prediction
17 September 2026 12:36
Ajouté
create_video
17 September 2026 12:36
Ajouté
edit_image
17 September 2026 12:36
Ajouté
generate_photo
17 September 2026 12:36
Ajouté
upload_image
17 September 2026 12:36
Ajouté
browse_themes
17 September 2026 12:36
Ajouté
get_account
17 September 2026 12:36
Ajouté
get_api_capabilities
17 September 2026 12:36
Ajouté
get_service_overview
17 September 2026 12:36
Ajouté
get_pricing
17 September 2026 12:36
Ajouté
list_photo_themes
17 September 2026 12:36