Skip to content

MCP servers › io.github.hermoso-ai › hermoso-social-media-manager

MCP server · registry snapshot 2026-11-07 · last checked 2026-11-19

hermoso-social-media-manager MCP server

Registry name io.github.hermoso-ai/hermoso-social-media-manager

by hermoso-ai · GitHub account (the registry's namespace rule)repository: same ownerSource ↗Website ↗

AI marketing agent for social: post, schedule and answer comments and DMs across 15 channels. — the publisher's description

5 of 5 record checks metRead-only · tools listed 2026-11-07version 1.0.0JavaScriptstreamable HTTP424 tools

Summary

io.github.hermoso-ai/hermoso-social-media-manager is a remote MCP server listed in the official MCP registry at version 1.0.0, under the namespace of the GitHub account hermoso-ai. Its linked repository, github.com/hermoso-ai/hermoso, belongs to the same GitHub account. On 2026-11-07 ProtocolProbe connected to it in read-only mode and read its inventory: 424 tools, 6 resources and 0 prompts.

Record checks

5 of 5 record checks met · 4 do not apply

  • met: Registry entry is active and says how to run it
  • met: Source repository link opens
  • met: Repository is not archived
  • met: Code pushed to the repository in the 90 days before our check
  • met: Repository publishes a security policy (SECURITY.md)
  • not applicable: Package names its licence with a standard (SPDX) identifier
  • not applicable: The version the registry lists can be installed and is not withdrawn
  • not applicable: npm package carries build provenance (attestation)
  • not applicable: No known critical or high advisory in the package or its dependencies
  • Not ranked by downloads: a remote server publishes no download figure
  • Not ranked by stars: 8 stars (ranked from 10)

From public records, not a safety rating. Each check with its reason · Is it safe to install?

Operate this server? Correct a fact · README badge · Run the checks yourself · Claim it

Key facts

Runs
remote (hosted by the publisher)
Transport
streamable HTTP
Your own values
none declared (not a guarantee)
Sign-in
none needed to open a session
Repository
public
Tools
424
Last tested
2026-11-07

Tool list size

275,204 tokens on Claude Opus 5.5

Added to every request that loads this server's tools (424 tools). Counted with Anthropic's token counter on 2026-11-09, from the tool list we read on 2026-11-07. Median across 28,560 counted servers: 2,657 tokens. How it is counted

How a client gets in

Connects without signing in

Read from the server's public metadata on 2026-11-07 (app.hermoso.ai), in our read-only connection; no tool was called. It may have changed since. How it is read

Tool list at the three APIs

Not sent yet for this version (1.0.0).

Add to your client

Observed fact

This server accepted a session without any credential and lists 182 tools whose name or declaration suggests they change data (call_tool, post_to_bluesky, delete_bluesky_post, post_to_telegram, delete_telegram_message and 177 more). That is our reading of the names; we did not call them. Source: our connection, 2026-11-07.

How fresh this is

Live-tested
yes, a real session (not a text-only review)
Last tested
2026-11-07
Mode
read-only (no tool calls)
Latest version
1.0.0, published 2026-11-06 (registry, as of the 2026-11-07 snapshot)
First listed version
2026-11-06 (earliest version still in the registry; older removed versions would be earlier)
Registry data
snapshot 2026-11-07
Package and repository
checked 2026-11-19
Engine
mcp-runtime-engine@0.1.0 · sdk@1.32.0

Dead or stale signals

None found in the records we hold

Looked for and not found: deprecated in the registry; repository link does not open; repository archived; no push in over 365 days. Does not apply: listed version cannot be installed or is withdrawn. Each line is a dated fact from a public record. It does not say whether the server still works, and a record can change after the date shown.

Changes since the last refresh

New in the registry: not in the list of 2026-11-06, listed on 2026-11-07 with version 1.0.0 (published 2026-11-06).

Source: the official MCP Registry list on 2026-11-06 and on 2026-11-07.

What it is

What does this server offer?

Observed inventory
424tools
6resources
0prompts

None of its 424 tools are described as changing anything. For 424 the reading was uncertain, so no mark is shown.

  • enable_toolson 4 other servers

    “LIST a group of tools that is not in this session's roster.”

    Publisher declares: read-only no · destructive no · idempotent yes · open-world no

    1 input, 1 required
    • groupsarrayrequired“Groups to switch on, e.g.”
  • “Search EVERY Hermoso tool — your starting list is deliberately short, and everything else in the product is here — by name, task or group.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

    4 inputs
    • querystring“words from the task or the tool name, e.g.”
    • groupstring“limit to one group: core, research, create, channels, channel_admin, analytics, ads, files, workspace”
    • limitnumber“how many to return (default 12, max 40)”
    • onlyHealthyboolean“leave out tools that are failing their recent calls or that need a connector this workspace has not made.”
  • “Run ANY Hermoso tool by name — including the paid-campaign, analytics and channel-admin tools that are not in this session's starting list — with the same permissions, the same account and the same r…”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    2 inputs, 1 required
    • namestringrequired“name”
    • argsobject“the tool's arguments as an object, exactly as its own schema takes them”
  • post_to_blueskyon 1 other server

    “Use this when the user wants to post to Bluesky.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    17 inputs, 1 required
    • accountstring“WHICH connected account of this channel to post as — its @handle or id from list_connector_accounts.”
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“The post's angle”
    • subjectstring“what the post is about”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • idempotencyKeystring“any stable string: a repeat within 24h returns the original post instead of posting again”
    • allowDuplicateboolean“post it even though an identical post was just made”
    • textstringrequired“The post, up to 300 characters / 3000 UTF-8 bytes.”
    • imageUrlsarray“Up to 10 public image URLs to attach (1–4 a standard image post, 5–10 a Bluesky gallery; more than 10 is refused, never cut).”
    • altTextstring or array“Alt text — an ARRAY, one per image in the same order, or a single STRING to describe every image with it.”
    • videoUrlstring“One public MP4 URL.”
    • videoAltstring“Alt text describing the video, for accessibility.”
    • captionsarray“Up to 20 WebVTT caption tracks: [{lang:'en', url:'https://…/en.vtt'}] or [{lang:'en', content:'WEBVTT\n\n00:00…'}].”
    • langsarray“BCP-47 language tags, e.g.”
    • linkCardboolean or object“Rich link card (`app.bsky.embed.external`).”
    • platformCoverboolean“VIDEO COVER.”
  • delete_bluesky_post

    “PERMANENTLY delete one of the connected Bluesky account's OWN posts.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    5 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • uristringrequired“the post's AT-URI (at://did:plc:…/app.bsky.feed.post/…) as post_to_bluesky returned it, the handle form of the same URI for the CONNECTED account only (at://<i…”
    • confirmboolean“REQUIRED true — deletion is permanent and cannot be undone”
    • confirmTextstring“the post's own text as the unconfirmed call reported it — the first 40 characters is enough.”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • post_to_telegramon 1 other server

    “Use this when the user wants to post to a Telegram channel or group.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    19 inputs, 1 required
    • accountstring“WHICH connected account of this channel to post as — its @handle or id from list_connector_accounts.”
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“The post's angle”
    • subjectstring“what the post is about”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • idempotencyKeystring“any stable string: a repeat within 24h returns the original post instead of posting again”
    • allowDuplicateboolean“post it even though an identical post was just made”
    • chatIdstringrequired“REQUIRED — the destination: a public channel's @username, or the numeric chat id.”
    • textstring“the message.”
    • imageUrlstring“one image (≤10MB after upload); a URL, not a local file path; use upload_file for local files”
    • imageUrlsarray“an ALBUM of 2–10 media, in order.”
    • videoUrlstring“one video (≤50MB).”
    • disablePreviewboolean“suppress the link-preview card on a text-only post.”
    • silentboolean“deliver without a notification sound (Telegram’s disable_notification).”
    • buttonsarray“URL BUTTONS under the post, Telegram's call to action: [{text:'Shop now', url:'https://…'}] one per row, or rows [[a,b],[c]].”
    • parseModestring“'HTML' to format the text with Telegram's HTML: <b>, <i>, <u>, <s>, <a href="…">, <code>, <pre>, <blockquote>, <tg-spoiler>.”
    • platformCoverboolean“VIDEO COVER.”
    • coverAtMsnumber“THE VIDEO COVER in the chat, as ONE frame: milliseconds from the start (7000 = the frame at 7s).”
  • list_telegram_chatson 1 other server

    “Find the chat ids this Telegram bot can be addressed by.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs
    • limitnumber“how many recent updates to scan, 1–100 (default 100)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • list_telegram_dms

    “Read what people have SENT to the connected Telegram bot — the newest message from each chat, newest chat first, so you can see who is waiting on a reply.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs
    • limitnumber“how many raw updates to scan, 1-100 (default 100).”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • delete_telegram_message

    “PERMANENTLY delete one message the bot posted to a Telegram chat.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    5 inputs, 2 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • chatIdstringrequired“the chat the message is in — the same @username or numeric id it was posted with”
    • messageIdnumberrequired“the message id post_to_telegram returned (also the number at the end of a t.me link)”
    • confirmboolean“REQUIRED true — Telegram has no trash and no undelete”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • post_to_wordpresson 1 other server

    “Use this when the user wants to publish, draft or schedule a BLOG POST on their WordPress site.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    19 inputs, 1 required
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“The post's angle”
    • subjectstring“what the post is about”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • idempotencyKeystring“any stable string: a repeat within 24h returns the original post instead of posting again”
    • allowDuplicateboolean“post it even though an identical post was just made”
    • titlestringrequired“REQUIRED — the post title”
    • textstring“the body: plain text, light markdown or HTML”
    • statusstring“default publish”
    • datestring“ISO time to publish at; a future date schedules it on WordPress itself”
    • excerptstring“the summary under the title in lists and search”
    • slugstring“the end of the post URL”
    • categoriesarray“category names or ids (a missing name is created)”
    • tagsarray“tag names or ids (a missing name is created)”
    • imageUrlstring“one image — becomes the featured image”
    • imageUrlsarray“several images: the first is featured, the rest go inline”
    • videoUrlstring“one video, embedded in the post”
    • altTextstring“alt text for the images”
  • update_wordpress_post

    “Change a WordPress post that already exists: title, body, excerpt, slug, status (publish a draft, unpublish to draft, make private, or schedule with a future date), categories, tags or the featured i…”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    11 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • postIdnumberrequired“the post id post_to_wordpress or list_wordpress_posts returned”
    • titlestring
    • textstring“the new body — replaces the old one”
    • excerptstring
    • slugstring
    • statusstring
    • datestring
    • categoriesarray
    • tagsarray
    • featuredImageUrlstring“a new featured image”
  • delete_wordpress_post

    “Delete a WordPress post.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • postIdnumberrequired
    • permanentboolean“skip the trash — cannot be undone”
    • confirmboolean“true only once the user agreed to the sentence the first call returned”
Show 88 more tools
  • list_wordpress_posts

    “List the posts on the brand's WordPress site, newest first — published, scheduled, drafts, pending and private — each with its id, status, title and live URL.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • statusstring“one status or a comma list: publish, future, draft, pending, private (default all)”
    • searchstring
    • pagenumber
    • perPagenumber“1–100, default 20”
  • get_wordpress_post

    “Read one WordPress post back — WordPress's own title, status, live URL, excerpt and body.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • postIdnumberrequired
  • list_wordpress_terms

    “List the WordPress site's categories or tags (kind), most-used first, each with its id.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • kindstringrequired
    • searchstring
  • create_wordpress_term

    “Create a category or tag on the WordPress site.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    5 inputs, 2 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • kindstringrequired
    • namestringrequired
    • parentnumber“a parent category id (categories only)”
    • descriptionstring
  • post_to_discordon 1 other server

    “Post to the user's Discord server.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    20 inputs
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“The post's angle”
    • subjectstring“what the post is about”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • idempotencyKeystring“any stable string: a repeat within 24h returns the original post instead of posting again”
    • allowDuplicateboolean“post it even though an identical post was just made”
    • textstring“the announcement, ≤2000 characters”
    • imageUrlstring
    • imageUrlsarray“up to 10 files in one message”
    • videoUrlstring
    • mentionsboolean“let @everyone / @here / role mentions ping people (off by default)”
    • silentboolean“post without a notification”
    • threadNamestring“required when the channel is a FORUM channel: the new thread title”
    • usernamestring“webhook posts only: a different display name than the webhook's own”
    • discordServerstring“HERMOSO BOT: which Discord server (id or name) when the bot is in several”
    • channelstring“HERMOSO BOT: channel id or #name (list_discord_channels); unset = the default channel”
    • replyTostring“HERMOSO BOT: reply to this message id”
    • threadIdstring“HERMOSO BOT: post inside this existing thread”
    • startThreadstring“HERMOSO BOT: start a thread under the new post with this title”
  • edit_discord_message

    “Change the text of a Discord message Hermoso posted (≤2000 characters) — the bot's or the announcement webhook's.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 2 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • messageIdstringrequired“the message id post_to_discord returned (a bot post's is "<channel>/<message>")”
    • channelstring“the channel, when messageId is a bare id of a BOT post”
    • textstringrequired
  • delete_discord_message

    “PERMANENTLY delete a Discord message Hermoso posted (the bot's or the announcement webhook's).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • messageIdstringrequired
    • channelstring
    • confirmboolean“true only once the user agreed”
  • get_discord_message

    “Read back a Discord message Hermoso posted: its text, link and REACTIONS — the only engagement Discord exposes (there is no view count).”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • messageIdstringrequired
    • channelstring
  • post_to_slackon 1 other server

    “Post to the user's Slack.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    19 inputs
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“The post's angle”
    • subjectstring“what the post is about”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • idempotencyKeystring“any stable string: a repeat within 24h returns the original post instead of posting again”
    • allowDuplicateboolean“post it even though an identical post was just made”
    • textstring
    • titlestring“a header line above the text”
    • imageUrlstring
    • imageUrlsarray
    • videoUrlstring
    • altTextstring“alt text for the images”
    • slackWorkspacestring“HERMOSO APP: which Slack workspace (id or name) when the app is in several”
    • channelstring“HERMOSO APP: channel id or #name (list_slack_channels); unset = the default channel”
    • threadTsstring“HERMOSO APP: reply in this thread (the parent message ts)”
    • replyBroadcastboolean“HERMOSO APP: also show the thread reply in the channel”
    • postAtstring“HERMOSO APP: schedule in Slack itself for this ISO time (≤120 days, text only; use schedule_post for files)”
    • unfurlLinksboolean“false = no link previews”
  • list_slack_channelson 1 other server

    “The Slack workspaces this brand added the Hermoso app to, and the channels in one of them (public, plus private ones the app was invited to with /invite @Hermoso), with the default channel marked.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • slackWorkspacestring“which workspace (id or name) when there are several”
    • querystring“filter channel names”
  • set_slack_channel

    “Choose the DEFAULT Slack channel the Hermoso app posts to: post_to_slack, scheduled Slack posts and Autopilot use it whenever a post names no channel.”

    Publisher declares: read-only no · destructive no · idempotent yes · open-world yes

    3 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • slackWorkspacestring
    • channelstringrequired“channel id or #name from list_slack_channels”
  • read_slack_channel

    “Read a Slack channel's recent messages, newest first, for context — what the team is discussing before you write.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • slackWorkspacestring
    • channelstring“channel id or #name; unset = the default channel”
    • limitnumber“how many, 1–200 (default 20)”
    • oldeststring“only messages after this ts”
  • list_discord_channels

    “The Discord servers this brand added the Hermoso app to, and the channels in one of them (text, announcement and forum channels), with the default channel marked.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • discordServerstring“which server (id or name) when there are several”
    • querystring“filter channel names”
  • set_discord_channel

    “Choose the DEFAULT Discord channel the Hermoso app posts to: post_to_discord, scheduled Discord posts and Autopilot use it whenever a post names no channel.”

    Publisher declares: read-only no · destructive no · idempotent yes · open-world yes

    3 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • discordServerstring
    • channelstringrequired“channel id or #name from list_discord_channels”
  • read_discord_channel

    “Read a Discord channel's recent messages, newest first, for context — what members are saying before you write.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • discordServerstring
    • channelstring“channel id or #name; unset = the default channel”
    • limitnumber“how many, 1–100 (default 20)”
    • beforestring“page back from this message id”
  • edit_slack_message

    “Change the text of a Slack message the Hermoso app posted (≤4,000 characters, Slack's edit limit).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 2 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • messageIdstringrequired
    • textstringrequired
    • slackWorkspacestring
  • delete_slack_message

    “PERMANENTLY delete a Slack message the Hermoso app posted.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • messageIdstringrequired
    • slackWorkspacestring
    • confirmboolean“true only once the user agreed”
  • get_slack_message

    “Read back a Slack message the Hermoso app posted: text, link, REACTIONS and thread REPLIES — the engagement Slack exposes (there is no view count).”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • messageIdstringrequired
    • slackWorkspacestring
  • list_slack_scheduled

    “Messages the Hermoso app scheduled IN SLACK (post_to_slack with postAt) that have not posted yet.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • slackWorkspacestring
    • channelstring
  • cancel_slack_scheduled

    “Cancel a message scheduled in Slack (from list_slack_scheduled).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 2 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • slackWorkspacestring
    • channelstringrequired
    • scheduledMessageIdstringrequired
  • “Use this when the user asks for their unanswered comments, messages or reviews.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    7 inputs
    • sourcesarray“Limit to these sources: facebook, instagram, threads, meta_dm, instagram_dm, meta_webhook, threads_mention, youtube, google_business, x, bluesky, bluesky_menti…”
    • postIdstring“Restrict Facebook/Instagram to one post or media id (Meta reads comments per post).”
    • videoIdstring“Restrict YouTube to one video.”
    • conversationIdstring“Restrict DMs to one conversation (from list_meta_conversations, list_bluesky_convos or list_x_dms).”
    • pageIdstring“Facebook Page id (list_meta_pages) when the brand has several Pages connected: reads that Page's Messenger and Instagram DMs and comments only.”
    • limitnumber“Max items per source (default 25).”
    • unansweredOnlyboolean“Only items with no reply from the brand yet.”
  • reply_to_inbox_item

    “Answer an inbox item BY ITS COMPOSITE ID — the `id` list_inbox returned, e.g.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    2 inputs, 2 required
    • idstringrequired“The composite id from list_inbox — '<source>:<platform id>'.”
    • textstringrequired“The reply, exactly as it should appear publicly.”
  • hermoso_capabilitieson 3 other servers

    “Probe what this Hermoso account can do RIGHT NOW: available image/video model ids + their credit costs (estimates: a render is charged its actual cost), aspect ratios, video durations, the recipe ids…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

    Takes no inputs.

  • hermoso_creditson 3 other servers

    “Return the credit balance, recent priced calls with their credits, and costModel (the one-sentence rule of what costs credits).”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

    Takes no inputs.

  • “Out of credits?”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    3 inputs
    • packstring“the pack id to buy (e.g.”
    • confirmboolean“set true to actually charge the saved card for `pack` (required for the one-click charge; ignored on the checkout-link path)”
    • quote_tokenstring“the quoteToken returned by the quote step — REQUIRED (with confirm:true) to charge; it binds the exact pack + price you quoted (10-minute validity) and makes a…”
  • “Report a bug in Hermoso to the team.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    3 inputs, 2 required
    • summarystringrequired“one-line summary of the bug”
    • detailsstringrequired“what you were doing, the tool + arguments you called, what you expected, and what actually happened (paste the exact error)”
    • severitystring“high = blocks the task or loses paid work; medium = wrong output but workable; low = cosmetic”
  • request_featureon 14 other servers

    “Ask the Hermoso team for a capability that doesn't exist yet.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    2 inputs, 2 required
    • summarystringrequired“one line: the capability you need”
    • detailsstringrequired“what the user was actually trying to achieve, why the current tools couldn't do it, and what you'd expect the capability to do”
  • billing_statuson 9 other servers

    “Show this account's billing at a glance: current plan (quote plan.priceUsd per plan.period), credit balance, whether auto-reload is on, whether a card is on file, and whether YOU (this key) have ADMI…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

    Takes no inputs.

  • “Change the SUBSCRIPTION plan (admin only).”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    4 inputs
    • planstring“the plan id to move to (e.g.”
    • periodstring“monthly only ('yr' buys monthly)”
    • confirmboolean“true (with quote_token) to make a quoted upgrade”
    • quote_tokenstring“the quoteToken from the quote step”
  • set_auto_reloadon 3 other servers

    “Turn automatic credit reloads on or off (admin only): when the balance drops below a threshold, the card on file is charged for a top-up pack — SERVER-SIDE, even with no app open.”

    Publisher declares: read-only no · destructive no · idempotent yes · open-world no

    3 inputs, 1 required
    • enabledbooleanrequired“true to turn auto-reload on, false to turn it off”
    • thresholdCreditsinteger“reload when the balance drops below this many credits”
    • reloadCreditsinteger“how many credits to add each reload — must match a credit pack size (see buy_credits)”
  • “List every profile on this account (id + name; a profile is a brand, a creator or a personal workspace) and which one this connection acts on, PLUS any profile another account shared with you.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

    Takes no inputs.

  • “Pin which profile this connection acts on.”

    Publisher declares: read-only no · destructive no · idempotent yes · open-world no

    1 input, 1 required
    • brandstringrequired“profile id (e.g.”
  • “Add a NEW profile (a brand, client, creator or personal workspace) and switch to it.”

    Publisher declares: read-only no · destructive no · idempotent yes · open-world no

    2 inputs, 1 required
    • namestringrequired“the name for the new profile (a brand, client or creator name)”
    • activateboolean“switch this connection to the new profile (default true); everything you do next scopes to it”
  • delete_brandon 4 other servers

    “PERMANENTLY delete a profile and EVERYTHING in it — brand details, memory, swipefile, Library creations, generated assets, avatars, skills, playbooks, chats — and disconnect its connected accounts.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 1 required
    • brandstringrequired“profile id or exact name from list_brands”
    • confirmboolean“REQUIRED true — this destroys the whole profile and cannot be undone”
    • confirmNamestring“the workspace's EXACT name, required when it is not empty — copy it from the inventory this tool returned, after the user has agreed to it”
    • confirmConnectorsnumber“the number of connected accounts the inventory reported, required when there is at least one — the user must specifically agree to losing them, because reconne…”
  • meta_page_insightson 1 other server

    “Organic performance for the brand’s connected Facebook Page — views and unique reach (page_media_view / page_total_media_view_unique, Meta’s own replacements for the impressions family it retired), p…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs
    • pageIdstring“Page id — omit when the profile has exactly one Page connected”
    • periodstring“window (default week)”
  • meta_post_insights

    “Performance for a single organic post — on Facebook views/reach (post_media_view, post_total_media_view_unique — Meta’s own replacements for the retired impressions family), clicks, reactions and vid…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • postIdstringrequired“post/media id returned by post_to_meta”
    • targetstring“which metric set to ask for; an Instagram media id is detected and read as Instagram either way (default: Facebook for a Facebook id)”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram").”
    • pageIdstring“Page id — omit when only one Page is connected”
  • instagram_insightson 1 other server

    “ACCOUNT-level performance for the brand’s connected Instagram Business account — views, reach, accounts engaged, total interactions, likes, comments, shares, saves, profile link taps, replies, repost…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    8 inputs
    • metricsarray“account metrics (default: views, reach, accounts_engaged, total_interactions, likes, comments, shares, saves, profile_links_taps).”
    • breakdownarray“contact_button_type / follow_type / media_product_type for account metrics; age / city / country / gender for the demographic metrics (exactly one)”
    • timeframestring“window for the demographic metrics only (default this_month = the last 30 days).”
    • periodstring“aggregation for reach, the one time-series metric (default day)”
    • sincestring“YYYY-MM-DD window start”
    • untilstring“YYYY-MM-DD window end”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram").”
    • pageIdstring“Facebook Page id the Instagram account is linked to — omit when only one Page is connected”
  • list_instagram_media

    “The connected Instagram Business account’s own recent media — id, caption, media type (feed / reel / story-era), permalink, timestamp, like and comment counts.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    4 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • limitnumber“how many (1–50, default 15)”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram").”
    • pageIdstring“Facebook Page id — omit when only one Page is connected”
  • list_meta_stories

    “The Stories live right now on the connected Instagram accounts and Facebook Pages: id, caption (Instagram), posted time, hours left and permalink, and on Instagram `insights`: reach, views, replies, …”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    7 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • channelstring“default all”
    • accountstring“one Instagram account: an @handle or id”
    • pageIdstring“one Facebook Page, and its linked Instagram”
    • limitnumber“rows, newest first (1-100, default 25)”
    • includeEndedboolean“also list Stories that ended, with their kept numbers”
    • daysnumber“how far back includeEnded goes (1-400, default 30)”
  • instagram_story_insights

    “An Instagram Story’s numbers: reach, views, replies, shares, link clicks, profile visits, follows, and navigation (forward, back, next story, exit).”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    6 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • storyIdstring“one Story id, from list_meta_stories”
    • accountstring“one Instagram account: an @handle or id”
    • pageIdstring“one Facebook Page, for its linked Instagram”
    • daysnumber“how far back (1-400, default 30)”
    • limitnumber“rows, newest first (1-100, default 25)”
  • get_meta_story

    “What can be known about one story id, usually from a story_reply or story_mention item in list_inbox: its caption, posted time and permalink while it is live, or that it has expired.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    6 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • storyIdstring“the story id from the inbox item, or a media id”
    • urlstring“the story url from the same inbox item”
    • repliedAtstring“when the reply arrived, the item’s `at`; a reply older than 24 hours means the Story has expired”
    • accountstring“one Instagram account: an @handle or id”
    • pageIdstring“one Facebook Page”
  • instagram_collaborators

    “Did the collab invites on an Instagram post get accepted?”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs, 1 required
    • mediaIdstringrequired“the Instagram media id — post_to_meta returns it as postId, list_instagram_media lists the account’s own posts”
    • pageIdstring“Facebook Page id — omit when only one Page is connected”
  • search_instagram_audioon 1 other server

    “Audio the brand may legally put under a Reel — music or original sound — with title, artist, length, whether it is eligible for ads, a preview link and a download link.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • audioTypestring“default music”
    • querystring“omit for trending audio”
    • limitnumber“1–50, default 15”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram"); omit for the one Page-linked account”
    • pageIdstring“Facebook Page id — omit when only one Page is connected”
  • list_instagram_collab_invites

    “Posts where a creator tagged this Instagram account as a COLLABORATOR and is waiting for an answer.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    4 inputs
    • limitnumber“1–100, default 25”
    • afterstring“cursor from a previous page”
    • accountstring“which Instagram account — @handle or id; omit for the one Page-linked account”
    • pageIdstring“Facebook Page id — omit when only one Page is connected”
  • respond_instagram_collab_invite

    “Answer a collab invite from list_instagram_collab_invites.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    4 inputs, 2 required
    • mediaIdstringrequired“the media id from list_instagram_collab_invites”
    • acceptbooleanrequired“true = accept and co-author the post; false = decline”
    • accountstring“which Instagram account — @handle or id; omit for the one Page-linked account”
    • pageIdstring“Facebook Page id — omit when only one Page is connected”
  • list_instagram_collab_media

    “Every collaborative post this Instagram account is a co-author on — who posted it, and the COMBINED engagement across all co-authors (total likes and comments, plus saves, shares and reposts where In…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • limitnumber“1–100, default 25”
    • afterstring“cursor from a previous page”
    • accountstring“which Instagram account — @handle or id; omit for the one Page-linked account”
    • pageIdstring“Facebook Page id — omit when only one Page is connected”
  • list_meta_comments

    “Read the comments under a Facebook Page post or Instagram media object — customer questions, objections and the exact language real people use about the product.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs, 1 required
    • postIdstringrequired“post/media id — or a COMMENT id, which returns that comment’s replies”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram").”
    • pageIdstring“Page id — omit when only one Page is connected”
    • limitnumber“how many comments (1–50, default 25)”
    • cursorstring“the cursor from a previous call.”
  • comment_on_meta_post

    “Leave a NEW top-level comment on one of the brand’s own posts — a Facebook Page post OR an Instagram post/Reel — as the brand.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    5 inputs, 1 required
    • postIdstringrequired“the Facebook Page post id or Instagram media id — from list_meta_posts, or returned by post_to_meta”
    • messagestring“the comment text.”
    • attachmentUrlstring“FACEBOOK ONLY — optional public image URL to post as the comment’s attachment (refused on Instagram)”
    • pageIdstring“Page id — omit when only one Page is connected”
    • accountstring“INSTAGRAM — which account, an @handle or id from list_connector_accounts("instagram"); needed for an Instagram Login account or when several are linked”
  • like_instagram

    “Like (or unlike) an Instagram post, Reel, comment or reply AS the brand’s Instagram account — Meta’s Like Media and Comments API (April 2026).”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    5 inputs
    • mediaIdstring“an IG media id (post or Reel), from list_instagram_media”
    • commentIdstring“an IG comment or reply id, from list_meta_comments”
    • undoboolean“true to unlike”
    • pageIdstring“Facebook Page id when the brand's Instagram is linked to a Page; from list_meta_pages”
    • accountstring“direct Instagram account (@handle or id) when several are connected; from list_connector_accounts”
  • find_instagram_marketplace_creators

    “SEARCH INSTAGRAM'S CREATOR MARKETPLACE: Meta's own directory of creators who partner with brands, searched AS the brand's Instagram account, so the recommendations are personalised to it.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    32 inputs
    • querystring“keywords, e.g.”
    • usernamestring“one creator handle; no other filter allowed with it”
    • similarToarray“up to 5 creator handles to find look-alikes of”
    • recommendationstring“Meta's recommendation ranking for the results; omit for a plain search”
    • countriesarray“2-letter ISO codes”
    • statesarray“state or region codes; needs exactly one country”
    • minFollowersnumber“0, 10000, 25000, 50000, 75000, 100000, 250000 or 1000000”
    • maxFollowersnumber“10000, 25000, 50000, 75000, 100000, 250000 or 1000000”
    • ageBucketstring“creator age bucket filter, e.g.”
    • genderstring“creator gender filter: male or female”
    • interestsarray“up to 5 of Meta’s categories, e.g.”
    • minEngagednumber“0, 2000, 10000, 50000 or 100000”
    • maxEngagednumber“2000, 10000, 50000 or 100000”
    • audienceCountriesarray“2-letter ISO codes of countries the creator's audience must match”
    • audienceStatesarray“state or region codes the creator's audience must match”
    • audienceAgeBucketstring“age bucket of the creator's audience, e.g.”
    • audienceGenderstring“gender of the creator's audience: male or female”
    • audienceDevicesarray“device filter for the creator's audience: ios and/or android”
    • customAudienceIdstring“from list_instagram_marketplace_audiences”
    • reelsInteractionRatenumber“minimum reels interaction rate, as a plain number”
    • languagestring“creator language filter, e.g.”
    • followerGrowthstring“follower growth band: creators in the top 10, 30 or 50 percent”
    • lastPostWithinstring“only creators who posted within the last 7, 30 or 90 days”
    • verifiedAccountboolean“true = verified accounts only”
    • hasPortfolioboolean“true = creators with a portfolio only”

    and 7 more not listed here.

  • instagram_marketplace_creator

    “ONE CREATOR FROM INSTAGRAM'S CREATOR MARKETPLACE, IN DEPTH: Meta's first-party insights (total followers, reach, engaged accounts, reels interaction rate, reels hook rate), audience demographics (eng…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs, 1 required
    • usernamestringrequired“the creator’s Instagram handle”
    • demographicsboolean“default true”
    • mediaboolean“default true”
    • pageIdstring“Facebook Page id linked to the brand's Instagram; from list_meta_pages”
    • accountstring“direct Instagram account (@handle or id) when several are connected; from list_connector_accounts”
  • list_instagram_marketplace_audiences

    “The brand's custom audiences that Instagram's creator marketplace accepts as a creator filter (Meta's creator_marketplace_brand_info).”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs
    • businessIdstring“agency Business portfolio id”
    • pageIdstring“Facebook Page id linked to the brand's Instagram; from list_meta_pages”
    • accountstring“direct Instagram account (@handle or id) when several are connected; from list_connector_accounts”
  • reply_to_meta_comment

    “Post a public reply to a comment on the brand’s Facebook or Instagram post.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    5 inputs, 2 required
    • privateboolean“true = send ONE PRIVATE message to the person who left the comment (Messenger / Instagram Direct) instead of a public reply — the way to answer "price?" or "DM…”
    • commentIdstringrequired“comment id from list_meta_comments”
    • messagestringrequired“reply text”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram").”
    • pageIdstring“Page id — omit when only one Page is connected”
  • moderate_meta_comment

    “Moderate a comment on the brand’s Facebook or Instagram post.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    5 inputs, 1 required
    • commentIdstringrequired“comment id from list_meta_comments”
    • actionstring“default hide”
    • confirmboolean“required (true) only for delete”
    • accountstring“which Instagram account — an @handle or id from list_connector_accounts("instagram").”
    • pageIdstring“Page id — omit when only one Page is connected”
  • list_threads_posts

    “List recent posts on the brand’s connected Threads account (id, text, media, permalink, timestamp).”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    3 inputs
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • limitnumber“how many posts (1–50, default 15)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • threads_insights

    “Performance for ONE Threads post (views, likes, replies, reposts, quotes, shares) when postId is given, or for the whole ACCOUNT when it is omitted — views, likes, replies, reposts, quotes, LINK CLIC…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    6 inputs
    • postIdstring“post id from list_threads_posts — omit for account-level insights”
    • metricsarray“account metrics: views, likes, replies, reposts, quotes, clicks, followers_count, follower_demographics”
    • breakdownarray“country / city / age / gender — required by follower_demographics, exactly one”
    • sincestring“YYYY-MM-DD window start (account scope)”
    • untilstring“YYYY-MM-DD window end (account scope)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • list_threads_replies

    “Read the replies on a Threads post.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    4 inputs, 1 required
    • postIdstringrequired“post id from list_threads_posts”
    • conversationboolean“true = the whole thread, not just direct replies”
    • limitnumber“how many replies (1–50, default 25)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • reply_to_threadon 13 other servers

    “Post a reply to a Threads post — the brand’s own or someone else’s.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    3 inputs, 2 required
    • replyToIdstringrequired“the post id being replied to”
    • textstringrequired“reply text (max 500 characters)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • hide_thread_reply

    “Hide a reply on the brand’s Threads post (or unhide it with hide:false) — for spam and abuse moderation.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    3 inputs, 1 required
    • replyIdstringrequired“reply id from list_threads_replies”
    • hideboolean“false to UNHIDE (default true)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • delete_threadon 3 other servers

    “PERMANENTLY delete one of the brand’s Threads posts.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    5 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • postIdstringrequired“post id from list_threads_posts”
    • confirmboolean“REQUIRED true — deletion is permanent; only set it after the user has explicitly agreed”
    • confirmNamestring“the post’s exact text as the unconfirmed call reported it — required once it has any likes, replies or reposts”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • repost_thread

    “Repost an existing Threads post to the brand’s own Threads profile — the Threads equivalent of a retweet.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    2 inputs, 1 required
    • postIdstringrequired“the Threads post id to repost”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • threads_publishing_limit

    “How much of the brand’s Threads quota is left right now — posts (250 per rolling 24 hours), replies (1,000), DELETIONS (100) and location searches (500) — each as used, total and REMAINING.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    1 input
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • list_threads_mentions

    “Posts where someone MENTIONED the brand on Threads — anywhere, not just under your own posts.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs
    • limitnumber“how many mentions (1–50, default 25)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • search_threads_keyword

    “Search PUBLIC Threads posts for a keyword or topic — competitor listening, finding what people say about a product, or sourcing real customer language for ad copy.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    9 inputs, 1 required
    • searchModestring“KEYWORD (default) or TAG — TAG searches a TOPIC TAG (what is being said under #skincare)”
    • mediaTypestring“TEXT, IMAGE or VIDEO — only that kind of post”
    • sincestring“only posts on/after this date (YYYY-MM-DD, ISO or unix seconds; Threads search reaches back to 2023-07-05)”
    • untilstring“only posts on/before this date”
    • limitinteger“how many results (1–100, default 25)”
    • authorUsernamestring“only posts by this Threads account (exact username, no @) — 'what has @competitor said about X'”
    • qstringrequired“keyword or phrase”
    • searchTypestring“TOP (default) or RECENT”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • list_meta_pageson 1 other server

    “List the Facebook Pages (with any linked Instagram business account) and ad accounts on the connected Meta account.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    Takes no inputs.

  • “Persist an ARBITRARY user file (image, video, audio, PDF or document, up to 150MB) into Hermoso and get back a durable public URL that EVERY publish, schedule and ad-build tool accepts.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    4 inputs
    • getUploadUrlboolean“ASK FOR A ONE-TIME UPLOAD URL instead of uploading now — use this whenever the file is on the user’s machine and you can run a shell or an HTTP request.”
    • urlstring“a PUBLIC http(s) URL Hermoso fetches server-side (private/internal addresses are refused, and every redirect hop is re-checked).”
    • dataUristring“base64 data: URI of the file bytes (data:<mime>;base64,<…>) — bytes travel over this connection, so keep it small”
    • namestring“original file name — helps pick the right extension”
  • search_threads_locations

    “Search Threads’ public place index by name (or by latitude+longitude) and get location ids.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    4 inputs
    • qstring“place name to search, e.g.”
    • latitudenumber“latitude (use with longitude to search near a point)”
    • longitudenumber“longitude”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • threads_profileon 1 other server

    “Read ANY public Threads account by handle — name, bio, avatar, verified badge, follower count, and its lifetime likes / quotes / reposts / views.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    2 inputs, 1 required
    • usernamestringrequired“the Threads handle — "nike", "@nike", or a threads.net profile link”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • list_threads_profile_posts

    “The recent PUBLIC posts of any Threads account.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    4 inputs, 1 required
    • brandstring“WHICH PROFILE the post lives in — id or exact name from list_brands (a shared workspace: its profile id).”
    • usernamestringrequired“the Threads handle — "nike", "@nike", or a threads.net profile link”
    • limitnumber“how many posts (1–50, default 25)”
    • accountstring“which connected account: its @handle or id from list_connector_accounts; needed only when several are connected”
  • search_instagram_hashtag

    “Read the PUBLIC Instagram posts carrying a hashtag — the caption, the media, the permalink and the like and comment counts — on the brand’s own Meta credentials rather than a scraper.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    4 inputs, 1 required
    • tagstringrequired“the hashtag — "skincare", "#skincare" or an instagram.com/explore/tags/… link all work.”
    • edgestring“"recent" (default) = posted in the last 24 hours; "top" = the best-performing posts, with no time limit.”
    • limitnumber“how many posts (1–50, default 10).”
    • pageIdstring“Facebook Page id — omit when only one Page is connected.”
  • list_whatsapp_accountson 1 other server

    “The WhatsApp Business Accounts SHARED WITH THIS PROFILE and the phone numbers registered on each — the ids every other WhatsApp tool needs, plus each number’s QUALITY RATING, which is what decides ho…”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    Takes no inputs.

  • list_whatsapp_templateson 2 other servers

    “The message templates on one WhatsApp Business Account with the REVIEW STATUS Meta actually holds for each.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • wabaIdstring“the WhatsApp Business Account id, from list_whatsapp_accounts.”
    • namestring“filter to one template name (Meta matches it exactly)”
    • languagestring“filter to one language code, e.g.”
    • statusstring“filter to one review status, e.g.”
    • limitnumber“how many (1–200, default 50)”
  • create_whatsapp_templateon 4 other servers

    “Submit a new WhatsApp message template for Meta’s review.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    6 inputs, 4 required
    • wabaIdstring“the WhatsApp Business Account id, from list_whatsapp_accounts.”
    • namestringrequired“lowercase letters, digits and underscores only, e.g.”
    • languagestringrequired“the language code, e.g.”
    • categorystringrequired“MARKETING = promotional, UTILITY = transactional follow-up, AUTHENTICATION = one-time passcode.”
    • componentsarrayrequired“Meta’s component array.”
    • parameterFormatstring“POSITIONAL (default, {{1}}) or NAMED”
  • delete_whatsapp_template

    “PERMANENTLY delete a WhatsApp message template.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    4 inputs, 1 required
    • wabaIdstring“the WhatsApp Business Account id.”
    • namestringrequired“the template name (Meta matches it exactly)”
    • confirmboolean“REQUIRED true to actually delete — deletion is permanent and covers every language”
    • confirmNamestring“the template’s exact name, echoed back — required alongside confirm”
  • send_whatsapp_messageon 2 other servers

    “Send a WhatsApp message from one of the brand’s registered numbers to a customer.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    8 inputs, 2 required
    • phoneNumberIdstringrequired“WHICH NUMBER IT SENDS FROM — from list_whatsapp_accounts (a WABA can have several)”
    • tostringrequired“the recipient in full international form, e.g.”
    • templatestring“an APPROVED template name — required to start a conversation outside the 24-hour window”
    • languagestring“which language of that template, e.g.”
    • wabaIdstring“the account the template’s review status is read from.”
    • componentsarray“the template’s variable values, in Meta’s component form.”
    • textstring“a free-form message — only lands INSIDE the 24-hour window”
    • confirmboolean“REQUIRED true — this sends a real message to a real phone and Meta bills the business for it”
  • send_whatsapp_broadcast

    “Send ONE approved WhatsApp template to MANY recipients .”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    11 inputs
    • jobIdstring“READ MODE — pass a broadcast’s job id (and nothing else) to get its status and per-recipient outcome instead of starting a new one”
    • phoneNumberIdstring“WHICH NUMBER IT SENDS FROM — from list_whatsapp_accounts (a WABA can have several).”
    • templatestring“an APPROVED template name.”
    • languagestring“which language of that template, e.g.”
    • wabaIdstring“the account the template is read from.”
    • recipientsarray“the list: either phone numbers in full international form ["+14165550142", …] (or business-scoped user ids, e.g.”
    • componentsarray“template values SHARED by every recipient, in Meta’s component form.”
    • skipInvalidboolean“drop unusable numbers instead of refusing the whole list.”
    • dryRunboolean“cost nothing, send nothing, queue nothing: report exactly who would be messaged, what Meta charges for it, and whether it fits the 24-hour messaging limit”
    • confirmboolean“REQUIRED true — this sends real messages to real phones and Meta bills the business for every one”
    • confirmCountnumber“REQUIRED — the exact number of DISTINCT valid recipients, echoed back.”
  • post_to_metaon 1 other server

    “Use this when the user wants to post now to Facebook, Instagram or Threads.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    58 inputs
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“WHAT ANGLE this post is built on, recorded only at publish time.”
    • subjectstring“WHAT THIS POST IS ABOUT — product, feature, offer or theme (e.g.”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • messagestring“post text / caption”
    • imageUrlstring“public https URL, a data: URI, or a Hermoso /generated path (upload_file gives you one for a local file); a URL, not a local file path; use upload_file for loc…”
    • videoUrlstring“public https URL, data: URI, or /generated path — FB video post / IG Reel; a URL, not a local file path; use upload_file for local files”
    • productTagsarray“INSTAGRAM SHOPPING — make the post SHOPPABLE by tagging products from the brand’s own catalog; tapping a tag opens the product’s price sheet inside Instagram.”
    • imageUrlsarray“CAROUSEL — an ORDERED list of image (and, where the channel allows, video) URLs published as ONE post the viewer swipes through.”
    • idempotencyKeystring“SAFE RETRIES — any stable string: a repeat of the SAME publish within 24h returns the ORIGINAL post id instead of posting again (an identical publish is also a…”
    • allowDuplicateboolean“post it even though an identical post was just made or attempted.”
    • asyncboolean“publish in the BACKGROUND and return a job id to poll with get_job, instead of waiting.”
    • linkstring“a URL to attach (FB text post only)”
    • collaboratorsarray“INSTAGRAM COLLAB — up to 3 Instagram usernames invited to CO-AUTHOR this post.”
    • userTagsarray“INSTAGRAM USER TAGS — tag people (public accounts) on the post; each is notified.”
    • targetstring“default facebook; instagram -> the Page’s linked IG; threads -> the brand’s connected Threads account”
    • accountstring“WHICH Instagram account when target is instagram and the brand has several — Page-linked and Instagram Login accounts alike; an @username or id from list_conne…”
    • scheduleAtstring“FACEBOOK ONLY — schedule instead of posting now.”
    • locationIdstring“TAG A PLACE.”
    • audienceobject“FACEBOOK PAGE POST ONLY — limit who can see this organic post to people in these places and/or over this age (Facebook allows 13, 15, 18, 21 or 25).”
    • placestring“FACEBOOK — tag a location on the Page post.”
    • placeNamestring“the name the user saw for that place; a different business is refused”
    • callToActionstring“FACEBOOK — a real call-to-action BUTTON on the Page post.”
    • callToActionLinkstring“FACEBOOK — where the button goes, when that is not the post’s own `link`.”

    and 33 more not listed here.

  • schedule_poston 13 other servers

    “Use this to schedule a social media post for later, on one channel or several.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    120 inputs, 1 required
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“WHAT ANGLE this post is built on, recorded only at publish time.”
    • subjectstring“WHAT THIS POST IS ABOUT — product, feature, offer or theme (e.g.”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • channelsarrayrequired“one or more channels to post to at that time”
    • atstring“when to post: local wall clock, no offset (2026-10-30T10:00), read in `timezone` or the brand’s zone ON THAT DATE so a series survives a clock change; or UTC (…”
    • useQueueboolean“instead of naming a minute, drop this into the brand’s POSTING QUEUE: Hermoso takes the earliest of its saved posting times that is still free (skipping any sl…”
    • timezonestring“IANA zone (e.g.”
    • messagestring“the caption/text used for every channel unless overridden in captions”
    • captionsobject“per-channel caption overrides, e.g.”
    • accountsobject“WHICH accounts of a multi-account channel to post to, e.g.”
    • imageUrlstring“a Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL.”
    • videoUrlstring“a Hermoso render URL (a /generated path, or what upload_file returned), a data: URI, or a public https URL — required for youtube, and for tiktok unless you pa…”
    • imageUrlsarray“CAROUSEL — an ORDERED list of image URLs to publish as ONE swipeable post on every channel that supports it (Instagram 2–20, Threads 2–20, Facebook, LinkedIn c…”
    • titlestring“PINTEREST / YOUTUBE — the headline, max 100 characters.”
    • descriptionstring“YOUTUBE: the video DESCRIPTION, max 5000 characters, carrying the links, the CTA and what YouTube search reads.”
    • tagsarray“YOUTUBE — up to 30 search tags for the video (plain words, no #).”
    • thumbnailUrlstring“YOUTUBE: the custom thumbnail, a Hermoso-hosted image.”
    • paidProductPlacementboolean“YOUTUBE: paid product placement (shows the disclosure).”
    • brandPartnerstring“YOUTUBE: sponsoring brand channel (UC… or @handle).”
    • categoryIdstring“YOUTUBE: NUMERIC category id (28 Science & Technology, 27 Education, 24 Entertainment, 22 People & Blogs…; list_youtube_categories names them).”
    • madeForKidsboolean“YOUTUBE: declare the video MADE FOR KIDS (COPPA).”
    • notifySubscribersboolean“YOUTUBE: notify subscribers when it goes live.”
    • captionTrackobject“YOUTUBE: a subtitle track (SRT or WebVTT) uploaded right after the video goes up.”

    and 95 more not listed here.

  • list_scheduledon 5 other servers

    “Use this when the user asks what is scheduled, what already posted, or whether a post went out.”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    5 inputs
    • brandstring“WHICH PROFILE to list — the id or exact name from list_brands.”
    • idstring“one post id from this list: returns that post in full, every caption and setting included”
    • channelstring“only posts that include this channel, e.g.”
    • upcomingnumber“how many queued posts to list, soonest first (default 25, max 200)”
    • firednumber“how many already-fired posts to list, most recent last (default 15, max 200)”
  • reschedule_poston 5 other servers

    “Change a post that is still QUEUED — move it to a different time, rewrite the caption, swap the media, add or drop a channel, or change which board / Page / company Page / listing it goes to.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    117 inputs, 1 required
    • brandstring“WHICH PROFILE this post is in — id or exact name from list_brands; needed when it is not the profile this connection is pinned to.”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • idstringrequired“the scheduled post id from list_scheduled”
    • atstring“the new time: local wall clock (2026-10-30T10:00, read in `timezone` or the brand’s zone on that date), UTC (…Z) or epoch ms.”
    • timezonestring“IANA zone for a wall-clock `at`”
    • messagestring“replace the caption used for every channel that has no override”
    • captionsobject“replaces the WHOLE per-channel caption map — send every override you want to keep, not just the new one”
    • optimizeCopyboolean“fit the shared caption to each channel’s own rules when you schedule it (the fitted caption is stored on the scheduled post, so what you scheduled is what publ…”
    • channelsarray“replaces the channel list”
    • imageUrlstring“swap the image; "" removes it”
    • videoUrlstring“swap the video; "" removes it”
    • imageUrlsarray“replace the CAROUSEL slides, in order; an empty array [] drops the carousel and goes back to a single image.”
    • titlestring“PINTEREST / YOUTUBE — replace the headline; "" clears it and goes back to deriving one from the caption”
    • descriptionstring“YOUTUBE — replace the video description; "" clears it and the caption is used.”
    • tagsarray“YOUTUBE — replaces the WHOLE tag list; an empty array [] clears the tags.”
    • thumbnailUrlstring“YOUTUBE: replace the custom thumbnail; "" goes back to a frame of the video, "auto" to YouTube’s pick.”
    • paidProductPlacementboolean“YOUTUBE: paid product placement (shows the disclosure) — false removes it”
    • brandPartnerstring“YOUTUBE: sponsoring brand channel (UC… or @handle); "" removes it”
    • categoryIdstring“YOUTUBE: NUMERIC category id; "" goes back to the default (22).”
    • madeForKidsboolean“YOUTUBE: made-for-kids declaration.”
    • notifySubscribersboolean“YOUTUBE: notify subscribers when it goes live.”
    • captionTrackobject“YOUTUBE: replace the queued caption track (url OR text, plus language).”
    • replyControlstring“THREADS ONLY — who may reply.”
    • threadsLongTextstring“THREADS ONLY — LONG-FORM text, up to 10,000 characters, attached under a TEXT-only Threads post (Threads' text attachment).”

    and 92 more not listed here.

  • cancel_scheduledon 5 other servers

    “Remove a queued post before it goes out.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    2 inputs, 1 required
    • idstringrequired“the scheduled post id from list_scheduled”
    • brandstring“WHICH PROFILE this post is in — id or exact name from list_brands; needed when it is not the profile this connection is pinned to.”
  • retry_scheduledon 1 other server

    “Send a post that FAILED again.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    13 inputs, 1 required
    • brandstring“WHICH PROFILE this post is in — id or exact name from list_brands; needed when it is not the profile this connection is pinned to.”
    • idstringrequired“the scheduled post id from list_scheduled”
    • channelsarray“retry only these channels (default: every channel that did not publish)”
    • atstring“hold the retry until a later time — ISO timestamp or epoch milliseconds.”
    • allowDuplicateboolean“ONLY for a channel you have checked by hand and confirmed the post is genuinely NOT there.”
    • boardIdstring“CORRECT THE BOARD on retry — the Pinterest board the Pin goes on, from list_pinterest_boards.”
    • chatIdstring“CORRECT THE TELEGRAM DESTINATION on retry — the @username or numeric id of the chat.”
    • whopExperienceIdstring“WHOP — correct the forum or chat on retry (exp_…, from list_whop_destinations).”
    • pageIdstring“CORRECT THE PAGE on retry — which connected Facebook Page (and its linked Instagram/Threads) publishes, from list_meta_pages.”
    • linkedinOrganizationIdstring“CORRECT THE LINKEDIN AUTHOR on retry — the company Page id from list_linkedin_pages.”
    • locationIdstring“CORRECT THE LISTING on retry — which Google Business Profile location, e.g.”
    • messagestring“CORRECT THE CAPTION on retry — use this when the original was refused for length or content.”
    • captionsobject“CORRECT ONE CHANNEL’S CAPTION on retry, e.g.”
  • duplicate_scheduledon 1 other server

    “Copy an existing scheduled or already-published post into a NEW queued post — the way to run a creative again, reuse a post that worked as the starting point for the next one, or re-send something af…”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    22 inputs, 1 required
    • brandstring“WHICH PROFILE this post is in — id or exact name from list_brands; needed when it is not the profile this connection is pinned to.”
    • idstringrequired“the post to copy, from list_scheduled”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • atstring“when the copy goes out: local wall clock (2026-10-30T10:00), UTC or epoch ms (default: an hour from now)”
    • useQueueboolean“instead of naming a time, take the brand’s next free posting slot”
    • timezonestring“IANA zone for a wall-clock `at` or the queue”
    • channelsarray“post the copy to these channels instead of the original’s”
    • messagestring“a different caption for the copy”
    • captionsobject“per-channel caption overrides for the copy”
    • imageUrlstring“replacement image for the copy: a Hermoso render URL or an upload_file URL”
    • videoUrlstring“replacement video for the copy: a Hermoso render URL or an upload_file URL”
    • imageUrlsarray“CAROUSEL — an ORDERED list of image URLs published as ONE swipeable post”
    • titlestring“Pinterest or YouTube headline for the copy, max 100 characters”
    • linkstring“destination URL for the copy (Pinterest, Facebook text post or Google Business post)”
    • boardIdstring“PINTEREST — the board for the copy (list_pinterest_boards)”
    • chatIdstring“TELEGRAM — which chat, group or channel the copy goes to (@username or numeric id)”
    • whopExperienceIdstring“WHOP — which forum or chat the copy goes to (exp_…, from list_whop_destinations).”
    • linkedinOrganizationIdstring“LINKEDIN — publish the copy as this company Page (list_linkedin_pages)”
    • pageIdstring“FACEBOOK / INSTAGRAM / THREADS — which connected Page (list_meta_pages)”
    • locationIdstring“GOOGLE BUSINESS — which listing (list_business_locations)”
    • visibilitystring“public (default), unlisted or private (YouTube), or draft (TikTok or an unpublished Facebook Page post)”
  • get_post_refillon 1 other server

    “Show AUTOPILOT POSTING (autoposting, the posting refill) for this profile — "is autopilot on?", "what is waiting for review?": whether it is on, its mode (review = each batch of fresh posts waits as …”

    Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

    Takes no inputs.

  • set_post_refillon 1 other server

    “Turn AUTOPILOT POSTING (autoposting, the posting refill) on, change it or pause it.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    24 inputs
    • enabledboolean“on/off.”
    • modestring“"review" (default): each batch of fresh posts waits as drafts for approval.”
    • daysAheadnumber“how far ahead to keep the queue full, 1–30 (default 7)”
    • postsPerDaynumber“posts a day, up to the number of posting times ("2 times a day" = 2).”
    • postingTimesarray“the brand's daily posting times, 24-hour "HH:MM" (e.g.”
    • timezonestring“IANA timezone the posting times are in, e.g.”
    • channelPostsPerDayobject“per channel, how many posts a day (the first N of the posting times), e.g.”
    • goalstring“THE BRIEF: what the posts are for — grow followers, drive sales, promote a launch, or other (say what in goalNote).”
    • goalNotestring“THE BRIEF: a line about the goal (e.g.”
    • pillarsarray“THE BRIEF: content pillars / topics, up to 8 short lines.”
    • formatsstring“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.”
    • avoidarray“THE BRIEF: never mention or show these — topics, claims, competitors, faces.”
    • learningsarray“notes learned from reviews; REPLACES the list”
    • forgetCaptionEditsboolean“true = forget the caption edits learned from past reviews”
    • channelsarray or string“REPLACES the list; a channel connected later stays out until added.”
    • addChannelsarray“add these”
    • removeChannelsarray“stop posting here”
    • excludeChannelsarray“never these channels, even ones connected later; [] clears”
    • boardIdstring“PINTEREST — which board Pins go on (list_pinterest_boards).”
    • chatIdstring“TELEGRAM — which chat, group or channel posts go to (@username or numeric id).”
    • whopExperienceIdstring“WHOP — which forum or chat posts go to (exp_…, from list_whop_destinations).”
    • linkedinOrganizationIdstring“LINKEDIN — which company Page to post as (list_linkedin_pages).”
    • pageIdstring“FACEBOOK / INSTAGRAM / THREADS — which connected Page to publish from (list_meta_pages).”
    • accountsobject“accounts to post to on a channel holding several: {"tiktok":["@a","@b"]} or "all"; null clears.”
  • run_post_refillon 1 other server

    “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 …”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    7 inputs
    • dryRunboolean“default TRUE (a preview: nothing rendered, nothing queued; the copy it writes bills its model cost).”
    • forceboolean“plan a preview even while autoposting is switched off — useful for showing someone what it would do before they turn it on.”
    • approvearray“REVIEW: draft ids to schedule, or ["all"].”
    • discardarray“REVIEW: draft ids to delete, or ["all"].”
    • editarray“REVIEW: change drafts before approving them.”
    • learnarray“notes for future batches, e.g.”
    • redoobject“remake one draft from feedback; paid, so without confirm:true it returns only the price”
  • post_to_linkedinon 1 other server

    “Use this when the user wants to post to their personal LinkedIn profile.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    23 inputs, 1 required
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“WHAT ANGLE this post is built on, recorded only at publish time.”
    • subjectstring“WHAT THIS POST IS ABOUT — product, feature, offer or theme (e.g.”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • textstringrequired“the post text”
    • imageUrlstring“a Hermoso-hosted image URL to attach (≤12MB) — a Hermoso render, or ANY file of the user’s own put through upload_file first.”
    • imageUrlsarray“a MULTI-IMAGE post: 2–20 Hermoso-hosted images in order, one post the reader swipes through (LinkedIn’s MultiImage API takes a member author on w_member_social…”
    • videoUrlstring“a Hermoso-hosted video (a render, or the user’s footage via upload_file).”
    • captionsSrtstring“SRT caption CONTENT for a videoUrl post (English only, attached during upload)”
    • videoThumbnailUrlstring“cover image for a videoUrl post (Hermoso-hosted)”
    • titlestring“video title”
    • altTextstring or array“image alt text — a string for every image, or an array per slide”
    • linkUrlstring“a LINK post with a real preview card.”
    • linkTitlestring“the card headline — LinkedIn never scrapes the page, so without it the card is unlabelled”
    • linkDescriptionstring“link card description; LinkedIn does not read the page, so set it here”
    • linkThumbnailUrlstring“Hermoso-hosted image for the card”
    • documentUrlstring“a DOCUMENT post — a Hermoso-hosted PDF / PPTX / DOCX (upload_file first) that readers swipe through page by page in the feed; LinkedIn takes up to 100MB and 30…”
    • documentTitlestring“the title shown on the document (defaults to the file name)”
    • mentionsarray“TAG COMPANIES: write "@Name" in the text where each tag goes and list each company here — its vanity name (the part after linkedin.com/company/), its company p…”
    • idempotencyKeystring“SAFE RETRIES — any stable string: a repeat of the SAME publish within 24h returns the ORIGINAL post id instead of posting again (an identical publish is also a…”
    • allowDuplicateboolean“post it even though an identical post was just made or attempted.”
    • visibilitystring“default PUBLIC”
  • “Use this when the user wants to post to X (Twitter) now.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    27 inputs
    • accountstring“WHICH connected account of this channel to post as — its @handle or id from list_connector_accounts.”
    • brandstring“WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id).”
    • hookstring“WHAT ANGLE this post is built on, recorded only at publish time.”
    • subjectstring“WHAT THIS POST IS ABOUT — product, feature, offer or theme (e.g.”
    • recipestring“the post's FORMAT id, e.g.”
    • ideaIdstring“short id of the content-plan idea this post came from”
    • textstring“the post text.”
    • threadarray“a thread: each string is one post, published in order, each replying to the previous (if `text` is also set it is posted first and these follow).”
    • dryRunboolean“true = post NOTHING and return what this exact post would cost (costCredits).”
    • mediaUrlstring“a Hermoso render (image or video) to attach to the first post — pass its served URL, or an upload_file url for external media; a URL, not a local file path; us…”
    • videoUrlstring“alias of mediaUrl for a VIDEO — same as passing it as mediaUrl”
    • imageUrlstring“alias of mediaUrl for an IMAGE — same as passing it as mediaUrl”
    • mediaUrlsarray“UP TO FOUR Hermoso-hosted media attached to ONE post — X’s own schema caps media_ids at 4.”
    • altTextstring or array“accessibility description of the attached media, max 1000 characters — write one whenever you attach a render.”
    • pollobject“run a poll on the post.”
    • replySettingsstring“restrict who can reply — omit for everyone, which is the right default for a brand post”
    • replyToIdstring“numeric id of an existing X post to reply to.”
    • quotePostIdstring“numeric id of a post to QUOTE — X renders the quoted post inside yours.”
    • communityIdstring“publish into an X COMMUNITY instead of the main timeline — the number in the community’s own URL (x.com/i/communities/<id>).”
    • paidPartnershipboolean“label the post a PAID PARTNERSHIP on X — the same disclosure Hermoso already ships for TikTok.”
    • videoTitlestring“VIDEO posts only — a headline under the video, max 70 (measured: X drops it on an image post, so it is refused there)”
    • videoDescriptionstring“VIDEO posts only — a line under the title, max 200”
    • videoCtastring“VIDEO posts only — a button on the video; needs videoCtaUrl (https)”
    • videoCtaUrlstring“https link the video button opens; used with videoCta”
    • taggedUserIdsarray“tag up to 10 people (numeric X user ids, from x_user) in the post’s media”

    and 2 more not listed here.

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. The first 100 of 424 tools are listed. Read 2026-11-07; remote servers are read the day they appear and again about every 30 days; package servers at the monthly refresh.

How well are its tools described?

Features #4 and #5

How clearly this server's own tool descriptions say what a tool does, and how consistent its tool list is. The first part is an AI model's yes/no reading of each description; the second part is counted. We do not turn it into a grade.

Descriptions

AI reading of each description

No AI reading was available for this server's tools (the two runs did not agree, or the listing was not reviewed).

Counted from the listing

Parameters with a description
93% of 2,391
Tools with a description
100% of 424
Typical description length
641 characters

The tool set

Counted from the listing

Tools
424
Size of the list
about 203,842 tokens for an agent to load (characters ÷ 4)
Naming
422 of 424 names use snake_case

AI reading: easy to mix up

No pair found.

The AI items cover 0 of 424 tools: for a tool where two differently worded runs disagreed, that item is left out. They were not checked by hand, and no tool was called. “Easy to mix up” means two tools whose names or descriptions overlap without saying how they differ; the AI found none, comparing tools within groups of 40. We do not rate whether the tool set is complete or whether side effects are spelled out, because our AI reading of those was not reliable enough.

How do I add it to my client?

Config from the registry entry

From the remote endpoint (Streamable HTTP)

We connected to this URL on 2026-11-07 (a read-only session: no tool was called).

Add to CursorAn install link in the format Cursor documents, holding the Cursor config below.

Claude Desktop or claude.ai
Settings → Connectors → Add custom connector, then paste:
https://app.hermoso.ai/mcp
Cursor · .cursor/mcp.json in a project, or ~/.cursor/mcp.json
{
  "mcpServers": {
    "hermoso-social-media-manager": {
      "url": "https://app.hermoso.ai/mcp"
    }
  }
}
VS Code · .vscode/mcp.json
{
  "servers": {
    "hermoso-social-media-manager": {
      "type": "http",
      "url": "https://app.hermoso.ai/mcp"
    }
  }
}
VS Code (command line) · Bash or zsh terminal (macOS, Linux)
code --add-mcp '{"name":"hermoso-social-media-manager","type":"http","url":"https://app.hermoso.ai/mcp"}'
Claude Code
claude mcp add --transport http hermoso-social-media-manager https://app.hermoso.ai/mcp
Cline · cline_mcp_settings.json (Cline CLI: ~/.cline/data/settings/; in the editor: MCP Servers → Configure → Configure MCP Servers)
{
  "mcpServers": {
    "hermoso-social-media-manager": {
      "type": "streamableHttp",
      "url": "https://app.hermoso.ai/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Gemini CLI · ~/.gemini/settings.json, or .gemini/settings.json in a project
{
  "mcpServers": {
    "hermoso-social-media-manager": {
      "httpUrl": "https://app.hermoso.ai/mcp"
    }
  }
}
OpenAI Codex · ~/.codex/config.toml, or .codex/config.toml in a trusted project
[mcp_servers.hermoso-social-media-manager]
url = "https://app.hermoso.ai/mcp"
Zed · Zed settings file (command: zed: open settings file)
{
  "context_servers": {
    "hermoso-social-media-manager": {
      "url": "https://app.hermoso.ai/mcp"
    }
  }
}
Try it in the MCP Inspector · runs on your machine, opens in your browser · Node 22.19+
npx @modelcontextprotocol/inspector@2.11.0 --server-url https://app.hermoso.ai/mcp --transport http
  • The server runs on the operator's infrastructure; it may ask you to sign in when you first connect.
  • Zed's docs we read on 2026-10-26 describe remote servers by URL and do not name the transport.
  • The MCP Inspector lists the server's tools, resources and prompts; a tool you call there runs for real.

Built from the server's registry entry with each client's documented format (checked 2026-10-14; the Cursor link and the VS Code command 2026-10-19; the MCP Inspector command 2026-10-21; Cline, Gemini CLI, OpenAI Codex and Zed 2026-10-26). Values in < > are yours to fill in; this page never contains a key. Where the server needs a setting the entry does not declare, it can still fail to start.

Does the registry listing match what we found?

Feature #6

The registry checks an entry when it is published (each new version), and nothing re-checks it on a schedule. A difference below is about the listing, not a judgement of the publisher.

Registry saysWe foundResultSource · date
Remote endpoint app.hermoso.ai/mcpSession openedmatchesour test · 2026-11-07
No credential declared as requiredOpened a session without any credentialmatchesour test · 2026-11-07
Repository github.com/hermoso-ai/hermosoOpens publiclymatchesapi.github.com · 2026-11-19

Who made it?

Feature #7 · lineage

Facts about the publisher. We do not turn them into a trust score.

Namespace
io.github.hermoso-ai · 4 servers
GitHub owner
an organization (hermoso-ai)
Repository
github.com/hermoso-ai/hermoso
Stars
8
Repository age
91–180 days
Last push
0–30 days ago
Archived
no
Security policy
SECURITY.md

Source: the registry entry and api.github.com · 2026-11-19; security policy read from GitHub · 2026-11-07; read when the server is listed, then about every 30 days; an operator can ask for an earlier re-read.

Publish this server? Run these checks against it yourself before release, from your own machine: a server the command starts, or your own server at its URL after a one-time proof that you control it: npx protocolprobe-selftest.

Choosing

Record checks

Public records · not a safety rating

5 of 5 record checks met · 4 do not apply

  • Not ranked by downloads: a remote server publishes no download figure
  • Not ranked by stars: 8 stars (ranked from 10)
  • MetRegistry entry is active and says how to run itActive, with a package or a remote address.
  • MetSource repository link opensThe linked GitHub repository is public.
  • MetRepository is not archivedNot archived.
  • MetCode pushed to the repository in the 90 days before our checkLast push 0-30 days before our check.
  • MetRepository publishes a security policy (SECURITY.md)SECURITY.md found.
  • Does not applyPackage names its licence with a standard (SPDX) identifierRemote server: it ships no package.
  • Does not applyThe version the registry lists can be installed and is not withdrawnRemote server: it ships no package.
  • Does not applynpm package carries build provenance (attestation)Remote server: it ships no package.
  • Does not applyNo known critical or high advisory in the package or its dependenciesRemote server: it ships no package.

Read from public records only: the registry entry, npm/PyPI, GitHub and advisory databases, checked 2026-11-19 (security policy 2026-11-07). No tool was called. Only “met” and “not met” are counted, so the total differs between servers; a check that does not apply or that we could not run is listed, never counted against it. It is not a safety rating, and the same rules apply to every server. How each check works · Leaderboards · How we stay neutral

Common questions about io.github.hermoso-ai/hermoso-social-media-manager

Answered from the data above

Who publishes io.github.hermoso-ai/hermoso-social-media-manager?

The registry ties the namespace io.github.hermoso-ai to the GitHub account hermoso-ai; only its owner can publish under it. Its linked repository, github.com/hermoso-ai/hermoso, belongs to the same GitHub account. These are facts from the registry and GitHub, not a rating.

Is io.github.hermoso-ai/hermoso-social-media-manager safe to install?

We do not rate servers as safe or unsafe. 5 of its 5 applicable record checks are met (facts from public records, each listed on this page). What the records show: Its source repository opens publicly. Its repository had a push in the last 90 days. These are facts with their sources on this page, not a safety guarantee, and we did not run its tools.

Does io.github.hermoso-ai/hermoso-social-media-manager need an API key or sign-in?

It opened a session without any credential on 2026-11-07. The registry entry declares no required credential; no declaration is not a guarantee.

Has io.github.hermoso-ai/hermoso-social-media-manager been security tested?

Partly. 4 of the 15 checks that apply to it were exercised. It accepted a session without any credential and lists tools whose names suggest they change data. We did not call them. ProtocolProbe publishes no security verdict for a named server.

Does io.github.hermoso-ai/hermoso-social-media-manager publish a security policy?

Yes: its repository has a public security policy (github.com/hermoso-ai/hermoso/blob/HEAD/SECURITY.md). That is the publisher's statement, not permission for us to test the server, and we call none of its tools.

Where is the source code of io.github.hermoso-ai/hermoso-social-media-manager?

In github.com/hermoso-ai/hermoso, which opens publicly.

Found this page useful?

Anonymous · no sign-in

A quick, anonymous reaction — no account, no email. One per kind from your browser. The tally updates when the page is next refreshed, and it is only a rough count, never a safety rating or a measured number of people.

Compare with another server

Side by side: registry entry, our read-only session, the tools and the 18 classification fields. Same values as each page; no score.

Security testing

What did we test, and what did we leave out?

18 checks · features #1, #2

Open without sign-in

It accepted a session without any credential and lists tools whose names suggest they change data. We did not call them. No security score is given; a check we did not run is never counted as passed.

The 18 checks at a glanceour test · 2026-11-07
  1. Inventory: exercised
  2. Hidden instructions: exercised
  3. Real execution: not run · our policy
  4. Secret leak: not run · nothing to check it against
  5. Internal addresses: not run · our policy
  6. Unconfirmed changes: not run · our policy
  7. Bad input: not run · our policy
  8. Model requests: not run · nothing to check it against
  9. Sensitive questions: not run · nothing to check it against
  10. Folder boundary: not run · our policy
  11. Log leaks: not run · nothing to check it against
  12. Hidden content: exercised
  13. Fake assistant turns: not applicable
  14. Token passthrough: not applicable
  15. Token audience: not applicable
  16. Sign-in redirect: not run · our policy
  17. Consent handling: not testable from outside
  18. Sign-in metadata: exercised

4 exercised11 not run (reason given)3 not applicable

Each check ends in exactly one state: exercised, not run (with the reason), or not applicable (with the reason). 4 of the 15 checks that apply to it were exercised. We do not publish security-check outcomes for named servers. These 18 checks are separate from the record checks at the top of this page, which read public records only.

Exercised · 4
  • 1Inventory
    tool-list
    Reads the declared tools, resources and prompts.exercised
  • 2Hidden instructions
    description-poisoning
    Looks for hidden instructions in tool descriptions.exercised
  • 12Hidden content
    audience-hiding
    Checks resources that hide content from the user.exercised
  • 18Sign-in metadata
    oauth-url-scheme
    Checks the published sign-in metadata for unsafe URLs.exercised
Not run, with the reason · 11
  • 3Real execution
    real-execution
    Calls a tool and checks what really happens.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes, except for a server whose operator has claimed it and given permission (that server's page says so); an operator can run this check on their own server with our self-test command.not run · our policy
  • 4Secret leak
    canary-leak
    Plants a fake secret and checks whether it leaks.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 5Internal addresses
    ssrf
    Checks whether a tool can be steered to internal addresses.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes, except for a server whose operator has claimed it and given permission (that server's page says so); an operator can run this check on their own server with our self-test command.not run · our policy
  • 6Unconfirmed changes
    write-without-confirmation
    Checks whether tools that change data act without asking.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes, except for a server whose operator has claimed it and given permission (that server's page says so); an operator can run this check on their own server with our self-test command.not run · our policy
  • 7Bad input
    error-handling
    Sends bad input and watches how the server answers.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes, except for a server whose operator has claimed it and given permission (that server's page says so); an operator can run this check on their own server with our self-test command.not run · our policy
  • 8Model requests
    sampling
    Checks whether the server asks the client's model to act for it.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 9Sensitive questions
    elicitation-sensitive-data
    Checks whether the server asks users for sensitive data.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 10Folder boundary
    root-boundary
    Checks whether the server reaches outside the folders it was given.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes, except for a server whose operator has claimed it and given permission (that server's page says so); an operator can run this check on their own server with our self-test command.not run · our policy
  • 11Log leaks
    logging-side-channel
    Checks whether log messages carry data they should not.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 16Sign-in redirect
    open-redirect
    Checks the sign-in redirect for abuse.Testing the sign-in redirect means sending probes to the operator's sign-in service, which we do not do.not run · our policy
  • 17Consent handling
    confused-deputy
    Checks consent handling when one service acts for another.Depends on the operator's own consent screen, which differs per server and cannot be tested from outside.not testable from outside
Does not apply to this server · 3
  • 13Fake assistant turns
    fake-assistant-turn
    Checks prompts that pose as the assistant's own words.The server exposes no prompts.not applicable
  • 14Token passthrough
    token-passthrough
    Checks whether the server forwards a user's token to other services.The server opened a session without sign-in, so there is no token flow to check.not applicable
  • 15Token audience
    token-audience-validation
    Checks whether tokens meant for another service are accepted.The server opened a session without sign-in, so there is no token flow to check.not applicable

Source: our own test, 2026-11-07, mcp-runtime-engine@0.1.0. Which checks count and why follows our published scoring model.

What happened during the test?

Feature #8

The steps in order, as the test record holds them.

  1. 0 msStarted a read-only session with the server's remote endpoint
  2. 729 msConnected after 0 redirects. No credential was sent or needed.
  3. Read the inventory: 424 tools, 6 resources, 0 prompts.
  4. 6,920 msFinished: 4 checks exercised.

Reference

How is it classified?

18 fields

One value per field, each with its source. Fields written by AI models are marked. A field with no value says why. How often each is read again: methodology.

TopicAI-classified
pending: added at the next monthly refresh
listed 2026-11-07; not classified yet
Pricing modelAI-classified
pending: added at the next monthly refresh
the website is not read yet
Programming language
api.github.com · 2026-11-07 · read when a version is new, and at the monthly refresh
Hosting type
registry · 2026-11-07 · read from the registry entry; changes when a new version is listed
MCP capability
resources, tools
our test · 2026-11-07
Transport
streamable HTTP
registry · 2026-11-07 · read from the registry entry; changes when a new version is listed
Required credentials
none declared
registry · 2026-11-07 · no declaration is not a guarantee · read from the registry entry; changes when a new version is listed
Package registry
does not apply
remote-only server: no package is shipped, so there is no package registry
Freshness
0–30 days
registry updatedAt · 2026-11-07
Lifecycle status
registry · 2026-11-07 · status read from the registry every day
License class
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Integrity hash
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Signature / provenance
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Dependency advisories
does not apply
ships no package, so there are no dependencies to audit
Popularity
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Publisher signals
owner: an organization · repository age: 91–180 days · stars: 0–9
api.github.com · 2026-11-19 · new versions read the day they appear; the rest re-read about every 30 days
Maintenance
api.github.com · 2026-11-19 · new versions read the day they appear; the rest re-read about every 30 days
Environment
the publisher's infrastructure
where it runs, from the hosting type · 2026-11-07 · read from the registry entry; changes when a new version is listed

“Not stated” means the source did not state it; “does not apply” means it does not apply to this kind of server; “our limit” means our own lookup failed. A linked value opens the directory filtered to the same value.

Cite or correct this page

Sources and corrections

Suggested citation

ProtocolProbe. “io.github.hermoso-ai/hermoso-social-media-manager: MCP server record.” Data checked 2026-11-19. https://protocolprobe.com/mcp/servers/io.github.hermoso-ai/hermoso-social-media-manager

Figures are valid for the date shown. Our facts on this page are CC BY 4.0: reuse them with a link and the check date. Quoted text (the publisher’s descriptions, website quotes, tool names) is not ours to license.

As JSON: this record in the API · API documentation.

Badge for your README

ProtocolProbe: 5 of 5 record checks met

[![ProtocolProbe](https://protocolprobe.com/api/v1/badge/io.github.hermoso-ai/hermoso-social-media-manager)](https://protocolprobe.com/mcp/servers/io.github.hermoso-ai/hermoso-social-media-manager)

It shows this server's record-check count: facts from public records, no tool called. It is not a security rating or a pass. It links here and updates after each data reload.

Something wrong, or is this yours?

If a fact here is wrong, tell us and we will re-check it. If you operate this server, you can run our checks on it yourself with the free self-test command; we call no server’s tools ourselves for anything shown here, except for a server whose operator has claimed it and given permission (that server's page says so).

Write to hello@protocolprobe.com · corrections log · methodology