Tools Reference

The Qamera AI MCP server exposes 17 tools organized into 6 categories. Each tool can be called by your AI assistant to interact with the Qamera AI platform.

Products

get_products

List uploaded products (images) in your workspace.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of product objects with IDs, names, and image URLs.

Models & Sceneries

get_models

List AI-generated models (mannequins) available in your workspace.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of model objects with IDs, names, and preview images.

get_sceneries

List AI-generated backgrounds available in your workspace.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of scenery objects with IDs, names, and preview images.

register_models

Generate new AI models (mannequins).

Parameters:

• prompt (string) — Description of the model to generate
• count (number, optional) — Number of models to generate

Returns: Confirmation with generation job details.

register_sceneries

Generate new AI backgrounds.

Parameters:

• prompt (string) — Description of the scenery to generate
• count (number, optional) — Number of sceneries to generate

Returns: Confirmation with generation job details.

Photo Shoots

get_images

List generated images from photo shoots.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of photo shoot images with IDs, preview URLs, and metadata.

register_photo_shoot

Create a new AI photo shoot combining a product, model, and scenery.

Parameters:

• product_id (string) — ID of the product to photograph
• model_id (string, optional) — ID of the AI model to use
• scenery_id (string, optional) — ID of the background scenery
• preset_id (string, optional) — ID of a preset to apply

Returns: Confirmation with photo shoot job details.

Packshots

get_packshots

List generated packshots in your workspace.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of packshot objects with IDs, status, and preview URLs.

get_packshot_preview

Preview a specific packshot with the actual image. This is a unique tool — it returns the generated image directly, allowing your AI assistant to see and analyze the packshot visually.

Parameters:

• packshot_id (string) — ID of the packshot to preview

Returns: The packshot image along with metadata. Your AI can describe the image, evaluate quality, and suggest improvements.

register_packshots

Generate new packshots for a product.

Parameters:

• product_id (string) — ID of the product
• preset_id (string, optional) — ID of a preset to apply
• count (number, optional) — Number of packshots to generate

Returns: Confirmation with generation job details.

update_packshot

Update a packshot's status (approve, reject, or archive).

Parameters:

• packshot_id (string) — ID of the packshot to update
• status (string) — New status: approved, rejected, or archived

Returns: Updated packshot object.

Videos

get_videos

List generated videos in your workspace.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of video objects with IDs, status, and preview URLs.

register_video

Generate a video from a single image.

Parameters:

• image_id (string) — ID of the source image
• preset_id (string, optional) — ID of a preset to apply

Returns: Confirmation with video generation job details.

register_reel

Create a reel or short video from multiple images.

Parameters:

• image_ids (array of strings) — IDs of source images to combine
• preset_id (string, optional) — ID of a preset to apply

Returns: Confirmation with reel generation job details.

Presets

get_presets

List available presets. Presets are shared across accounts and include both system presets and user-created presets.

Parameters:

• page (number, optional) — Page number for pagination
• per_page (number, optional) — Items per page

Returns: A list of preset objects with IDs, names, and configurations.

create_preset

Create a new account-owned user preset.

Parameters:

• name (string) — Name for the preset
• configuration (object) — Preset configuration settings

Returns: Created preset object.

Note: In hosted HTTP mode, file uploads are disabled for safety. In local STDIO mode, you can attach files using file:// links or local paths.

update_preset

Update an existing account-owned user preset.

Parameters:

• preset_id (string) — ID of the preset to update
• name (string, optional) — New name
• configuration (object, optional) — Updated configuration

Returns: Updated preset object.

Note: You can only update presets owned by your account, not system presets.