Skip to main content
Glama

Save Hook Demo Draft

reelsfarm_save_draft
Destructive

Create or update a Hook/Demo builder draft. The described operation can have destructive or irreversible effects, including overwriting saved data.

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": {
      "hookUrl": "<hookUrl>"
    },
    "name": "reelsfarm_save_draft"
  }
}

Input Schema

NameRequiredDescriptionDefault
idNoID of the ReelsFarm item.
partsNoOrdered video parts used to assemble the UGC video. Each part must provide exactly one videoId or videoUrl.
demoIdNoUUID of an existing user-owned ReelsFarm demo video.
dryRunNoValidate only: nothing is saved, charged or queued.
hookIdNoUUID of an existing ReelsFarm hook video.
captionNoCaption text. Omit it for no caption.
demoUrlNoPublic HTTPS URL or authorized ReelsFarm URL of the demo video.
hookUrlYesPublic HTTPS URL or authorized ReelsFarm URL of the hook video.
hookTypeNoHook origin classification: generated, uploaded, or template.
musicUrlNoPublic HTTPS URL or authorized ReelsFarm URL of the selected music track.
musicNameNoHuman-readable name of the selected ReelsFarm music track.
musicTypeNoMusic source or selection type used by the video composition.
hookThumbUrlNoPublic HTTPS URL or authorized ReelsFarm URL of the hook thumbnail.
textPositionNoVertical position of the caption or slideshow text.
idempotencyKeyNoStable key for this action, reused only on retries. Required in Creator and Autopilot.

Output Schema

