Clipwright

Quote a personal actor

quote_actor

Read-only

Preview actor creation costs before spending credits, including per-format pricing and free validation of own-image portraits for 9:16 framing and one-face checks.

Instructions

Price create_actor WITHOUT spending credits. Each format is a charged image, except a portrait from your own image, which costs nothing. A portrait not within 2% of 9:16 is refused here; one without exactly one well-framed face fails at no charge.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>"
    },
    "name": "quote_actor"
  }
}

Input Schema

Name	Required	Description	Default
`name`	Yes
`gender`	No
`framing`	No
`holding`	No
`quality`	No	medium (default) or high; the price per image depends on it.	medium
`setting`	No
`portrait`	No
`description`	No	Words describing a fictional adult; with from_actor_id, the view's look, clothing and pose. A real person or a likeness to one is refused before any charge (actor_prompt_refused).
`aspect_ratios`	No	Always includes 9:16; a format that fails the identity check is not charged.
`from_actor_id`	No
`approximate_age`	No
`style_reference`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed24 schema fields changedv0.45.0Nov 7, 2026

addedInput schema / $defs

Added value: +{
+  "d0": {
+    "properties": {
+      "asset_id": {
+        "pattern": "^ast_[a-f0-9]{32}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "asset_id"
+    ],
+    "type": "object"
+  }
+}

removedInput schema / properties / approximate_age / description

Removed value: -"Approximate age in years, 18 to 90: actors are adults. Required unless from_actor_id is given."

changedInput schema / properties / aspect_ratios / description

Previous value: -"Formats to create: 9:16 | 1:1 | 16:9, always including 9:16. Omitted means all three."New value: +"Always includes 9:16; a format that fails the identity check is not charged."

changedInput schema / properties / description / description

Previous value: -"Words describing a fictional adult: appearance, clothing, setting."New value: +"Words describing a fictional adult; with from_actor_id, the view's look, clothing and pose. A real person or a likeness to one is refused before any charge (actor_prompt_refused)."

changedInput schema / properties / description / maxLength
```
Previous value: -500New value: +2000
```

removedInput schema / properties / framing / description

Removed value: -"wide: the camera further back, the head lower with room above; make_ugc then renders it as a wide view."

changedInput schema / properties / framing / enum

Previous value: -[
-  "wide"
-]New value: +[
+  "close",
+  "wide",
+  "full"
+]

removedInput schema / properties / from_actor_id / description

Removed value: -"Derive a new personal actor from this one (a library actor or your own): the same face, gender and age, with the view changed by framing, holding or setting."

removedInput schema / properties / gender / description

Removed value: -"female | male. Fixes the actor's gender and the default voice of videos with this actor. Required unless from_actor_id is given."

removedInput schema / properties / holding / description

Removed value: -"Up to 2 objects the presenter holds, one per hand."

removedInput schema / properties / holding / items / properties / description / description
```
Removed value: -"The object, e.g. \"a white coffee mug\"."
```
changedInput schema / properties / holding / items / properties / description / maxLength
```
Previous value: -200New value: +1000
```
removedInput schema / properties / holding / items / properties / hand / description
```
Removed value: -"left | right; omitted lets the edit choose."
```
addedInput schema / properties / holding / items / properties / reference / $ref
```
Added value: +"#/$defs/d0"
```
removedInput schema / properties / holding / items / properties / reference / description
```
Removed value: -"A PNG or JPEG picture of the object: an image asset of this…"
```

removedInput schema / properties / holding / items / properties / reference / properties

Removed value: -{
-  "asset_id": {
-    "pattern": "^ast_[a-f0-9]{32}$",
-    "type": "string"
-  }
-}

removedInput schema / properties / holding / items / properties / reference / required
```
Removed value: -[
-  "asset_id"
-]
```
removedInput schema / properties / holding / items / properties / reference / type
```
Removed value: -"object"
```
removedInput schema / properties / name / description
```
Removed value: -"Name shown in list_actors."
```

addedInput schema / properties / portrait

Added value: +{
+  "$ref": "#/$defs/d0"
+}

changedInput schema / properties / quality / description

Previous value: -"Image quality: medium | high. Omitted means medium. The price per image depends on it; quote shows it before any charge."New value: +"medium (default) or high; the price per image depends on it."

removedInput schema / properties / setting / description

Removed value: -"The room or background to put the presenter in, in words."

changedInput schema / properties / setting / maxLength
```
Previous value: -300New value: +2000
```
addedInput schema / properties / style_reference
```
Added value: +{
+  "$ref": "#/$defs/d0"
+}
```

Changed7 schema fields changedv0.39.0Nov 3, 2026

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

changedInput schema / properties / aspect_ratios / description

Previous value: -"Formats to create: 9:16 | 1:1 | 16:9, always including 9:16. Omitted means all three. Formats that fail the identity check are not charged and are named in warnings."New value: +"Formats to create: 9:16 | 1:1 | 16:9, always including 9:16. Omitted means all three."

changedInput schema / properties / description / description

Previous value: -"Words describing a fictional adult: appearance, clothing, setting. Naming a real person or a likeness to one is refused before any charge (actor_prompt_refused). Required unless from_actor_id is given."New value: +"Words describing a fictional adult: appearance, clothing, setting."

changedInput schema / properties / from_actor_id / description

Previous value: -"Derive a new personal actor from this one (a library actor or your own): the same face, gender and age, with the view changed by framing, holding or setting. Omit description, gender and approximate_age."New value: +"Derive a new personal actor from this one (a library actor or your own): the same face, gender and age, with the view changed by framing, holding or setting."

removedInput schema / properties / holding / items / additionalProperties
```
Removed value: -false
```
removedInput schema / properties / holding / items / properties / reference / additionalProperties
```
Removed value: -false
```

changedInput schema / properties / holding / items / properties / reference / description

Previous value: -"A PNG or JPEG picture of the object: an image asset of this account (upload, URL import or a found picture, rights_confirmed)."New value: +"A PNG or JPEG picture of the object: an image asset of this…"

Changed8 schema fields changedv0.35.0Oct 30, 2026

changedInput schema / properties / approximate_age / description

Previous value: -"Approximate age in years, 18 to 90: actors are adults."New value: +"Approximate age in years, 18 to 90: actors are adults. Required unless from_actor_id is given."

changedInput schema / properties / description / description

Previous value: -"Words describing a fictional adult: appearance, clothing, setting. Naming a real person or a likeness to one is refused before any charge (actor_prompt_refused)."New value: +"Words describing a fictional adult: appearance, clothing, setting. Naming a real person or a likeness to one is refused before any charge (actor_prompt_refused). Required unless from_actor_id is given."

addedInput schema / properties / framing

Added value: +{
+  "description": "wide: the camera further back, the head lower with room above; make_ugc then renders it as a wide view.",
+  "enum": [
+    "wide"
+  ],
+  "type": "string"
+}

addedInput schema / properties / from_actor_id

Added value: +{
+  "description": "Derive a new personal actor from this one (a library actor or your own): the same face, gender and age, with the view changed by framing, holding or setting. Omit description, gender and approximate_age.",
+  "pattern": "^actor_[a-z0-9][a-z0-9_-]{0,63}$",
+  "type": "string"
+}

changedInput schema / properties / gender / description

Previous value: -"female | male. Fixes the actor's gender and the default voice of videos with this actor."New value: +"female | male. Fixes the actor's gender and the default voice of videos with this actor. Required unless from_actor_id is given."

addedInput schema / properties / holding

Added value: +{
+  "description": "Up to 2 objects the presenter holds, one per hand.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "description": "The object, e.g. \"a white coffee mug\".",
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "hand": {
+        "description": "left | right; omitted lets the edit choose.",
+        "enum": [
+          "left",
+          "right"
+        ],
+        "type": "string"
+      },
+      "reference": {
+        "additionalProperties": false,
+        "description": "A PNG or JPEG picture of the object: an image asset of this account (upload, URL import or a found picture, rights_confirmed).",
+        "properties": {
+          "asset_id": {
+            "pattern": "^ast_[a-f0-9]{32}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "asset_id"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "description"
+    ],
+    "type": "object"
+  },
+  "maxItems": 2,
+  "minItems": 1,
+  "type": "array"
+}

addedInput schema / properties / setting

Added value: +{
+  "description": "The room or background to put the presenter in, in words.",
+  "maxLength": 300,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "description",
-  "gender",
-  "approximate_age",
-  "name"
-]New value: +[
+  "name"
+]

First observedv0.20.0Sep 25, 2026

TDQS

A4/5.0

Behavior4/5

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

Annotations declare readOnlyHint=true and destructiveHint=false, and the description is consistent with that, reinforcing 'WITHOUT spending credits'. It goes well beyond the annotations by disclosing the charging model (each format is a charged image, portrait from your own image is free), the hard refusal rule (portrait outside 2% of 9:16), and that face-detection failures cost nothing.

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

Conciseness4/5

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

Three dense sentences, front-loaded with the cost-free promise and then the two refusal rules. Nothing is filler, though 'Each format is a charged image' is compressed enough to require a second read to map onto the aspect_ratios parameter.

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?

For a 12-parameter pricing tool with no output schema, the description covers the risk/cost semantics well but never says what the quote actually returns (total price, per-format breakdown, per-quality difference), and it leaves most parameters unexplained. An agent can decide to call it, but not fully predict the response or the parameter set.

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

Parameters3/5

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

Schema description coverage is only 25%, so nine of twelve parameters are undocumented in structured fields. The description partially compensates by explaining the cost behavior of 'portrait' and the 9:16 constraint tied to 'aspect_ratios', but it says nothing about name, gender, framing, holding, setting, from_actor_id, approximate_age, or style_reference.

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

Purpose5/5

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

The first clause names the verb and the exact sibling it prices ('Price create_actor'), which immediately distinguishes it from create_actor and the other quote_* tools. It also states the key economic difference: no credits are spent.

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

Usage Guidelines4/5

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

Usage is clearly implied: call this before paying for create_actor, and expect zero charge. It does not explicitly exclude other quote siblings (quote_image, quote_ugc) or say what to do with the returned price, so the routing guidance is strong but not exhaustive.

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

Deploy Server

Quote a personal actor

Instructions

Tool call template

Input Schema

Schema Changelog

TDQS

Other Tools