Skip to main content
Glama
Hermoso

Hermoso

Official

Run autopilot now / approve its drafts

run_post_refill
Destructive

Preview, trigger, or review autoposting now: generate post previews, render and schedule drafts, or approve, edit, discard, and note batch changes before publishing.

Instructions

Run AUTOPILOT POSTING (autoposting, paid plans only) NOW instead of waiting for its daily turn, or review the drafts it made: schedule them, delete one, change a caption, or save a note such as "too salesy". By default it is a preview: it returns the posts it WOULD make — each new picture’s scene, the caption, the channels and the price — rendering nothing and queueing nothing. The preview still WRITES the scenes and copy with a model, which bills its model cost (the reply says exactly how many credits). dryRun:false actually renders a fresh image or video for each post within the budget (credits are spent) and then, by mode, schedules them ("auto") or keeps them as drafts ("review"). It never re-posts the Library. REVIEWING A BATCH: pass approve (draft ids, or ["all"]) to schedule drafts, discard to delete them, edit ([{id, message?, captions?, title?, at?, channels?}]) to change one first (a new at reschedules it); get_post_refill lists them. learn saves notes future batches follow (free). redo remakes ONE draft from a note and is paid; without confirm:true it returns only the price. A scheduled post can still be pulled before it goes out with cancel_scheduled. Every caption is screened against the voice rules and a failing one is dropped, so a plan can come back shorter than the cadence — the reason is in the notes.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

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

Input Schema

NameRequiredDescriptionDefault
editNoREVIEW: change drafts before approving them. Edited copy is screened by the voice rules.
redoNoremake one draft from feedback; paid, so without confirm:true it returns only the price
forceNoplan a preview even while autoposting is switched off — useful for showing someone what it would do before they turn it on.
learnNonotes for future batches, e.g. "too salesy". Free.
dryRunNodefault TRUE (a preview: nothing rendered, nothing queued; the copy it writes bills its model cost). false renders fresh creative and schedules or drafts it per the mode.
approveNoREVIEW: draft ids to schedule, or ["all"]. A draft whose time has passed moves to the next free posting slot.
discardNoREVIEW: draft ids to delete, or ["all"]. Nothing is posted for them.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.1.484
    • changedInput schema / properties / dryRun / description
      Previous value: -"default TRUE (a preview: nothing rendered, nothing queued; the copy it writes bills a few credits). false renders fresh creative and schedules or drafts it per the mode."New value: +"default TRUE (a preview: nothing rendered, nothing queued; the copy it writes bills its model cost). false renders fresh creative and schedules or drafts it per the mode."
  2. Changed7 schema fields changedv0.1.465
    • addedInput schema / properties / edit / items / properties / captions / description
      Added value: +"per-channel caption overrides for the draft, e.g. {instagram: ...}"
    • addedInput schema / properties / edit / items / properties / id / description
      Added value: +"draft id to change, from get_post_refill"
    • addedInput schema / properties / edit / items / properties / message / description
      Added value: +"replacement caption for the draft"
    • addedInput schema / properties / edit / items / properties / title / description
      Added value: +"Pinterest or YouTube headline for the draft"
    • addedInput schema / properties / redo / description
      Added value: +"remake one draft from feedback; paid, so without confirm:true it returns only the price"
    • addedInput schema / properties / redo / properties / feedback / description
      Added value: +"what to change, e.g. too salesy; saved for later batches when remember is on"
    • addedInput schema / properties / redo / properties / id / description
      Added value: +"draft id to remake, from get_post_refill"
  3. Changed7 schema fields changedv0.1.398
    • addedInput schema / properties / approve
      Added value: +{
      +  "description": "REVIEW: draft ids to schedule, or [\"all\"]. A draft whose time has passed moves to the next free posting slot.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / discard
      Added value: +{
      +  "description": "REVIEW: draft ids to delete, or [\"all\"]. Nothing is posted for them.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / dryRun / description
      Previous value: -"default TRUE (preview only). false actually queues the posts."New value: +"default TRUE (a preview: nothing rendered, nothing queued; the copy it writes bills a few credits). false renders fresh creative and schedules or drafts it per the mode."
    • addedInput schema / properties / edit
      Added value: +{
      +  "description": "REVIEW: change drafts before approving them. Edited copy is screened by the voice rules.",
      +  "items": {
      +    "properties": {
      +      "at": {
      +        "description": "ISO time, at least 5 minutes ahead",
      +        "type": "string"
      +      },
      +      "captions": {
      +        "additionalProperties": {
      +          "type": "string"
      +        },
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      },
      +      "channels": {
      +        "description": "narrow to some of the draft’s own channels",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / force / description
      Previous value: -"plan even while the refill is switched off — useful for showing someone what it would do before they turn it on. Combined with dryRun:false it still respects a stored dryRun."New value: +"plan a preview even while autoposting is switched off — useful for showing someone what it would do before they turn it on."
    • addedInput schema / properties / learn
      Added value: +{
      +  "description": "notes for future batches, e.g. \"too salesy\". Free.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / redo
      Added value: +{
      +  "properties": {
      +    "change": {
      +      "description": "caption keeps the picture",
      +      "enum": [
      +        "both",
      +        "caption",
      +        "picture"
      +      ],
      +      "type": "string"
      +    },
      +    "confirm": {
      +      "description": "omit for the price only",
      +      "type": "boolean"
      +    },
      +    "feedback": {
      +      "type": "string"
      +    },
      +    "id": {
      +      "type": "string"
      +    },
      +    "remember": {
      +      "description": "save the note too (default true)",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "id"
      +  ],
      +  "type": "object"
      +}
  4. Addedv0.1.161

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already declare destructive=true and openWorld=true, but the description adds the costly, non-obvious behaviors: the preview still writes scenes and copy with a model and bills credits, dryRun:false spends credits to render creative, redo is paid and returns only a price without confirm:true, learn is free, the Library is never re-posted, and captions failing voice rules are silently dropped so a plan can come back shorter than cadence. That is precisely the context annotations cannot convey.

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?

The default-is-a-preview fact is front-loaded and every sentence carries operational weight, including cost and failure modes. It is a dense single block with heavy capitalization and mid-sentence branching, so an agent must parse carefully, but there is little true redundancy to cut.

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

Completeness5/5

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

For a seven-parameter, nested-object, paid and destructive tool with no output schema, the description covers cost, default behavior, mode branching, each review action, and the failure mode of dropped captions. It even sketches the preview's return contents (scene, caption, channels, price) and states that credit counts appear in the reply, leaving little an agent needs to guess.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, and the description earns the bump by explaining semantics the schema does not: dryRun defaults to true as a cost-incurring preview, approve accepts ["all"], edit's `at` reschedules the draft, and redo's confirm gates payment. The `force` parameter is the one notable gap, since its behavior is only explained in the schema.

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 description states a specific verb+resource+scope: run autopilot posting now, or review/approve the drafts it produced. It enumerates the review sub-actions (schedule, delete, edit caption, save note) and names the sibling that lists drafts (get_post_refill), so an agent can distinguish it from get_post_refill and set_post_refill without opening a schema.

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

Usage Guidelines5/5

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

It explicitly defines the default path as a preview, the condition that selects the real path (dryRun:false plus mode "auto" vs "review"), and routes review work to approve/discard/edit/learn/redo with the exact argument shapes. It also names alternatives for adjacent needs: get_post_refill for listing drafts and cancel_scheduled for pulling a scheduled post once this tool has already left it queued.

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

Deploy Server

Other Tools