NameRequiredDescriptionDefault
draftNoCanonical saved ReelsFarm draft returned by the operation.
dryRunNoValidate only: nothing is saved, charged or queued.
summaryNoShort explanation of the changes made by a slideshow revision.
executedNoTrue when ReelsFarm executed the action instead of preparing a confirmation.
nextStepNoShort instruction for continuing the prepared workflow.
providerNoService that executed or prepared this action. A value of reelsfarm is required before attributing a result to ReelsFarm.
toolNameNoExact public MCP tool associated with this prepared action or result.
expiresAtNoISO 8601 date and time when this prepared action expires.
operationNoDurable MCP operation state and result data.
actionTypeNoStable ReelsFarm action category used for policy and operation tracking.
policyCodeNoStable code that explains the server authorization decision.
sourceToolNoPublic ReelsFarm MCP tool responsible for this execution state.
operationIdNoUUID of the ReelsFarm MCP operation to inspect.
assetCreatedNoTrue only when this response contains a completed media asset created by ReelsFarm.
resultMessageNoHuman-readable rule for accurately presenting this ReelsFarm result.
confirmationIdNoShort-lived ReelsFarm confirmation identifier returned by a prepared action.
connectionModeNoEffective Review, Creator, or Autopilot mode for this action.
creditEstimateNoEstimated credit cost, or null when the cost cannot be fixed in advance.
executionStateNoAuthoritative ReelsFarm execution state. Only COMPLETED can support a completion claim.
policyDecisionNoServer authorization decision applied to this action.
confirmationToolNoThe public tool that confirms only this prepared operation after explicit user approval.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / parts / items / properties / caption / description
      Previous value: -"Caption text. Omit it for no caption."New value: +"Short form of one text item in the default look (white letters, black outline). Ignored when textItems is set."
    • addedInput schema / properties / parts / items / properties / textItems
      Added value: +{
      +  "description": "Text drawn on this part with the slideshow text engine, the same fields as slideshow text items: TikTok font (textFont), mode (textEffect: none, outline, background, translucent), colour (textColor), fontSize (10px to 32px, default 14px), slot (textPosition) or point (textX, textY), and lineWidthEm. Only text is required. Use \\n for a line break; emoji are drawn. An empty list draws no text.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "fontSize": {
      +        "description": "CSS pixel font size used to render the slideshow text.",
      +        "enum": [
      +          "10px",
      +          "12px",
      +          "14px",
      +          "16px",
      +          "18px",
      +          "20px",
      +          "24px",
      +          "28px",
      +          "32px"
      +        ],
      +        "type": "string"
      +      },
      +      "fontWeight": {
      +        "anyOf": [
      +          {
      +            "const": 500,
      +            "type": "number"
      +          },
      +          {
      +            "const": 700,
      +            "type": "number"
      +          }
      +        ],
      +        "description": "Numeric font weight. Use 500 for medium text or 700 for bold text."
      +      },
      +      "id": {
      +        "description": "ID of the ReelsFarm item.",
      +        "maxLength": 100,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "lineWidthEm": {
      +        "description": "Longest line in em (multiples of the font size), from 4 to 40. Omit it: the width then follows the text. Set it only to copy a reference slideshow.",
      +        "maximum": 40,
      +        "minimum": 4,
      +        "type": "number"
      +      },
      +      "text": {
      +        "description": "Text rendered on the slideshow or used by the content workflow.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "textAlign": {
      +        "description": "Horizontal alignment of the slideshow text.",
      +        "enum": [
      +          "left",
      +          "center",
      +          "right"
      +        ],
      +        "type": "string"
      +      },
      +      "textColor": {
      +        "description": "Hex colour such as #ea403f: the text colour for none, the outline colour for outline, the box colour otherwise.",
      +        "pattern": "^#[0-9a-f]{6}$",
      +        "type": "string"
      +      },
      +      "textEffect": {
      +        "description": "TikTok text mode: none, outline, background or translucent. When set, it and textColor replace textStyle.",
      +        "enum": [
      +          "none",
      +          "outline",
      +          "background",
      +          "translucent"
      +        ],
      +        "type": "string"
      +      },
      +      "textFont": {
      +        "description": "TikTok text font, such as classic, elegance, retro, typewriter, neon or handwriting. Omit it for Classic.",
      +        "enum": [
      +          "classic",
      +          "elegance",
      +          "retro",
      +          "vintage",
      +          "typewriter",
      +          "comic",
      +          "bold",
      +          "serif",
      +          "neon",
      +          "handwriting",
      +          "freehand",
      +          "heavy",
      +          "luxury",
      +          "arcade",
      +          "curiouscat",
      +          "oblique",
      +          "serene",
      +          "telegraph",
      +          "paintstroke",
      +          "slab",
      +          "phantom",
      +          "postcard",
      +          "script",
      +          "technic"
      +        ],
      +        "type": "string"
      +      },
      +      "textPosition": {
      +        "description": "Vertical position of the caption or slideshow text.",
      +        "enum": [
      +          "top",
      +          "middle",
      +          "bottom"
      +        ],
      +        "type": "string"
      +      },
      +      "textStyle": {
      +        "description": "ReelsFarm visual style applied to the slideshow text.",
      +        "enum": [
      +          "outline",
      +          "solid",
      +          "shadow",
      +          "neon",
      +          "tiktok",
      +          "white",
      +          "black",
      +          "yellow",
      +          "pink",
      +          "whiteBubble",
      +          "blackBubble"
      +        ],
      +        "type": "string"
      +      },
      +      "textTransform": {
      +        "description": "Text casing rule. Use uppercase or none.",
      +        "enum": [
      +          "uppercase",
      +          "none"
      +        ],
      +        "type": "string"
      +      },
      +      "textX": {
      +        "description": "Optional exact position: the horizontal centre of the text column, from 0 (left edge) to 1 (right edge). Only used with textY; 0.5 when omitted.",
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "textY": {
      +        "description": "Optional exact position: the vertical centre of the text column, from 0 (top) to 1 (bottom). When set it replaces textPosition. Items with the same textX and textY stack in one column.",
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "text"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 6,
      +  "type": "array"
      +}
    • changedInput schema / properties / parts / items / properties / textPosition / description
      Previous value: -"Vertical position of the caption or slideshow text."New value: +"Slot for caption. Ignored when textItems is set."
  2. Changed12 schema fields changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • changedInput schema / properties / caption / description
      Previous value: -"Social caption or video-part caption text. Omit it when no caption is required."New value: +"Caption text. Omit it for no caption."
    • changedInput schema / properties / dryRun / description
      Previous value: -"When true, validate and describe the action without creating an operation, confirmation, job, charge, or domain mutation."New value: +"Validate only: nothing is saved, charged or queued."
    • changedInput schema / properties / id / description
      Previous value: -"UUID or stable ReelsFarm identifier of the resource used by this operation."New value: +"ID of the ReelsFarm item."
    • changedInput schema / properties / idempotencyKey / description
      Previous value: -"Stable key for this logical mutation. Required in Creator and Autopilot; reuse it across retries."New value: +"Stable key for this action, reused only on retries. Required in Creator and Autopilot."
    • changedInput schema / properties / parts / items / properties / caption / description
      Previous value: -"Social caption or video-part caption text. Omit it when no caption is required."New value: +"Caption text. Omit it for no caption."
    • changedInput schema / properties / parts / items / properties / id / description
      Previous value: -"UUID or stable ReelsFarm identifier of the resource used by this operation."New value: +"ID of the ReelsFarm item."
    • changedInput schema / properties / parts / items / properties / name / description
      Previous value: -"Human-readable name for the ReelsFarm resource."New value: +"Display name."
    • changedInput schema / properties / parts / items / properties / thumbnailUrl / description
      Previous value: -"Public HTTPS URL or authorized ReelsFarm URL of the thumbnail image."New value: +"Thumbnail image URL."
    • removedInput schema / properties / parts / items / properties / videoId / pattern
      Removed value: -"^([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)$"
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / properties / dryRun / description
      Previous value: -"When true, validate and describe the action without changing data or spending credits."New value: +"Validate only: nothing is saved, charged or queued."
  3. First observed

TDQS

B3.1/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true, readOnlyHint=false and idempotentHint=false, and the description largely restates that with 'destructive or irreversible effects.' It does add one concrete detail beyond the booleans, namely that saved data can be overwritten by an update, which is meaningful for a create-or-update tool. It omits other behavioral facts the schema hints at, such as charging/queueing behavior and idempotency key requirements.

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?

Two short sentences, front-loaded with the operation, with no filler or repetition. The second sentence is generic boilerplate but is at least brief and placed after the essential information.

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

Completeness2/5

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

This is a complex, destructive, 15-parameter upsert with an output schema, yet the description is two generic sentences. It never mentions the dryRun probe, the idempotency key requirement, the likely credit consumption, or the confirm-step sibling that its name implies; an agent would have to read the full schema to call it safely.

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 100% across 15 parameters, so the schema itself documents hookUrl, dryRun, idempotencyKey and the rest. The description adds no parameter meaning beyond 'create or update,' leaving it at the baseline for fully documented schemas.

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 pair and resource: 'Create or update a Hook/Demo builder draft.' That is clear enough to distinguish a draft-writing tool from read or generate tools. It stops short of differentiating itself from the near-identical sibling reelsfarm_confirm_save_draft, so an agent cannot tell whether this call commits or merely stages the draft.

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 when-to-use guidance at all: no mention of when to prefer this over reelsfarm_confirm_save_draft, no mention of when to use the dryRun validation path, and no preconditions such as required ids or credits. The only guidance is a generic warning that the operation may be destructive, which does not tell an agent when to select the tool.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources