Skip to main content
Glama
Hermoso

Hermoso

Official

Set up, change or pause autopilot posting

set_post_refill
DestructiveIdempotent

Configure autopilot posting: enable, adjust, or pause recurring fresh posts, and choose draft review or auto-scheduling.

Instructions

Turn AUTOPILOT POSTING (autoposting, the posting refill) on, change it or pause it. Available on paid plans: on the Free plan switching it on is refused, so relay that and do not retry. PASS ONLY WHAT CHANGES. It always makes NEW posts (a fresh image, carousel or video for each) and never re-posts the Library. Ask the user for anything missing (goal, mode, channels) rather than guessing. mode picks what happens to each batch: "review" (the default) keeps the fresh posts as drafts until a human approves them (run_post_refill approve), "auto" schedules them straight away. enabled:false is the PAUSE — it removes the recurring job outright, and posts already queued are left alone (cancel those with cancel_scheduled). Full rules: get_instructions({topic:'set_post_refill'}).

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": "set_post_refill"
  }
}

Input Schema

NameRequiredDescriptionDefault
goalNoTHE BRIEF: what the posts are for — grow followers, drive sales, promote a launch, or other (say what in goalNote). Required to switch it on.
modeNo"review" (default): each batch of fresh posts waits as drafts for approval. "auto": fresh posts are scheduled to publish automatically.
avoidNoTHE BRIEF: never mention or show these — topics, claims, competitors, faces.
queueNoa named queue to post at (postingTimes then edit it)
chatIdNoTELEGRAM — which chat, group or channel posts go to (@username or numeric id). Without one, telegram is skipped: there is no default chat and posting to the wrong one is a public mistake.
pageIdNoFACEBOOK / INSTAGRAM / THREADS — which connected Page to publish from (list_meta_pages). Omit for the brand’s only Page.
boardIdNoPINTEREST — which board Pins go on (list_pinterest_boards). Without one, Pinterest is skipped: a Pin on the wrong board is a public mistake, so it is never guessed.
enabledNoon/off. true needs a connected channel and a goal (refused otherwise). false PAUSES it: the recurring job is deleted and nothing new is made. Already-queued posts are untouched.
formatsNoTHE BRIEF: what to make — mix (images with a short video now and then, the default), video (short videos only), carousel (3 new images per post), image.
pillarsNoTHE BRIEF: content pillars / topics, up to 8 short lines. Every post belongs to one. get_post_refill suggests some from the brand profile.
accountsNoaccounts to post to on a channel holding several: {"tiktok":["@a","@b"]} or "all"; null clears. A new setup must pick; an older one posts to the primary until it does.
channelsNoREPLACES the list; a channel connected later stays out until added. "all" = every channel, later ones too, only if the user asks
goalNoteNoTHE BRIEF: a line about the goal (e.g. the launch date and what is launching).
timezoneNoIANA timezone the posting times are in, e.g. "America/New_York" (default: the brand's, else UTC)
daysAheadNohow far ahead to keep the queue full, 1–30 (default 7)
learningsNonotes learned from reviews; REPLACES the list
addChannelsNoadd these
postsPerDayNoposts a day, up to the number of posting times ("2 times a day" = 2). 0 (default) = one per posting time. To post MORE per day than there are posting times, also pass postingTimes.
postingTimesNothe brand's daily posting times, 24-hour "HH:MM" (e.g. ["09:00","13:00","18:00"]); REPLACES the list. Autopilot makes one post per posting time, and scheduled posts use the same times. get_post_refill shows the current ones.
removeChannelsNostop posting here
excludeChannelsNonever these channels, even ones connected later; [] clears
whopExperienceIdNoWHOP — which forum or chat posts go to (exp_…, from list_whop_destinations). Without one, the whop’s only forum or chat is used; with several, whop is skipped rather than guessed.
channelPostsPerDayNoper channel, how many posts a day (the first N of the posting times), e.g. {"x":1,"instagram":3}. 0 turns a channel off; null resets it to every posting time. Merged into what is saved.
forgetCaptionEditsNotrue = forget the caption edits learned from past reviews
linkedinOrganizationIdNoLINKEDIN — which company Page to post as (list_linkedin_pages). A single shared Page is used automatically; a Page that is not shared with this profile is ignored rather than failing the whole post.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.1.571
    • changedInput schema / properties / addChannels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram",
      -  "wordpress",
      -  "discord",
      -  "slack",
      -  "whop"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop",
      +  "shopify_blog",
      +  "webflow",
      +  "wix"
      +]
    • changedInput schema / properties / channels / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "enum": [
      -        "facebook",
      -        "instagram",
      -        "threads",
      -        "tiktok",
      -        "youtube",
      -        "linkedin",
      -        "x",
      -        "pinterest",
      -        "google_business",
      -        "bluesky",
      -        "telegram",
      -        "wordpress",
      -        "discord",
      -        "slack",
      -        "whop"
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "const": "all",
      -    "type": "string"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "enum": [
      +        "facebook",
      +        "instagram",
      +        "threads",
      +        "tiktok",
      +        "youtube",
      +        "linkedin",
      +        "x",
      +        "pinterest",
      +        "google_business",
      +        "bluesky",
      +        "telegram",
      +        "wordpress",
      +        "discord",
      +        "slack",
      +        "whop",
      +        "shopify_blog",
      +        "webflow",
      +        "wix"
      +      ],
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "const": "all",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / excludeChannels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram",
      -  "wordpress",
      -  "discord",
      -  "slack",
      -  "whop"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop",
      +  "shopify_blog",
      +  "webflow",
      +  "wix"
      +]
    • addedInput schema / properties / queue
      Added value: +{
      +  "description": "a named queue to post at (postingTimes then edit it)",
      +  "type": "string"
      +}
    • changedInput schema / properties / removeChannels / items / enum
      Previous value: -[
      -  "facebook",
      -  "instagram",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "linkedin",
      -  "x",
      -  "pinterest",
      -  "google_business",
      -  "bluesky",
      -  "telegram",
      -  "wordpress",
      -  "discord",
      -  "slack",
      -  "whop"
      -]New value: +[
      +  "facebook",
      +  "instagram",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "linkedin",
      +  "x",
      +  "pinterest",
      +  "google_business",
      +  "bluesky",
      +  "telegram",
      +  "wordpress",
      +  "discord",
      +  "slack",
      +  "whop",
      +  "shopify_blog",
      +  "webflow",
      +  "wix"
      +]
  2. Changed9 schema fields changedv0.1.519
    • addedInput schema / properties / accounts
      Added value: +{
      +  "additionalProperties": {
      +    "anyOf": [
      +      {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "const": "all",
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "description": "accounts to post to on a channel holding several: {\"tiktok\":[\"@a\",\"@b\"]} or \"all\"; null clears. A new setup must pick; an older one posts to the primary until it does.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / addChannels
      Added value: +{
      +  "description": "add these",
      +  "items": {
      +    "enum": [
      +      "facebook",
      +      "instagram",
      +      "threads",
      +      "tiktok",
      +      "youtube",
      +      "linkedin",
      +      "x",
      +      "pinterest",
      +      "google_business",
      +      "bluesky",
      +      "telegram",
      +      "wordpress",
      +      "discord",
      +      "slack",
      +      "whop"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / channels / anyOf
      Added value: +[
      +  {
      +    "items": {
      +      "enum": [
      +        "facebook",
      +        "instagram",
      +        "threads",
      +        "tiktok",
      +        "youtube",
      +        "linkedin",
      +        "x",
      +        "pinterest",
      +        "google_business",
      +        "bluesky",
      +        "telegram",
      +        "wordpress",
      +        "discord",
      +        "slack",
      +        "whop"
      +      ],
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "const": "all",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / channels / description
      Previous value: -"restrict it to these channels. Omit (or send an empty list) to use every connected channel that can carry each post."New value: +"REPLACES the list; a channel connected later stays out until added. \"all\" = every channel, later ones too, only if the user asks"
    • removedInput schema / properties / channels / items
      Removed value: -{
      -  "enum": [
      -    "facebook",
      -    "instagram",
      -    "threads",
      -    "tiktok",
      -    "youtube",
      -    "linkedin",
      -    "x",
      -    "pinterest",
      -    "google_business",
      -    "bluesky",
      -    "telegram"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / channels / type
      Removed value: -"array"
    • addedInput schema / properties / excludeChannels
      Added value: +{
      +  "description": "never these channels, even ones connected later; [] clears",
      +  "items": {
      +    "enum": [
      +      "facebook",
      +      "instagram",
      +      "threads",
      +      "tiktok",
      +      "youtube",
      +      "linkedin",
      +      "x",
      +      "pinterest",
      +      "google_business",
      +      "bluesky",
      +      "telegram",
      +      "wordpress",
      +      "discord",
      +      "slack",
      +      "whop"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / removeChannels
      Added value: +{
      +  "description": "stop posting here",
      +  "items": {
      +    "enum": [
      +      "facebook",
      +      "instagram",
      +      "threads",
      +      "tiktok",
      +      "youtube",
      +      "linkedin",
      +      "x",
      +      "pinterest",
      +      "google_business",
      +      "bluesky",
      +      "telegram",
      +      "wordpress",
      +      "discord",
      +      "slack",
      +      "whop"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / whopExperienceId
      Added value: +{
      +  "description": "WHOP — which forum or chat posts go to (exp_…, from list_whop_destinations). Without one, the whop’s only forum or chat is used; with several, whop is skipped rather than guessed.",
      +  "type": "string"
      +}
  3. Changed1 schema field changedv0.1.465
    • addedInput schema / properties / forgetCaptionEdits / description
      Added value: +"true = forget the caption edits learned from past reviews"
  4. Changed18 schema fields changedv0.1.398
    • removedInput schema / properties / assetCooldownDays
      Removed value: -{
      -  "description": "how long before a Library render may be posted again (default 30). It never repeats one inside this window — it queues fewer posts and says so.",
      -  "type": "number"
      -}
    • addedInput schema / properties / avoid
      Added value: +{
      +  "description": "THE BRIEF: never mention or show these — topics, claims, competitors, faces.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / channelPostsPerDay
      Added value: +{
      +  "additionalProperties": {
      +    "type": "number"
      +  },
      +  "description": "per channel, how many posts a day (the first N of the posting times), e.g. {\"x\":1,\"instagram\":3}. 0 turns a channel off; null resets it to every posting time. Merged into what is saved.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • removedInput schema / properties / dryRun
      Removed value: -{
      -  "description": "true (the default) = plan and preview only, queue nothing. Set false ONLY after a human has read a preview.",
      -  "type": "boolean"
      -}
    • changedInput schema / properties / enabled / description
      Previous value: -"on/off. false PAUSES it: the recurring job is deleted and nothing new is queued. Already-queued posts are untouched."New value: +"on/off. true needs a connected channel and a goal (refused otherwise). false PAUSES it: the recurring job is deleted and nothing new is made. Already-queued posts are untouched."
    • addedInput schema / properties / forgetCaptionEdits
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / formats
      Added value: +{
      +  "description": "THE BRIEF: what to make — mix (images with a short video now and then, the default), video (short videos only), carousel (3 new images per post), image.",
      +  "enum": [
      +    "mix",
      +    "video",
      +    "carousel",
      +    "image"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / goal
      Added value: +{
      +  "description": "THE BRIEF: what the posts are for — grow followers, drive sales, promote a launch, or other (say what in goalNote). Required to switch it on.",
      +  "enum": [
      +    "followers",
      +    "sales",
      +    "launch",
      +    "other"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / goalNote
      Added value: +{
      +  "description": "THE BRIEF: a line about the goal (e.g. the launch date and what is launching).",
      +  "type": "string"
      +}
    • addedInput schema / properties / learnings
      Added value: +{
      +  "description": "notes learned from reviews; REPLACES the list",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / maxCreditsPerDay
      Removed value: -{
      -  "description": "a hard credit ceiling per day, checked BEFORE any render starts. It binds independently of the counts above.",
      -  "type": "number"
      -}
    • removedInput schema / properties / maxImagesPerDay
      Removed value: -{
      -  "description": "how many NEW images a day it may render when the Library runs dry. 0 (default) = none, spend nothing.",
      -  "type": "number"
      -}
    • removedInput schema / properties / maxVideosPerDay
      Removed value: -{
      -  "description": "how many NEW videos a day it may render. 0 (default) = none. Video is the expensive one — hundreds of credits each.",
      -  "type": "number"
      -}
    • addedInput schema / properties / mode
      Added value: +{
      +  "description": "\"review\" (default): each batch of fresh posts waits as drafts for approval. \"auto\": fresh posts are scheduled to publish automatically.",
      +  "enum": [
      +    "review",
      +    "auto"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / pillars
      Added value: +{
      +  "description": "THE BRIEF: content pillars / topics, up to 8 short lines. Every post belongs to one. get_post_refill suggests some from the brand profile.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / postingTimes
      Added value: +{
      +  "description": "the brand's daily posting times, 24-hour \"HH:MM\" (e.g. [\"09:00\",\"13:00\",\"18:00\"]); REPLACES the list. Autopilot makes one post per posting time, and scheduled posts use the same times. get_post_refill shows the current ones.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / postsPerDay / description
      Previous value: -"cap the posts per day BELOW the number of posting times. 0 (default) = use every posting time, which is where \"3 a day\" comes from. To post MORE per day, add posting times instead."New value: +"posts a day, up to the number of posting times (\"2 times a day\" = 2). 0 (default) = one per posting time. To post MORE per day than there are posting times, also pass postingTimes."
    • addedInput schema / properties / timezone
      Added value: +{
      +  "description": "IANA timezone the posting times are in, e.g. \"America/New_York\" (default: the brand's, else UTC)",
      +  "type": "string"
      +}
  5. Changed1 schema field changedv0.1.374
    • changedInput schema / properties / linkedinOrganizationId / description
      Previous value: -"LINKEDIN — which company Page to post as (list_linkedin_pages). A single shared Page is used automatically; a Page that is not shared with this brand is ignored rather than failing the whole post."New value: +"LINKEDIN — which company Page to post as (list_linkedin_pages). A single shared Page is used automatically; a Page that is not shared with this profile is ignored rather than failing the whole post."
  6. Addedv0.1.161

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already flag destructiveHint=true and idempotentHint=true, but the description adds real behavioral context beyond them: it always creates new posts and never re-posts the Library, enabled:false deletes the recurring job while leaving queued posts untouched, and Free-plan calls are refused. It does not describe the response shape, but with no output schema and rich annotations a 4 is fair.

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?

Front-loaded with the core action and the pause semantics, then the key constraints. It is dense and a few clauses (e.g. the mode explanation) partly duplicate schema text, but every sentence carries operational value.

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

Completeness4/5

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

For a 25-parameter, no-output-schema mutation tool, the description covers the critical behaviors (new posts only, pause semantics, plan gating, ask-don't-guess) and points to get_instructions for full rules. It leaves per-parameter detail to the schema, which is reasonable given 100% coverage.

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, but the description adds meaning on top: it explains what mode 'review' vs 'auto' does to each batch, that enabled:false is a pause that removes the job, and that channels REPLACES the list. These clarify semantics rather than restating 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?

States a specific verb set (turn on, change, pause) and a specific resource (autopilot posting / posting refill), and explicitly distinguishes itself from siblings by naming run_post_refill for approvals and cancel_scheduled for queued posts.

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?

Gives explicit when-to-use rules: 'PASS ONLY WHAT CHANGES', ask the user for missing goal/mode/channels rather than guessing, and the Free-plan case is refused so relay and do not retry. It also routes to alternatives (run_post_refill approve, cancel_scheduled) for adjacent actions.

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