BlitzReels Video Editor

Carousel save theme

carousels_save_theme

DestructiveIdempotent

Save and activate the current carousel styling as a private theme; removes the oldest saved theme when the 40-theme limit is reached.

Input Schema

Name	Required	Description
`name`	Yes
`scope`	No
`projectId`	Yes	UUID string.
`workspaceId`	No
`idempotencyKey`	Yes

Output Schema

Name	Required	Description	Default
`kit`	No
`name`	No
`frame`	No
`style`	No
`locale`	No
`slides`	No
`can_undo`	No
`platform`	No
`revision`	No
`warnings`	No
`templates`	No
`font_faces`	No
`project_id`	No
`next_actions`	No
`mutationReceipt`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedOct 18, 2026

addedOutput schema / properties / font_faces

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "family": {
+        "maxLength": 160,
+        "minLength": 1,
+        "type": "string"
+      },
+      "src": {
+        "maxLength": 4000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "style": {
+        "enum": [
+          "normal",
+          "italic",
+          "oblique"
+        ],
+        "type": "string"
+      },
+      "unicodeRange": {
+        "maxLength": 8000,
+        "type": "string"
+      },
+      "weight": {
+        "maxLength": 32,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "family",
+      "src",
+      "weight",
+      "style",
+      "unicodeRange"
+    ],
+    "type": "object"
+  },
+  "maxItems": 256,
+  "type": "array"
+}

addedOutput schema / properties / slides / items / properties / visual / properties / creative_artifact_id

Added value: +{
+  "format": "uuid",
+  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+  "type": "string"
+}

addedOutput schema / properties / slides / items / properties / visual / properties / creative_source

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "artifact_id": {
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "composition_id": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "controls": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "fields": {
+              "items": {
+                "oneOf": [
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "key": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
+                        "type": "string"
+                      },
+                      "label": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "maxLength": {
+                        "maximum": 10000,
+                        "minimum": 1,
+                        "type": "integer"
+                      },
+                      "type": {
+                        "const": "text",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "key",
+                      "label",
+                      "type",
+                      "maxLength"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "key": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
+                        "type": "string"
+                      },
+                      "label": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "type": {
+                        "const": "color",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "key",
+                      "label",
+                      "type"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "key": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
+                        "type": "string"
+                      },
+                      "label": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "type": {
+                        "const": "media",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "key",
+                      "label",
+                      "type"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "key": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
+                        "type": "string"
+                      },
+                      "label": {
+                        "maxLength": 120,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "max": {
+                        "maximum": 10800,
+                        "type": "number"
+                      },
+                      "min": {
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      "step": {
+                        "exclusiveMinimum": 0,
+                        "type": "number"
+                      },
+                      "type": {
+                        "const": "timing",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "key",
+                      "label",
+                      "type",
+                      "min",
+                      "max",
+                      "step"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              },
+              "maxItems": 40,
+              "minItems": 1,
+              "type": "array"
+            },
+            "file": {
+              "format": "ends_with",
+              "maxLength": 180,
+              "minLength": 1,
+              "pattern": ".*\\.json$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "file",
+            "fields"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "fps": {
+      "exclusiveMinimum": 0,
+      "type": "number"
+    },
+    "frame": {
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "frame_hash": {
+      "pattern": "^[a-f0-9]{64}$",
+      "type": "string"
+    },
+    "height": {
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    },
+    "media_asset_id": {
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "project_id": {
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "runtime_identity": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "source_hash": {
+      "pattern": "^[a-f0-9]{64}$",
+      "type": "string"
+    },
+    "source_revision": {
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    },
+    "source_revision_id": {
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "values": {
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "maxLength": 10000,
+            "type": "string"
+          },
+          {
+            "type": "number"
+          }
+        ]
+      },
+      "propertyNames": {
+        "maxLength": 80,
+        "minLength": 1,
+        "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "width": {
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "artifact_id",
+    "project_id",
+    "source_revision_id",
+    "source_revision",
+    "source_hash",
+    "runtime_identity",
+    "composition_id",
+    "frame",
+    "width",
+    "height",
+    "fps",
+    "frame_hash",
+    "media_asset_id",
+    "controls",
+    "values"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / slides / items / properties / visual / properties / crop

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "height": {
+      "exclusiveMinimum": 0,
+      "maximum": 1,
+      "type": "number"
+    },
+    "left": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "top": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "width": {
+      "exclusiveMinimum": 0,
+      "maximum": 1,
+      "type": "number"
+    }
+  },
+  "required": [
+    "left",
+    "top",
+    "width",
+    "height"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / slides / items / properties / visual / properties / kind / enum

Previous value: -[
-  "media_asset",
-  "generate",
-  "solid",
-  "gradient",
-  "html",
-  "template"
-]New value: +[
+  "creative_source",
+  "media_asset",
+  "generate",
+  "solid",
+  "gradient",
+  "html",
+  "template"
+]

AddedOct 15, 2026

TDQS

B3.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and idempotentHint=true, but the description adds real behavior beyond them: the theme is saved as private, it becomes the active theme, and the oldest theme is evicted at the 40-theme cap. That eviction detail is exactly the kind of destruction semantics annotations cannot convey. It still omits permission requirements and what 'activate' changes for other users.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One front-loaded sentence whose two clauses both earn their place: the primary action first, then the retention constraint. No filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and annotations carry the safety profile. However, with five parameters at 20% schema coverage and a mutation that maintains a capped theme library, the description should at least hint at scope/idempotency behavior to be fully actionable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 20% — just 'UUID string.' on projectId — yet the description explains no parameters. The scope enum (project vs brand), workspaceId, idempotencyKey, and name are all left for the agent to infer, so the description fails to compensate for the sparse schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb-plus-resource pair ('save and activate the current carousel styling as a private theme'), which clearly separates it from siblings like carousels_save_template or carousels_apply_theme. It stops short of explicitly contrasting itself with those siblings, so it is clear but not fully differentiated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no statement of when to choose this over carousels_save_template, carousels_apply_theme, or carousels_apply_brand, nor any prerequisite (e.g., that styling must already exist on the carousel). Usage is only inferable from the phrase 'current carousel styling'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All BlitzReels Video Editor tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?