Skip to content

Hermoso: Social Media Manager MCP server

io.github.hermoso-ai/hermoso-social-media-managerhermoso-aistreamable-httpv1.0.0Scanned

AI marketing agent for social: post, schedule and answer comments and DMs across 15 channels.

605 tools: 220 can delete or cancel things, 13 do something that can't be undone, 171 change things and 201 only read.

Tools: 220 delete, 13 irreversible, 171 write, 201 read.
  • Reads private data · 66
  • Reads text others write · 539
  • Can send data out · 129
  • 41 findings, 5 high

Tools listed without sign-in. Remote posture

With Anlyon

220 tools here can delete or cancel things and 13 do something that can't be undone. Govern them.

  • Anlyon lists the tools and adopts none.
  • Each tool you adopt gets approvals and receipts.
  • Your agent never holds the key.
Govern this server →

A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.

What the Hermoso: Social Media Manager MCP server can do

The Hermoso: Social Media Manager MCP server is published by the GitHub account hermoso-ai. It has 605 tools. It can delete or cancel things (220 tools: call_tool, post_to_bluesky, delete_bluesky_post, post_to_telegram and 216 more), do things that cannot be undone, such as sending, paying or publishing (send_line_message, shopify_sales_report, send_sms, place_call and 9 more) and create or change data (171 tools: enable_tools, create_wordpress_term, set_webflow_collection, set_slack_channel and 167 more). 201 tools only read.

66 tools read private data (list_telegram_chats, list_telegram_dms, get_discord_message and 63 more); 539 tools bring in text other people can write (call_tool, post_to_bluesky, delete_bluesky_post and 536 more); 129 tools can send data out of your system (post_to_bluesky, post_to_telegram, post_to_wordpress and 126 more). On its own it has all three parts of a prompt-injection exfiltration path: private data, text others write, and a way out.

The fixed checks matched 41 findings, 5 of them high severity (tool-shadowing, long-description, credentials-mention, annotation-conflict and 1 more). Each one comes with the text it matched.

Its remote endpoint lists its tools without sign-in, and its tools changed once since Anlyon Radar first saw them.

Last scanned Nov 21, 2026, version 1.0.0.

Tools

Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.

605 tools

Deletes or cancels 220Claude Code: deny
  • add_intercom_noteLeave an INTERNAL NOTE on an Intercom conversation: only the brand's teammates see it, never the customer (a summary, a suggested reply, a handover).Reads text others writeNo findings

    Why it is in this group

    • The name "add_intercom_note" says "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Leave an INTERNAL NOTE on an Intercom conversation: only the brand's teammates see it, never the customer (a summary, a suggested reply, a handover). Without confirm:true it adds nothing and returns the preview; call again with confirm:true once the user agrees. Read back from the conversation. Free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add an internal Intercom note
  • answer_google_business_questionPost the business’s answer to a public question on the brand’s Google Business Profile listing, or delete the answer already there.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The description's first verb is "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Post the business’s answer to a public question on the brand’s Google Business Profile listing, or delete the answer already there. THIS IS AN UPSERT — one answer per account, so answering again REPLACES the previous one rather than adding a second. Deleting is public and immediate and is confirm-gated. Needs Google Business Profile connected and the project approved.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Answer a question on a Google Business listing
  • approve_postApprove a scheduled post that is waiting for approval: it then goes out at its time (right away if that time has passed).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "approve_post" says "approve": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "approve_post" says "approve" and "post": it writes something other people read.
    Description, as the server wrote it
    Approve a scheduled post that is waiting for approval: it then goes out at its time (right away if that time has passed). Admins of the brand only. Show the user the post first (list_pending_approvals).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Approve a scheduled post
  • assign_discord_roleGive one member of the brand's Discord server a role.Reads text others writeNo findings

    Why it is in this group

    • The name "assign_discord_role" says "assign": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Give one member of the brand's Discord server a role. userId is the member id (search_discord_members); role is its id or exact name. A role can unlock channels and powers, so call it WITHOUT confirm first: nothing changes and you get a sentence naming the member, what the role carries and how many members hold it. The role must sit below the Hermoso role. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Give a Discord member a role
  • call_toolRun 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 acc…Reads text others writeNo findings

    Why it is in this group

    • The name "call_tool" says "call": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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 result as calling it directly. Get the exact `name` and its `args` from find_tools first. This is the route on hosts that cannot reload their tool list mid-conversation (claude.ai, ChatGPT): enable_tools switches a group on server-side, but such a host keeps the list it fetched at connect time. Arguments are validated against the tool's own schema and a mistake is answered with the expected parameters, not a silent default. Refused by name, with the way out, when the tool needs a connector this workspace has not made or is withheld by the host's own policy.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Run any Hermoso tool by name
  • cancel_klaviyo_campaignStop a Klaviyo campaign that is scheduled or sending: action 'revert' puts it back to a draft (only before it goes), 'cancel' cancels it for good.Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_klaviyo_campaign" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Stop a Klaviyo campaign that is scheduled or sending: action 'revert' puts it back to a draft (only before it goes), 'cancel' cancels it for good. Emails already delivered stay delivered. Without confirm:true nothing changes and you get what would happen. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Stop a Klaviyo campaign
  • cancel_mailchimp_campaignStop a Mailchimp campaign: action 'unschedule' puts a scheduled one back to a draft; 'cancel' stops one that is sending (emails already delivered stay delivered).Reads text others write1 finding

    Why it is in this group

    • The name "cancel_mailchimp_campaign" says "cancel": a word for removing or ending something.
    • The server marks it not destructive (destructiveHint: false), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "cancel_mailchimp_campaign" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "cancel_mailchimp_campaign" says "cancel": a word for removing or ending something.

      What this check looks for
    Description, as the server wrote it
    Stop a Mailchimp campaign: action 'unschedule' puts a scheduled one back to a draft; 'cancel' stops one that is sending (emails already delivered stay delivered). Without confirm:true nothing changes and you get what would happen. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Stop a Mailchimp campaign
  • cancel_port_orderStop a port that has not completed: the numbers stay with their current carrier.Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_port_order" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Stop a port that has not completed: the numbers stay with their current carrier. Without confirm:true nothing is cancelled; call again with confirm:true once the user agrees. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Cancel a port order
  • cancel_scheduledRemove a queued post before it goes out.Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_scheduled" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a queued post before it goes out. Get the id from list_scheduled. Only works while it is still queued — something already published cannot be unsent (use manage_meta_post to delete a Facebook/Instagram post after the fact).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Cancel a scheduled post
  • cancel_shopify_orderCancel a Shopify order.Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_shopify_order" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Cancel a Shopify order. Shopify CANNOT undo a cancellation. By default it refunds what was paid to the original payment and puts the items back in stock (refund:false / restock:false keep either); notifyCustomer emails the buyer; staffNote (≤255) is for staff. Without confirm:true NOTHING changes and the reply states the refund amount: show the user, get a yes, then call again with confirm:true and confirmAmount set to that exact amount. Shopify cancels in the background, so the reply says whether the order read back cancelled; never cancel it twice. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Cancel a Shopify order
  • cancel_slack_scheduledCancel a message scheduled in Slack (from list_slack_scheduled).Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_slack_scheduled" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Cancel a message scheduled in Slack (from list_slack_scheduled). Slack refuses once it is within 60 seconds of posting. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Cancel a message scheduled in Slack
  • cancel_voice_agent_batchCancel a batch the platform has not finished: calls not yet placed are dropped (Telnyx: one scheduled call, with agentId).Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_voice_agent_batch" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Cancel a batch the platform has not finished: calls not yet placed are dropped (Telnyx: one scheduled call, with agentId). Without confirm:true nothing is cancelled. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Cancel a voice-agent batch
  • cancel_voice_agent_callCancel one scheduled voice-agent call before it starts: Vapi deletes a scheduled call (place_voice_agent_call with scheduledAt), Telnyx a scheduled call (with agentId), and on Rete…Reads text others writeNo findings

    Why it is in this group

    • The name "cancel_voice_agent_call" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Cancel one scheduled voice-agent call before it starts: Vapi deletes a scheduled call (place_voice_agent_call with scheduledAt), Telnyx a scheduled call (with agentId), and on Retell it ends a registered or ongoing call. ElevenLabs schedules only batches (cancel_voice_agent_batch). Without confirm:true nothing is cancelled. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Cancel a scheduled voice-agent call
  • clear_sheet_rangeEmpty a range of cells in a Google Sheet, leaving the rows themselves in place.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Empty a range of cells in a Google Sheet, leaving the rows themselves in place. DESTRUCTIVE: call it WITHOUT confirm first and nothing is cleared — you get back the real number of filled cells in that exact range. Show the user that number, get an unambiguous yes, then call again with confirm:true AND confirmCells set to it. The echo is not ceremony: it is what catches naming A1:Z1000 when you meant A1:Z10, which is the mistake that actually happens. There is deliberately NO default range. The clear is read back and reported as confirmed only if the range really is empty afterwards. To remove a whole tab instead, use manage_sheet_tabs.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Clear a range in a Google Sheet
  • comment_on_meta_postLeave 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.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "comment_on_meta_post" says "comment": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "comment_on_meta_post" says "comment" and "post": it writes something other people read.
    Description, as the server wrote it
    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. This is the "link in the first comment" tactic (Facebook suppresses reach on a post with an outbound link in the body, and an Instagram caption link is not clickable), and it is also how you add a pinned clarification, an offer code or a correction without editing the post. It is PUBLIC and posted as the brand: show the user the exact wording and get their go-ahead first. postId comes from list_meta_posts (target:"instagram" for Instagram media ids). INSTAGRAM: text only (Meta documents no attachment on that edge, so attachmentUrl is refused by name), not on live videos; pass account for an Instagram-Login account or one of several. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Comment on your own Facebook or Instagram post
  • comment_on_tiktok_videoWrite a NEW top-level comment on a TikTok post the authorized account owns.Reads text others writeNo findings

    Why it is in this group

    • The name "comment_on_tiktok_video" says "comment": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Write a NEW top-level comment on a TikTok post the authorized account owns. Text (≤1,200 characters, UTF-8) or an image, and TikTok requires at least one of the two. AN IMAGE HERE MUST BE UPLOADED FIRST — a raw URL is refused on a new comment; call upload_tiktok_comment_image and pass back imageUri + imageWidth + imageHeight together (a reply is the one place TikTok accepts a plain URL). TIKTOK SILENTLY HIDES COMMENTS IT FLAGS AS SPAM and sends no signal when it does, so avoid posting many near-identical comments in a short window, and read the comment back with list_tiktok_comments(status:'PUBLIC') if it matters that it is visible. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Post a new comment on the brand’s own TikTok post
    • idempotentHint: false
  • configure_phone_numberSet what one of the brand's numbers does.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Set what one of the brand's numbers does. connectInbox:true brings its texts into the Hermoso Inbox (false stops it). forwardTo sends its calls to a phone number (+1…), a voice agent's SIP address (sip:…, e.g. a Vapi, Retell or ElevenLabs agent) or, on Twilio, a wss:// media stream; empty string stops forwarding. record:true records forwarded calls. missedCallText is a text sent back to a caller whose call was not answered (empty string turns it off). tracking { campaign, platform, campaignId, callValue } tags the number with the ad campaign it is printed in, for call_tracking_report. If the number's texts or calls already go somewhere else, the answer names it and replaceExisting:true takes them over. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Configure a phone number
  • connect_connectorConnect an account that links with a KEY rather than a sign-in screen, from here, with no browser: AppLovin Ads, Twilio, Vapi, Retell AI, ElevenLabs, Telnyx, Stripe, Intercom, Mail…Reads text others write1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description is 2,485 characters long, over the 2,000 this check looks for.

      Matched text

      description ends: "...ceWebhookUrl} · discord {webhookUrl, announceWebhookUrl} · webhook {webhookUrl*}."

      What this check looks for
    Description, as the server wrote it
    Connect an account that links with a KEY rather than a sign-in screen, from here, with no browser: AppLovin Ads, Twilio, Vapi, Retell AI, ElevenLabs, Telnyx, Stripe, Intercom, Mailchimp, Any mailbox, Klaviyo, Vercel, ChatGPT Ads, Apple Ads, Bluesky, Telegram, Bing Webmaster Tools, PostHog, Mixpanel, Amplitude, LINE, WordPress, Webflow, Wix, Slack, Discord, Webhook. Gmail and Google Workspace too: provider "gmail", fields { email, password } with an APP PASSWORD (detect_mailbox_settings gives the steps); it sends and reads replies. Pass provider and fields in that provider's own field names (listed below, * = required). The key is checked live with the provider before anything is saved, exactly as the app's Connectors page checks it, and the reply is read back from the saved connection. OFFER BOTH WAYS AND LET THE USER CHOOSE: a key pasted into this chat stays in this conversation's history, while pasting it in the app (Connectors, or the one-click link https://app.hermoso.ai/?connect=<provider>) keeps it out of the chat. Hermoso never repeats a submitted key back. An account that connects through the provider's own sign-in screen (OAuth) cannot be connected here: this answers with the link to hand the user instead. Apple Ads with no key material first generates a signing key pair and returns the public key to register with Apple plus a setupToken to send back. Fields: applovin_ads {reportKey, eventKey, apiKey, capiKey, accountId} · twilio {accountSid*, authToken, apiKeySid, apiKeySecret} · vapi {apiKey*} · retell {apiKey*} · elevenlabs {apiKey*} · telnyx {apiKey*, publicKey} · stripe {apiKey*} · intercom {accessToken*, region} · mailchimp {apiKey*, server} · smtp {email*, password*, preset, username, smtpHost, smtpPort, smtpSecurity, imapHost, imapPort, imapSecurity, fromName} · klaviyo {apiKey*} · vercel {token*, team} · openai_ads {apiKey*} · apple_ads {clientId, teamId, keyId, privateKey, setupToken, orgId} · bluesky {identifier*, appPassword*, pds} · telegram {token*} · bing_webmaster {apiKey*} · posthog {apiKey*, region, host, projectId} · mixpanel {username*, secret*, projectId*, region, workspaceId} · amplitude {apiKey*, secretKey*, region, host} · line {channelAccessToken*, channelSecret*, replaceWebhook} · wordpress {siteUrl*, username*, appPassword*} · webflow {token*, siteId, collectionId} · wix {apiKey*, siteId*, memberId} · slack {webhookUrl, announceWebhookUrl} · discord {webhookUrl, announceWebhookUrl} · webhook {webhookUrl*}.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Connect a paste-a-key account
  • create_messenger_marketing_campaignThe container a paid Messenger marketing message is sent from (Meta act_<AD>/message_campaign).Reads text others writeNo findings

    Why it is in this group

    • The name "create_messenger_marketing_campaign" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The container a paid Messenger marketing message is sent from (Meta act_<AD>/message_campaign). Budgets are in the AD ACCOUNT’s currency (the *Usd parameter names are historical); Meta bills per DELIVERED message against the campaign budget, and creating it sends and charges nothing. A NEW campaign cannot send for about an hour (61 minutes measured 2026-09-14) while Meta populates and prepares it (2300012 then 2300041, each with remaining_seconds), so create it ahead of time or reuse one from list_messenger_marketing_campaigns. dailyBudgetUsd OR lifetimeBudgetUsd, and Meta refuses either under USD 30 (code 1885272, measured 2026-09-14) (omit both and Meta sets an estimated daily cap; Meta may spend up to 175% of a daily budget on one day, never more than 7× per week). REGION LAW: Meta lets us serve businesses in 20 countries only — US, Mexico, Brazil, India, Australia, Singapore, UAE, Saudi Arabia, Hong Kong, Taiwan, Thailand, Malaysia, Indonesia, Philippines, Vietnam, New Zealand, Chile, Colombia, Peru, Israel — NOT Canada, the EU or the UK — and cannot deliver to people in the EU, UK, Japan, South Korea or Australia. Political Pages are excluded. dryRun:true shows the exact body.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Messenger marketing-message campaign
    • idempotentHint: false
  • create_shopify_discount_codeCreate a discount code customers type at checkout on the merchant's Shopify store, for every product: percentOff (20 = 20% off) OR amountOff (a fixed amount in the store's currency…Reads text others writeNo findings

    Why it is in this group

    • The name "create_shopify_discount_code" says "create": a word for a change.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a discount code customers type at checkout on the merchant's Shopify store, for every product: percentOff (20 = 20% off) OR amountOff (a fixed amount in the store's currency), with an optional minimum purchase (minSubtotal OR minQuantity, not both), startsAt (default now), endsAt, usageLimit (total uses) and oncePerCustomer. THE CODE WORKS AT THE LIVE CHECKOUT AND EVERY USE IS MONEY OFF THE STORE'S SALES, so without confirm:true NOTHING is created and the reply describes exactly the code that would be: show the user, get a yes, then call again with confirm:true. The reply after creating is Shopify's own copy of the code, read back. Nothing the user wrote is changed: an impossible value (a code with a space, 0% or over 100%, an end date in the past) is refused with the reason. The first time, the store may need to approve Hermoso's discount permission: the reply says how. Works for the Shopify store connected to this brand (Connectors > Shopify, or connect_shopify_store) or the store this account was installed on. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Shopify discount code
  • create_whatsapp_templateSubmit a new WhatsApp message template for Meta’s review, or with edit:true change an existing one (see edit).Reads text others write1 finding

    Why it is in this group

    • The name "create_whatsapp_template" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description is 2,057 characters long, over the 2,000 this check looks for.

      Matched text

      description ends: "...d a PRODUCT card carousel takes its pictures from a connected catalog. 0 credits."

      What this check looks for
    Description, as the server wrote it
    Submit a new WhatsApp message template for Meta’s review, or with edit:true change an existing one (see edit). This is the ONLY way a business can start a WhatsApp conversation: outside the 24-hour window that opens when a customer messages first, WhatsApp accepts approved templates and nothing else. CATEGORY IS NOT COSMETIC — MARKETING (anything promotional), UTILITY (a transactional follow-up to something the customer did) or AUTHENTICATION (a one-time passcode) decides both what Meta charges for the conversation and the policy the content is reviewed against, and Meta RE-CATEGORISES a template whose content does not match the claim; the reply reports the category Meta actually assigned, not the one requested. The name is lowercase letters, digits and underscores only. Language is never defaulted: en and en_US are different templates to Meta. Submitting does NOT make it sendable — it comes back PENDING and has to be re-read with list_whatsapp_templates. CAROUSEL TEMPLATES ARE SUPPORTED: add a “CAROUSEL” component whose “cards” array holds 2–10 cards, each card carrying its own HEADER (format IMAGE or VIDEO for a media carousel, PRODUCT for a catalog one), an optional card BODY of at most 160 characters — a different and far shorter limit than the message bubble’s 1024 — and up to 2 buttons. Meta requires every card to carry THE SAME components, and if any card has body text then all of them must. A MEDIA HEADER NEEDS AN UPLOADED ASSET: any IMAGE, VIDEO or DOCUMENT header — including every card header in a media carousel — must carry example: { header_handle: [ … ] } holding a handle from Meta’s Resumable Upload API, or Meta refuses the whole template with a bare “Invalid parameter”. Pass `mediaUrl` on that header (a public JPEG/PNG for IMAGE, MP4 for VIDEO, PDF for DOCUMENT) and Hermoso uploads it through Meta's Resumable Upload API and fills the handle; a header with neither is refused locally and by name. A TEXT header needs no handle, and a PRODUCT card carousel takes its pictures from a connected catalog. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a WhatsApp message template
  • creator_campaign_fundsMoney a brand pays INTO one creator campaign ahead of payouts, and the campaign's OPTIONAL automatic payouts (off unless the brand turns them on).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Money a brand pays INTO one creator campaign ahead of payouts, and the campaign's OPTIONAL automatic payouts (off unless the brand turns them on). action read (default): funds available, on hold, spent and taken back, and whether automatic payouts are on. action fund with amountUsd (+ method card or bank): a PREVIEW, nothing charged (the funds + one payment processing line + currency conversion); confirm:true with acceptTerms:true and expectTotalCents from the preview makes the payment link. Funds are held like every payment (7 days by card, 14 once a bank debit clears), then payouts are paid from them, each taking the creator's amount, the Hermoso fee and Stripe's payout costs. action auto_on (acceptTerms:true: the brand's standing instruction) or auto_off: Hermoso pays payable earnings from the funds as they come off hold and never charges the brand. action refund: what is left goes back to the payment method (preview, then confirm:true). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Campaign funds and automatic payouts
  • crosspost_discord_messagePublish a message in a Discord ANNOUNCEMENT channel to every server that follows that channel.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The description's first verb is "publish": a word for a change that another call does not undo.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "publish": it sends or publishes something to other people.
    Description, as the server wrote it
    Publish a message in a Discord ANNOUNCEMENT channel to every server that follows that channel. It cannot be taken back short of deleting the message, so only when the user asked. The channel must be an announcement channel (list_discord_channels marks them). The bot publishes its own posts; a message somebody else wrote needs Manage Messages on the Hermoso role, which the bot does not ask for. post_to_discord with crosspost:true does both steps at once. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Publish a Discord announcement to following servers
  • deactivate_phone_serviceTurn Hermoso phone off for this brand: every number it holds is released (gone for good), texts and calls stop, and nothing more is charged.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Turn Hermoso phone off for this brand: every number it holds is released (gone for good), texts and calls stop, and nothing more is charged. Without confirm:true nothing changes and the answer names the numbers that would be released; call again with confirm:true only after the user agrees to that exact list. To keep a number, port it to another carrier first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Turn off Hermoso phone
  • delete_bluesky_postPERMANENTLY delete one of the connected Bluesky account's OWN posts.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_bluesky_post" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete one of the connected Bluesky account's OWN posts. IRREVERSIBLE — the AT Protocol removes the record from the account's repo, there is no trash and no undelete, and the post's likes, reposts, replies and quotes go with it. Call it WITHOUT confirm first: nothing is deleted, and it reports the post's REAL text and its live like / repost / reply / quote counts read back from Bluesky. Show the user that, get an unambiguous yes, then call again with confirm:true — plus, once the post has ANY engagement, confirmText echoing the post's own text (the first 40 characters is enough; any longer leading run works too). confirmText exists because confirming that you meant to delete SOMETHING does not prove you aimed at the right post, and a wrong id must not be confirmable blind. A brand-new post with nothing on it stays a ONE-call delete. Identify the post by its AT-URI or by just its RECORD KEY — the short id at the end of its bsky.app link, e.g. 3mtc4n3fibn2x. Deleting only ever works on the connected account's own posts; another account's URI is refused. 0 credits. Needs Bluesky connected (Connectors > Bluesky, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a post from the connected Bluesky account
  • delete_brandPERMANENTLY delete a profile and EVERYTHING in it — brand details, memory, swipefile, Library creations, generated assets, avatars, skills, playbooks, chats — and disconnect its co…Reads text others writeNo findings

    Why it is in this group

    • The name "delete_brand" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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. Irreversible, and it applies to everyone the workspace is shared with. Call it WITHOUT confirm first: it reports exactly what that workspace holds. Show the user that inventory verbatim, get an unambiguous yes, then call again with confirm:true — plus, if the workspace is not empty, confirmName set to its exact name and confirmConnectors set to the number of connected accounts it reported. Those two exist because confirming INTENT does not prove you picked the right WORKSPACE, and a wrong target is how a live profile was destroyed. The account's FIRST/anchor profile cannot be deleted this way (it holds the workspace's root storage) — that one is replaced from the app.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a profile
  • delete_contactsRemove contacts by id, email, phone or "instagram:<id>".No findings

    Why it is in this group

    • The name "delete_contacts" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Remove contacts by id, email, phone or "instagram:<id>". Without confirm:true nothing is removed and the answer says what would go, including recorded opt-outs (removing one forgets it). Sequence history and the email lead list are kept. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete contacts
  • delete_creatorRemove a saved creator from this workspace’s cast by id (from list_creators).No findings

    Why it is in this group

    • The name "delete_creator" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Remove a saved creator from this workspace’s cast by id (from list_creators). Records a cross-device delete so they don’t reappear on the user’s other devices. It only drops the roster entry — ads already rendered with that person are untouched — and the same portrait can be saved again with save_creator, so no confirm is needed.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete a creator
  • delete_creator_campaignDelete a DRAFT or CLOSED creator campaign through which no money moved: no payment made or started and no earnings standing.No findings

    Why it is in this group

    • The name "delete_creator_campaign" says "delete": a word for removing or ending something.
    • The description says "cannot be undone".
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete a DRAFT or CLOSED creator campaign through which no money moved: no payment made or started and no earnings standing. It removes the campaign, its creator records, posts, drafts and files, and frees its page address; it cannot be undone. A live campaign must be closed first; one with payment history stays closed instead. Without confirm it is a PREVIEW of what goes; call again with confirm:true only after the user agreed. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
    • title: Delete a creator campaign
  • delete_discord_eventPERMANENTLY delete a scheduled event from the brand's Discord server; Discord keeps no record of it.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_discord_event" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a scheduled event from the brand's Discord server; Discord keeps no record of it. To call an event off but keep it in the server's history, cancel it instead (update_discord_event with status canceled). Call it WITHOUT confirm first: nothing is deleted and you get a sentence naming the event and how many people are interested. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Discord event
  • delete_discord_messagePERMANENTLY delete a Discord message Hermoso posted (the bot's or the announcement webhook's).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_discord_message" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Discord message Hermoso posted (the bot's or the announcement webhook's). Call it WITHOUT confirm first: nothing is deleted and you get a sentence quoting the message to show the user. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Discord announcement
  • delete_discord_rolePERMANENTLY delete a role from the brand's Discord server.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_discord_role" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a role from the brand's Discord server. It comes off every member who holds it, and channels only that role could see become hidden from them. Discord has no undo. Call it WITHOUT confirm first: nothing is deleted and you get a sentence with how many members hold the role to show the user. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Discord role
  • delete_dm_automationDelete one automation by id on any channel.No findings

    Why it is in this group

    • The name "delete_dm_automation" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete one automation by id on any channel. Nothing further is sent by it; messages already sent stay; on X the event subscription is removed when no rule needs it. To pause instead, save it with enabled:false. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete a DM automation
  • delete_drive_fileDelete a Drive file.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_drive_file" says "delete": a word for removing or ending something.
    • The description says "Irreversible".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a Drive file. By default it goes to Trash (recoverable); pass permanent:true to delete it forever. Pass fileId (from list_drive_files) + confirm:true. Irreversible when permanent — confirm with the user first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Drive file
  • delete_google_business_postRemove a Post from the brand’s Google Business Profile listing.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_google_business_post" says "delete": a word for removing or ending something.
    • The description says "CANNOT be undone".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a Post from the brand’s Google Business Profile listing. This takes it off Google Search and Maps immediately and CANNOT be undone — confirm with the user first. Pass the full post name from list_google_business_posts. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Google Business Profile Post
  • delete_instagram_dm_automationDelete one automation by id.No findings

    Why it is in this group

    • The name "delete_instagram_dm_automation" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete one automation by id. Nothing further is sent by it; DMs already sent stay. To pause instead, save it with enabled:false. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete an Instagram DM automation
  • delete_klaviyo_campaignPERMANENTLY delete a Klaviyo campaign (a draft, a sent or a cancelled one; a scheduled one must be reverted first).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_klaviyo_campaign" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Klaviyo campaign (a draft, a sent or a cancelled one; a scheduled one must be reverted first). Without confirm:true nothing is deleted and you get the campaign it would delete; call again with confirm:true only after the user says yes. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a Klaviyo campaign
  • delete_klaviyo_templatePERMANENTLY delete a Klaviyo template.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_klaviyo_template" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Klaviyo template. Without confirm:true nothing is deleted and you get the template it would delete; call again with confirm:true only after the user says yes. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a Klaviyo template
  • delete_library_itemPERMANENTLY delete images/videos from this brand's Library: the entry and the stored file.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_library_item" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete images/videos from this brand's Library: the entry and the stored file. Pass ids (L0… from list_library) or urls. Without confirm it lists what would be deleted; ask the user, then call again with confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete from Library
  • delete_linkedin_commentRemove a comment from one of your LinkedIn company Page's posts — your own Page's comment, or somebody else's on your Page.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_linkedin_comment" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a comment from one of your LinkedIn company Page's posts — your own Page's comment, or somebody else's on your Page. Community Management surface, same separate connection. CONFIRM-GATED: call once without `confirm` to be refused and shown what would go, then again with confirm:true. Deleting is immediate and public. `organizationId` is required because LinkedIn refuses a Page-level delete that does not name the acting organization. The delete is idempotent, so a repeat reports success rather than an error.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a comment from a LinkedIn Page post
  • delete_linkedin_lead_subscriptionRemove a lead notification webhook (subscriptionId from list_linkedin_lead_subscriptions).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_linkedin_lead_subscription" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a lead notification webhook (subscriptionId from list_linkedin_lead_subscriptions). Leads themselves are unaffected and stay readable; only the real-time delivery stops. Read back from LinkedIn. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Stop a LinkedIn lead webhook
  • delete_locationRemove a saved place by id (list_elements).No findings

    Why it is in this group

    • The name "delete_location" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Remove a saved place by id (list_elements). Renders already made are untouched.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete a place
  • delete_mailchimp_campaignPERMANENTLY delete a Mailchimp campaign (a draft or a sent one; a scheduled one must be unscheduled first).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_mailchimp_campaign" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Mailchimp campaign (a draft or a sent one; a scheduled one must be unscheduled first). Without confirm:true nothing is deleted and you get the campaign it would delete; call again with confirm:true only after the user says yes. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a Mailchimp campaign
  • delete_mailchimp_templatePERMANENTLY delete a Mailchimp template.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_mailchimp_template" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Mailchimp template. Without confirm:true nothing is deleted and you get the template it would delete; call again with confirm:true only after the user says yes. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a Mailchimp template
  • delete_messenger_marketing_campaignDelete a marketing-message campaign.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_messenger_marketing_campaign" says "delete": a word for removing or ending something.
    • The description says "Irreversible".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a marketing-message campaign. Irreversible: the first call names it and refuses; confirm:true deletes.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a Messenger marketing-message campaign
    • idempotentHint: false
  • delete_meta_catalogPERMANENTLY delete a product catalog.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_meta_catalog" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a product catalog. Meta does not let a catalog be removed from a business portfolio and then restored, and it cannot be transferred to another portfolio — there is no archive and no undo, and its product sets go with it, so any ad set still bound to one of those sets keeps spending and stops having products to show. Confirming is therefore not enough on a catalog that holds anything: pass confirm:true PLUS confirmName set to the catalog’s exact name (and confirmChildren when asked), which proves you inspected the catalog you are aiming at rather than merely meaning to delete something. An EMPTY catalog stays a one-call delete. Call meta_catalog_blast_radius first to get those numbers and to show the user what they are agreeing to. The result is the READ-BACK, never Meta’s acknowledgement — if the catalog still resolves afterwards you are told it is NOT confirmed. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a Meta product catalog
  • delete_onedrive_fileDelete a OneDrive item — it moves to the OneDrive recycle bin (recoverable there).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_onedrive_file" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a OneDrive item — it moves to the OneDrive recycle bin (recoverable there). Pass fileId (from list_onedrive_files) + confirm:true. Confirm the exact file with the user first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a OneDrive file
  • delete_pinterest_boardPERMANENTLY delete a board AND EVERY PIN ON IT.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_pinterest_board" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a board AND EVERY PIN ON IT. This is the heaviest thing that can be done to a Pinterest account and there is no undelete. Call it WITHOUT confirm first: nothing is deleted, and it answers with the board’s real name, how many Pins are on it, how many people FOLLOW it and how many collaborators lose access — all read back from Pinterest. Show the user that, then call again with confirm:true plus confirmName (its exact name) and confirmChildren (the Pin count it reported); those echoes exist because a caller who has not looked at the board cannot supply them, and confirming intent alone does not prove aim. IF THEY ONLY WANT IT OUT OF PUBLIC VIEW: making the board SECRET with update_pinterest_board is reversible, but it needs a Pinterest permission (boards:write_secret) that an older connection may not hold. The unconfirmed refusal says which applies to this connection, read off the live scope set, so relay it verbatim rather than guessing. 0 credits. Needs Pinterest connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Pinterest board
  • delete_pinterest_pinPERMANENTLY delete a Pin.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_pinterest_pin" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Pin. Pinterest has no undelete and no archive for one. Call it WITHOUT confirm first: nothing is deleted, and it answers with the Pin’s real title, its lifetime saves and impressions, and whether it HAS BEEN PROMOTED in an ad — all read back from Pinterest. Show the user that, get an unambiguous yes, then call again with confirm:true plus confirmName (its exact title) once it has saves or has been promoted, because confirming that you meant to delete SOMETHING does not prove you aimed at the right Pin. DELETING A PIN THAT AN AD PROMOTES pulls the creative out from under that ad, so check the promoted flag before agreeing. The verdict is read back from Pinterest, never taken from its 2xx. 0 credits. Needs Pinterest connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Pin
  • delete_playbookDelete a saved playbook by id (from list_playbooks).No findings

    Why it is in this group

    • The name "delete_playbook" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete a saved playbook by id (from list_playbooks). Records a cross-device delete so it does not come back on the next sync. Minor + re-creatable, so no confirm needed.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete a playbook
  • delete_shopify_articleDelete a Shopify blog article.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_shopify_article" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a Shopify blog article. Call it WITHOUT confirm first: nothing is deleted and you get a sentence naming the article to show the user. Shopify keeps no trash for blog articles, so this is PERMANENT. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Shopify blog article
  • delete_skillDelete one of the workspace’s CUSTOM skills by id (from list_skills).No findings

    Why it is in this group

    • The name "delete_skill" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete one of the workspace’s CUSTOM skills by id (from list_skills). Built-in skills/recipes can’t be deleted. Minor + re-creatable, so no confirm needed.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Delete a custom skill
  • delete_slack_messagePERMANENTLY delete a Slack message the Hermoso app posted.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_slack_message" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a Slack message the Hermoso app posted. Call it WITHOUT confirm first: nothing is deleted and you get a sentence quoting the message to show the user. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Slack message
  • delete_telegram_messagePERMANENTLY delete one message the bot posted to a Telegram chat.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_telegram_message" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete one message the bot posted to a Telegram chat. Call it WITHOUT confirm first: nothing is deleted and you get a sentence to show the user. There is deliberately NO preview of the message — the Bot API has no method that reads one message back, so anything shown would be invented, and for the same reason the result after deleting is Telegram’s own success answer rather than a verified read-back. TWO VENDOR LIMITS, both Telegram’s and neither ours: "A message can only be deleted if it was sent less than 48 hours ago", and in a CHANNEL the bot needs the Post Messages right to remove even its own posts. Takes the same chatId as post_to_telegram plus the messageId post_to_telegram returned. 0 credits. Needs Telegram connected (Connectors > Telegram, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Telegram message
  • delete_threadPERMANENTLY delete one of the brand’s Threads posts.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_thread" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete one of the brand’s Threads posts. IRREVERSIBLE — Threads has no undelete. Call it WITHOUT confirm first: nothing is deleted, and it answers with the post’s real text plus its views, likes, replies and reposts read back from Threads. Show the user that, get an unambiguous yes, then call again with confirm:true — plus confirmName (the post’s exact text as it was reported) once anyone has engaged with it. confirmName exists because confirming that you meant to delete SOMETHING does not prove you aimed at the right post, and a wrong id must not be confirmable blind. Threads allows only 100 deletions per account per rolling 24 hours; threads_publishing_limit says how many are left, and a quota refusal otherwise reads like a broken connection. Note Meta documents nothing about what a delete does to the replies underneath a post, so do not promise the conversation survives. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Threads post
  • delete_tiktok_post_ad_authorizationDelete the Spark-Ads authorization code for a post the authorized account owns.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_tiktok_post_ad_authorization" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete the Spark-Ads authorization code for a post the authorized account owns. CONFIRM-GATED, and not because it spends: ads already built on the post keep running, but no NEW ad can be built against it until a fresh code exists, and TikTok REFUSES this outright while any campaign or ad using the post is still ACTIVE — pause those first. Calling it without confirm changes nothing and returns the sentence describing exactly what would happen. THE READ-BACK INVERTS: proof of success is that TikTok no longer reports a code for the post, and a code that is still there is reported as not confirmed rather than done. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a post’s Spark-Ads authorization code
  • delete_voice_agentDelete a voice agent from the platform (Retell: its Retell LLM too; Telnyx keeps it restorable 30 days).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_voice_agent" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a voice agent from the platform (Retell: its Retell LLM too; Telnyx keeps it restorable 30 days). Without confirm:true nothing is deleted and the answer names the agent; call again with confirm:true once the user says yes. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a voice agent
  • delete_webflow_itemDelete a Webflow blog item.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_webflow_item" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a Webflow blog item. Call it WITHOUT confirm first: nothing is deleted and you get a sentence naming the item to show the user. A live item is taken off the site and deleted. Webflow keeps no trash, so this is PERMANENT. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Webflow blog item
  • delete_whatsapp_templatePERMANENTLY delete a WhatsApp message template.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_whatsapp_template" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a WhatsApp message template. META DELETES EVERY LANGUAGE OF A NAME AT ONCE, which is a wider blast radius than most callers picture, so call it WITHOUT confirm first: nothing is deleted and it reports exactly how many templates and which languages would go. Then show the user that, get an unambiguous yes, and call again with confirm:true AND confirmName set to the template’s exact name — confirming that you meant to delete SOMETHING does not prove you aimed at the right template. Any message sent against a deleted template afterwards is refused. The answer is a RE-READ from Meta, never the 200: if the template still comes back it is reported as not deleted. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a WhatsApp message template
  • delete_wix_postDelete a Wix blog post.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_wix_post" says "delete": a word for removing or ending something.
    • The description says "cannot be undone".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a Wix blog post. Call it WITHOUT confirm first: nothing is deleted and you get a sentence naming the post to show the user. By default it goes to the blog's TRASH in Wix (restorable); permanent:true skips the trash and cannot be undone. A live post is taken off the site first. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Wix blog post
  • delete_wordpress_postDelete a WordPress post.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_wordpress_post" says "delete": a word for removing or ending something.
    • The description says "cannot be undone".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete a WordPress post. Call it WITHOUT confirm first: nothing is deleted and you get a sentence naming the post to show the user. By default it goes to WordPress's TRASH (restorable from Posts > Trash); permanent:true skips the trash and cannot be undone. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a WordPress post
  • delete_x_postPermanently delete one of the connected account’s posts on X.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_x_post" says "delete": a word for removing or ending something.
    • The description says "Permanently delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Permanently delete one of the connected account’s posts on X. This CANNOT be undone — confirm the exact post with the user first. Costs credits (X bills per API call). Needs X connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a post on X
  • delete_youtube_report_jobStop a YouTube bulk reporting job.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_youtube_report_job" says "delete": a word for removing or ending something.
    • The description says "IRREVERSIBLE".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Stop a YouTube bulk reporting job. IRREVERSIBLE IN A WAY THAT IS EASY TO MISS: the job IS the history — deleting it discards every daily CSV it has accumulated, and a replacement job starts over with only a 30-day backfill, so anything older than that is gone for good. Call WITHOUT confirm first: nothing is deleted and you get the real job read back from YouTube (its report type and when it was scheduled) to show the user. Then call again with confirm:true. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a YouTube bulk reporting job
  • delete_youtube_videoPERMANENTLY delete a video from the connected YouTube channel.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_youtube_video" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY delete".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete a video from the connected YouTube channel. IRREVERSIBLE — YouTube has no trash and no undelete, and the video's views, comments and every link or embed pointing at it go with it. Call it WITHOUT confirm first: nothing is deleted, and it reports the video's REAL title, privacy, view count and comment count read back from YouTube. Show the user that, get an unambiguous yes, then call again with confirm:true — plus, once the video is public or has any views or comments, confirmTitle set to its exact title. confirmTitle exists because confirming that you meant to delete SOMETHING does not prove you aimed at the right video, and a wrong id must not be confirmable blind. If the user only wants it out of public view, use update_youtube_video(privacy:"private") instead — that is reversible and this is not. Get the videoId from list_youtube_videos. 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a video from the connected YouTube channel
  • detach_voice_agent_numberStop an agent answering a number: a forwarded number goes back to Hermoso's call handling; a number imported into the platform is removed from it (the number stays on the carrier a…Reads text others writeNo findings

    Why it is in this group

    • The name "detach_voice_agent_number" says "detach": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Stop an agent answering a number: a forwarded number goes back to Hermoso's call handling; a number imported into the platform is removed from it (the number stays on the carrier account). Without confirm:true nothing changes and the answer says what would. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Take an agent off a number
  • disable_shopify_discount_codeStop a discount code working at checkout on the merchant's Shopify store, by id (from list_shopify_discount_codes) or by the code itself.Reads text others writeNo findings

    Why it is in this group

    • The name "disable_shopify_discount_code" says "disable": a word for a change.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Stop a discount code working at checkout on the merchant's Shopify store, by id (from list_shopify_discount_codes) or by the code itself. Shopify keeps the code and it can be switched back on in Shopify admin under Discounts, but every customer holding it loses it at once, so without confirm:true NOTHING changes and the reply names the code and what it does: show the user, get a yes, then call again with confirm:true. The answer is the status read back from Shopify (EXPIRED means it no longer works). Works for the Shopify store connected to this brand (Connectors > Shopify, or connect_shopify_store) or the store this account was installed on. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Disable a Shopify discount code
  • disconnect_connectorDisconnect a third-party account from this workspace (Meta, Google Ads, Google Drive/Sheets/Docs, YouTube, TikTok, LinkedIn, X, Reddit Ads, Pinterest, Google Business, Microsoft Ad…Reads text others write1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...Slack, …). This always drops the stored credentials, so every tool for that provider stops..."

      What this check looks for
    Description, as the server wrote it
    Disconnect a third-party account from this workspace (Meta, Google Ads, Google Drive/Sheets/Docs, YouTube, TikTok, LinkedIn, X, Reddit Ads, Pinterest, Google Business, Microsoft Advertising/OneDrive, Slack, …). This always drops the stored credentials, so every tool for that provider stops working immediately and posts/campaigns already published are NOT affected. IT NEVER REVOKES THE GRANT AT THE PROVIDER: the authorisation stays in place, so the same account keeps working in any other brand it is connected to, until the user removes Hermoso in that provider's own settings. The unconfirmed call names where to do that (list_connectors carries revokesAtProvider:"local") — relay it rather than promising a revoke. WITHOUT account, EVERY account on that connector is removed (pass account to remove just one). Removing a mailbox stops the emails still waiting to go from it: its sequences pause and say why. RECONNECTING IS THE USER'S JOB: a sign-in account needs their browser (the provider's consent screen), so an agent cannot undo this. Name the provider to the user, then call with confirm:true. Use list_connectors for the exact provider ids.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Disconnect a connected account
  • draft_brandUse this when the user gives a website, a description or a social handle to set up their brand or creator profile.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Use this when the user gives a website, a description or a social handle to set up their brand or creator profile. It fills in the profile: its name, products, logo and summary, saved as the brand profile when none is saved yet. On an account with NO saved brand one call does it all: it saves the brand and reads its product photos (no second call with confirmed:true). Check the business it returns against what you know about the user and go straight on to the ad unless you have a real reason to think it is a different business. A domain can resolve to a DIFFERENT company than intended (e.g. Bala.com is an engineering firm, not the Bala fitness brand at shopbala.com): if the returned `name` or `summary` is clearly not the business the user named, re-draft with the correct domain or a description.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Draft profile
  • duplicate_scheduledCopy 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 r…Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "copy": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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 after it went out. It copies the caption, media, per-channel captions, title, description, tags and the target board / Page / company Page / listing, and ANY of those can be overridden in the same call. Give a new time in `at`, or useQueue:true to drop it into the brand’s next free posting slot. The copy is INDEPENDENT — editing or cancelling it never touches the original — and it is a genuinely new post rather than a re-send, so it publishes even where the original already did. To re-fire only the channels that FAILED, use retry_scheduled instead.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Duplicate a scheduled post
  • edit_discord_messageChange the text of a Discord message Hermoso posted (≤2000 characters) — the bot's or the announcement webhook's.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "edit_discord_message" says "edit": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "edit_discord_message" says "edit" and "message": it writes something other people read.
    Description, as the server wrote it
    Change the text of a Discord message Hermoso posted (≤2000 characters) — the bot's or the announcement webhook's. Pass messageId exactly as post_to_discord returned it. Mentions never ping on an edit. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Discord announcement
  • edit_linkedin_commentChange the text of a comment your LinkedIn company Page wrote (LinkedIn lets only the text change).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "edit_linkedin_comment" says "edit": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "edit_linkedin_comment" says "edit" and "comment": it writes something other people read.
    Description, as the server wrote it
    Change the text of a comment your LinkedIn company Page wrote (LinkedIn lets only the text change). Public: show the user the new wording first. Same LinkedIn comments authorization (provider linkedin_community). Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a LinkedIn Page comment
  • edit_shopify_order_itemsAdd products to a Shopify order, or change or remove its lines (quantity 0 removes one; removed units are restocked unless restock:false).Reads text others writeNo findings

    Why it is in this group

    • The name "edit_shopify_order_items" says "edit": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add products to a Shopify order, or change or remove its lines (quantity 0 removes one; removed units are restocked unless restock:false). Without confirm:true Shopify recalculates the order (new total, and what the buyer would owe) and NOTHING changes: show the user, get a yes, then call again with confirm:true (notifyCustomer emails the buyer the change; staffNote is for staff). When the new total is lower, refund the difference with refund_shopify_order. Line ids come from list_shopify_orders with an id; variant ids from get_shopify_inventory or list_shopify_products. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Edit the items on a Shopify order
  • edit_slack_messageChange the text of a Slack message the Hermoso app posted (≤4,000 characters, Slack's edit limit).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "edit_slack_message" says "edit": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "edit_slack_message" says "edit" and "message": it writes something other people read.
    Description, as the server wrote it
    Change the text of a Slack message the Hermoso app posted (≤4,000 characters, Slack's edit limit). messageId is what post_to_slack returned ("<channel>/<ts>"). A message posted through a pasted webhook has no id and cannot be edited. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Slack message
  • edit_telegram_messageChange the TEXT or CAPTION of a message already posted to a Telegram channel, group or chat — the fix for a typo that would otherwise cost the post AND its accumulated views, since…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "edit_telegram_message" says "edit": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "edit_telegram_message" says "edit" and "message": it writes something other people read.
    Description, as the server wrote it
    Change the TEXT or CAPTION of a message already posted to a Telegram channel, group or chat — the fix for a typo that would otherwise cost the post AND its accumulated views, since deleting and reposting starts from zero. Pass `text` for a plain post or `caption` for one carrying media; Telegram refuses the wrong one and its error names the other. It overwrites the published text, and the previous wording is not kept. Free, 0 credits. Needs Telegram connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Telegram post
  • edit_x_postEDIT the text of one of the connected account’s own posts on X.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "edit_x_post" says "edit": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "edit_x_post" says "edit" and "post": it writes something other people read.
    Description, as the server wrote it
    EDIT the text of one of the connected account’s own posts on X. Three things about X’s edit model change how you must use this and none is guessable: (1) X REPLACES THE WHOLE TEXT — there is no partial patch, so pass the complete new post; (2) an edit MINTS A NEW POST ID, and the old id keeps resolving and keeps showing the OLD text, so always hand the user the NEW url afterwards or they will circulate a link to the version they just corrected; (3) X’s window is ONE HOUR from the ORIGINAL post and DOES NOT RESTART when a post is edited, and each post has a limited number of edits. Pass whichever id the user has — Hermoso reads X’s edit chain and aims at the newest id, which is the only one X accepts (an edit aimed at the id the user was originally given is refused by X once the post has been edited once). A published ARTICLE can never be edited whatever the subscription, and this says so rather than trying. Editing needs X Premium on the POSTING account; Hermoso attempts it and reports X’s own refusal rather than pre-refusing on a guess about the plan. Everything knowable for free — window closed, edits used up, post ineligible — is refused before anything is billed. Costs credits. Needs X connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Edit a post on X
  • end_discord_pollClose a Discord poll the Hermoso bot posted, before its time is up.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "close": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Close a Discord poll the Hermoso bot posted, before its time is up. PERMANENT: nobody can vote afterwards and a closed poll cannot be reopened. Call it WITHOUT confirm first: nothing changes and you get the votes so far to show the user. Discord only lets the bot end its own polls. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: End a Discord poll early
  • enroll_contactsStart a sequence (save_email_sequence) for contacts: sequence (its id) and contacts [ids, emails, phones or "instagram:<id>"], or tag, or all:true.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "start": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Start a sequence (save_email_sequence) for contacts: sequence (its id) and contacts [ids, emails, phones or "instagram:<id>"], or tag, or all:true. Each step reaches the person on its channel from their contact; a person with nothing on a step's channel, or who opted out of it, is held or skipped on that step with the reason. Same pace, free-plan day and company rules as enroll_email_leads. listConfirmed:true is required when the sequence has an email step. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Enrol contacts in a sequence
  • follow_x_accountFollow ONE account from the brand’s X account, or unfollow it with undo:true.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Follow ONE account from the brand’s X account, or unfollow it with undo:true. ONE ACCOUNT PER CALL, and only an account the user named: X restricts accounts that follow or unfollow in volume, so there is no list input and a brand is held to 20 follows and unfollows a day. A protected account gets a follow REQUEST that waits for its owner. Needs the follows.write permission: an X connection made before 2026-11-15 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per API call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Follow or unfollow an account on X
  • forgetDelete a saved Memory item by its id (from list_memory).No findings

    Why it is in this group

    • The description's first verb is "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete a saved Memory item by its id (from list_memory). Records a cross-device delete so it doesn’t come back. Minor + re-creatable (you can remember it again), so no confirm needed.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Forget a memory
  • format_sheetMake an exported sheet readable: bold the header row, FREEZE it so it stays visible while scrolling, and auto-size the columns so nothing is cut off.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Make an exported sheet readable: bold the header row, FREEZE it so it stays visible while scrolling, and auto-size the columns so nothing is cut off. Worth calling right after create_sheet — a raw export with unsized columns and a header that scrolls away is the difference between a spreadsheet someone reads and one they close. Changes no cell VALUE, so it is never gated. The defaults do all three on the first tab; pass `tab` to pick another, freezeRows:0 to skip freezing, boldHeader:false or autoResize:false to skip those.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Format a Google Sheet
  • fulfill_shopify_orderMark a Shopify order's items as shipped from the store's own locations, with tracking (trackingCompany, trackingNumber, trackingUrl).Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "mark": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Mark a Shopify order's items as shipped from the store's own locations, with tracking (trackingCompany, trackingNumber, trackingUrl). Every remaining unit by default, or only lineItems [{ lineItemId, quantity }]. notifyCustomer:true sends Shopify's shipping confirmation email. Without confirm:true NOTHING changes and the reply says exactly what would ship and from where: show the user, get a yes, then call again with confirm:true. Read back. Items held by a fulfilment-service app are fulfilled by that app. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Fulfil a Shopify order
  • hide_thread_replyHide a reply on the brand’s Threads post (or unhide it with hide:false) — for spam and abuse moderation.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "hide_thread_reply" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "hide_thread_reply" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Hide a reply on the brand’s Threads post (or unhide it with hide:false) — for spam and abuse moderation.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Hide or unhide a Threads reply
  • hide_x_replyHide a reply under the brand’s own X post (hidden:false to unhide) — spam and abuse moderation.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "hide_x_reply" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "hide_x_reply" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Hide a reply under the brand’s own X post (hidden:false to unhide) — spam and abuse moderation. A hidden reply is not deleted; it moves behind "View hidden replies". Only works on replies in a conversation the connected account started. Needs the tweet.moderate.write permission: an X connection made before 2026-10-27 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per API call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Hide or unhide a reply on X
    • idempotentHint: false
  • import_posts_csvBulk-schedule posts from a CSV.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "import_posts_csv" says "import": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "import_posts_csv" says "import" and "post": it writes something other people read.
    Description, as the server wrote it
    Bulk-schedule posts from a CSV. Columns: text, media (URLs or Library ids, | between), channels, time or queue, timezone, link, title, text_<channel>, time_<channel>. A column it does not read is refused by name. DEFAULT IS A DRY RUN: every row is checked and its problems listed, nothing is created. dryRun false creates them, all or nothing unless skipInvalid. Pass url (an upload_file link) or csv (the text).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Schedule posts from a CSV
  • instagram_posting_holdSee or lift the HOLD on an Instagram account's scheduled posts.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    See or lift the HOLD on an Instagram account's scheduled posts. When Meta refuses two posts in a row from an Instagram account with its spam restriction (code 4/2207051, "We restrict certain activity to protect our community"), Hermoso holds that account's scheduled Instagram posts instead of sending them into the restriction: they stay queued and nothing is posted. action:"status" (default) says whether posting is held, since when, and how many posts wait. action:"resume" lifts the hold and releases the waiting posts (ones whose time passed go out 30 minutes apart). Resume only after the user says the account holder has checked Account Status in the Instagram app. Reconnecting Instagram or a successful Instagram post also lifts it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: See or resume a held Instagram account
  • invite_memberInvite someone to this profile by email (role: member = read-only on billing, admin = full).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "invite_member" says "invite": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "invite_member" says "invite": it sends or publishes something to other people.
    Description, as the server wrote it
    Invite someone to this profile by email (role: member = read-only on billing, admin = full). This SENDS a real email invite / share link — an account change. Confirm the exact email + role with the user, then call with confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Invite a teammate
  • leave_connectorOn a connector that several teammates can contribute their OWN account to (see list_connectors — the row reports multiContributor), remove YOURS from this profile: your stored cred…Reads text others write1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description mentions "credential".

      Matched text

      description: "...ve YOURS from this profile: your stored credential is dropped and the accounts you shared..."

      What this check looks for
    Description, as the server wrote it
    On a connector that several teammates can contribute their OWN account to (see list_connectors — the row reports multiContributor), remove YOURS from this profile: your stored credential is dropped and the accounts you shared stop being shared. Your teammates' accounts on the same connection keep working, and nothing changes at the provider — reconnecting in a browser shares again. Use this instead of disconnect_connector when the connection is not yours to remove: disconnect_connector removes the whole connection for everyone on this profile, and only the person who created the connection may call it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove my own account from a shared connection
  • list_productsThe brand's product catalog: each product's id, title, page link, price (and whether it is current), photos, its own selling points and audience, and when it was last checked again…Reads text others write1 finding

    Why it is in this group

    • The name "list_products" says "list": a word for reading.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "list_products" destructive (destructiveHint: true), and its name says "list", a word for reading.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}; The name "list_products" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    The brand's product catalog: each product's id, title, page link, price (and whether it is current), photos, its own selling points and audience, and when it was last checked against its live page. Free. `refresh:'stale'` re-reads rows older than a day first, `refresh:'all'` re-reads every page.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: List the product catalog
  • make_evergreenPost something again on a repeat: every N days, weeks or months, up to maxRepeats times.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The description's first verb is "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Post something again on a repeat: every N days, weeks or months, up to maxRepeats times. Source: fromPost (a published post id from list_published_posts), libraryId (L0…), or channels + message + media. Each repost is its own scheduled post, placed one at a time, through every check schedule_post runs (approval included). captionVariants (off by default) rotate the caption; X refuses identical reposts, so X needs two or more different variants. firstAt = the first repost (default one interval after the original).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Repost on a repeat (evergreen)
  • manage_bluesky_convoAct on one Bluesky DM conversation.Reads text others writeNo findings

    Why it is in this group

    • The description says "cannot be undone".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Act on one Bluesky DM conversation. ACCEPT a message request — Bluesky holds DMs from people the account does not follow in a separate requests folder, and until one is accepted it stays there. MUTE / UNMUTE it. LOCK / UNLOCK it (no new messages). LEAVE it. Or DELETE one message from THIS account’s view. TWO THINGS TO SAY OUT LOUD BEFORE USING THEM: deleting is FOR SELF ONLY — the other person still sees the message, because Bluesky offers no delete-for-everyone in chat — and leaving a conversation cannot be undone from here. Accepting a request that was already accepted is reported as such rather than as a change, because Bluesky says so by returning no revision. Free, and it needs the same PRIVILEGED app password as every other Bluesky DM tool. Get a convoId from list_bluesky_convos.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Accept, mute, lock, leave or prune a Bluesky DM conversation
    • idempotentHint: false
  • manage_evergreenEvergreen series on this brand: action list, stop (no more reposts; the next queued one is cancelled unless keepQueued), pause or resume.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Evergreen series on this brand: action list, stop (no more reposts; the next queued one is cancelled unless keepQueued), pause or resume.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Evergreen series
  • manage_instagram_product_tagsREAD the product tags on a post the brand has already published, or ADD/MOVE tags on it.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    READ the product tags on a post the brand has already published, or ADD/MOVE tags on it. Pass `tags` to update: Meta's own behaviour is "updates coordinates if the product is already tagged; otherwise adds new tag" — so it is ADD-OR-MOVE, never replace-all, and it CANNOT be used to take a tag off. THERE IS NO WAY TO REMOVE A PRODUCT TAG: Meta documents Creating, Reading and Updating on this edge and no delete at all, so Hermoso will not guess at one — deleting the post is the only thing that removes its tags, and the reply says so rather than implying otherwise. The answer is always READ BACK from Instagram, and it separates tags that are STORED from tags that will actually be SHOWN — only an "approved" product ever appears on a published post. Read is free; the update costs 0 credits too. Whether Meta has approved Hermoso's app for the permission this needs is read LIVE from Meta: when it has not, list_connectors says so under Meta and this tool's refusal says Meta hasn't approved Hermoso for it yet. That is Meta's decision about Hermoso, not the user's connection, so never tell them to reconnect for it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Read or update the product tags on a published Instagram post
  • manage_intercom_conversationClose, snooze, reopen or assign an Intercom conversation in the brand's shared inbox.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "close": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Close, snooze, reopen or assign an Intercom conversation in the brand's shared inbox. action: close | snooze (needs snoozeUntil, a future date-time) | open | assign (assigneeId = a teammate id, or teamId, or assignToMe:true, or unassign:true; ids from list_intercom_teammates). close and assign may carry a message the CUSTOMER sees. Without confirm:true nothing changes and the preview comes back; call again with confirm:true when the user agrees. The new state is read back. Free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Close, snooze, reopen or assign an Intercom conversation
  • manage_linkedin_postEdit or delete a published LinkedIn post — personal profile or company Page.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "manage_linkedin_post" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "manage_linkedin_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Edit or delete a published LinkedIn post — personal profile or company Page. Pass postUrn, the full urn returned when it was published. action:"edit" changes ONLY THE COPY: LinkedIn does not allow the image or video of a published post to be replaced, so a new visual means a NEW post — tell the user that instead of promising a swap. action:"delete" is immediate and public and requires confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit or delete a LinkedIn post
  • manage_meta_partnership_creatorAdd a creator to — or remove one from — this brand’s Partnership Ads lists.Reads text others write1 finding

    Why it is in this group

    • The description's first verb is "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • High

      The description contains "do not tell the user", an instruction to keep something from the user.

      Matched text

      description: "...write that HAPPENED: do not retry, and do not tell the user it failed. The reply’s `verdict` is one..."

      What this check looks for
    Description, as the server wrote it
    Add a creator to — or remove one from — this brand’s Partnership Ads lists. Name at least one list: `allowAds` (whose content this profile may RUN AS AN ADVERT) and/or `allowTagging` (who may TAG this brand as a paid partner on their own post). NEITHER DEFAULTS ON, because one of them lets somebody attach this brand’s name to their own post. ADDING IS A REQUEST, NOT AN APPROVAL: Meta’s own name for the operation is "send permission request", the creator accepts on their own Instagram account in their own time, and until the read-back reports approved this profile cannot advertise their content. Never tell anyone a partnership is live off the back of this call — report the status the reply carries. THE OUTCOME IS READ BACK OFF META’S OWN LIST, NEVER TAKEN FROM THE WRITE’S REPLY — because Meta answers the ADD with HTTP 500 (code 1, “Please reduce the amount of data you’re asking for”) while performing it, measured 4/4 on 2026-08-25. If this reply carries `metaWriteError` alongside a successful summary, that error is Meta noise about a write that HAPPENED: do not retry, and do not tell the user it failed. The reply’s `verdict` is one of applied / already / unchanged / unknown, and `unknown` means the list could not be re-read — which is not the same as nothing having changed. REMOVING FLIPS A STATUS TO “Canceled”; it does not delete the row. One tool does both lists because Meta removes from them with two DIFFERENT verbs (DELETE on one, a `revoke` flag on the other) and a caller who assumes one silently does nothing on the other. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Add or remove a Partnership Ads creator
  • manage_meta_postEdit the text of, or delete, a published post.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "manage_meta_post" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "manage_meta_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Edit the text of, or delete, a published post. target:"facebook" -> edit the message and/or Meta’s AI-generated label (action:"edit", message, aiGenerated) OR delete (action:"delete"), and on a Facebook Reel list or invite collaborator Pages (action:"collaborators"); target:"threads" -> delete only (Threads has no edit API); target:"instagram" -> DELETE ONLY — Meta lets you change nothing on a published Instagram post except whether comments are enabled, so a caption cannot be fixed; deleting covers ordinary posts, Stories, Reels and ENTIRE carousel albums (Instagram cannot remove one card out of an album — pass the album’s own media id, from list_instagram_media). Deleting is permanent. FOR INSTAGRAM, CALL IT WITHOUT confirm FIRST: nothing is deleted and you get back the post’s real caption, its likes and comments and how many carousel cards go with it — show the user exactly that, then call again with confirm:true plus confirmName (and confirmChildren for an album) if the refusal asks for them. A post nobody has liked or commented on yet stays a one-call delete. INSTAGRAM DELETE NEEDS A RECONNECT ON AN OLD CONNECTION: the `instagram_manage_contents` permission joined Hermoso’s Meta grant on 2026-08-05, so any Meta connection made before then must be reconnected (Connectors > Meta) before Instagram will accept a delete. Call the tool rather than pre-refusing — every refusal it can raise names the one thing that fixes it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Edit or delete a published post
  • manage_pinterest_board_sectionCreate, rename or delete a section of a Pinterest board.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create, rename or delete a section of a Pinterest board. action:"create" needs name; "rename" needs sectionId and name; "delete" needs sectionId and confirm:true (without confirm it reports what would go). Read back from Pinterest. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create, rename or delete a Pinterest board section
  • manage_pinterest_catalog_feedCreate, edit or delete a Pinterest PRODUCT FEED — the CSV / TSV / XML file of your products Pinterest downloads on a schedule to fill the catalog Shopping ads serve from.Reads text others write1 finding

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...logId, schedule {time HH:MM, timezone}, credentials. action:"update" changes those on feedI..."

      What this check looks for
    Description, as the server wrote it
    Create, edit or delete a Pinterest PRODUCT FEED — the CSV / TSV / XML file of your products Pinterest downloads on a schedule to fill the catalog Shopping ads serve from. action:"create" needs name, location (the feed URL), defaultCountry and defaultLocale (Pinterest refuses a feed without them), optionally format, defaultCurrency, defaultAvailability, catalogId, schedule {time HH:MM, timezone}, credentials. action:"update" changes those on feedId. action:"delete" removes feedId and needs confirm:true — without it nothing changes and the reply names what would go. Read back from Pinterest every time. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create, edit or delete a Pinterest product feed
  • manage_pinterest_product_groupCreate, edit or delete a Pinterest PRODUCT GROUP — the slice of a catalog a Shopping ad group promotes (one brand, a price band, a custom label).Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create, edit or delete a Pinterest PRODUCT GROUP — the slice of a catalog a Shopping ad group promotes (one brand, a price band, a custom label). action:"create" needs name, feedId and filters; "update" changes name / description / filters on productGroupId; "delete" needs confirm:true. Read back from Pinterest. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create, edit or delete a Pinterest product group
  • manage_post_queuesThe brand’s posting queues: Default (its posting times) plus named queues, each with its own times per weekday and channels.Can send data outNo findings

    Why it is in this group

    • The name "manage_post_queues" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • outboundThe name "manage_post_queues" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    The brand’s posting queues: Default (its posting times) plus named queues, each with its own times per weekday and channels. action list; save (by name: slots = every-day "HH:MM" times, days = per-weekday overrides like {"sat":[],"sun":["11:00"]}, timezone, channels, rename); delete. schedule_post useQueue:"<name>" fills one; set_post_refill queue points autopilot at one. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Posting queues
  • manage_sheet_tabsAdd, rename or delete a tab in a Google Spreadsheet.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add, rename or delete a tab in a Google Spreadsheet. action:"add" + title · action:"rename" + tab + newTitle · action:"delete" + tab. Name the tab by its TITLE or its numeric sheetId (list_sheet_tabs gives both); an unknown tab is refused with the real list rather than a Google error nobody can map back. DELETING a tab destroys everything on it: call it without confirm first to get the filled-cell count, then confirm:true + confirmCells. Google does not allow removing the LAST remaining tab in a file, and that is refused by name with the way out (clear it, or delete the whole file with delete_drive_file). Every action is read back from the spreadsheet before it is reported as done.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add, rename or delete a sheet tab
  • manage_whatsapp_flowWhatsApp Flows: forms people fill in without leaving the chat (sign-up, booking, lead capture, survey).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WhatsApp Flows: forms people fill in without leaving the chat (sign-up, booking, lead capture, survey). action "list" or "get" (with a preview link). "create" makes a DRAFT from name, categories (SIGN_UP, SIGN_IN, APPOINTMENT_BOOKING, LEAD_GENERATION, CONTACT_US, CUSTOMER_SUPPORT, SURVEY, OTHER) and flowJson (Meta's Flow JSON, ≤10 MB), or cloneFlowId. "update" changes a DRAFT (name, categories, flowJson, endpointUri). Meta's validation errors come back verbatim. "publish" is FINAL (a published form cannot be changed or deleted, only deprecated), "deprecate" stops it being sent, "delete" removes a draft: these three need confirm:true after a first call without it. Send a form with send_whatsapp_message interactive { type: "flow", flowId, flowCta } (mode "draft" to test); answers arrive in read_whatsapp_inbox. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: WhatsApp forms (Flows)
  • manage_whatsapp_numberEverything about ONE WhatsApp business number except sending.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Everything about ONE WhatsApp business number except sending. PROFILE: "get" reads, "update" changes only what you pass: about ≤139, address ≤256, description ≤512, email ≤128, websites (≤2), vertical, photoUrl (JPEG/PNG), iceBreakers (≤4 tappable questions, ≤80, no emoji), commands ([{ name, hint }], ≤30, typed after /), welcomeMessage. BLOCKLIST: "list_blocked", "block", "unblock" with users (phones or business-scoped ids, ≤1,000; only people who wrote in the last 24 hours can be blocked). GROUPS (Official Business Accounts only; ≤8 people, joining only by invite link): "list_groups", "get_group", "create_group" (subject ≤128, description ≤2048, joinApproval), "invite_link", "update_group", "reset_invite_link", "remove_participants", "delete_group" (also confirmName = the subject). Every change customers or members see takes confirm:true after a first call without it, which changes nothing. Over a limit is refused, never cut. Answers are read back from Meta. Send to a group with send_whatsapp_message groupId. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: WhatsApp number settings, blocklist and groups
  • manage_x_broadcastSchedule, update, go live on, or cancel an X LIVE VIDEO broadcast on the connected account.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "manage_x_broadcast" says "broadcast": a word for sending, and what is sent cannot be taken back.
    • The description says "cannot be undone".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "manage_x_broadcast" says "broadcast": it sends or publishes something to other people.
    Description, as the server wrote it
    Schedule, update, go live on, or cancel an X LIVE VIDEO broadcast on the connected account. action 'schedule' needs sourceId (from manage_x_stream_source), startAt, and manualPublish, which is REQUIRED with no default: true = nothing airs until action 'go_live'; false = X puts the brand ON AIR automatically at startAt (needs confirm:true). 'update' changes only the fields you pass (Hermoso re-sends the rest, because X's update replaces the whole schedule). 'go_live' airs a manualPublish schedule NOW, publicly, as the brand (confirm:true). 'cancel' deletes a schedule and cannot be undone (confirm:true). X retired recurring broadcasts: schedule each occurrence on its own. WITHOUT A SCHEDULE: 'create' puts sourceId ON AIR NOW (confirm:true; X announces it in a post unless skipPost:true, and ends it if no video arrives within 5 minutes; X retired the separate 'publish' step), 'end' stops one for everyone (confirm:true), 'delete' removes one and its replay (confirm:true; end it first). X limits broadcasting by account (Premium or 1,000 followers) and says so. Confirm the exact broadcast, time and stream with the user before passing confirm:true; a refusal is free. Needs X connected with the broadcast permissions added 2026-09-21: an X connection made before then must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Schedule, update, go live on or cancel an X broadcast
  • manage_x_chatManage one of the connected X account's X Chat conversations (id from list_x_chats).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Manage one of the connected X account's X Chat conversations (id from list_x_chats). For the brand only: 'mute' / 'unmute'; 'delete' removes it from the brand's inbox for good while the others keep theirs (confirm:true). For everyone in it: 'set_disappearing' (disappearAfter like '24h' or '7d'), 'clear_disappearing', 'screen_capture' (blockScreenshots OR notifyOnScreenshot, one per call). GROUPS (id starts with g; the brand must be an admin): 'admin_settings' (adminOnly {addMember, editGroupInfo, sendMessage, startCall, editMessageTtl, blockScreenCapture}; sendMessage:true makes it announcement-only), 'add_admins' / 'remove_admins' (userIds), 'remove_members' (userIds, confirm:true), 'leave' (confirm:true), 'approve_admin_request' / 'reject_admin_request' (userId), 'reject_join_requests' (userIds; APPROVING a join re-keys the encrypted group, so it is done in the X app), 'enable_invite' (optional title, avatarUrl, welcomeMessage, expiresAt; X stores that preview UNENCRYPTED and shows it to anyone with the link), 'disable_invite' (the shared link dies for good: confirm:true). INBOX, for the brand only: 'archive' / 'unarchive', 'mark_read' (may send the other person a read receipt). MESSAGE REQUESTS: 'accept_request' (id = the sender's numeric id, or the request's conversationId from list_x_chats view message_requests) moves the conversation into the inbox; show the user who sent it first (list_x_dms with participantId reads the message only if it was not sent encrypted). Confirm the exact conversation with the user before passing confirm:true; a refusal is free. The answer is X's own yes or no, never an echo. Needs X connected with direct-message access: an X connection made before 2026-08-25 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Manage an X Chat conversation
  • manage_x_stream_sourceThe connected X account's STREAM SOURCES, the RTMP ingest points a live broadcast plays from.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The connected X account's STREAM SOURCES, the RTMP ingest points a live broadcast plays from. action 'list' (default) and 'get' (id) show each source's id (19 digits), RTMPS URL, region and whether video is arriving; 'stream_key' (id) reads its stream key, which X leaves out of the list; 'create' (name, optional region, the nearest one when omitted) makes one and returns its key; 'rename' (id, name); 'delete' (id, confirm:true: it kills the stream key); 'region' reads the nearest ingest region. Pass a source's id as sourceId to manage_x_broadcast. The stream key is a secret, so never post it. Needs X connected with the broadcast permissions added 2026-09-21: an X connection made before then must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Manage X stream sources
  • manage_youtube_captionAttach a real subtitle track to one of the connected channel’s videos, replace one, or delete one.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "attach": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Attach a real subtitle track to one of the connected channel’s videos, replace one, or delete one. Pass the caption file BODY itself as `text` (SRT or WebVTT), not a URL. `language` is required and may not be guessed — YouTube uses it to decide which viewers see the track. A track YouTube generated itself (trackKind ASR) is refused by name: YouTube owns it and it cannot be edited or deleted through any API; to replace it, upload your own track in the same language and YouTube prefers yours. Delete is confirm-gated — viewers with captions on lose them immediately and YouTube stops indexing the video by that text, though it can be re-uploaded if you still have the file. 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload, replace or delete a caption track
  • manage_youtube_channel_sectionTHE SHELVES ON THE CHANNEL HOMEPAGE — what a visitor sees first, and the only place a chosen playlist can be put above YouTube’s own default layout.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE SHELVES ON THE CHANNEL HOMEPAGE — what a visitor sees first, and the only place a chosen playlist can be put above YouTube’s own default layout. action:'list' reads them in the order they appear, 'create' adds one, 'update' replaces one, 'delete' removes one (confirm-gated, and there is no undo — the layout has to be rebuilt by hand). EVERY WRITE IS PUBLIC IMMEDIATELY: a channel homepage is not a draft. `type` decides what the shelf holds — singlePlaylist and multiplePlaylists take playlist ids, multipleChannels takes channel ids and those two plus multiplePlaylists take a title you choose, while popularUploads, recentUploads, subscriptions and the rest are filled by YouTube and take neither. `position` is zero-based and is what re-orders the page. DO NOT TREAT A LIST AS A READ-BACK: YouTube's own section list lags a write by a few seconds in BOTH directions — measured, it returned nothing right after a create and still returned a deleted section right after a delete — so a write reports what YouTube returned and a delete reports as ACCEPTED, and re-listing straight away can show the old layout. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Channel homepage sections
  • manage_youtube_playlistCreate, update or delete a playlist on the connected channel.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create, update or delete a playlist on the connected channel. CREATE makes it PRIVATE unless you pass privacy — a public playlist appears on the channel immediately, so publishing is always a deliberate choice. UPDATE merges: an omitted title or description is LEFT ALONE rather than erased. DELETE is confirm-gated and does NOT delete the videos — what dies is the playlist, its ordering and every link or embed pointing at its URL; a playlist that is public or has videos in it additionally needs confirmTitle echoed back exactly, because confirm alone proves you meant to delete something and not that you aimed at the right playlist. To take a playlist out of public view WITHOUT destroying it use action="update" with privacy="private" — that is reversible and delete is not. 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create, rename or delete a YouTube playlist
  • manage_youtube_playlist_imagePUT A CUSTOM COVER ON A PLAYLIST.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "put": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PUT A CUSTOM COVER ON A PLAYLIST. Without one YouTube shows the first video's thumbnail. Action:'list' reads what is on a playlist, 'set' uploads a cover, 'delete' removes it. ImageUrl must be a Hermoso-hosted URL, up to 50MB. Nothing else is fetched server-side. YOUTUBE ANSWERS EVERY FAILURE HERE AS AN HTTP 500 "Internal error encountered" with the real reason buried inside it, so a plain relay would report a missing playlist id as a Hermoso outage — the refusals here are the real ones. If it comes back refused, the first thing to check is CHANNEL VERIFICATION: custom imagery needs a verified YouTube channel (add a phone number at youtube.com/verify), and on an unverified channel the sibling call that sets a custom video thumbnail is refused in the same way. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Custom playlist cover image
  • manage_youtube_playlist_itemsAdd a video to a playlist, remove an entry, or move an entry to a new position.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add a video to a playlist, remove an entry, or move an entry to a new position. ADD takes playlistId + videoId and returns the new entry’s `itemId`. REMOVE and MOVE take that `itemId` — NOT the videoId — because one video can sit in a playlist more than once, so a videoId does not identify which row to touch; list_youtube_playlists with a playlistId returns the itemId of every entry. Removing an entry does NOT delete the video, only its place in the playlist. Positions are zero-based. 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add, remove or re-order a video in a playlist
  • meta_conversation_labelsThe Facebook Page’s inbox labels (VIP, Wholesale, Call back…), which tag a PERSON in the Page inbox and Meta Business Suite and are never shown to them.Reads text others writeNo findings

    Why it is in this group

    • The name "meta_conversation_labels" says "label": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The Facebook Page’s inbox labels (VIP, Wholesale, Call back…), which tag a PERSON in the Page inbox and Meta Business Suite and are never shown to them. action "list" (the Page’s labels), "person" (labels on one person), "create" (name), "assign" / "remove" (labelId or exact name + recipientId), "delete" (removes the label from everyone; confirm-gated). Each change is read back from Meta. Messenger only: Meta’s labels API covers Messenger people, not Instagram. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Label people in the Messenger inbox
  • meta_messenger_profileWhat EVERY person sees before they write: on Messenger the Get Started button and greeting, and on Messenger and Instagram the ice breakers (up to 4 suggested questions) and the pe…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What EVERY person sees before they write: on Messenger the Get Started button and greeting, and on Messenger and Instagram the ice breakers (up to 4 suggested questions) and the persistent menu (up to 20 items, each a link or a reply tap). action "get" reads it from Meta; "set" and "delete" change it and are confirm-gated: without confirm:true they return the before and after and change nothing. The answer is read back from Meta, and anything Meta did not keep is named. Instagram has no greeting or Get Started button. Messenger shows a menu only when a Get Started button is set. Meta allows 10 changes per 10 minutes per Page. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Welcome screen, ice breakers and menu for Messenger / Instagram DMs
  • meta_thread_controlWho answers a conversation when the brand runs another chat app beside Hermoso (ManyChat, a help desk, Meta’s own inbox): Meta’s Conversation Routing.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Who answers a conversation when the brand runs another chat app beside Hermoso (ManyChat, a help desk, Meta’s own inbox): Meta’s Conversation Routing. action "owner" (which app holds this conversation now), "status" (does the Page route between several apps), and, confirm-gated because they change who answers a real customer: "pass" (to targetAppId: another app’s numeric Meta app id, or "Page inbox" / "Instagram inbox"), "take" (for Hermoso; Meta blocks it unless the Page has a default app), "release" (back to the Page’s default app), "request" (ask the holder to hand it over), "extend" (keep it up to 7 days). Without confirm:true a write only previews. Facebook Page connections only. Secondary receivers belonged to Meta’s retired Handover Protocol and are not offered. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Hand a Messenger / Instagram conversation to another app
  • moderate_meta_commentModerate a comment on the brand’s Facebook or Instagram post.Reads text others writeNo findings

    Why it is in this group

    • The name "moderate_meta_comment" says "comment": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Moderate a comment on the brand’s Facebook or Instagram post. Hide is the default and can be undone. Deleting is PERMANENT and requires confirm:true after the user has agreed.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Hide, unhide or delete a Meta comment
  • moderate_tiktok_commentModerate one comment on a TikTok post the authorized account owns: LIKE, UNLIKE, HIDE, UNHIDE or DELETE.Reads text others writeNo findings

    Why it is in this group

    • The name "moderate_tiktok_comment" says "comment": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Moderate one comment on a TikTok post the authorized account owns: LIKE, UNLIKE, HIDE, UNHIDE or DELETE. TWO RULES TIKTOK ENFORCES AND THIS TOOL STATES UP FRONT. (1) YOU CAN ONLY DELETE A COMMENT THIS ACCOUNT WROTE — anyone else's can be hidden but never deleted, so HIDE is the tool for an unwanted comment from a stranger, and it is reversible. DELETE is permanent and confirm-gated. (2) UNHIDE IS NOT GUARANTEED: TikTok says a comment may stay hidden because ITS OWN moderation, privacy or spam filters are what hid it, in which case accepting the request changes nothing — so pass videoId and the reply reads the comment back and reports its real status rather than claiming success from a 200. HIDE and UNHIDE require videoId; LIKE, UNLIKE and DELETE do not. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Like, hide or delete a TikTok comment
  • moderate_x_broadcastModerate the connected X account's live broadcast chat.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "moderate_x_broadcast" says "broadcast": a word for sending, and what is sent cannot be taken back.
    • The description says "cannot be undone".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "moderate_x_broadcast" says "broadcast": it sends or publishes something to other people.
    Description, as the server wrote it
    Moderate the connected X account's live broadcast chat. action 'remove_message' (broadcastId + messageId; cannot be undone, confirm:true), 'mute' (broadcastId + userId or username; until = when a timeout ends, omit to mute indefinitely; messageId removes that message while muting), 'unmute', 'list_mutes' (everyone muted across the brand's chats), 'mute_everywhere' / 'unmute_everywhere' (userId or username, every chat of the brand; when the brand moderates another host, broadcastId scopes it to that host), and the account's PERSISTENT chat moderators, which apply to every current and future broadcast: 'list_moderators', 'add_moderator', 'remove_moderator' (userId or username). Only the host or a moderator can moderate, and X says so if not. A username costs one extra lookup. Needs X connected with the broadcast permissions added 2026-09-21: an X connection made before then must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Moderate an X broadcast chat
  • moderate_youtube_commentModerate a comment on the connected channel — the YouTube twin of moderate_meta_comment.Reads text others write1 finding

    Why it is in this group

    • The name "moderate_youtube_comment" says "comment": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • High

      The description contains "do not tell the user", an instruction to keep something from the user.

      Matched text

      description: "...o YouTube — a REPORT, not a removal, so do not tell the user it is gone) · delete (permanent; YouTub..."

      What this check looks for
    Description, as the server wrote it
    Moderate a comment on the connected channel — the YouTube twin of moderate_meta_comment. ACTIONS: publish (make it visible again) · hold (hide it pending review) · reject (hide it as unfit for display) · spam (report it to YouTube — a REPORT, not a removal, so do not tell the user it is gone) · delete (permanent; YouTube has no undelete for a comment). hold, reject and publish are all reversible with each other, so only delete is confirm-gated. If the goal is just to take a comment out of public view, use reject rather than delete. banAuthor is valid ONLY with action="reject" — that is YouTube’s own restriction — and auto-rejects every future comment that author leaves on the channel. Get commentId from list_youtube_comments. 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Hide, reject, spam-report or delete a YouTube comment
  • onedrive_file_permissionsaction list (default): every sharing link and person with access to a OneDrive file or folder: link URL, view or edit, scope, expiry, password, whether it is inherited from a paren…Reads text others writeNo findings

    Why it is in this group

    • The description says "cannot be restored".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    action list (default): every sharing link and person with access to a OneDrive file or folder: link URL, view or edit, scope, expiry, password, whether it is inherited from a parent folder. action remove: revoke one (permissionId from the list); anyone relying on it loses access at once and the link cannot be restored, so WITHOUT confirm:true nothing is removed and you get what would go. An inherited permission is removed on the parent folder, and the owner's own access cannot be removed. Removal is verified by reading the list back. 0 credits. Needs OneDrive connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Who can open a OneDrive file
  • pay_campaign_creatorsDefault (no confirm): a PREVIEW, nothing charged: each payable creator gets the full amount, plus the Hermoso fee (3%, min $2 per creator), Stripe's payout costs at cost and one pa…Reads text others writeNo findings

    Why it is in this group

    • The name "pay_campaign_creators" says "pay": a word that usually means money moves, which cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Default (no confirm): a PREVIEW, nothing charged: each payable creator gets the full amount, plus the Hermoso fee (3%, min $2 per creator), Stripe's payout costs at cost and one payment processing line (the same whatever pays; bank debit gets a discount), totals by card and by bank debit. confirm:true with acceptTerms:true creates one payment link: card (held 7 days) or method "bank" (pre-authorized debit, Canadian business bank account, held 14 days once it clears), then Stripe pays each creator. A disputed payment freezes every campaign and payout on the account. recordOnly with participantId: mark a creator paid outside Hermoso (moves no money). fromFunds:true pays from money already paid into the campaign (creator_campaign_funds): a preview, then confirm:true; nothing is charged. A creator who owes back a claw-back is paid the net.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Preview or pay what campaign creators are owed
  • post_to_blueskyUse this when the user wants to post to Bluesky.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_bluesky" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_bluesky" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post to Bluesky. Publishing costs no credits. Publish a post to Bluesky as the connected account. Text up to 300 characters — Bluesky ALSO caps a post at 3000 UTF-8 bytes, so an emoji-heavy post can be under 300 characters and still be refused; Hermoso checks both and says which limit. Bluesky requires a CONFIRMED EMAIL on the account before it will process any video — if it is unconfirmed you get a refusal saying so, and reconnecting will not help. Returns the post's public bsky.app URL. Connect at Connectors > Bluesky. Full rules: get_instructions({topic:'post_to_bluesky'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post to Bluesky
  • post_to_discordPost to the user's Discord server.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_discord" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_discord" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Post to the user's Discord server. Free. With the Hermoso bot added it posts as the bot to channel (or the brand's default channel) with attachments up to 25 MB a message, replyTo, threadId (inside a thread), startThread (a thread under the post) and threadName (a forum channel); the messageId it returns ("<channel>/<message>") is what edit, delete and get_discord_message take. Without the bot it posts through the brand's announcement webhook (never the alert one): ≤2000 characters, files up to 20 MB attached (up to 10), larger ones as links. Mentions never ping unless mentions:true. EITHER WAY it can carry embeds (up to 10 rich cards, 6000 characters between them), a native poll (question, up to 10 answers, 1 to 768 hours; get_discord_poll reads the votes) and tts (read aloud). A webhook post can also take a display name and avatar for that one post (username, avatarUrl); crosspost:true (bot only) also publishes the post to every server that follows the announcement channel. Anything over a Discord limit is refused, never cut. Reactions are the only per-post number (get_discord_message). Not connected: connect_connector with provider discord and no fields returns the install link.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post a Discord announcement
  • post_to_google_businessPublish a Post to the brand’s Google Business Profile — the panel that appears on Google Search and Maps for the business.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_google_business" says "post": a word for a change.
    • The description's first verb is "publish": a word for a change that another call does not undo.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_google_business" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Publish a Post to the brand’s Google Business Profile — the panel that appears on Google Search and Maps for the business. Text, optionally ONE PHOTO, and a call-to-action button. Google’s Posts API accepts NO VIDEO, so pass a still image. This PUBLISHES immediately and publicly on the business listing — show the user the exact text, photo and button and get an explicit yes BEFORE calling. If the account manages several listings, call list_business_locations first and pass locationId. EVENT and OFFER posts both REQUIRE a title and a start date (Google’s rule). On an OFFER, Google IGNORES the button’s link — pass redeemOnlineUrl instead. A CALL button dials the number on the listing and takes no link. Needs Google Business Profile connected (Connectors > Google Business Profile).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post to Google Business Profile
  • post_to_linkedinUse this when the user wants to post to their personal LinkedIn profile.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_linkedin" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_linkedin" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post to their personal LinkedIn profile. Publishing costs no credits. Publish a post to the user’s connected LinkedIn profile — text, and optionally an image (imageUrl), a VIDEO (videoUrl, with captionsSrt and a videoThumbnailUrl cover), a 2–20 image MULTI-IMAGE post (imageUrls), a LINK post with a real preview card (linkUrl + linkTitle / linkDescription / linkThumbnailUrl — LinkedIn never scrapes the page), a DOCUMENT post (documentUrl: a PDF / PPTX readers swipe through), and @mentions of companies (mentions). The image does NOT have to be something Hermoso generated: LinkedIn is served the bytes from us, so the URL must be Hermoso-hosted, and upload_file turns ANY file the user already has into exactly that. This PUBLISHES immediately and PUBLICLY — ALWAYS show the user the exact text and get an explicit yes BEFORE calling. Needs a connected LinkedIn account (Connectors > LinkedIn).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish to LinkedIn
  • post_to_linkedin_pageUse this when the user wants to post to a LinkedIn company Page.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_linkedin_page" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_linkedin_page" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post to a LinkedIn company Page. Publishing costs no credits. This is a DIFFERENT thing from post_to_linkedin, which publishes to the person’s own profile: pick the one the user actually asked for and never substitute. organizationId comes from list_linkedin_pages; omit it only when the account administers exactly one Page. This PUBLISHES immediately and PUBLICLY — ALWAYS show the user the exact text and get an explicit yes BEFORE calling. LinkedIn does NOT allow the image, video, captions or thumbnail of a published post to be swapped afterwards, so get all of that right first (the copy can still be edited with manage_linkedin_post). Full rules: get_instructions({topic:'post_to_linkedin_page'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish to a LinkedIn company Page
  • post_to_metaUse this when the user wants to post now to Facebook, Instagram or Threads.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_meta" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_meta" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post now to Facebook, Instagram or Threads. Publish to a connected Facebook Page, its linked Instagram, OR the brand’s Threads account — text/link/image/VIDEO/CAROUSEL. A MULTI-SLIDE creative is a CAROUSEL, not several posts: pass the slides in order as imageUrls[] and they publish as ONE swipeable post (Instagram album, Threads carousel, Facebook multi-photo post). Never publish slide 1 of a deck on its own — the creative tells the viewer to swipe. target:"facebook" (default) posts to the Page; target:"instagram" publishes a photo or Reel to the linked IG business account (needs an image or video); target:"threads" posts to the connected Threads account (text, image, or video). imageUrl/videoUrl accept a public https URL, a data: URI, or a Hermoso /generated path; for a LOCAL file (e.g. on the user’s desktop) call upload_file first and pass the url it returns. INSTAGRAM COLLAB: pass `collaborators` (up to 3 usernames) to invite other accounts to CO-AUTHOR the post — it then shows on their profile too once they accept. This PUBLISHES immediately — confirm the copy + media with the user first. Needs a connected Meta account (Connectors > Meta) with posting permission; Threads needs its own connection.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post to Facebook, Instagram or Threads
  • post_to_pinterestUse this when the user wants to publish a Pin to Pinterest.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_pinterest" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_pinterest" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to publish a Pin to Pinterest. Publishing costs no credits. Create a Pin on one of the user’s Pinterest boards: an image, video, or a 2–5 slide CAROUSEL (pass the slides in order as imageUrls[] and Pinterest publishes one swipeable Pin). Title, description and destination link ride along. Ask the user for the destination link; Pinterest search reads the description. boardId is REQUIRED: call list_pinterest_boards first and let the user choose. This PUBLISHES to their public profile — confirm the board, title and link before calling. Video Pins take a minute or two while Pinterest ingests the file. Needs Pinterest connected (Connectors > Pinterest).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Pin
  • post_to_shopify_blogUse this when the user wants to publish, draft or schedule a BLOG ARTICLE on their Shopify store's blog.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_shopify_blog" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_shopify_blog" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to publish, draft or schedule a BLOG ARTICLE on their Shopify store's blog. Publishing costs no credits. Works for the Shopify store connected to this brand (Connectors > Shopify, or connect_shopify_store) or the store this account was installed on. A title is REQUIRED and the text becomes the body: plain text or light markdown (## headings, - lists, **bold**, [links](url)) becomes HTML, and HTML is sent as written. status: publish (default), draft, or scheduled with a future `date`, which Shopify schedules natively. The FIRST image becomes the featured image (Shopify copies it into the store); other images and a video go inside the body by their own links. A store with one blog needs no blog named; with several, pass blog (list_shopify_blogs); newBlogTitle creates a blog with the article. The reply is Shopify's own copy of the article, with its public address once published. An over-long tag is refused, never cut. A store that installed Hermoso before blog posts existed is asked to open the app once and approve the new permission. Shopify has no view counts on a blog article: never quote one.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish a Shopify blog article
  • post_to_slackPost to the user's Slack.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_slack" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_slack" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Post to the user's Slack. Free. With the Hermoso app installed it posts as the app to channel (or the brand's default channel), uploads images and video, replies in a thread (threadTs) or schedules in Slack (postAt, text only, ≤120 days); the messageId it returns ("<channel>/<ts>") is what edit_slack_message, delete_slack_message and get_slack_message take. Without the app it posts through the brand's announcement webhook (never the alert one): text ≤40,000 characters (refused, never cut), a title line, png/jpg/gif images by link, video as a link; a webhook post has no id, so it cannot be edited, deleted or measured. Not connected: connect_connector with provider slack and no fields returns the install link.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post a Slack announcement
  • post_to_telegramUse this when the user wants to post to a Telegram channel or group.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_telegram" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_telegram" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post to a Telegram channel or group. Publishing costs no credits. Publish to a Telegram channel, group or chat as the brand's own bot. WHICH CHAT IS ALWAYS REQUIRED AND IS NEVER GUESSED: pass chatId as the public channel's @username (e.g. @yourchannel) or its numeric id (a group is negative; a supergroup or channel starts with -100). THE BOT MUST BE IN THE CHAT — an administrator with Post Messages for a channel, an unrestricted member for a group; if it is not, Telegram refuses and the error says to add it rather than to reconnect. 0 credits. Connect at Connectors > Telegram. Full rules: get_instructions({topic:'post_to_telegram'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post to Telegram
  • post_to_tiktokUse this when the user wants to post a video or photo post to TikTok now.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_tiktok" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_tiktok" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post a video or photo post to TikTok now. Publishing costs no credits. Publish to the user’s connected TikTok account — a finished VIDEO, or a PHOTO POST (TikTok’s photo/slideshow format). A photo post carries 1 to 35 images and ONE image is simply a one-slide photo post, so there is nothing special to do for a single picture: pass imageUrls, in the order the slides should appear, and optionally coverIndex. Pass videoUrl for a video. Never pass both — TikTok has no mixed post. TWO destinations. destination:"post" (THE DEFAULT) publishes it LIVE on their profile: TikTok requires the user to CHOOSE the privacy themselves (no default is allowed), so call tiktok_creator_info, show them their real privacy options, and get their choice and an explicit yes before calling. destination:"draft" is ONLY for when the user asks for a draft, or wants to add a TikTok sound or trending audio (TikTok’s API takes no sound for a VIDEO): BEFORE sending, tell them plainly it lands in their TikTok inbox as a DRAFT, that they add the sound in TikTok’s editor, and that THEY must publish it from the TikTok app — nothing goes live until they do. Never pick draft on your own. A photo post published with destination:"post" gets a TikTok-recommended track automatically (autoAddMusic, default on) that they can change in the app. Pass Hermoso render URLs (or upload_file urls for local/external files). Needs TikTok connected (Connectors > TikTok).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post a video or photo post to TikTok
  • post_to_webflowUse this when the user wants to publish or draft a BLOG POST on their Webflow site.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_webflow" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_webflow" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to publish or draft a BLOG POST on their Webflow site. It becomes an item in the site's blog CMS collection. Publishing costs no credits. A title is REQUIRED and the text becomes the body: plain text or light markdown becomes HTML in the collection's rich text field, and HTML is sent as written (Webflow's API cannot take code blocks, so a body with one is refused). Hermoso maps the post onto the collection's OWN fields: title and slug, the body, a summary field, a cover image field (up to 4 MB), and search title and description fields when the collection has them. A part the collection has no field for is refused by name, never dropped. REQUIRED FIELDS of the collection are filled from the post where they can be: a required Title or Headline field takes the title, an Intro or Summary field the excerpt (else the first lines of the body), every required image field the cover image. A required Author, Category or other choice is NEVER guessed: the refusal names each such field's slug, type and allowed values (a Reference's items by name and id, an Option's options), and you pass them in fieldData by slug; a Reference or Option value may be the item's or option's id or its name. fieldData also sets any other field. status: publish (default) or draft. Webflow's API CANNOT SCHEDULE a post: for a later time use schedule_post with the webflow channel. The reply is Webflow's own copy of the item, with its public address. Webflow has no view counts on an item: never quote one. Not connected: the user connects it under Connectors > Webflow, or you call connect_connector with provider webflow (token).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish a Webflow blog post
  • post_to_wixUse this when the user wants to publish, draft or schedule a BLOG POST on their Wix site.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_wix" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_wix" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to publish, draft or schedule a BLOG POST on their Wix site. Publishing costs no credits. A title is REQUIRED (up to 200 characters) and the text becomes the body: plain text or light markdown is turned into Wix's own rich content, and HTML is converted by Wix (up to 30,000 characters). status: publish (default), draft, or scheduled with a future `date`, which Wix schedules natively. The FIRST image becomes the cover; other images and a video are brought into the site's Media Manager and placed in the body. tags and categories take names; one the blog lacks is CREATED, and the reply says which categories. A title over 200 characters, an excerpt over 500, a slug over 100 or more than 30 tags is refused, never cut. The reply is Wix's own copy of the post, with its public address once it is live. Not connected: the user connects it under Connectors > Wix, or you call connect_connector with provider wix (apiKey, siteId).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish a Wix blog post
  • post_to_wordpressUse this when the user wants to publish, draft or schedule a BLOG POST on their WordPress site.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_wordpress" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_wordpress" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to publish, draft or schedule a BLOG POST on their WordPress site. Publishing costs no credits. A title is REQUIRED and the text becomes the body: plain text or light markdown (## headings, - lists, **bold**, [links](url)) is turned into WordPress blocks, and HTML is sent as written. status: publish (default), draft, pending (submit for review), private (logged-in editors only) or future with a date — a future `date` makes WordPress schedule it natively. The FIRST image becomes the FEATURED image, every other image is uploaded and placed inline, and a video is uploaded and embedded (if the site's host refuses the file as too large, the post plays it from its own link and the reply says so). categories and tags take names or ids; a name the site lacks is CREATED and the reply says which. An over-long title is refused, never cut. WordPress has NO per-post views in its API: never quote a view count for a WordPress post. Works on a self-hosted site and on a site hosted on WordPress.com, whichever the brand connected. Not connected: the user connects it under Connectors > WordPress, or you call connect_connector with provider wordpress (siteUrl, username, appPassword).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish a WordPress blog post
  • post_to_xUse this when the user wants to post to X (Twitter) now.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_x" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_x" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to post to X (Twitter) now. Publish to the user’s connected X (Twitter) account — a single post, a post with an image or video render attached, a reply to an existing post, or a whole THREAD (pass `thread` as an array and each part is posted as a reply to the one before). This PUBLISHES immediately and PUBLICLY — ALWAYS show the user the exact text and get an explicit yes BEFORE calling. Text is NEVER truncated. Write altText whenever you attach a render. COSTS CREDITS at X’s per-post price, every post in a thread billed: a post that contains a link (any web address, and every quote post) is X’s link rate, far higher than one without (hermoso_credits gives both figures). When the user asks what a post will cost, call this with dryRun:true: it posts NOTHING and returns that exact post’s costCredits. THIS TOOL POSTS ORGANICALLY — it does not create an ad campaign. Needs X connected (Connectors > X). Full rules: get_instructions({topic:'post_to_x'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish a post to X (Twitter)
  • post_to_youtubeUse this when the user wants to upload a video or Short to YouTube.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_to_youtube" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_to_youtube" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to upload a video or Short to YouTube. Publishing costs no credits. Publish a finished video to the brand’s connected YouTube channel. Pass a Hermoso render URL (or an upload_file url for a local/external file). PUBLISHES PUBLICLY BY DEFAULT: a plain "post this to YouTube" puts it ON the channel (confirm the title with the user, as for any publish) and notifies subscribers as YouTube does. Pass the privacy the user states instead: "unlisted" (link-only) or "private" (eyes-only). A video meant to run as a YouTube/Google AD should go up "unlisted" — private videos CANNOT be used as ads. Never choose unlisted for music on your own. Needs a connected YouTube channel (Connectors > YouTube). Full rules: get_instructions({topic:'post_to_youtube'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Post a video to YouTube
  • post_x_articlePublish a long-form ARTICLE to the user’s connected X (Twitter) account — X’s own long-form format, which is a different thing from a long POST.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "post_x_article" says "post": a word for a change.
    • The description's first verb is "publish": a word for a change that another call does not undo.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "post_x_article" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Publish a long-form ARTICLE to the user’s connected X (Twitter) account — X’s own long-form format, which is a different thing from a long POST. THE HARD LIMIT TO PLAN AROUND: X allows only about 10 Article DRAFTS and 5 Article PUBLISHES per account per DAY, it publishes that cap nowhere, and it counts a FAILED attempt against them — so never iterate on an article by republishing it, and use `publish: false` to save a draft for the user to read in X’s own composer when they want to review before it goes out. This PUBLISHES immediately and PUBLICLY: show the user the full text and get an explicit yes first, because a published Article can NEVER be edited (X’s own rule — edit_x_post will refuse it) and the only remedy is to delete and republish, which costs another of the five. Costs credits (X bills per API request, and this is three of them). Needs X connected (Connectors > X). Full rules: get_instructions({topic:'post_x_article'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish a long-form Article to X
  • publish_to_shopify_productAttach a finished IMAGE or VIDEO to one of the merchant's Shopify product listings, as product media.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "publish_to_shopify_product" says "publish": a word for a change that another call does not undo.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "publish_to_shopify_product" says "publish": it sends or publishes something to other people.
    Description, as the server wrote it
    Attach a finished IMAGE or VIDEO to one of the merchant's Shopify product listings, as product media. Pass productId (from list_shopify_products, the gid://shopify/Product/… form) and a PUBLIC https mediaUrl, which is what every Hermoso render returns. Whether it is a video is read from the file (.mp4 / .mov / .webm, or the link's content type); pass kind to say so outright. An image is fetched by Shopify directly; a video is uploaded to Shopify for you (MP4, MOV or WEBM, up to Shopify's 1 GB and 10-minute product-video limits; a file over a limit is refused by name, never cut). Shopify processes media asynchronously: the reply is the status read back from Shopify, and READY means it is live on the listing while PROCESSING means it will appear when Shopify finishes. That is success, not a failure. Works for the Shopify store connected to this brand (Connectors > Shopify, or connect_shopify_store) or the store this account was installed on. Free: the render was already paid for.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Publish an image or video onto a Shopify product
  • refund_shopify_orderRefund a Shopify order to its original payments: full:true (everything still refundable, plus shipping), or lineItems [{ lineItemId, quantity, restock }], shipping { full:true } or…Reads text others writeNo findings

    Why it is in this group

    • The name "refund_shopify_order" says "refund": a word that usually means money moves, which cannot be taken back.
    • The input carries an amount (input.amount) and a currency, so it moves money.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Refund a Shopify order to its original payments: full:true (everything still refundable, plus shipping), or lineItems [{ lineItemId, quantity, restock }], shipping { full:true } or { amount }, and/or amount (a sum of money, e.g. a goodwill refund). Every amount is in the currency the buyer paid (pass currency to have a mismatch refused). Without confirm:true Shopify computes the refund and NOTHING is refunded: show the user the amount and where it goes, get a yes, then call again with confirm:true and confirmAmount set to that exact amount. notify emails the buyer. Retrying the same confirmed refund never refunds twice. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Refund a Shopify order
  • reject_postReject a scheduled post waiting for approval: it will not be published.Can send data outNo findings

    Why it is in this group

    • The name "reject_post" says "reject": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • outboundThe name "reject_post" says "reject" and "post": it writes something other people read.
    Description, as the server wrote it
    Reject a scheduled post waiting for approval: it will not be published. The author can edit it, which sends it back for approval. Admins only.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Reject a scheduled post
  • release_phone_numberGive one of the brand's numbers back to Twilio or Telnyx: it stops receiving texts and calls and stops being billed, and usually cannot be got back.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Give one of the brand's numbers back to Twilio or Telnyx: it stops receiving texts and calls and stops being billed, and usually cannot be got back. Without confirm:true nothing is released and you get the number it would release; call again with confirm:true only after the user says yes. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Release a phone number
  • remove_discord_roleTake a role away from one member of the brand's Discord server; they lose every channel and permission it gave them.Reads text others writeNo findings

    Why it is in this group

    • The name "remove_discord_role" says "remove": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Take a role away from one member of the brand's Discord server; they lose every channel and permission it gave them. Call it WITHOUT confirm first: nothing changes and you get a sentence naming the member and the role to show the user. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Take a role away from a Discord member
  • remove_memberRemove a member from this profile by email — they lose access (you can re-invite them later), AND every connection THEY made on this profile is disconnected with them: their own X,…Reads text others writeNo findings

    Why it is in this group

    • The name "remove_member" says "remove": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a member from this profile by email — they lose access (you can re-invite them later), AND every connection THEY made on this profile is disconnected with them: their own X, LinkedIn, TikTok, YouTube, Pinterest, Threads… connections (on a channel holding several accounts, only the accounts they added), and any extra login or authorization they added. Connections the owner or anyone else made are never touched, and one with no record of who connected it is treated as the owner's. Queued posts that would publish through their accounts, or that they scheduled themselves, will not go out. The unconfirmed call reports exactly which connections and how many scheduled posts — relay that to the user, then call with confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove a teammate
  • reply_to_google_business_reviewAnswer a customer review publicly, as the business, on the brand’s Google Business Profile listing — or delete a reply that is already there.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_google_business_review" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_google_business_review" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Answer a customer review publicly, as the business, on the brand’s Google Business Profile listing — or delete a reply that is already there. THIS IS AN UPSERT: a listing has exactly one reply per review, so replying to a review that already has an answer REPLACES it rather than adding a second. Google only accepts replies on a VERIFIED listing. Deleting is public and immediate, so it is confirm-gated. Write the reply in the brand’s voice and answer the specific complaint — a generic reply under a one-star review is worse than none. Needs Google Business Profile connected and the project approved.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Reply to (or remove a reply from) a Google review
  • reply_to_inbox_itemUse this when the user wants to answer a comment, review, mention or message from the inbox.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_inbox_item" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_inbox_item" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user wants to answer a comment, review, mention or message from the inbox. Pass its composite id — the `id` list_inbox returned, e.g. 'facebook:123_456' or 'google_business:accounts/1/locations/2/reviews/3'. Routes to the right channel for you; you do not need to know which reply tool a platform uses. The reply is posted as the brand — PUBLIC on every comment, reply, mention and review (a Discord mention is answered with a reply in its channel), and PRIVATE on the DM sources (Slack and Discord DMs too), WhatsApp, LINE, Intercom (it goes to the customer from the brand's support inbox) and email (it goes in the same thread from the same Outlook mailbox) — so show the user the exact wording and get their go-ahead first either way. On X a reply is a new post, so it goes through post_to_x with replyTo; an X or Telegram DIRECT MESSAGE is answered here, from the account or bot it reached (an X DM reply costs credits). A WhatsApp reply goes out only while the 24-hour window is open (windowOpen on the item); after that WhatsApp accepts only an approved template, so the reply is refused for free and send_whatsapp_message with `template` is the way. A LINE reply is free inside a minute of their message and uses the account's LINE quota after it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Reply to anything in the inbox
  • reply_to_intercom_conversationSend a reply to the CUSTOMER on an Intercom conversation, from the brand's inbox as the teammate who owns the connection.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_intercom_conversation" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_intercom_conversation" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Send a reply to the CUSTOMER on an Intercom conversation, from the brand's inbox as the teammate who owns the connection. This reaches a real customer and cannot be unsent. Read the conversation first (read_intercom_conversation), draft the reply in the brand's voice, show the user the exact words, and send only when they ask: call with confirm:true. Without confirm it sends nothing and returns the preview. The result is read back from the conversation Intercom returns. Plain text; blank lines become paragraphs. Never leave a placeholder such as [Your name] or [Order number] in it: Intercom already shows the customer which teammate replied, so sign with the brand's name or leave it unsigned, and ask the user for any fact you do not have. Free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Reply to an Intercom customer
  • reply_to_linkedin_commentSpeak AS your LinkedIn company Page: comment on one of its posts, or reply to somebody else's comment on it.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_linkedin_comment" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_linkedin_comment" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Speak AS your LinkedIn company Page: comment on one of its posts, or reply to somebody else's comment on it. Community Management surface — same separate connection as list_linkedin_comments. `organizationId` is WHO IS SPEAKING (the Page, from list_linkedin_pages) and `postUrn` is WHAT IS BEING COMMENTED ON; they are different things and both are required. To reply to a particular comment rather than the post itself, pass that comment's `commentUrn` from list_linkedin_comments as `parentComment`. LinkedIn's API does not support images in comments. It also throttles comment creation per member, and a throttle is reported as a throttle so you wait rather than retrying into it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Comment or reply on a LinkedIn Page post
  • reply_to_meta_commentPost a public reply to a comment on the brand’s Facebook or Instagram post.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_meta_comment" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_meta_comment" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Post a public reply to a comment on the brand’s Facebook or Instagram post. This is PUBLIC and posted as the brand — show the user the exact wording and get their go-ahead first. With private:true it instead sends ONE private message to the commenter (Messenger / Instagram Direct) — once per comment, within 7 days.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Reply to a Facebook/Instagram comment
  • reply_to_meta_messageSend a text reply to someone who has messaged the brand.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_meta_message" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_meta_message" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Send a text reply to someone who has messaged the brand. THIS REACHES A REAL PERSON — show the user the exact text and who it goes to, get a yes, then send. Pass `conversationId` as well as `recipientId` and Hermoso checks Meta’s 24-hour window for free BEFORE sending, and refuses with the real reason instead of letting Meta refuse it; without one it sends and discloses that the window could not be checked. HERMOSO SENDS REPLIES ONLY: messaging_type is always RESPONSE, and proactive messages and message tags are not offered at all — that is a deliberate product boundary, not a gap. THE ONE PROACTIVE THING MESSENGER ALLOWS IS A MARKETING-MESSAGES SUBSCRIPTION: to ask a person in the inbox to SUBSCRIBE to marketing messages, call request_messenger_optin (Meta’s own opt-in template, in the ads group — enable_tools(["ads"]) or find_tools if it is not in your list). Never answer that with a plain-text reply asking them to say YES, and never say the capability does not exist. And a closed window is a RULE that only the person writing again reopens. `recipientId` is a PAGE-SCOPED ID on Messenger and an INSTAGRAM-SCOPED ID on Instagram (read_meta_conversation returns it as `replyTo`); a username or a handle is not one and cannot be turned into one. ACCEPTED IS NOT DELIVERED — never report it as delivered or read. RICH REPLIES: `attachments` (photos, video, voice notes, PDFs by https URL; upload_file turns a local file into one), `buttons` (up to 3 link or postback buttons under the text), `cards` (a carousel of up to 10), `quickReplies` (up to 13 tap-to-answer chips), `replyToMessageId` (answer one earlier message), `senderAction` (typing_on, typing_off or mark_seen, sent first). One reply can become several Meta messages, sent in order: the text, the media, the cards; the answer lists each part and, when one is refused, which parts went out. Limits are Meta’s and a reply over one is refused, never cut (Instagram text is 1000 bytes). 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Reply to a Messenger / Instagram DM
  • reply_to_threadPost a reply to a Threads post — the brand’s own or someone else’s.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_thread" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_thread" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Post a reply to a Threads post — the brand’s own or someone else’s. This PUBLISHES publicly under the brand’s account, so show the user the exact wording and get their go-ahead first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Reply on Threads
  • reply_to_tiktok_commentReply to an existing comment on a TikTok post the authorized account owns.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_tiktok_comment" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_tiktok_comment" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Reply to an existing comment on a TikTok post the authorized account owns. Text (≤1,200 characters) or an image; at least one is required. A REPLY IS THE ONE PLACE TIKTOK ACCEPTS A PLAIN IMAGE URL (pass imageUrl); an uploaded imageUri + width + height also works. TikTok silently hides replies it flags as spam, so read it back with list_tiktok_comment_replies if visibility matters. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Reply to a comment on the brand’s TikTok post
    • idempotentHint: false
  • reply_to_youtube_commentPost a public reply to a comment on the connected channel, as the channel.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reply_to_youtube_comment" says "reply": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_youtube_comment" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Post a public reply to a comment on the connected channel, as the channel. This is PUBLIC and immediate — show the user the exact reply text and get an explicit yes before calling. Get commentId from list_youtube_comments. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Reply to a YouTube comment
  • repost_on_xRepost (retweet) ONE post from the brand’s X account, or take the repost back with undo:true.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Repost (retweet) ONE post from the brand’s X account, or take the repost back with undo:true. A repost is public at once on the brand’s timeline, so only repost a post the user named or approved. One post per call. The reply states what X reports afterwards. Costs credits (X bills per API call). Needs X connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Repost a post on X
  • repost_threadRepost an existing Threads post to the brand’s own Threads profile — the Threads equivalent of a retweet.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Repost an existing Threads post to the brand’s own Threads profile — the Threads equivalent of a retweet. It is how a brand amplifies a customer’s post, a mention, or one of its own older threads without copying the text, and there was previously no way to do it. Works on any Threads post id: list_threads_posts, list_threads_mentions and search_threads_keyword all return them. This creates a NEW post on the profile, so show the user what is being reposted and get a yes first. Threads publishes NO un-repost endpoint — because a repost returns its own media id, deleting THAT id with delete_thread is the likely undo, but Meta does not document it, so check the profile afterwards rather than promising it worked. 0 credits. Needs Threads connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Repost a Threads post
  • request_messenger_optinSend Meta’s opt-in request (the notification_messages template) to someone ALREADY in a Messenger conversation with the Page, inside the 24-hour window.Reads text others writeNo findings

    Why it is in this group

    • The name "request_messenger_optin" says "request": a word for a change.
    • The description's first verb is "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Send Meta’s opt-in request (the notification_messages template) to someone ALREADY in a Messenger conversation with the Page, inside the 24-hour window. If they accept, Meta posts a messaging_optin webhook with their subscription token and they appear in list_messenger_subscribers. One identical-title request per person per week. Free to send. The PSID comes from the Page inbox.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Ask a Messenger contact to subscribe to marketing messages
    • idempotentHint: false
  • reschedule_postChange 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 …Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "reschedule_post" says "reschedule": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reschedule_post" says "reschedule" and "post": it writes something other people read.
    Description, as the server wrote it
    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. PASS ONLY WHAT CHANGES: an omitted field is left exactly as it was, and an explicit empty string CLEARS one (linkedinOrganizationId:"" moves a company-Page post back to the person’s own profile). The edited item is re-checked against the identical rules its create passed — visibility the channel can honour, per-channel length, media the channel can carry — so an edit can never slip past a refusal that a create would have caught. Get the id from list_scheduled. Something that already went out cannot be changed: a published post is edited or removed with manage_meta_post / manage_linkedin_post / delete_x_post, not rescheduled.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a scheduled post
  • respond_instagram_collab_inviteAnswer a collab invite from list_instagram_collab_invites.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "respond_instagram_collab_invite" says "invite": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "respond_instagram_collab_invite" says "invite": it sends or publishes something to other people.
    Description, as the server wrote it
    Answer a collab invite from list_instagram_collab_invites. accept:true makes this account a co-author and the creator’s post appears on its profile; accept:false declines. `accept` is REQUIRED — never guess which way the user wants it. The reply is read back from Instagram (the invite leaves the pending list), not taken from the vendor’s 200. Free. Instagram allows 50 answers per account per day.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Accept or decline a collab invite
  • retry_scheduledSend a post that FAILED again.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The description's first verb is "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send a post that FAILED again. A scheduled post fans out across its channels INDEPENDENTLY, so a failure is usually PARTIAL (LinkedIn 401s while Instagram published), and by default this re-fires ONLY the channels that did not succeed (list_scheduled reports them as `retryable`). It re-queues the same content as a NEW post that goes out RIGHT AWAY, within seconds; the original keeps its failure record. Naming a channel that already published is REFUSED rather than posted twice: a channel that published can only REPLAY (nothing is posted), and one whose outcome is UNRESOLVED (the platform timed out and may be holding the post) refuses with that reason instead of guessing. Fix the cause IN THIS CALL: pass `boardId`, `pageId`, `linkedinOrganizationId`, `locationId`, `message` or `captions` to correct the value that failed, and the corrected post is re-validated exactly like a fresh schedule. The commonest cause is a field, not an outage: a Pin aimed at the wrong board fails identically however many times it is re-sent. Anything you do not name is copied from the original. To send the same thing again ON PURPOSE, use duplicate_scheduled.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Retry a failed scheduled post
  • review_campaign_creatorDecide on a creator in a campaign: approve or deny one waiting to join (joinApproval manual), suspend (their posts stop counting, a retainer pauses, and they are skipped by payouts…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Decide on a creator in a campaign: approve or deny one waiting to join (joinApproval manual), suspend (their posts stop counting, a retainer pauses, and they are skipped by payouts) or reinstate one, remove one (earnings already approved stay theirs), or grant_retainer: pay a retainer month (period YYYY-MM) that had fewer approved posts than the minimum. read_creator_campaigns with campaignId shows the ids.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Approve, deny, suspend, reinstate or remove a campaign creator
  • review_campaign_postUse this when the user approves, rejects or gives feedback on a creator's submitted post.Can send data outNo findings

    Why it is in this group

    • The name "review_campaign_post" says "post": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • outboundThe name "review_campaign_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Use this when the user approves, rejects or gives feedback on a creator's submitted post. Approve a submitted post (it earns under the campaign's payout model; earnings are held, then payable), reject it with a reason (anything it earned and was not yet paid is cancelled), request_changes (say what to change; atSecond points at a moment in the video; the creator replies when it is done and it comes back for review), or comment. Everything lands in the post's feedback thread on the creator's page, and the creator is emailed (several updates within a few minutes go as one email). Hermoso never rejects on its own. taken_down: confirm a post was removed before the campaign's minLiveDays (without confirm:true it previews); its unpaid earnings are cancelled and a paid part is taken back from the creator's next payouts in the campaign, never from their bank. restore undoes it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Approve, reject or give feedback on a campaign post
  • rotate_webhook_signing_secretCreate (or replace) the signing secret for this brand's generic alert webhook and return it ONCE — it is never readable again, so hand it to the user to store.No findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Create (or replace) the signing secret for this brand's generic alert webhook and return it ONCE — it is never readable again, so hand it to the user to store. Every event carries Standard Webhooks headers: webhook-id, webhook-timestamp and webhook-signature = v1,<base64 HMAC-SHA256 of "id.timestamp.body"> keyed by the base64 part after whsec_. On a rotation the OLD secret keeps signing alongside the new one for 24 hours (two signatures in the header), then stops: a receiver still holding only the old secret rejects events after that, so rotate only when the user means to replace it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
    • title: Rotate the webhook signing secret
  • run_post_refillRun 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…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "run_post_refill" says "run": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Run autopilot now / approve its drafts
  • save_dm_automationCreate (no id) or edit (id) an AUTO-DM / AUTO-REPLY automation: "when someone comments GUIDE on my posts, DM them my guide link", "reply to anyone who DMs PRICE with our pricing pa…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "save_dm_automation" says "save": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "save_dm_automation" says "save" and "dm": it writes something other people read.
    Description, as the server wrote it
    Create (no id) or edit (id) an AUTO-DM / AUTO-REPLY automation: "when someone comments GUIDE on my posts, DM them my guide link", "reply to anyone who DMs PRICE with our pricing page", "reply to people who mention us on X". PAUSE one with {id, enabled:false}; PRACTICE MODE (dryRun:true) logs what it would send and sends nothing. Instagram/Facebook: a keyword comment (one post, the next post, any post; on Facebook also ads) gets a private reply in DMs/Messenger, a DM keyword or ig.me/m.me ref link gets a message, with optional link buttons and rotated public replies. X: a keyword @mention or a reply under your post gets a public reply, a DM keyword gets a DM (X allows an automated DM only after the person DMed you). TikTok, Threads, YouTube and LinkedIn company Pages: a keyword comment on your own posts gets a PUBLIC REPLY under that comment and nothing else; those platforms give an app no way to DM a commenter, so a DM, buttons, a follow gate and publicReplies are refused there, and comments are checked every 10 to 30 minutes instead of pushed. Once per person per post; a DM saying STOP opts that person out. Every channel except X is free; X is billed in credits for every mention, reply or DM X delivers to the account plus each reply or DM sent, and running out stops the X rules. It messages real people, so confirm the text first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create or edit a DM or comment automation
  • save_instagram_dm_automationCreate (no id) or edit (id) an automation that DMs people automatically: a comment with a keyword on one post / the next post / any post gets a private reply, or a DM / story reply…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "save_instagram_dm_automation" says "save": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "save_instagram_dm_automation" says "save" and "dm": it writes something other people read.
    Description, as the server wrote it
    Create (no id) or edit (id) an automation that DMs people automatically: a comment with a keyword on one post / the next post / any post gets a private reply, or a DM / story reply / ig.me link gets an answer. Optional link buttons, public comment replies, follow gate and dry run. Once per person per post; Meta allows private replies within 7 days of the comment. It DMs real people, so confirm the text first. Free, no AI on the send path.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create or edit an Instagram DM automation
  • schedule_postUse this to schedule a social media post for later, on one channel or several.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "schedule_post" says "schedule": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "schedule_post" says "schedule" and "post": it writes something other people read.
    Description, as the server wrote it
    Use this to schedule a social media post for later, on one channel or several. Costs no credits (X alone bills per call: hermoso_credits). FREE PLAN: 5 posts a month on up to 3 channels (a post counts once; UTC month); paid plans are unlimited. Over it the post is refused and nothing is queued: relay the refusal as written, never retry or split the post. A MULTI-SLIDE creative goes in imageUrls[] as a CAROUSEL, in order, never just slide 1. Name the time in `at`, or pass `useQueue:true` for the brand’s next free POSTING SLOT (“just queue it”). Hermoso never guesses the account: Pinterest needs `boardId` (list_pinterest_boards), else refused; a LinkedIn COMPANY PAGE post needs `linkedinOrganizationId` (list_linkedin_pages), else it goes to the person’s own profile. Several Facebook Pages need `pageId` (list_meta_pages), for Facebook and for an Instagram that posts through a Page: none named is refused at scheduling with the Pages listed, so ask the user which. Resolve these FIRST; let the user pick. Posts GO LIVE PUBLICLY by default. Full rules: get_instructions({topic:'schedule_post'}).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Schedule a post for later
  • send_bluesky_dmSend ONE direct message on the connected Bluesky account, either into an existing conversation (convoId) or to a named handle (a conversation is opened for you — the handle is reso…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_bluesky_dm" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_bluesky_dm" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send ONE direct message on the connected Bluesky account, either into an existing conversation (convoId) or to a named handle (a conversation is opened for you — the handle is resolved to a DID first, because Bluesky identifies chat members by DID). A DM allows 1000 characters, NOT the 300 a post allows. Refusals name the real situation rather than a generic failure: the recipient has DMs off, only accepts DMs from people they follow, has blocked this account, is suspended, or does not exist. There is deliberately no broadcast form — a recipient is always named.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send a Bluesky direct message
    • idempotentHint: false
  • send_discord_dmSend ONE member of the brand's Discord server a direct message from the Hermoso bot: text (up to 2000 characters), embeds, images or a video.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_discord_dm" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_discord_dm" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send ONE member of the brand's Discord server a direct message from the Hermoso bot: text (up to 2000 characters), embeds, images or a video. userId is the member id from search_discord_members. DISCORD'S OWN RULES: the person must share a server with the bot AND allow direct messages from that server's members, otherwise Discord refuses and its refusal is passed on as it is; their reply is read with read_discord_channel (member) or list_inbox (discordMember); and Discord blocks bots that open many DMs quickly, so this is for one person who is expecting it, never a broadcast. Only a member of a server this brand added the bot to can be messaged. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a Discord direct message
  • send_klaviyo_campaignSEND or SCHEDULE a Klaviyo campaign draft.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_klaviyo_campaign" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_klaviyo_campaign" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    SEND or SCHEDULE a Klaviyo campaign draft. An email cannot be unsent, so this is gated on how many people it reaches: without confirm:true nothing is sent and you get Klaviyo's own count of recipients with the subject, sender, lists and timing. Show the user that number; only after they say yes call again with confirm:true AND confirmRecipients set to that count (a mismatch, a zero, or a count Klaviyo cannot produce is refused). sendTime (ISO, in the future) schedules instead of sending now; strategy 'local_timezone' sends at that time in each recipient's own timezone. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send or schedule a Klaviyo campaign
  • send_line_broadcastSend ONE LINE message to MANY people.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_line_broadcast" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.recipients): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_line_broadcast" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send ONE LINE message to MANY people. THREE MODES, as LINE defines them: "broadcast" goes to EVERY friend of the account; "multicast" goes to a list of LINE user ids (up to 5,000 a call, sent 500 at a time as LINE requires); "narrowcast" goes to the friends who match a LINE audience or demographic filter, and LINE sends it in the background (it needs the account to reach at least 100 friends, and at least 50 people to match). EVERY PERSON REACHED USES ONE MESSAGE of the account’s monthly LINE quota, and a sent message cannot be recalled. So it never runs on confirm alone. FIRST call it with dryRun:true: free, sends nothing, and reports the number of people it reaches (read from LINE just now) and the quota left. Show the user the message and that number. THEN call with confirm:true and confirmCount set to exactly that number; a different number is refused. If LINE has not finished counting the account’s friends (its figures take about a day) the number is unknown, the tool says so, and it sends only with confirmUnknownAudience:true. A multicast reports how many people LINE accepted the message for; if a request fails part-way the answer says how many were NOT sent to, never success. Duplicates on a list are removed and ids that are not LINE user ids are refused by name (skipInvalid:true sends to the rest, still naming them). READ MODE: pass requestId alone to read how far a narrowcast got. LINE bills the quota to the account; Hermoso charges nothing. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Broadcast a LINE message to many people
  • send_mailchimp_campaignSEND or SCHEDULE a Mailchimp campaign draft.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_mailchimp_campaign" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_mailchimp_campaign" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    SEND or SCHEDULE a Mailchimp campaign draft. An email cannot be unsent, so this is gated on how many people it reaches: without confirm:true nothing is sent and you get Mailchimp's own recipient count with the subject, sender, audience, timing and Mailchimp's send checklist. Show the user that number; only after they say yes call again with confirm:true AND confirmRecipients set to that count (a mismatch, a zero, or a campaign Mailchimp says is not ready is refused). sendTime (ISO, in the future, on :00/:15/:30/:45; Mailchimp schedules only on the quarter-hour) schedules instead of sending now; timewarp:true sends at that time in each recipient's own timezone. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send or schedule a Mailchimp campaign
  • send_messenger_marketing_messageSend a PAID marketing message on Messenger to opted-in subscribers (Meta act_<AD>/messages).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_messenger_marketing_message" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_messenger_marketing_message" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send a PAID marketing message on Messenger to opted-in subscribers (Meta act_<AD>/messages). A campaign created in the last ~hour answers 2300012 then 2300041 (Meta still preparing it) with the seconds left; prefer an existing campaign from list_messenger_marketing_campaigns. One message per subscriber per 12 hours — Meta’s rule, enforced before dispatch and by Meta. message.type: text | button (text + up to 3 web_url buttons) | generic (a card: title, subtitle, image, tap-through url, up to 3 buttons) | media (imageUrl or videoId + buttons). Give subscriptionTokens (≤200 per call, from list_messenger_subscribers) OR customAudienceId of a MESSENGER_SUBSCRIBER_LIST audience of 100+ people for a bulk send. Meta bills the ad account per delivered message. A successful send means ACCEPTED, not delivered: read sent / delivered / read / clicked / failed per tracking id with get_messenger_marketing_message_status (Meta pushes them on the Page webhook; the Page must be subscribed with subscribe_meta_webhooks fields ["marketing_messages"]). dryRun:true previews the wire body and sends nothing. Meta’s frequency caps are silent: a refusal saying the person is capped is Meta protecting them, not a broken send.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send a paid Messenger marketing message
    • idempotentHint: false
  • send_slack_dmSend a direct message to ONE member of a Slack workspace, as the Hermoso app (it arrives in their Apps section, from Hermoso).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_slack_dm" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_slack_dm" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send a direct message to ONE member of a Slack workspace, as the Hermoso app (it arrives in their Apps section, from Hermoso). It reaches a real person at once: show the user the exact text and who it goes to first. `member` is a member id from list_slack_members, or an @name or full name; two people with the same name are listed for you to choose, never guessed between. Up to 4,000 characters; a longer message is refused, not split. Needs the Hermoso app in the Slack workspace with its direct-message permissions: a workspace that added the app before 2026-11-15 adds it again once under Connectors > Slack (the tool says so). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a Slack direct message
  • send_whatsapp_broadcastSend ONE approved WhatsApp template to MANY recipients .Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "send_whatsapp_broadcast" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.recipients): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_whatsapp_broadcast" says "send": it sends or publishes something to other people.

    Findings

    • Info

      The description is 2,042 characters long, over the 2,000 this check looks for.

      Matched text

      description ends: "...PTED IS NOT DELIVERED — never report a broadcast as delivered. 0 Hermoso credits."

      What this check looks for
    Description, as the server wrote it
    Send ONE approved WhatsApp template to MANY recipients . TEMPLATES ONLY: WhatsApp accepts free-form text only inside the 24-hour customer-service window that opens when THAT person messages the business, and Meta refuses each closed one. META HAS NO BULK ENDPOINT, so this is a paced fan-out — one message per recipient, about 10 a second — so it runs as a QUEUED JOB and returns a job id: nothing has been sent when it returns. Poll it by calling this tool again with `jobId` (or use get_job), and read the PER-RECIPIENT outcome; a partial failure is reported as one, never as success. PER-RECIPIENT VARIABLES ARE THE POINT: pass recipients as objects { to, components } so each person gets their own {{1}}, {{2}} values in a single broadcast. Duplicates are removed and unusable numbers are REFUSED BY NAME rather than silently dropped — pass skipInvalid:true to send to the rest, and they are still named in the result. RUN IT WITH dryRun:true FIRST: that costs nothing, sends nothing, and reports the exact recipient count, the template’s real category, what Meta bills for it, and whether the list fits inside the business portfolio’s moving 24-hour messaging limit. Warning: META DOES NOT DELIVER MARKETING MESSAGES TO WHATSAPP USERS IN THE UNITED STATES AT ALL (error 131049, platform-wide since 1 April 2025) — the sends are still ACCEPTED and given message ids, so a US marketing broadcast looks like a success and is not one; the dry run says how many recipients are on +1. META BILLS THE BUSINESS, not Hermoso credits: per message delivered, at Meta’s own per-country rates, marketing always charged and utility/authentication free inside an open service window. WhatsApp policy REQUIRES recipient opt-in; nothing in the API enforces it. Confirm-gated in code: show the user the message, the template and the recipient count, get an explicit yes, then call again with confirm:true AND confirmCount set to the exact number of distinct recipients. ACCEPTED IS NOT DELIVERED — never report a broadcast as delivered. 0 Hermoso credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Broadcast a WhatsApp template to many people
  • send_whatsapp_messageSend a WhatsApp message from one of the brand’s registered numbers to a customer.Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "send_whatsapp_message" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_whatsapp_message" says "send": it sends or publishes something to other people.

    Findings

    • High

      The description contains "never tell the user", an instruction to keep something from the user.

      Matched text

      description: "...box shows it as the message status), so never tell the user it was delivered. THE VARIABLE COUNT IS..."

      What this check looks for
    Description, as the server wrote it
    Send a WhatsApp message from one of the brand’s registered numbers to a customer. TWO KINDS, and which one is legal depends on time: pass `template` (an APPROVED template name) to START a conversation — the only thing WhatsApp accepts outside the 24-hour customer-service window — or `text` for a free-form reply INSIDE that window, which opens only when the customer messages the business first. Inside the window it can also send `interactive` (reply buttons, a list, a link button, a location request or a form) or `media` (image, video, audio, document); exactly one kind per message. To ANSWER someone who wrote in, use read_whatsapp_inbox (or list_inbox + reply_to_inbox_item): it shows the conversation and whether the window is open. A free-form message to someone whose window Hermoso knows has closed is refused for free; when it cannot tell, Meta judges and a closed window comes back as a re-engagement error the reply explains. THIS REACHES A REAL PERSON’S PHONE AND META BILLS THE BUSINESS for the conversation, so it is confirm-gated: show the user the exact message and the recipient, get an explicit yes, then call again with confirm:true. WhatsApp policy REQUIRES the business to hold the recipient’s opt-in first. An unapproved template is refused BEFORE the send, against the status Meta holds. ACCEPTED IS NOT DELIVERED — the reply reports what Meta accepted, and delivery arrives later on a webhook (read_whatsapp_inbox shows it as the message status), so never tell the user it was delivered. THE VARIABLE COUNT IS CHECKED BEFORE ANYTHING IS DISPATCHED: Hermoso reads the template’s own components back from Meta and refuses a payload that supplies the wrong number of values, naming exactly what is missing — for free, before a real phone is involved, instead of Meta answering 132000 after the attempt. It refuses only what it can prove; anything it cannot determine is sent for Meta to judge. 0 Hermoso credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a WhatsApp message
  • send_x_broadcast_chatPost ONE chat message, as the brand, into a RUNNING live broadcast on the connected X account (max 140 characters; a longer one is refused, never cut).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_x_broadcast_chat" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_x_broadcast_chat" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Post ONE chat message, as the brand, into a RUNNING live broadcast on the connected X account (max 140 characters; a longer one is refused, never cut). It is PUBLIC in front of everyone watching: show the user the exact wording, get a yes, then pass confirm:true. replyTo answers one specific message. Needs X connected with the broadcast permissions added 2026-09-21: an X connection made before then must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a message to an X broadcast chat
  • send_x_dmSend ONE direct message from the connected X account, either into an existing conversation (conversationId) or to a named account (participantId — the NUMERIC id, not an @handle; s…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_x_dm" says "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_x_dm" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send ONE direct message from the connected X account, either into an existing conversation (conversationId) or to a named account (participantId — the NUMERIC id, not an @handle; sending to someone with no existing thread starts one). THIS IS A PRIVATE MESSAGE TO A REAL PERSON AND IT CANNOT BE TAKEN BACK: show the user the exact wording and the exact recipient and get an explicit yes BEFORE calling. Never send the same message to several people — send one, to one named recipient. X may refuse a message to someone whose settings do not accept DMs from accounts they do not follow; that refusal comes from X, not from Hermoso. Costs credits per send. Needs X connected with direct-message access — an X account connected before DMs shipped must be reconnected once (Connectors > X).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send an X direct message
  • set_alert_eventsChoose which events one alert channel receives.No findings

    Why it is in this group

    • The name "set_alert_events" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Choose which events one alert channel receives. provider: slack, discord or webhook. events: GROUPS (renders, posts, approvals, watch, credits, leads, connections, adrules, ads, whatsapp; opt-in, never on unless named: inbox, mentions, reviews, email, channel_posts), exact event names (post.failed, account.broken, comment.received) or a family (post.*), or "all". list_alert_settings catalog:true lists every event. An empty list keeps the channel connected and sends it nothing. Unknown names are refused by name. Read back from the stored setting. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Choose which alerts a channel receives
  • set_connector_accountsSet WHICH of a connector's accounts this profile is allowed to post to and spend from — Facebook Pages / Instagram / Meta ad accounts, Google Ads customers, LinkedIn company Pages …Reads text others writeNo findings

    Why it is in this group

    • The name "set_connector_accounts" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Set WHICH of a connector's accounts this profile is allowed to post to and spend from — Facebook Pages / Instagram / Meta ad accounts, Google Ads customers, LinkedIn company Pages (and the personal profile), Pinterest or Microsoft Advertising ad accounts. Pass ids from list_connector_accounts. This REPLACES the current selection: anything you leave out is un-shared, and an EMPTY list shares nothing (publishing then refuses — it fails closed by design, and the server re-verifies every id against the live connection, so an id the account cannot actually reach is rejected rather than saved). Ask the user which accounts they mean; posting as the wrong Page is a public mistake. Providers: tiktok, x, youtube, threads, bluesky, telegram, pinterest, instagram, meta, google_ads, linkedin, pinterest_ads, linkedin_ads, reddit_ads, apple_ads, amazon_ads, microsoft_ads, google_business, google_analytics, snapchat_ads, x_ads, tiktok_ads, google_tag_manager, google_search_console, bing_webmaster. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Choose which accounts a brand may use
  • set_post_approvalTurn approval before publish on or off for this brand.Can send data outNo findings

    Why it is in this group

    • The name "set_post_approval" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • outboundThe name "set_post_approval" says "set" and "post": it writes something other people read.
    Description, as the server wrote it
    Turn approval before publish on or off for this brand. mode "all" (every channel), "channels" (only those listed) or "off"; who "everyone" (default, admins’ posts wait too) or "members" (admins’ own posts skip it). Switching it on also holds posts already queued there unless applyToQueued is false. Switching it off never publishes what is already waiting. Admins only.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Approval before publishing
  • set_post_refillTurn AUTOPILOT POSTING (autoposting, the posting refill) on, change it or pause it.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "set_post_refill" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set up, change or pause autopilot posting
  • set_roleChange a workspace member’s role — admin (full access incl.No findings

    Why it is in this group

    • The name "set_role" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Change a workspace member’s role — admin (full access incl. billing) or member (read-only on billing). A privilege change: confirm the exact person + new role with the user, then call with confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Change a teammate’s role
  • set_shopify_inventoryChange stock on the merchant's Shopify store.Reads text others writeNo findings

    Why it is in this group

    • The name "set_shopify_inventory" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change stock on the merchant's Shopify store. mode set (quantity becomes the new count) or adjust (quantity is added; negative subtracts). changes: [{ variantId or sku, locationId or the location's name, quantity }], up to 100. name: available (default) or on_hand for set; available, damaged, incoming, quality_control, reserved or safety_stock for adjust. reason: correction (default), received, damaged, shrinkage, restock, cycle_count_available, promotion, safety_stock, other and Shopify's other reasons. Without confirm:true NOTHING changes and the reply shows now → after for each: show the user, get a yes, then call again with confirm:true and each change's expected set to the 'now' number, so a sale in between is refused instead of overwritten. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set or adjust Shopify stock
  • set_sms_settingsOptional sending settings for a Twilio or Telnyx connection, all off unless turned on: quietHours (hold texts outside quietStart–quietEnd, default 8 and 20, in the recipient's loca…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "set_sms_settings" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "set_sms_settings" says "set" and "sms": it writes something other people read.
    Description, as the server wrote it
    Optional sending settings for a Twilio or Telnyx connection, all off unless turned on: quietHours (hold texts outside quietStart–quietEnd, default 8 and 20, in the recipient's local time worked out from their number; a reply to someone who wrote in the last 24 hours is not held), optOutList (keep the STOP / START texts people send on the brand's opt-out list and skip those numbers), consentCheck (say in a send's answer when a number has no consent record). On Twilio, messagingServiceSid (MG…) is the Messaging Service used to schedule texts. Called with none of them, it returns the current settings. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: SMS sending settings
  • set_telegram_commandsRead or change the Telegram bot's command menu (the / list every user of the bot sees).Reads text others writeNo findings

    Why it is in this group

    • The name "set_telegram_commands" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read or change the Telegram bot's command menu (the / list every user of the bot sees). action get (default) shows it; set replaces it with commands [{command, description}] (1 to 32 lowercase letters, digits or _; description 1 to 256; at most 100); delete clears it. scope: default, all_private_chats, all_group_chats, all_chat_administrators, or chat / chat_administrators with chatId; languageCode for one language. set and delete are CONFIRM-GATED: the first call shows the menu now and after and changes nothing; call again with confirm:true once the user agrees. Read back from Telegram. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Read or set the Telegram command menu
  • set_tiktok_post_ad_authorizationTurn TikTok's 'Ad authorization' setting ON or OFF for a post the authorized account owns — THIS IS WHERE A SPARK ADS AUTHORIZATION CODE COMES FROM.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "set_tiktok_post_ad_authorization" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "set_tiktok_post_ad_authorization" says "set" and "post": it writes something other people read.
    Description, as the server wrote it
    Turn TikTok's 'Ad authorization' setting ON or OFF for a post the authorized account owns — THIS IS WHERE A SPARK ADS AUTHORIZATION CODE COMES FROM. For somebody ELSE's post the code still comes from that creator, copied out of the TikTok app. IT IS CONFIRM-GATED ON THE WAY ON, and not because it spends: TikTok changes the post's privacy to 'Available for Ads', sends it to their ad review team, says the post 'may also appear as an ad on third party platforms', and treats the call as accepting their Advertising Content Terms on the owner's behalf. Turning it OFF needs no confirm — but TikTok REFUSES to turn it off while an active Spark Ad is using the post, so pause those campaigns first. AuthorizationDays must be one of 7, 30, 60, 180, 365. THE ANSWER IS THE READ-BACK: the reply carries the post's real authorization status and its code, because TikTok's own response body is empty. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Turn Spark-Ads authorization on or off for the brand’s own post
    • idempotentHint: false
  • set_youtube_thumbnailSet the CUSTOM THUMBNAIL on a video already on the connected channel, using a Hermoso image.Reads text others writeNo findings

    Why it is in this group

    • The name "set_youtube_thumbnail" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Set the CUSTOM THUMBNAIL on a video already on the connected channel, using a Hermoso image. The thumbnail is the single biggest lever on YouTube click-through and YouTube otherwise auto-picks a frame, so a published video without one is leaving reach on the table. It changes ONLY the thumbnail — video, title and privacy are untouched — but it is public and immediate, so show the user which image is going on which video and get a yes first. Custom thumbnails require a VERIFIED YouTube channel (a phone number at youtube.com/verify); without it YouTube refuses and the error says so. Works on Shorts too, once YouTube has finished processing the Short. Images up to YouTube’s 50MB cap go as they are; a larger one is compressed automatically. The image must be Hermoso-HOSTED, which is not the same as Hermoso-GENERATED: the user’s own artwork works, put it through upload_file first and pass the URL that returns. An arbitrary external host is refused. 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set the custom thumbnail on a YouTube video
  • set_youtube_watermarkSet (or remove) the BRANDING WATERMARK — the small subscribe badge overlaid on EVERY video on the channel, including ones uploaded later.Reads text others writeNo findings

    Why it is in this group

    • The name "set_youtube_watermark" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Set (or remove) the BRANDING WATERMARK — the small subscribe badge overlaid on EVERY video on the channel, including ones uploaded later. One generated asset brands the whole channel at once, which is why it is worth doing before a batch of uploads rather than after. YouTube wants a SQUARE image, at least 150x150, under 10MB, and it renders SMALL: a full logo lockup with text will not read at that size. By default it shows for the whole video; timingType offsetFromStart/offsetFromEnd with offsetMs and durationMs narrows it. THE DATA API PUBLISHES NO WAY TO READ A WATERMARK BACK — there is only set and unset — so this reports 'accepted', never 'confirmed', and says so rather than claiming a verification it did not get. 0 credits. Needs YouTube connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set or remove the YouTube branding watermark
  • share_onedrive_fileCreate a SHARING LINK to a OneDrive file or folder (fileId from list_onedrive_files): type view (read-only, default), edit, or embed (an <iframe> link, personal OneDrive only); sco…Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a SHARING LINK to a OneDrive file or folder (fileId from list_onedrive_files): type view (read-only, default), edit, or embed (an <iframe> link, personal OneDrive only); scope anonymous (anyone with the link, default), organization (work or school OneDrive only) or users (only people you invite); optional expiresAt (date or ISO) and password (on a personal OneDrive both need a Microsoft 365 subscription; the refusal says so). An ANONYMOUS EDIT link lets anyone holding it change or delete the file, so it needs confirm:true after you show the user that; every other link is created straight away. If Hermoso already made the same kind of link, OneDrive returns that one and the reply says it was reused. Read back from the item's permission list. 0 credits. Needs OneDrive connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Share a OneDrive file as a link
  • tag_intercom_conversationAdd an Intercom tag to a conversation, or remove it (remove:true).Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add an Intercom tag to a conversation, or remove it (remove:true). Name it by tagId or exact tagName (list_intercom_tags); a tagName the workspace does not have yet is created only with create:true (ask the user first). Internal to the inbox: the customer never sees tags. Read back. Free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Tag an Intercom conversation
  • tidy_memoryClean up and consolidate the workspace Memory: drops entries that are about how Hermoso, a tool, a connector or a platform API behaves (product behaviour, not the brand), drops pho…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Clean up and consolidate the workspace Memory: drops entries that are about how Hermoso, a tool, a connector or a platform API behaves (product behaviour, not the brand), drops phone numbers and emails, and merges near-duplicate facts into one sentence each. Call with no argument to get the PROPOSAL (what would be removed and merged, with reasons) — nothing changes. Call again with confirm:true to apply it through the same typed writers the app uses (deletes carry tombstones so they stay deleted on every device). One model call, billed at its token cost.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Tidy the Memory list
  • unpin_discord_messageTake a message off the pinned list of its Discord channel.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "unpin_discord_message" says "unpin": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "unpin_discord_message" says "unpin" and "message": it writes something other people read.
    Description, as the server wrote it
    Take a message off the pinned list of its Discord channel. The message itself stays. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Unpin a Discord message
  • unsubscribe_meta_webhooksRemove this app’s webhook subscription from a Page, so Meta stops pushing its events.Reads text others writeNo findings

    Why it is in this group

    • The name "unsubscribe_meta_webhooks" says "unsubscribe": a word for a change.
    • The description's first verb is "remove": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove this app’s webhook subscription from a Page, so Meta stops pushing its events. It removes the WHOLE subscription — Meta’s DELETE takes no field list — so it is all fields or none; to keep some, call subscribe_meta_webhooks again with just those. Nothing published or posted is affected; only the notifications stop. THE ANSWER IS THE READ-BACK: a subscription still present when read back means the unsubscribe did NOT take effect, and that is reported rather than the 200. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Stop Meta pushing events for a Page
  • update_brandPatch SPECIFIC fields of the active profile (name, domain, sells, summary, category, audience, positioning, voice, style, goal, fonts, palette, logos, brand/product name pronunciat…No findings

    Why it is in this group

    • The name "update_brand" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Patch SPECIFIC fields of the active profile (name, domain, sells, summary, category, audience, positioning, voice, style, goal, fonts, palette, logos, brand/product name pronunciations, profileType: explore = kept but unused) WITHOUT overwriting the rest — a read-modify-write on the saved brand. Use for “change our voice to playful”, “we sell to dentists now”, “our fonts are Benne and Josefin Sans”, “our colours are #3D4C41 and #EEE4DA”. The fonts and palette are what template ads are set in and what every planned ad is told to use, so set them here rather than describing them in style. To onboard a brand from scratch, use draft_brand. If no brand is saved yet and you only INFERRED one from what the user is making, ask them to confirm it is their brand before saving it (they may be working for a client or just trying things). Only pass the fields you’re changing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
    • title: Update profile fields
  • update_business_locationChange the brand’s Google Business Profile listing — hours, phone, website, description, categories, service area, labels, store code, address or the business name.Reads text others writeNo findings

    Why it is in this group

    • The name "update_business_location" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change the brand’s Google Business Profile listing — hours, phone, website, description, categories, service area, labels, store code, address or the business name. THIS EDITS THE PANEL ON GOOGLE SEARCH AND MAPS, immediately and publicly: there is no draft, no preview and no undo. Pass ONLY what changes, in `fields`, keyed by Google’s own field names: websiteUri, phoneNumbers, regularHours, specialHours, moreHours, profile, categories, storefrontAddress, title, labels, storeCode, openInfo, serviceArea, serviceItems, latlng, adWordsLocationExtensions, relationshipData. CALL IT WITHOUT confirm FIRST — nothing is written, Google validates the payload for you, and you get back the CURRENT value of every field you are about to change, so you can show the user the exact before-and-after; then call again with confirm:true once they approve. Changing the business NAME (title) or ADDRESS (storefrontAddress) additionally needs confirmName set to the listing’s CURRENT name, because Google can suspend a listing over either. Output-only fields (metadata) and immutable ones (languageCode) are refused by name rather than dropped. serviceItems is the WHOLE list and replaces what is there: each item is {structuredServiceItem:{serviceTypeId}} from the listing’s categories (get_business_location shows them) or {freeFormServiceItem:{category:<a listing category id>, label:{displayName, languageCode like "pt"}}}, plus an optional price {currencyCode, units}. Use dryRun:true to validate a payload with Google and write nothing. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update a Google Business Profile listing
  • update_discord_eventChange a Discord event: name, description, startsAt, endsAt, location, channel, kind or imageUrl.Reads text others writeNo findings

    Why it is in this group

    • The name "update_discord_event" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Discord event: name, description, startsAt, endsAt, location, channel, kind or imageUrl. status moves it: active (start it now), completed (end a running event) or canceled (call off an upcoming one, kept in the server's history). Ending or canceling is PERMANENT, so call WITHOUT confirm first to get a sentence with how many people are interested. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit, start, end or cancel a Discord event
  • update_discord_roleChange a Discord role's name, color, hoist, mentionable or permissions.Reads text others writeNo findings

    Why it is in this group

    • The name "update_discord_role" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Discord role's name, color, hoist, mentionable or permissions. role is its id or exact name. Changing PERMISSIONS changes what every member holding the role may do, so when anyone holds it call WITHOUT confirm first: nothing changes and you get a sentence with how many members it affects. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Discord role
  • update_docEDIT a Google Doc — the correction append_to_doc cannot make.Reads text others writeNo findings

    Why it is in this group

    • The name "update_doc" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EDIT a Google Doc — the correction append_to_doc cannot make. Two shapes: `replacements:[{find, replace}]` rewrites specific text wherever it appears (call read_doc first and match the text EXACTLY; matchCase:false ignores case), or `rewrite:"…"` replaces the ENTIRE body (rewrite:"" empties it), or `dropdowns:[{title, value}]` sets a dropdown chip (e.g. Status -> Approved — read_doc lists every chip with its options; pass dropdownId when two share a title; an unknown title or option is refused with the real list and nothing changes); the same entry with options:[…] (the COMPLETE new list, 2–50) and/or newTitle changes the dropdown itself for every chip built from it, and an option you drop that a chip shows needs replace:{"Old":"New"}. Find/replace runs immediately and REPORTS how many occurrences changed — zero matches is reported as a FAILURE to match, never as a quiet success, because a text edit that silently does nothing is worse than one that visibly fails. A whole-body rewrite is destructive: call it without confirm first to get the character count, then confirm:true + confirmCells. Both are index-free by design — an agent cannot reliably compute Google’s character offsets, and a wrong offset deletes the wrong sentence.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Google Doc in place
  • update_drive_fileUpdate a Drive file: rename (name), move it into a folder (moveToFolderId, optionally removeFromFolderId to move OUT of the old one), or trash / untrash it (trash:true|false).Reads text others writeNo findings

    Why it is in this group

    • The name "update_drive_file" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Update a Drive file: rename (name), move it into a folder (moveToFolderId, optionally removeFromFolderId to move OUT of the old one), or trash / untrash it (trash:true|false). Pass fileId (from list_drive_files). To delete permanently, use delete_drive_file.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Rename / move / trash a Drive file
  • update_google_business_postEdit a Post already live on the brand’s Google Business Profile listing, in place, instead of deleting and re-posting it: its text (summary), its button (actionType + link), an EVE…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "update_google_business_post" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "update_google_business_post" says "update" and "post": it writes something other people read.
    Description, as the server wrote it
    Edit a Post already live on the brand’s Google Business Profile listing, in place, instead of deleting and re-posting it: its text (summary), its button (actionType + link), an EVENT or OFFER’s title and dates, an OFFER’s coupon, redeem link or terms, or its photo (imageUrl). Only the fields you pass change. The edit is PUBLIC and immediate, so show the user the new wording and get their go-ahead first. A Post’s type cannot change (that is a new Post) and Google takes no video. The reply is built from the Post Google returns, and names any field Google did not keep. Pass the full post name from list_google_business_posts. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Google Business Profile Post
  • update_klaviyo_campaignEdit a Klaviyo campaign that is still a DRAFT: name, subject, previewText, fromEmail, fromLabel, replyTo, templateId, or its audience (listIds / segmentIds / excludeIds).Reads text others writeNo findings

    Why it is in this group

    • The name "update_klaviyo_campaign" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit a Klaviyo campaign that is still a DRAFT: name, subject, previewText, fromEmail, fromLabel, replyTo, templateId, or its audience (listIds / segmentIds / excludeIds). A scheduled one must be reverted first (cancel_klaviyo_campaign). Read back. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Update a Klaviyo campaign draft
  • update_klaviyo_templateChange a Klaviyo template: a new name, html (the unsubscribe footer is added if it has none) or plain text.Reads text others writeNo findings

    Why it is in this group

    • The name "update_klaviyo_template" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Klaviyo template: a new name, html (the unsubscribe footer is added if it has none) or plain text. Read back. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Update a Klaviyo template
  • update_linkedin_eventEdit a LinkedIn event the Page organizes: name, description, start / end time, the join or info url, the in-person address or venue details, or discoveryMode (LISTED / URL_ONLY).Reads text others writeNo findings

    Why it is in this group

    • The name "update_linkedin_event" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit a LinkedIn event the Page organizes: name, description, start / end time, the join or info url, the in-person address or venue details, or discoveryMode (LISTED / URL_ONLY). LinkedIn’s own rules, quoted back when it refuses: an event can be edited only BEFORE it starts (never once cancelled), and online vs in-person never changes. Read back from LinkedIn. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a LinkedIn event
  • update_meta_catalogChange a product catalog’s settings — most often its NAME.Reads text others writeNo findings

    Why it is in this group

    • The name "update_meta_catalog" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a product catalog’s settings — most often its NAME. Also accepts the default and fallback product image URLs (what Meta shows when a product row has no usable image), the dynamic-ad display settings, and the destination / flight / store / partner-integration settings for travel and local-inventory catalogs. A catalog’s VERTICAL and its owning business portfolio are permanent and cannot be changed here — Meta publishes no way to change either. THE 200 IS NOT THE ANSWER: Meta replies {"success":true} and never returns the catalog, and it says exactly the same thing for a field it quietly ignored — so the summary is built from a fresh READ-BACK, and if a value does not read back as sent you are told it was NOT confirmed. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Rename or reconfigure a Meta product catalog
  • update_notion_rowChange properties on ONE row of a Notion database (pageId from query_notion_database) — e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "update_notion_row" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change properties on ONE row of a Notion database (pageId from query_notion_database) — e.g. mark a calendar row Status "Posted" and put the live post link in its URL column. properties is {"Column": value} by column name: text, number, checkbox, select (an existing option or a new one), status (must be an existing option), multi-select (array; replaces the whole value), date (ISO, or {start, end}), url, email, phone; null clears. Validated against the database's own columns before anything is sent and refused by name otherwise, never coerced; columns you do not name keep their values. Read back from Notion. trash:true moves the row to Notion's trash (restorable; returns a preview first and needs confirm:true), trash:false restores it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update a Notion database row
  • update_onedrive_fileUpdate a OneDrive item: rename (name) and/or move it into a folder (moveToFolderId).Reads text others writeNo findings

    Why it is in this group

    • The name "update_onedrive_file" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Update a OneDrive item: rename (name) and/or move it into a folder (moveToFolderId). Pass fileId (from list_onedrive_files). To remove an item, use delete_onedrive_file.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Rename / move a OneDrive file
  • update_pinterest_boardRename a board, rewrite its description, or change its privacy.Reads text others writeNo findings

    Why it is in this group

    • The name "update_pinterest_board" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename a board, rewrite its description, or change its privacy. Warning: SETTING A BOARD TO SECRET HIDES EVERY PIN ON IT from everyone but this account — nothing errors and nothing is deleted, the Pins simply stop being public, which is the Pinterest flavour of a post that looks published and is not. Say so and get a yes before doing it; it IS reversible (set PUBLIC again), and the read-back reports how many Pins were hidden. Pinterest accepts only PUBLIC or SECRET on an update: PROTECTED can be chosen when a board is created and can never be set afterwards, so that is refused by name rather than sent and rejected. 0 credits. Needs Pinterest connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Rename or re-privacy a Pinterest board
  • update_pinterest_catalog_itemsAdd, change or remove PRODUCTS in a Pinterest catalog directly — no feed file needed.Reads text others writeNo findings

    Why it is in this group

    • The name "update_pinterest_catalog_items" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add, change or remove PRODUCTS in a Pinterest catalog directly — no feed file needed. items: up to 1,000 of {itemId (your SKU), operation UPSERT (default) / CREATE / UPDATE / DELETE, attributes {title, description, link, image_link, price e.g. "19.99 USD", availability e.g. "in stock", brand, sale_price, …}}. A create or upsert must carry title, link, image_link and price (refused here otherwise). Pinterest processes the batch asynchronously; the batch is read back and its status and every per-item error reported. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add, change or remove Pinterest catalog products
  • update_pinterest_pinEdit a published Pin — its title, description, destination link, alt text, or which board it sits on.Reads text others writeNo findings

    Why it is in this group

    • The name "update_pinterest_pin" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit a published Pin — its title, description, destination link, alt text, or which board it sits on. Only send the fields that should change. TWO LIMITS TO STATE BEFORE OFFERING THIS. (1) Pinterest marks its Update Pin endpoint "currently in beta and not available to all apps" in its own API description, so it may be refused outright whatever the account’s scopes or access tier — reconnecting cannot change that. If it is refused, save_pinterest_pin gets the Pin onto another board (generally available) and changing the wording means deleting and re-pinning. (2) A published Pin’s IMAGE or VIDEO can never be changed by anyone: Pinterest’s update model has no media field at all, so swapping the creative means delete and re-pin, which loses the Pin’s accumulated saves. The values reported back are what Pinterest STORED, not what was sent. 0 credits. Needs Pinterest connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a published Pin
  • update_saved_creatorSet the OUTREACH STATUS and/or a NOTE on a creator already saved in the swipefile.No findings

    Why it is in this group

    • The name "update_saved_creator" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Set the OUTREACH STATUS and/or a NOTE on a creator already saved in the swipefile. Status is one of new | contacted | replied | booked | passed. The note is free text (deal terms, rate, what was sent). Reads back the updated row. Use list_swipefile to find the key. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Update a saved creator (outreach status, note)
  • update_settingsChange this account's app settings.No findings

    Why it is in this group

    • The name "update_settings" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Change this account's app settings. language = the language EVERY ad, script and plan is written in from now on (chat replies follow the language the user writes in) (say the language in plain English, e.g. "German", "Japanese", "Brazilian Portuguese") — it applies to renders made over MCP as well as in the app. theme = the app's appearance, "dark" or "light". watchEmail = the weekly competitor-watch email on/off. emails = turn Hermoso emails on or off by group, including turning back on what an unsubscribe link turned off. Only pass what you are changing. Account-wide (every profile), and it takes effect on the next call.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Change app settings
  • update_sheetCORRECT cells in a Google Sheet — write values to an exact range, overwriting whatever is there.Reads text others writeNo findings

    Why it is in this group

    • The name "update_sheet" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    CORRECT cells in a Google Sheet — write values to an exact range, overwriting whatever is there. This is the fix append_to_sheet cannot make: appending only ever adds rows at the bottom, so without this a wrong number stays wrong forever and the only "correction" is a second row contradicting the first. Pass `range` (e.g. "B2:C5", or "Q3 Report!B2" to name a tab — list_sheet_tabs gives the names) and `values` as an array of row arrays; an anchor cell like "B2" is fine and the block is written down and right from it. Writing into EMPTY cells goes straight through. Writing OVER cells that already hold values is REFUSED first, naming exactly how many filled cells would be overwritten — show the user that, get a yes, then call again with confirm:true. The result is READ BACK from the sheet, so what you report is what the sheet now holds rather than what Google accepted.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Write to a range in a Google Sheet
  • update_shopify_articleChange a Shopify blog article that already exists: title, body, excerpt, tags, author, slug (redirect:true keeps the old address working), featured image, search title and descript…Reads text others writeNo findings

    Why it is in this group

    • The name "update_shopify_article" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Shopify blog article that already exists: title, body, excerpt, tags, author, slug (redirect:true keeps the old address working), featured image, search title and description, which blog it is in, or its status (publish a draft, unpublish to draft, or schedule with a future date). Only the fields passed change; the reply is Shopify's own copy of the article. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Shopify blog article
  • update_shopify_orderChange an order on the merchant's Shopify store: its note, tags (tags replaces the list; addTags / removeTags change it), PO number and additional details (customAttributes), and t…Reads text others writeNo findings

    Why it is in this group

    • The name "update_shopify_order" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an order on the merchant's Shopify store: its note, tags (tags replaces the list; addTags / removeTags change it), PO number and additional details (customAttributes), and the buyer's email or shipping address (the whole address is replaced, so send every line; parcels already shipped keep the old one, and Shopify may recalculate taxes). Note, tags, PO number and details apply at once and are read back. An email or address change is a preview until confirm:true: show the user the before and after, get a yes, then call again with confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update a Shopify order
  • update_webflow_itemChange a Webflow blog item that already exists: title, body, summary, slug, cover image, search title and description, any field through fieldData, or its status (publish a draft, …Reads text others writeNo findings

    Why it is in this group

    • The name "update_webflow_item" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Webflow blog item that already exists: title, body, summary, slug, cover image, search title and description, any field through fieldData, or its status (publish a draft, or unpublish to draft). Only the fields passed change. An edit to an item that is already live is published too. The reply is Webflow's own copy. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Webflow blog item
  • update_wix_postChange a Wix blog post that already exists: title, body, excerpt, slug, tags, categories, cover image, search title and description, or its status (publish a draft, unpublish to dr…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "update_wix_post" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "update_wix_post" says "update" and "post": it writes something other people read.
    Description, as the server wrote it
    Change a Wix blog post that already exists: title, body, excerpt, slug, tags, categories, cover image, search title and description, or its status (publish a draft, unpublish to draft, or schedule with a future date). Only the fields passed change. An edit to a post that is already live is published too. The reply is Wix's own copy. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Wix blog post
  • update_wordpress_postChange 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, tag…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "update_wordpress_post" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "update_wordpress_post" says "update" and "post": it writes something other people read.
    Description, as the server wrote it
    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 image. Only the fields passed change; the reply is WordPress's own copy of the post. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a WordPress post
  • update_x_chat_settingsChange the connected X account's X Chat privacy settings: the account-wide answer to 'open our DMs to everyone' or 'turn off read receipts'.Reads text others writeNo findings

    Why it is in this group

    • The name "update_x_chat_settings" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change the connected X account's X Chat privacy settings: the account-wide answer to 'open our DMs to everyone' or 'turn off read receipts'. Pass only what changes. allowDmsFrom: 'all' (anyone), 'verified' (verified accounts only) or 'following' (accounts the brand follows); narrowing it stops customers the brand does not follow from messaging it, so say that before changing it. Call settings are merged onto the stored ones (X does not promise a partial call setting keeps the rest). Returns the settings X stored, not what was sent. Reversible. Needs X connected with direct-message access: an X connection made before 2026-08-25 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change the X Chat privacy settings
  • update_youtube_channelAPPLY THE BRAND TO THE CHANNEL ITSELF — banner art, description, keywords, country and the trailer non-subscribers see.Reads text others writeNo findings

    Why it is in this group

    • The name "update_youtube_channel" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    APPLY THE BRAND TO THE CHANNEL ITSELF — banner art, description, keywords, country and the trailer non-subscribers see. Every other YouTube tool brands the videos; this brands the page they sit on. Under the hood channels.update is a PUT, so the CURRENT settings are read and merged first — otherwise setting a description would silently wipe the channel's keywords, country and trailer. AND YOUTUBE SILENTLY IGNORES SOME FIELDS, channel title above all (usually only changeable in YouTube Studio): the result DIFFS what YouTube actually stored against what was asked for and reports anything that did not stick in `notApplied`. DO NOT REPORT THOSE AS CHANGED — a 200 is what YouTube accepted, not what it stored. A banner must be a Hermoso render (jpeg or png, under 6MB); YouTube re-crops it per device, so the safe area is the middle 1235x338 of a 2048x1152 image. Public and immediate — show the user what is going on the channel first. 0 credits. Needs YouTube connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Apply the brand to the YouTube channel itself
  • update_youtube_videoEdit an existing video on the connected channel: title, description, tags, privacy (unlisted | public | private), category, schedule (publishAt; "" clears it), madeForKids, aiGener…Reads text others writeNo findings

    Why it is in this group

    • The name "update_youtube_video" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit an existing video on the connected channel: title, description, tags, privacy (unlisted | public | private), category, schedule (publishAt; "" clears it), madeForKids, aiGenerated, licence, embedding, stats visibility, languages + per-language translations, paid-placement disclosure and brand partner. THIS IS HOW YOU FLIP AN UNLISTED UPLOAD PUBLIC. Making a video PUBLIC puts it on the channel where anyone can find it, so show the user exactly what will change and get an explicit yes before calling with privacy:"public". Fields you omit are left untouched; every change is read back from YouTube and any field it did not apply is named. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update a YouTube video’s details
Can't be undone 13Claude Code: ask
  • batch_voice_agent_callsHave a voice agent call a list of people through the platform's own batch: recipients (numbers, or {to, name, variables}, up to 1,000), from, name, scheduledAt (ISO), maxConcurrenc…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "batch_voice_agent_calls" says "call": a word for a change.
    • The input addresses people (input.recipients): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.recipients): what the tool writes goes there.
    Description, as the server wrote it
    Have a voice agent call a list of people through the platform's own batch: recipients (numbers, or {to, name, variables}, up to 1,000), from, name, scheduledAt (ISO), maxConcurrency (Vapi). Vapi runs it as a campaign, Retell and ElevenLabs as a batch call, Telnyx as one scheduled call each. No credits; the platform bills the calls. In the US the FCC requires prior express written consent for marketing calls made with an AI voice; getting it is the caller’s responsibility. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Batch AI voice calls
  • bulk_invite_creatorsInvite up to 100 creators at once (name, optional email, handle or profile link).Can send data outNo findings

    Why it is in this group

    • The name "bulk_invite_creators" says "invite": a word for sending, and what is sent cannot be taken back.

    What it can reach

    • outboundThe name "bulk_invite_creators" says "invite": it sends or publishes something to other people.
    Description, as the server wrote it
    Invite up to 100 creators at once (name, optional email, handle or profile link). Each gets a personal link and a ready message, returned here; duplicates are skipped by name. Hermoso emails none of them: send the links yourself, or one by one with send_email from the brand's own connected mailbox. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Invite many creators to a campaign
  • check_verification_codeCheck the code a person typed against the one send_verification_code texted them.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The input addresses people (input.to): what it sends cannot be taken back.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.
    Description, as the server wrote it
    Check the code a person typed against the one send_verification_code texted them. Answers accepted true or false; an expired or used code is reported as such. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Check a one-time code
  • place_callCall someone from one of the brand's numbers.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "place_call" says "call": a word for a change.
    • The input addresses people (input.to): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.
    Description, as the server wrote it
    Call someone from one of the brand's numbers. With bridgeTo (the user's own phone; default: the number's forwarding phone), that phone rings first and, once answered, to is dialled from the brand's number, so the caller ID is the business. With agent (a voice agent's SIP address, or a wss:// stream on Twilio), the agent places the call to the person instead. record:true records it. On the brand's own account the provider bills the call; on Hermoso phone 0.7 credit a minute per leg (US and Canada). Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Place a phone call
  • place_voice_agent_callHave a voice agent call someone: agentId, to (E.164), from (a number on the platform, or for Retell one of the brand's numbers forwarded to it; default the agent's own number), var…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "place_voice_agent_call" says "call": a word for a change.
    • The input addresses people (input.to): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.
    Description, as the server wrote it
    Have a voice agent call someone: agentId, to (E.164), from (a number on the platform, or for Retell one of the brand's numbers forwarded to it; default the agent's own number), variables (values the agent's prompt uses, e.g. {name:'Ana'}), scheduledAt (Vapi). The platform places the call and bills it; no credits. In the US the FCC requires prior express written consent for marketing calls made with an AI voice; getting it is the caller’s responsibility. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Place an AI voice call
  • redeliver_webhookResend ONE past alert delivery by its delivery id (deliveries in list_alert_settings): the same event and, for the webhook, the same webhook-id and body bytes, signed again with a …Reads text others writeCan send data outNo findings

    Why it is in this group

    • The description's first verb is "resend": a word for sending, and what is sent cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "resend": it sends or publishes something to other people.
    Description, as the server wrote it
    Resend ONE past alert delivery by its delivery id (deliveries in list_alert_settings): the same event and, for the webhook, the same webhook-id and body bytes, signed again with a fresh timestamp, carrying the next attempt number (hermoso-attempt header). It reaches the channel even if that event was since switched off. Deliveries can be resent for 7 days. Reports what the channel answered. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Resend one alert delivery
  • send_klaviyo_test_emailSend ONE TEST EMAIL of a Klaviyo template to up to 5 addresses the user names (never to a list), so they can see it in a real inbox.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_klaviyo_test_email" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.recipients): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_klaviyo_test_email" says "send": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.recipients): what the tool writes goes there.
    Description, as the server wrote it
    Send ONE TEST EMAIL of a Klaviyo template to up to 5 addresses the user names (never to a list), so they can see it in a real inbox. Without confirm:true nothing is sent and you get the preview; call again with confirm:true after they say yes. Klaviyo allows 100 test sends a day. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a Klaviyo test email
  • send_line_messageSend a message from the brand’s LINE Official Account to ONE person: text (up to 5,000 characters), a picture (JPEG or PNG, up to 10 MB) or a video (MP4, up to 200 MB).Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "send_line_message" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.to): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_line_message" says "send": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.

    Findings

    • High

      The description contains "never tell the user", an instruction to keep something from the user.

      Matched text

      description: "...d the account without delivering it, so never tell the user it was delivered. LINE has no API for L..."

      What this check looks for
    Description, as the server wrote it
    Send a message from the brand’s LINE Official Account to ONE person: text (up to 5,000 characters), a picture (JPEG or PNG, up to 10 MB) or a video (MP4, up to 200 MB). Anything over a limit is REFUSED with the limit, never cut or converted. TWO KINDS, decided by time: inside a minute of the person’s own message it goes as a REPLY, which is free; otherwise it is a PUSH message, which uses one message of the account’s monthly LINE quota (line_quota reads the quota and what is used). LINE bills that quota to the account on its own plan; Hermoso charges nothing. The answer says which of the two it was. To ANSWER someone who wrote in, read_line_inbox (or list_inbox + reply_to_inbox_item) shows the conversation first. THIS REACHES A REAL PERSON, so it is confirm-gated: show the user the exact message and who it goes to, get an explicit yes, then call again with confirm:true. LINE does not report delivery, and it accepts a message to someone who blocked the account without delivering it, so never tell the user it was delivered. LINE has no API for LINE VOOM, so this is messages only: never offer to post to LINE. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a LINE message
  • send_mailchimp_test_emailSend ONE TEST of a Mailchimp campaign draft to up to 5 addresses the user names (never to the audience), so they can see it in a real inbox.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_mailchimp_test_email" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.recipients): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_mailchimp_test_email" says "send": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.recipients): what the tool writes goes there.
    Description, as the server wrote it
    Send ONE TEST of a Mailchimp campaign draft to up to 5 addresses the user names (never to the audience), so they can see it in a real inbox. Without confirm:true nothing is sent and you get the preview; call again with confirm:true after they say yes. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a Mailchimp test email
  • send_smsSend a text from one of the brand's own Twilio or Telnyx numbers: to (one number or a list of up to 100, E.164), text (up to 1,600 characters), media (up to 10 pictures for an MMS:…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_sms" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.to): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_sms" says "send": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.
    Description, as the server wrote it
    Send a text from one of the brand's own Twilio or Telnyx numbers: to (one number or a list of up to 100, E.164), text (up to 1,600 characters), media (up to 10 pictures for an MMS: a Library id, attachment://N or an https link), from (needed when the account has several numbers), sendAt (ISO time, to schedule it; on Twilio this needs a Messaging Service set with set_sms_settings). The answer has each message's id, segment count and status; delivery status follows (get_sms_status). Any optional sending settings the connection turned on (quiet hours, opt-out list) apply. On the brand's own account no credits (the provider bills it); on Hermoso phone 0.8 credit a segment, 2.5 an MMS. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Send an SMS or MMS
  • send_test_alertSend a test alert to one alert channel (provider: slack, discord or webhook) or to every connected one, and report what each answered (delivered, or the HTTP status and the channel…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_test_alert" says "send": a word for sending, and what is sent cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_test_alert" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send a test alert to one alert channel (provider: slack, discord or webhook) or to every connected one, and report what each answered (delivered, or the HTTP status and the channel's own words). A test that gets through also clears a NOT DELIVERING or stopped state. The webhook test is signed like every event. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Send a test alert
    • idempotentHint: false
  • send_verification_codeText a one-time verification code to a phone number: the code is generated and sent by the carrier, never shown to you; check_verification_code confirms what the person types.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_verification_code" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.to): what it sends cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_verification_code" says "send": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.
    Description, as the server wrote it
    Text a one-time verification code to a phone number: the code is generated and sent by the carrier, never shown to you; check_verification_code confirms what the person types. Valid for timeoutSecs (default 600). On Hermoso phone it costs 4 credits per code; on the brand's own Telnyx account Telnyx bills it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Send a one-time code
  • shopify_sales_reportSales on the merchant's Shopify store over a period (default the last 30 days; Shopify lets apps read the last 60): orders and sales after returns, cancelled and test orders counte…Reads text others writeCan send data out1 finding

    Why it is in this group

    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.to): what the tool writes goes there.

    Findings

    • Warn

      The server marks "shopify_sales_report" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The input addresses people (input.to): what it sends cannot be taken back.

      What this check looks for
    Description, as the server wrote it
    Sales on the merchant's Shopify store over a period (default the last 30 days; Shopify lets apps read the last 60): orders and sales after returns, cancelled and test orders counted apart, then broken down by DISCOUNT CODE, by UTM source, medium and campaign and by Shopify's own traffic source, using Shopify's last visit before each order. It also shows the part that came from HERMOSO: orders that used a discount code Hermoso created on the store or arrived through a campaign Hermoso recorded in Shopify > Marketing; add codes or campaigns to credit others you know are yours. Recent orders Shopify has not attributed yet are counted and named. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Shopify sales report
Changes things 171Claude Code: ask
  • activate_phone_serviceTurn on Hermoso phone for this brand: its own carrier sub-account on Hermoso's account, so it can buy numbers, text, call, run AI voice agents and send one-time codes with no Twili…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Turn on Hermoso phone for this brand: its own carrier sub-account on Hermoso's account, so it can buy numbers, text, call, run AI voice agents and send one-time codes with no Twilio or Telnyx sign-up: numbers are a monthly subscription on the card on file, texts and minutes are credits. Paid accounts only. Without confirm:true nothing is turned on and the answer lists the prices and the new-account limits; call again with confirm:true once the user agrees. Turning it on costs nothing. A brand that connects its own Telnyx account keeps that instead.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn on Hermoso phone
  • add_campaign_postSubmit a post link on a creator's behalf (e.g.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "add_campaign_post" says "add": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "add_campaign_post" says "add" and "post": it writes something other people read.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Submit a post link on a creator's behalf (e.g. one they emailed you). Same checks as their own submission: the campaign's platforms, a post published after the campaign started, from one of the creator's listed accounts, not already submitted. Reads its numbers once (costs credits).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Submit a post for a campaign creator
  • append_to_docAppend text to the end of a Google Doc Hermoso can reach — one it created (pass the documentId from create_doc) or one the user handed over with the Google file picker in the app (…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Append text to the end of a Google Doc Hermoso can reach — one it created (pass the documentId from create_doc) or one the user handed over with the Google file picker in the app (find its id with list_drive_files). Optional `dropdown:{title, options:[2-50], selected}` appends a Google Docs dropdown chip after the text — e.g. text "Status: " + dropdown {title:"Status", options:["Draft","In review","Approved"]} gives a brief a status the team can click to change; the chip is confirmed by reading the doc back. Set it later with update_doc dropdowns.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Append text to a Google Doc
  • append_to_notion_pageAdd to the END of an existing Notion page (pageId or its link, from list_notion_pages): markdown content, a swipefileCollection, or includeSchedule:true.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "add": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add to the END of an existing Notion page (pageId or its link, from list_notion_pages): markdown content, a swipefileCollection, or includeSchedule:true. Nothing already on the page changes. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Add to a Notion page
  • append_to_sheetAppend rows to a Google Sheet Hermoso can reach — one it created (pass the spreadsheetId from create_sheet) or one the user handed over with the Google file picker in the app (find…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Append rows to a Google Sheet Hermoso can reach — one it created (pass the spreadsheetId from create_sheet) or one the user handed over with the Google file picker in the app (find its id with list_drive_files). rows = array of row arrays.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Append rows to a Google Sheet
  • assign_number_to_campaignPut one of the brand's numbers under an approved 10DLC campaign: on Twilio by adding it to the campaign's Messaging Service (messagingServiceSid), on Telnyx by campaignId.Reads text others writeNo findings

    Why it is in this group

    • The name "assign_number_to_campaign" says "assign": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Put one of the brand's numbers under an approved 10DLC campaign: on Twilio by adding it to the campaign's Messaging Service (messagingServiceSid), on Telnyx by campaignId. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Add a number to a 10DLC campaign
  • attach_voice_agent_numberHave a voice agent answer (and place) the calls of a number.Reads text others write2 findings

    Why it is in this group

    • The name "attach_voice_agent_number" says "attach": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...lio number with the Twilio connection's credentials; a Telnyx number needs credentialId on..."

      What this check looks for
    • Info

      The input schema at properties.credentialId.description mentions "credential".

      Matched text

      inputSchema.properties.credentialId.description: "Vapi: a Telnyx credential made in the Vapi dashboard"

      What this check looks for
    Description, as the server wrote it
    Have a voice agent answer (and place) the calls of a number. number is one of the brand's Twilio or Telnyx numbers (from list_phone_numbers) or a number already on the platform. mode import: the platform takes the number itself (Vapi and ElevenLabs import a Twilio number with the Twilio connection's credentials; a Telnyx number needs credentialId on Vapi; Retell imports over a SIP trunk given terminationUri, sipUsername, sipPassword). mode forward: the number stays on Hermoso's call handling and each call is handed to the agent's SIP address (incoming calls only). Telnyx AI Assistants answer a Telnyx number on the same account. The default is the one the platform supports for that number. If the number's calls go elsewhere, the answer names it and replaceExisting:true takes them over. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Put an agent on a phone number
  • backfill_postsImport this brand's PAST posts from a channel into the performance record, so 'which hook works' can draw on history rather than only on what was published since Hermoso started re…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "backfill_posts" says "post": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "backfill_posts" says "post": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Import this brand's PAST posts from a channel into the performance record, so 'which hook works' can draw on history rather than only on what was published since Hermoso started recording. Supports facebook, instagram, threads, youtube, tiktok, pinterest and bluesky; the others say plainly why they cannot (LinkedIn has no enumerate-my-posts endpoint on our grant, X bills per read so it is excluded from bulk import, Google Business has had no per-post insights since 2023, and Telegram's Bot API cannot read a chat's past messages at all — nothing published before Hermoso is recoverable through a bot token). BOUNDED, RESUMABLE AND QUOTED: it runs as a DRY RUN by default and tells you how many posts it found and what reading them will cost — pass confirm:true to import, and pass the returned cursor to continue. AN IMPORTED POST IS WEAKER EVIDENCE THAN A RECORDED ONE and is labelled 'backfilled': its hook is recovered ONLY where the post matches a Hermoso creation by asset or caption. A post made outside Hermoso stays UNATTRIBUTED — it counts toward channel and format totals but never votes on which hook works. Never guess a hook from a caption. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Import a channel’s past posts
  • bluesky_accountACCOUNT-LEVEL numbers for a Bluesky account — FOLLOWERS, following and total posts — plus display name, bio, avatar and when it was created.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ACCOUNT-LEVEL numbers for a Bluesky account — FOLLOWERS, following and total posts — plus display name, bio, avatar and when it was created. With no argument it reads the CONNECTED account, which is the answer to “how many followers do we have on Bluesky”; pass `actor` (a handle or DID) to read any other account, which is free and is how you size a competitor there. The reply says which one it read: `self` is true only for the connected account, compared on the DID because a Bluesky handle can change. A counter Bluesky does not return comes back under `absent` with the reason and is NEVER reported as zero — all three are optional in the lexicon. Read-only, 0 credits, no extra permission. Needs Bluesky connected (Connectors > Bluesky, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Bluesky account
    • idempotentHint: true
  • bluesky_post_metricsRead live engagement for up to 25 of the connected account’s Bluesky posts — likes, reposts, replies, quotes and bookmarks.Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "bluesky_post_metrics" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "bluesky_post_metrics" says "post": it sends or publishes something to other people.
    • outboundThe input takes a URL (input.uris): a request to a URL can carry data to whoever runs it.

    Findings

    • Warn

      The server marks "bluesky_post_metrics" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "bluesky_post_metrics" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Read live engagement for up to 25 of the connected account’s Bluesky posts — likes, reposts, replies, quotes and bookmarks. Address a post by its AT-URI (the `at://…` value post_to_bluesky returns), not its web URL. Bluesky publishes NO impression or view count in any AT Protocol lexicon, so these are COUNTS with no denominator and no engagement rate can be computed from them — do not present one. A uri Bluesky returns nothing for is reported as MISSING (deleted, or not on the connected account), never as zero engagement. Read-only, 0 credits. Needs Bluesky connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read likes, reposts, replies and quotes on your Bluesky posts
    • idempotentHint: true
  • bookmark_x_postSave ONE post to the brand’s X bookmarks (private to the account), or remove it with undo:true.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "bookmark_x_post" says "post": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "bookmark_x_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Save ONE post to the brand’s X bookmarks (private to the account), or remove it with undo:true. One post per call. Needs the bookmark.write permission: an X connection made before 2026-11-15 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per API call).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Bookmark a post on X
  • business_google_updatedWhat GOOGLE thinks a Business Profile should say — the pending edits it has inferred from the web, from user submissions and from its own sources, with `changedFields` naming exact…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What GOOGLE thinks a Business Profile should say — the pending edits it has inferred from the web, from user submissions and from its own sources, with `changedFields` naming exactly which fields it would change. THESE CAN GO LIVE IF NOBODY LOOKS, which is why a business needs to see them. An empty result is a real and good answer (Google is proposing nothing) and is reported as such, never as a failure. Read-only — accepting or rejecting an edit is a write this tool does not do. 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Edits Google is proposing to a listing
    • idempotentHint: true
  • buy_creditsOut of credits?Reads text others write1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description mentions "CREDENTIAL".

      Matched text

      description: "...U ARE AN AGENT HOLDING YOUR OWN PAYMENT CREDENTIAL, there is a third path that needs no hu..."

      What this check looks for
    Description, as the server wrote it
    Out of credits? Top up with a credit PACK. Call with no argument to list the available packs (id · credits · price). If the account has a saved card and you have billing-admin rights, calling with `pack` quotes the exact charge and calling again with confirm:true AND the quote's quote_token charges the saved card instantly (same one-click top-up as the app — no redirect). If there's no saved card yet, you get a Stripe checkout URL to hand your human for the FIRST purchase; their card saves for one-click after that. Packs only; subscriptions are managed by a person in Billing. IF YOU ARE AN AGENT HOLDING YOUR OWN PAYMENT CREDENTIAL, there is a third path that needs no human at all: `POST /api/billing/machine-payment` with a `packId` answers HTTP 402 carrying an MPP challenge, and grants the pack once you authorise and retry with the credential — the same packs, the same prices, the same credits. `GET /api/billing/config` carries a `machinePayments` block listing the packs with their per-credit rates and saying whether that lane is enabled on this server. Most agents do NOT have their own credential yet, so the checkout link above remains the normal path. To stop running out entirely, turn on auto-reload with set_auto_reload (admin) — low balances then top themselves up from the saved card automatically.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Buy credits
  • buy_phone_numberBuy a phone number on Hermoso phone ($3 a month on the brand's phone subscription, prorated) or on the brand's own Twilio or Telnyx account (the provider bills it monthly).Reads text others writeCan send data outNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.phoneNumber): what the tool writes goes there.
    Description, as the server wrote it
    Buy a phone number on Hermoso phone ($3 a month on the brand's phone subscription, prorated) or on the brand's own Twilio or Telnyx account (the provider bills it monthly). phoneNumber comes from search_phone_numbers. connectInbox (default true) points its texts at the Hermoso Inbox and its calls at Hermoso's call handling. Without confirm:true nothing is bought and the answer says what would happen; call again with confirm:true once the user agrees. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Buy a phone number
  • call_tracking_reportCalls per ad campaign from the numbers configure_phone_number tagged with tracking: calls, answered, missed, minutes, distinct callers and, when a callValue was set, their value (c…Reads text others write1 finding

    Why it is in this group

    • The name "call_tracking_report" says "call": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "call_tracking_report" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "call_tracking_report" says "call": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Calls per ad campaign from the numbers configure_phone_number tagged with tracking: calls, answered, missed, minutes, distinct callers and, when a callValue was set, their value (callValue × answered calls), over the last `days` (default 30) or since a date. Each row carries the platform and campaign id it was tagged with, to join with that platform's ad report. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Call tracking report
  • campaign_draftsDrafts creators uploaded for approval before posting (a campaign with requireDraftApproval).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Drafts creators uploaded for approval before posting (a campaign with requireDraftApproval). No action: lists them with file links and comments. With draftId + action: approve, request_changes (comment required; atSecond points at a moment in the video), reject (reason) or comment. The creator sees comments on their link.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Review creator drafts before they post
  • check_discord_permissionsWhat the Hermoso bot is allowed to do in the brand's Discord server, feature by feature (polls, text-to-speech, pins, threads, roles, events), and exactly which permission each blo…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What the Hermoso bot is allowed to do in the brand's Discord server, feature by feature (polls, text-to-speech, pins, threads, roles, events), and exactly which permission each blocked one is missing. Use it when a Discord tool answers that a permission is missing: a server that added the bot before 15 November 2026 has the older, smaller set and needs the bot added again (connect_connector with provider discord and no fields returns the link), or the missing permission ticked on the Hermoso role. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check what the Hermoso bot may do in Discord
  • check_number_portabilityCheck whether phone numbers the business already has with another carrier can be moved (ported) to Hermoso phone or its own Telnyx account: portable or not, why not, and whether Fa…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Check whether phone numbers the business already has with another carrier can be moved (ported) to Hermoso phone or its own Telnyx account: portable or not, why not, and whether FastPort applies. Nothing is filed. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check numbers can be ported
  • collect_post_metricsFetch fresh performance numbers for this brand's recorded posts and store them as a time-series.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "collect_post_metrics" says "post": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "collect_post_metrics" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Fetch fresh performance numbers for this brand's recorded posts and store them as a time-series. Metrics ACCRUE, so a post is read at ~24 hours and again at ~7 days; this collects whichever readings are due and skips the ones already taken. A channel that cannot report a metric records it as ABSENT with the reason — never as zero — and a read that fails is recorded as 'could not tell', which contributes to nothing. X IS SKIPPED BY DEFAULT because X bills us per API call: pass includeMetered:true to include it, and tell the user it costs credits BEFORE you do. The skip is always reported so a channel missing from the numbers is never mistaken for one that performed badly. Free except for X.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read how the recorded posts performed
  • connect_shopify_storeConnect the user's Shopify store to this brand.Reads text others writeNo findings

    Why it is in this group

    • The name "connect_shopify_store" says "store": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Connect the user's Shopify store to this brand. Returns ONE Shopify admin link for the user to open while signed in to Shopify: Shopify asks which store, installs the Hermoso app on it if it is not there yet (they approve its permissions), and they press Connect store. The link works for 30 minutes and connects nothing until they press it. Once connected, the Shopify tools work for that store: products, orders and the sales report, buyers who agreed to marketing email into the brand's email leads, orders to the brand's Meta pixel as conversions, blog posts, discount codes, product media and Shopify Marketing records. Work for the store is paid from this Hermoso account; nothing is charged through Shopify. One store per brand: connecting another replaces it. List_shopify_stores says what is connected. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Connect a Shopify store
  • contact_supportMessage Hermoso's human support team for the user: billing, account or sign-in problems, a connector that will not connect, or a question the tools cannot answer.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Message Hermoso's human support team for the user: billing, account or sign-in problems, a connector that will not connect, or a question the tools cannot answer. Use the user's words. The team replies by email to the account's address (the result names it). Defects you found: report_bug. Missing capabilities: request_feature. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Contact Hermoso support
  • convert_onedrive_fileTurn a file already in the user’s OneDrive into a PDF or a JPG — Microsoft does the conversion on its own servers, so nothing is re-encoded here and nothing is lost in a screenshot…Reads text others writeNo findings

    Why it is in this group

    • The name "convert_onedrive_file" says "convert": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Turn a file already in the user’s OneDrive into a PDF or a JPG — Microsoft does the conversion on its own servers, so nothing is re-encoded here and nothing is lost in a screenshot. It reads about 130 source formats, which is the point: PowerPoint and Word decks, Excel, Photoshop PSD, Illustrator AI, Sketch, 3D (fbx/glb/obj), video (mp4/mov/webm), HEIC from an iPhone, and the raw camera formats (CR2, NEF, ARW, DNG) that nothing else in this product can open. Use it to turn a client’s deck into images you can actually put in an ad, to get a usable JPG out of a designer’s PSD or a photographer’s raw file, or to hand someone a PDF of a spreadsheet. CONVERTING TO JPG REQUIRES BOTH width AND height — Microsoft refuses the call without them. The result is stored at a durable Hermoso URL you can pass straight to a render or a post; Microsoft’s own conversion link expires within minutes, so do not hand that one to anyone. Needs OneDrive connected — no new permission.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Convert a OneDrive file to PDF or JPG
  • create_brandAdd a NEW profile (a brand, client, creator or personal workspace) and switch to it.No findings

    Why it is in this group

    • The name "create_brand" says "create": a word for a change.
    Description, as the server wrote it
    Add a NEW profile (a brand, client, creator or personal workspace) and switch to it. Each has its OWN brand details, memory, swipefile, Library, avatars, skills, playbooks and connectors; nothing leaks between them. Use draft_brand to FILL it and update_brand to edit it. Re-running with the same name returns the existing profile instead of a duplicate. Creating it is free. Drafting a NEW brand into it (draft_brand) needs the credits for its research on the balance, about 100; with fewer, draft_brand refuses before anything runs or is charged and says how many it needs and how many the account has.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Create a profile
  • create_creator_campaignUse this when the user asks to start a creator, UGC or clipping campaign that pays creators for posts about their brand.No findings

    Why it is in this group

    • The name "create_creator_campaign" says "create": a word for a change.
    Description, as the server wrote it
    Use this when the user asks to start a creator, UGC or clipping campaign that pays creators for posts about their brand. Start a creator (UGC / clipping) campaign where the brand pays creators for posts about it, with Hermoso as the platform: pick platforms (TikTok, Instagram, YouTube, Facebook, X, Threads) and a payout model: cpm (per 1,000 verified views, with a budget), flat (per approved post) or pool (a fixed amount split by views at close). Creators join by link with no Hermoso account, list the accounts they post from, and submit post links; Hermoso reads each post's platform-reported views (each read costs the brand credits), scores how real they look, and you approve or reject. Approved earnings are held (default 10 days), then payable. Brand the sign-up page with page, questions and slug. Created as a DRAFT: set it live with update_creator_campaign status "active", then share the page or creator_campaign_link.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Create a creator campaign
  • create_discord_eventCreate a scheduled event in the brand's Discord server; members see it in the Events panel and can mark themselves interested.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_discord_event" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Create a scheduled event in the brand's Discord server; members see it in the Events panel and can mark themselves interested. kind external (an outside place or link: needs location AND endsAt), voice or stage (held in that kind of channel: needs channel). Optional description and a cover image. A stage event also needs Manage Channels, Mute Members and Move Members for the Hermoso role in that stage channel, which the bot does not ask for by default. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Discord event
  • create_discord_roleCreate a role in the brand's Discord server: name, color, whether it shows separately in the member list (hoist), whether it can be @mentioned, and optionally its permissions by na…Reads text others writeNo findings

    Why it is in this group

    • The name "create_discord_role" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a role in the brand's Discord server: name, color, whether it shows separately in the member list (hoist), whether it can be @mentioned, and optionally its permissions by name. Unset permissions start as the server's @everyone permissions. Nobody holds a new role until assign_discord_role gives it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Discord role
  • create_discord_threadStart a thread in a Discord text or announcement channel: on its own, or under an existing message (messageId).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_discord_thread" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Start a thread in a Discord text or announcement channel: on its own, or under an existing message (messageId). kind is public (anyone who sees the channel), private (text channels only: invited people and moderators) or announcement (the public thread of an announcement channel); unset is public. autoArchiveMinutes is 60, 1440, 4320 or 10080. Returns the threadId, which post_to_discord takes to post inside it. A forum channel starts a thread with a post instead (post_to_discord with threadName). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Start a Discord thread
  • create_docCreate a new Google Doc in the user’s Drive with a title + optional body text — e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "create_doc" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a new Google Doc in the user’s Drive with a title + optional body text — e.g. export ad copy, a creative brief, or a report. Returns the document id + URL. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Doc
  • create_drive_folderCreate a folder in the user’s Google Drive (optionally nested under parentId) to organize saved files.Reads text others writeNo findings

    Why it is in this group

    • The name "create_drive_folder" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a folder in the user’s Google Drive (optionally nested under parentId) to organize saved files. Returns the folder id + webViewLink. Use that ID as update_drive_file’s moveToFolderId or as parentId for a nested folder. NOTE: save_to_drive’s `folder` is a NAME, not this id — it find-or-creates a folder by that name, so pass the folder NAME there (or omit and just save, then move with update_drive_file).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Drive folder
  • create_klaviyo_campaignCreate a Klaviyo email CAMPAIGN DRAFT: templateId (create_klaviyo_template), subject, previewText, the audience as listIds and/or segmentIds (excludeIds leaves people out), optiona…Reads text others writeNo findings

    Why it is in this group

    • The name "create_klaviyo_campaign" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a Klaviyo email CAMPAIGN DRAFT: templateId (create_klaviyo_template), subject, previewText, the audience as listIds and/or segmentIds (excludeIds leaves people out), optional name, fromEmail / fromLabel (default: the account's default sender) and replyTo. It is created as a DRAFT and NOTHING IS SENT; the answer is Klaviyo's own row read back. To send or schedule it use send_klaviyo_campaign, which shows the recipient count first. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Klaviyo campaign draft
  • create_klaviyo_templateMake an EMAIL TEMPLATE in Klaviyo from a creative: image (any reference upload_klaviyo_image takes; it goes into the image library first) plus copy YOU write in the brand's voice (…Reads text others writeNo findings

    Why it is in this group

    • The name "create_klaviyo_template" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Make an EMAIL TEMPLATE in Klaviyo from a creative: image (any reference upload_klaviyo_image takes; it goes into the image library first) plus copy YOU write in the brand's voice (read get_brand for voice and colours): headline, body (paragraphs split by a blank line), ctaText + ctaUrl for the button, accent (#RRGGBB button colour). It is laid out as a 600px email with the unsubscribe link and sender address Klaviyo requires. Or pass html for the user's own markup (that footer is added if it has no unsubscribe link). Saves the template only, nothing is sent; returns the templateId for create_klaviyo_campaign. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Klaviyo email template
  • create_linkedin_eventCreate an event on a LinkedIn company Page the brand administers: an EXTERNAL online event (a webinar on Zoom, YouTube or your own site — pass url), an IN-PERSON event (pass addres…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_linkedin_event" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Create an event on a LinkedIn company Page the brand administers: an EXTERNAL online event (a webinar on Zoom, YouTube or your own site — pass url), an IN-PERSON event (pass address), or a LinkedIn Live event (format:"live" — that one needs LinkedIn Live access on the member, and without it LinkedIn refuses with “The member does not have LINKEDIN_LIVE creation access”, measured 2026-08-31). Optionally attach a LinkedIn REGISTRATION FORM (registrationForm:true + privacyPolicyUrl, or your own approved leadFormId); sign-ups arrive as EVENT leads in list_linkedin_leads(leadType:"EVENT"). Read back from LinkedIn. Warning: ANNOUNCING IS A SEPARATE, PUBLIC STEP (announce:true does it in this call): LinkedIn requires a SEPARATE post to make an event publicly visible, so creating one puts nothing in anyone’s feed and the brand decides when to tell people. That separation is LinkedIn’s own and it is why an agent cannot accidentally broadcast to a company’s followers. Edit it with update_linkedin_event until it starts. A custom background image is not offered yet. Needs the Events permission (administrator flag) and a reconnect, the same two conditions as list_linkedin_events. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a LinkedIn event
    • idempotentHint: false
  • create_mailchimp_campaignCreate a Mailchimp email CAMPAIGN DRAFT: templateId (create_mailchimp_template), subject, previewText, audienceId and optionally segmentId (part of the audience), optional name, fr…Reads text others writeNo findings

    Why it is in this group

    • The name "create_mailchimp_campaign" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a Mailchimp email CAMPAIGN DRAFT: templateId (create_mailchimp_template), subject, previewText, audienceId and optionally segmentId (part of the audience), optional name, fromName and replyTo (default: the audience's own defaults). It is created as a DRAFT and NOTHING IS SENT; the answer is Mailchimp's own row read back with its send checklist. To send or schedule it use send_mailchimp_campaign, which shows the recipient count first. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Mailchimp campaign draft
  • create_mailchimp_templateMake an EMAIL TEMPLATE in Mailchimp from a creative: image (any reference upload_mailchimp_image takes; it goes into the File Manager first) plus copy YOU write in the brand's voic…Reads text others writeNo findings

    Why it is in this group

    • The name "create_mailchimp_template" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Make an EMAIL TEMPLATE in Mailchimp from a creative: image (any reference upload_mailchimp_image takes; it goes into the File Manager first) plus copy YOU write in the brand's voice (read get_brand for voice and colours): headline, body (paragraphs split by a blank line), ctaText + ctaUrl for the button, accent (#RRGGBB button colour). It is laid out as a 600px email with the unsubscribe link and mailing address Mailchimp requires. Or pass html for the user's own markup (that footer is added if it has no *|UNSUB|*). Saves the template only, nothing is sent; returns the templateId for create_mailchimp_campaign. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Mailchimp email template
  • create_meta_catalogCreate a NEW product catalog on one of the merchant’s Meta business portfolios.Reads text others writeNo findings

    Why it is in this group

    • The name "create_meta_catalog" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a NEW product catalog on one of the merchant’s Meta business portfolios. A catalog is the input to Advantage+ catalog ads (dynamic product ads) — build it first, then fill it from the merchant’s feed or Shopify, then point a campaign at it. Name the owning portfolio EITHER by its numeric businessId OR by businessName, exactly as list_meta_catalogs prints it (“DMDB Group”) — a name that matches no portfolio, or more than one, is refused BY NAME with the portfolios that really exist and their ids, never guessed, and it never falls back to “the only portfolio”. Vertical defaults to commerce and CANNOT be changed afterwards, nor can the owning portfolio, so both are worth getting right the first time. IMPORTANT — META DOES NOT REFUSE A DUPLICATE NAME: it silently creates a SECOND catalog with the same name and nothing to tell the two apart, so Hermoso refuses a name the portfolio already uses and tells you the existing id (if a previous create seemed to fail, that id is very likely the catalog it actually made). Pass allowDuplicateName:true if you genuinely want a twin. The confirmation is READ BACK from Meta — its create returns only an id, so the name, vertical and portfolio in the summary were fetched, not echoed. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Meta product catalog
  • create_onedrive_folderCreate a folder in the user’s OneDrive (optionally nested under parentId) to organize saved files.Reads text others writeNo findings

    Why it is in this group

    • The name "create_onedrive_folder" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a folder in the user’s OneDrive (optionally nested under parentId) to organize saved files. Returns the folder id + webViewLink. Use that id as update_onedrive_file’s moveToFolderId or as parentId for a nested folder. NOTE: save_to_onedrive’s `folder` is a NAME (find-or-created), not this id.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a OneDrive folder
  • create_pinterest_boardCreate a board on the connected Pinterest account.Reads text others writeNo findings

    Why it is in this group

    • The name "create_pinterest_board" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a board on the connected Pinterest account. Needed because a Pin cannot exist without a board, and a NEW Pinterest business account has none — if list_pinterest_boards comes back empty, make one here rather than telling the user you can't pin. Boards are PUBLIC unless you pass privacy 'SECRET'; a Pin on a secret board is invisible to everyone, so only choose that if the user asked for it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Pinterest board
  • create_pinterest_catalogCreate a Pinterest product CATALOG (RETAIL for products, or HOTEL) — the container feeds and items fill.Reads text others writeNo findings

    Why it is in this group

    • The name "create_pinterest_catalog" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a Pinterest product CATALOG (RETAIL for products, or HOTEL) — the container feeds and items fill. Read back from Pinterest. Most merchants can skip it: a feed created without catalogId lands in a default retail catalog. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Pinterest catalog
  • create_port_orderMove numbers from the business's current carrier to Hermoso phone (or its own Telnyx account).Reads text others writeNo findings

    Why it is in this group

    • The name "create_port_order" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Move numbers from the business's current carrier to Hermoso phone (or its own Telnyx account). Needs the details on the current carrier account (entityName, authPersonName, billingPhoneNumber, accountNumber, pin if it has one, and the service address) plus two PDF links: loaUrl (the signed Letter of Authorization) and invoiceUrl (a recent bill). Without confirm:true nothing is filed and the answer says what will happen; call again with confirm:true once the user agrees. Porting in is free; on Hermoso phone each number then joins the phone subscription at $3 a month once it arrives. get_port_order follows it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Port numbers in
  • create_sheetCreate a new Google Spreadsheet in the user’s Drive and optionally fill it with rows — e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "create_sheet" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a new Google Spreadsheet in the user’s Drive and optionally fill it with rows — e.g. export a swipefile, ad list, or performance report. Pass rows as an array of row arrays (first row = headers). Returns the spreadsheet id + URL. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Sheet
  • create_sms_registration_bundlesBuild the two Twilio Trust Hub bundles a US 10DLC brand is filed from, from the business details: a customer profile (legalName, businessType, industry, registrationIdType + regist…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_sms_registration_bundles" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "create_sms_registration_bundles" says "create" and "sms": it writes something other people read.
    • outboundThe input takes a destination (input.representative.phone): what the tool writes goes there.
    Description, as the server wrote it
    Build the two Twilio Trust Hub bundles a US 10DLC brand is filed from, from the business details: a customer profile (legalName, businessType, industry, registrationIdType + registrationNumber such as the EIN, website, address, representative) attached to the account's Primary Customer Profile, and an A2P messaging profile (companyType; stockExchange, stockTicker, brandContactEmail for a public company). Each is checked against Twilio's live policy and submitted for Twilio's review; one Twilio finds incomplete is removed and its reasons returned. The Primary Customer Profile itself is made only in the Twilio Console; the answer says so when it is missing. Without confirm:true it only checks and reports the plan. Twilio charges nothing for bundles; register_sms_brand files the brand with the two ids. Free in credits. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Build Twilio's 10DLC registration bundles
  • create_voice_agentCreate an AI voice agent on the brand's own Vapi, Retell AI, ElevenLabs or Telnyx account.Reads text others writeNo findings

    Why it is in this group

    • The name "create_voice_agent" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an AI voice agent on the brand's own Vapi, Retell AI, ElevenLabs or Telnyx account. Pass prompt (and any other field) to create exactly that, free; leave prompt out and Hermoso writes the agent from the brand profile first (purpose, direction), which costs credits. Hermoso sets the agent to report finished calls to the brand's call inbox. The platform bills the calls. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a voice agent
  • create_wordpress_termCreate a category or tag on the WordPress site.Reads text others writeNo findings

    Why it is in this group

    • The name "create_wordpress_term" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a category or tag on the WordPress site. (post_to_wordpress also creates any category or tag NAME it is given that the site lacks.) Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a WordPress category or tag
  • creator_campaign_reportUse this when the user asks how a creator campaign is performing or for its report.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Use this when the user asks how a creator campaign is performing or for its report. One campaign's report: spend against budget, posts, approved views, cost per 1,000 views, each creator's posts, views, earnings and payout status, top posts and the authenticity spread. format "csv" returns it as CSV (rows "creators" or "posts", money in US dollars) plus a download link. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Creator campaign report (CSV too)
  • creator_campaign_salesSales credited to campaign creators for commission.Reads text others writeNo findings

    Why it is in this group

    • The input takes a statement or command to run (input.code), which can change anything it can reach.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Sales credited to campaign creators for commission. action read (default): each sale (store, order, amount, refunds, commission or why it is not counted, how it was credited) and each creator's code and tracking link. Shopify orders and Stripe charges are read from the brand's connected store twice a day: a sale is the creator's when it used their code, or their link was on the last visit before it within the campaign's windowDays; commission is payable lockDays after the sale, and a refund lowers it (one already paid is taken back from the creator's next payouts, never their bank). action sync reads the store now. action record (participantId, amountUsd, ref, at) adds a sale from a store Hermoso does not read, e.g. WooCommerce; action adjust (key, amountUsd) lowers a recorded one after a refund. action set_code (participantId, code) sets a creator's code to match one made in the store. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Sales credited to campaign creators
  • creator_directoryEvery creator across the brand's campaigns: their campaigns, posts, approval rate, views, earnings, note and ban.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Every creator across the brand's campaigns: their campaigns, posts, approval rate, views, earnings, note and ban. action list (default; q searches); note (key + note); ban (key, optional reason: they cannot join, be invited to or submit to any of the brand's campaigns; earnings already made stay payable); unban (key). key comes from list.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: The brand's creators across all campaigns
  • diagnose_postsWHAT TO FIX NEXT, post by post, and the tool that fixes it: post_performance says which hook is AHEAD; this says what is WRONG with a post.Can send data out1 finding

    Why it is in this group

    • The name "diagnose_posts" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • outboundThe name "diagnose_posts" says "post": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.

    Findings

    • Warn

      The server marks "diagnose_posts" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "diagnose_posts" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    WHAT TO FIX NEXT, post by post, and the tool that fixes it: post_performance says which hook is AHEAD; this says what is WRONG with a post. Under-distributed is A HOOK PROBLEM. Seen but not held is A RETENTION PROBLEM. Seen, held and still not converting is AN OFFER PROBLEM. FOUR REFUSALS, to repeat rather than paper over: (1) a post younger than ~24h is TOO EARLY, never a failure; (2) a metric the platform does not publish is UNMEASURED, never zero (Facebook has published no post reach since 2026-06-15, Reddit publishes no impressions, Google Business nothing per post); (3) below 5 measured posts on a channel there is no brand baseline, and the ONLY fallback is a published short-video hook floor that is NOT our measured number and does not transfer off TikTok/Instagram/YouTube: attribute it as the output does; (4) 'nothing here needs fixing' is a real answer, not a failure to look. Hermoso cannot see conversions for an organic post (no channel reports them against a post id), so the offer rung runs ONLY when the user says they are not converting and you pass converting:false. Print `summary` verbatim. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: What to fix next, post by post
    • idempotentHint: true
  • draft_voice_agentHermoso's AI writes a phone voice agent from the brand profile (business facts, products, tone, FAQs): its instructions, first line, end-of-call and voicemail lines, what a success…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Hermoso's AI writes a phone voice agent from the brand profile (business facts, products, tone, FAQs): its instructions, first line, end-of-call and voicemail lines, what a successful call is, and the facts to pull from each call. purpose is the job (e.g. 'answer calls and book a demo'), direction inbound or outbound. Nothing is created; create_voice_agent takes the result. Costs credits. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Write a voice agent from the brand
  • email_campaign_creatorEmail ONE campaign creator from Hermoso's address, only when the user asks: kind "invite" (the invite with their personal link) or "link" (a fresh personal link; the old one stops …Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Email ONE campaign creator from Hermoso's address, only when the user asks: kind "invite" (the invite with their personal link) or "link" (a fresh personal link; the old one stops working). Needs their email (pass email to add one). At most 3 a day to one creator; one who unsubscribed is refused.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Email a campaign creator their invite or a fresh link
  • embed_threadsEmbed code (HTML) for a Threads PROFILE, showing the name, picture, bio, follower count and a Follow button, or for a post, to put on a website.Reads text others writeCan send data outNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Embed code (HTML) for a Threads PROFILE, showing the name, picture, bio, follower count and a Follow button, or for a post, to put on a website. url is https://www.threads.com/@name/ (or just @name) or a post link; theme light (default), dark or auto; maxWidth 320-658. Private, age-restricted or embed-disabled accounts cannot be embedded. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Embed a Threads profile or post
  • enable_toolsLIST a group of tools that is not in this session's roster.1 finding

    Why it is in this group

    • The name "enable_tools" says "enable": a word for a change.

    Findings

    • Warn

      The description contains "Every other tool", wording about other tools or servers.

      Matched text

      description: "...few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone —..."

      What this check looks for
    Description, as the server wrote it
    LIST a group of tools that is not in this session's roster. IT IS NOT HOW YOU REACH A TOOL — call_tool runs any Hermoso tool whether or not it is listed, and that works everywhere. Use this when the session will use MANY tools from one area and you want them in your list. WORKS ON CLIENTS THAT RE-READ THE TOOL LIST (stdio, the CLI, Cursor, Claude Code); a host that fixed its roster at connect time — claude.ai and ChatGPT do — will not show the new tools until it reconnects, and this tool says so in its reply rather than reporting a success you cannot use. The connect-time route that always works is `?tools=all` on the server URL. The default roster is CORE-FIRST: the core tools plus a few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone — the whole registry is several hundred thousand tokens of schema re-sent on every turn, and a roster far past the 30-50 tool mark measurably degrades tool choice. The heaviest groups are `ads`, `analytics`, `channel_admin`: paid-campaign management across every ad platform is most of the total schema weight. NOTHING held out is unfinished or unsafe, and nothing is unreachable — find_tools finds it and call_tool runs it. CALL THIS WHEN A WHOLE AREA IS IN PLAY. If the user settles into building, budgeting, targeting or reporting on ad campaigns, call enable_tools({groups:['ads']}) and the tools appear. If they ask about their own site or product analytics, a tag/tracking container, or how a search engine crawls, indexes or ranks their site, call enable_tools({groups:['analytics']}). Groups: core, research, create, channels, channel_admin, analytics, ads, files, workspace — or 'all'. Free, instant, and it never turns anything off.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Turn on more Hermoso tools
  • error_detailOne error group in full by fingerprint (from list_errors): every field, plus the most recent redacted occurrences — status, connector, job id, workspace, and a shape-only echo of t…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    One error group in full by fingerprint (from list_errors): every field, plus the most recent redacted occurrences — status, connector, job id, workspace, and a shape-only echo of the inputs. This is what makes a bug reproducible. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Error detail
    • idempotentHint: true
  • estimate_messenger_marketing_deliveryMeta’s own estimate of how many marketing messages a budget would deliver from a Page and what it would cost, before anything is created.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Meta’s own estimate of how many marketing messages a budget would deliver from a Page and what it would cost, before anything is created. Free. Meta marks the metric “in development”, so treat it as a range.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Estimate Messenger marketing-message delivery and cost
    • idempotentHint: true
  • export_schedule_to_notionExport the posting schedule to a Notion database, one row per post: date, channels, caption, media link and status.Reads text others writeNo findings

    Why it is in this group

    • The name "export_schedule_to_notion" says "schedule": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Export the posting schedule to a Notion database, one row per post: date, channels, caption, media link and status. Creates a new database (under parentPageId, or private in the workspace) or writes into an existing one (databaseId), matching its columns by name. historyDays adds posts already published. Up to 100 rows per run; the answer says if more were left. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Export the schedule to Notion
  • export_swipefile_deckTurn a SWIPEFILE COLLECTION into a real Google Slides deck — one slide per saved ad, carrying the creative, the brand, the ad copy, the run dates with the run length, and the platf…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Turn a SWIPEFILE COLLECTION into a real Google Slides deck — one slide per saved ad, carrying the creative, the brand, the ad copy, the run dates with the run length, and the platform. This is the thing a marketer actually presents to a client or a team. Returns the presentation id + URL. Creates a NEW deck every time: under the drive.file scope Hermoso can only touch files it created, so it cannot add slides to a deck the user already has. A creative whose ad-library link has expired cannot be embedded — Meta signs those URLs with a short expiry — so that slide says so in words and keeps its copy and run dates, and the reply reports how many. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets, Docs and Slides).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Swipefile to Google Slides
  • extend_tiktok_post_ad_authorizationExtend how long a post the authorized account owns stays promotable as a Spark Ad — and REGENERATE its code if it was deleted.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "extend_tiktok_post_ad_authorization" says "post": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "extend_tiktok_post_ad_authorization" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Extend how long a post the authorized account owns stays promotable as a Spark Ad — and REGENERATE its code if it was deleted. THE DAYS ARE ADDED, NOT SET: TikTok's own example is that a post with 180 days remaining, extended by 180, ends up at 360 — so passing '365' to a post that already has time left does not mean 'expires in a year'. Must be one of 7, 30, 60, 180, 365. Ad authorization has to be ON already (set_tiktok_post_ad_authorization) or TikTok refuses. The reply reads the new window back, because TikTok's own response body is empty. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Extend a post’s Spark-Ads authorization
    • idempotentHint: false
  • google_business_insightsHow the brand’s Google Business Profile listing actually performed — impressions on Google Search and Maps (desktop and mobile), calls, website clicks, direction requests, messages…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    How the brand’s Google Business Profile listing actually performed — impressions on Google Search and Maps (desktop and mobile), calls, website clicks, direction requests, messages and bookings — over the last N days. For a local business this is the real-world demand signal, and it is the number an ad campaign should be judged against. NOTE: Google discontinued PER-POST insights in February 2023 and published no replacement, so these are listing-level figures and per-post performance genuinely does not exist in any API — do not promise it. Read-only, 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Google Business Profile performance
    • idempotentHint: true
  • hermoso_capabilitiesProbe 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 durati…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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, and the canEdit/canAvatar flags. Call it when you need a specific model id, a credit cost, or a capability you are not sure of. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Hermoso models, options and credit costs
    • idempotentHint: true
  • hermoso_other_capabilitiesUse this when the user asks for something this connection's tools do not cover, or asks which Hermoso app or connection does what.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Use this when the user asks for something this connection's tools do not cover, or asks which Hermoso app or connection does what. Returns each area of Hermoso (posting, paid ads, ad creation, research, analytics and the rest) with the Hermoso app or connection that covers it and its link, so you can tell the user where to do it. Read-only: it runs nothing and changes nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Where each Hermoso feature is
  • import_from_cloudPull the files in a Google Drive or OneDrive FOLDER into this profile's Library, so they can be used like anything rendered here — published, scheduled, cloned, used as a product p…Reads text others writeNo findings

    Why it is in this group

    • The name "import_from_cloud" says "import": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Pull the files in a Google Drive or OneDrive FOLDER into this profile's Library, so they can be used like anything rendered here — published, scheduled, cloned, used as a product photo or a reference. Hermoso downloads each file with the user's own connected account (a Drive/OneDrive file is not public) and stores a durable Hermoso url for each. Give `folderId` from list_drive_files / list_onedrive_files with onlyFolders — omit it for the root. GOOGLE DRIVE ONLY SHOWS WHAT THE USER HANDED OVER: our Drive scope is `drive.file`, so Hermoso can see the files and folders it created plus the ones the user picked with the Google picker in the app, and NEVER their whole Drive. Picking a FOLDER hands over the folder alone, not the files in it, so if a folder comes back empty the reply carries a link that opens the picker inside it, where the user selects every file at once (Cmd+A / Ctrl+A); give them that link. SUBFOLDERS ARE NOT WALKED and Google-native docs (Docs/Sheets/Slides) have no file to download: both are reported back BY NAME rather than silently dropped, along with anything too large or unreadable, so you can tell the user exactly what did and did not come across.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Import a Drive / OneDrive folder into the Library
  • import_shopify_buyers_to_email_leadsAdd the merchant's past Shopify buyers to this brand's email lead list so an email sequence can win them back: name, email, number of orders, total spent and last order date (usabl…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "import_shopify_buyers_to_email_leads" says "import": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "import_shopify_buyers_to_email_leads" says "import" and "email": it writes something other people read.
    Description, as the server wrote it
    Add the merchant's past Shopify buyers to this brand's email lead list so an email sequence can win them back: name, email, number of orders, total spent and last order date (usable as {{orders_count}}, {{total_spent}}, {{last_order_date}} in a sequence). ONLY buyers who agreed to marketing email in Shopify are added; the reply says how many were skipped and why (never agreed, unsubscribed, not confirmed yet, no email). An address already on the list that unsubscribed stays unsubscribed. since = only buyers who ordered on or after that date. dryRun:true shows what would happen and adds nothing. NOTHING IS EMAILED: enrol them in a sequence for that. Up to 500 buyers a call; pass cursor for the next ones. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Add past Shopify buyers to the email leads
  • instagram_collaboratorsDid the collab invites on an Instagram post get accepted?Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Did the collab invites on an Instagram post get accepted? Reports every collaborator on one of the brand’s OWN Instagram posts with the status Instagram actually holds for it — Accepted (the post is live on their profile too, and its reach now includes their followers), Pending (invited, sitting in their notifications, NOT yet on their profile) or Declined. This is the tool for “did @creator accept yet?”, and the only way to find out: Instagram sends no notification either way. The media id is what post_to_meta returned as `postId`, or any id from list_instagram_media. A post with no collaborators simply reports none. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check who accepted a collab invite
    • idempotentHint: true
  • instagram_insightsACCOUNT-level performance for the brand’s connected Instagram Business account — views, reach, accounts engaged, total interactions, likes, comments, shares, saves, profile link ta…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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, reposts and follows/unfollows — plus the AUDIENCE DEMOGRAPHICS (follower_demographics and engaged_audience_demographics, broken down by age, city, country or gender), which is the read that says WHO the content reached rather than how many. Use meta_post_insights for one post and meta_page_insights for the Facebook Page. THERE IS NO "impressions": Meta deprecated it for every API version on 2025-04-21 and replaced it with "views" — an unknown metric is refused by name rather than quietly dropped. Instagram returns NO demographics for an account under 100 followers (or under 100 engagements in the window), and an absent block means exactly that, never an empty audience. Read-only, 0 credits. Needs the Instagram account connected, either through Meta (an Instagram account linked to a Facebook Page) or on its own through the Instagram connector; when several are connected, name the one you mean with account.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Instagram account insights + audience demographics
    • idempotentHint: true
  • instagram_marketplace_creatorONE CREATOR FROM INSTAGRAM'S CREATOR MARKETPLACE, IN DEPTH: Meta's first-party insights (total followers, reach, engaged accounts, reels interaction rate, reels hook rate), audienc…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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 (engaged accounts by gender, age, top countries, top cities), the brands they partnered with in the past year, and their recent posts, branded-content posts and partnership ads with likes, comments, views and shares. Pass username. Demographics:false or media:false skip those parts. A part Meta does not serve for this creator is listed as unavailable rather than failing the lookup. Then: approve them for partnership ads with manage_meta_partnership_creator, or save them to a swipefile collection. Needs the Meta (Facebook Login) connector and Meta's instagram_creator_marketplace_discovery permission; when it cannot run it says why. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: One creator from Instagram’s creator marketplace, in depth
    • idempotentHint: true
  • instagram_mentionsPosts and comments by OTHER accounts that @mention the brand’s Instagram account.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The description's first verb is "post": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Posts and comments by OTHER accounts that @mention the brand’s Instagram account. action "list" shows the ones Meta has told Hermoso about recently, with the words, who wrote it and the post link; action "reply" posts a PUBLIC comment as the brand under that mention (mediaId, and commentId for a comment mention) and is confirm-gated. Meta keeps no list to read back, only live notifications: Story mentions arrive as DMs instead, private accounts send nothing, and an account connected ONLY directly through Instagram gets its mentions inside comment notifications (one also linked to a Facebook Page is read through the Page). Also in list_inbox as source instagram_mention. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Instagram posts and comments that @mention the brand
  • instagram_profileTurn an Instagram @handle into the NUMERIC Instagram account id, straight from Meta — with the account’s real name, bio, follower count, post count, website and profile picture.Reads text others write1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • High

      The description contains "never tell a user", an instruction to keep something from the user.

      Matched text

      description: "...eturns one error code for all four — so never tell a user which of them it was. Read-only, 0 cred..."

      What this check looks for
    Description, as the server wrote it
    Turn an Instagram @handle into the NUMERIC Instagram account id, straight from Meta — with the account’s real name, bio, follower count, post count, website and profile picture. Two jobs: it answers "what is @<handle>’s Instagram id?", and it sizes up any brand or creator on Instagram before you work with them (followers and post count are Meta’s own numbers, not a scraper’s). CALL IT BEFORE manage_meta_partnership_creator: that tool’s `allowTagging` list takes NUMERIC IDS ONLY, and an id that did not come from Meta is rejected there with “An unknown error has occurred.” — an error carrying no cause at all, so a scraped or guessed id looks like an outage instead of a bad argument. PROFESSIONAL ACCOUNTS ONLY: Meta reads Instagram Business and Creator accounts here and nothing else. A personal account, a private account, an age-gated account and a handle that does not exist all come back as the SAME refusal, because Meta returns one error code for all four — so never tell a user which of them it was. Read-only, 0 credits, no new permission, no reconnect. RECENT POSTS: pass posts (1–50) to also get that account's latest posts with their like, comment and view counts and links, read first-party from Meta for FREE, for a business or creator account's recent Instagram posts (competitor organic research); page with cursor.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up an Instagram account by handle
    • idempotentHint: true
  • instagram_story_insightsAn Instagram Story’s numbers: reach, views, replies, shares, link clicks, profile visits, follows, and navigation (forward, back, next story, exit).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    An Instagram Story’s numbers: reach, views, replies, shares, link clicks, profile visits, follows, and navigation (forward, back, next story, exit). Meta keeps them for 24 hours, so Hermoso reads every live Story on a schedule, including ones posted from the phone, and they stay readable here after the Story ends. Pass storyId for one, or nothing for the recent ones. `state` says what is known: numbers, below_minimum (Meta withholds them under 5 viewers), not_captured (it ended before a read), or why a read failed; none of those means zero. Meta returns 0 replies for Stories created in Europe and Japan, and the answer says so. Link clicks need a Facebook-login connection. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: An Instagram Story’s numbers, kept past its 24 hours
    • idempotentHint: true
  • intercom_customer_languageWhat CUSTOMERS wrote in the brand's Intercom: reads recent conversations in full and returns only the customers' own words (no teammate or bot text; emails, phone numbers and links…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What CUSTOMERS wrote in the brand's Intercom: reads recent conversations in full and returns only the customers' own words (no teammate or bot text; emails, phone numbers and links redacted; no names). Use it for real pains, objections, questions and exact phrases for ad copy, hooks, angles and research, and quote their words rather than paraphrasing. days (default 30), conversations to read (default 25, at most 60), optional text or tagId to focus it. Read-only, free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Customer language from Intercom
    • idempotentHint: true
  • klaviyo_reportKlaviyo PERFORMANCE for campaigns (default) or flows (of:'flows'): recipients, delivered, unique opens and open rate, unique clicks and click rate, conversions and conversion rate,…Reads text others writeCan send data outNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Klaviyo PERFORMANCE for campaigns (default) or flows (of:'flows'): recipients, delivered, unique opens and open rate, unique clicks and click rate, conversions and conversion rate, REVENUE (conversion_value) and revenue per recipient, unsubscribes, bounces and spam complaints, per campaign (or per flow message), over timeframe (last_7_days, last_30_days default, last_90_days, this_month, last_12_months...) or start + end (at most a year). Conversions and revenue count on conversionMetric (default 'Placed Order'). Narrow with campaignIds / flowIds or channel. Rates are fractions (0.25 = 25%). Klaviyo allows only 2 report queries a minute and 225 a day, so ask once with a wide window; the same question within 10 minutes is answered from the last read unless fresh:true. Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Klaviyo campaign and flow performance
  • like_instagramLike (or unlike) an Instagram post, Reel, comment or reply AS the brand’s Instagram account — Meta’s Like Media and Comments API (April 2026).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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). like the good comments on your own posts and the posts you are tagged in. Pass exactly one of mediaId or commentId; undo:true unlikes. Stories and private accounts cannot be liked. Needs the Meta (Facebook Login) connector — a direct Instagram login has no likes edge. Roughly 200 likes per account per hour. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Like or unlike on Instagram as the brand
    • idempotentHint: false
  • line_accountThe connected LINE Official Account: its name and LINE id, HOW MANY FRIENDS it has, how many of them a broadcast can reach and how many blocked it (LINE’s own figures, about a day …Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The connected LINE Official Account: its name and LINE id, HOW MANY FRIENDS it has, how many of them a broadcast can reach and how many blocked it (LINE’s own figures, about a day old; unknown is reported as unknown, never zero), and whether LINE is sending the account’s messages to Hermoso: the webhook address LINE holds, whether it is Hermoso’s, and whether the Use webhook switch is on. This is the answer to “how many LINE friends do we have” and the first thing to read when LINE messages are not arriving; it lists what is left to switch on in the LINE console. Pass test:true to have LINE call the address and report what it got (LINE allows 60 tests an hour). Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read the LINE account and its webhook
  • line_profileOne LINE user’s display name, picture, status message and language, by their LINE user id (from read_line_inbox).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One LINE user’s display name, picture, status message and language, by their LINE user id (from read_line_inbox). LINE answers this only for people who added the account as a friend or wrote to it, and answers “not found” for someone who blocked it. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a LINE user’s profile
  • line_quotaThe connected LINE Official Account’s monthly message quota: the limit on its plan (or that it has none) and how many messages have been used this month, as LINE reports them.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The connected LINE Official Account’s monthly message quota: the limit on its plan (or that it has none) and how many messages have been used this month, as LINE reports them. WHAT COUNTS: push, multicast, broadcast and narrowcast messages, one per person reached; a reply sent inside a minute of a person’s message does not. Read it before send_line_broadcast. LINE calls the usage figure approximate, and it includes messages sent from LINE’s own Official Account Manager. A number LINE did not return is reported as unknown, never as zero. LINE bills the quota to the account on its own plan; Hermoso charges nothing. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read the LINE message quota
  • linkedin_page_analyticsORGANIC performance for one of the brand’s LinkedIn COMPANY PAGES: total followers, followers gained (organic vs paid) across the window, Page views (all / unique / desktop / mobil…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ORGANIC performance for one of the brand’s LinkedIn COMPANY PAGES: total followers, followers gained (organic vs paid) across the window, Page views (all / unique / desktop / mobile), and the impressions, unique impressions, clicks, likes, comments, shares and engagement rate of the Page’s posts. This is what answers “is our LinkedIn actually working” and “did that post land”. LinkedIn excludes sponsored activity from these figures entirely. Pass postUrns (the urn:li:share:… / urn:li:ugcPost:… that post_to_linkedin_page returned) for PER-POST numbers; LinkedIn forbids a date range together with named posts, so that switches to lifetime-per-post. Only Pages the user ticked in Manage accounts (or call list_connector_accounts with provider linkedin, then set_connector_accounts) are readable — a Page the account merely administers is refused, by design. LinkedIn keeps 12 months, follower figures run about 2 days behind, and it OMITS posts with no recorded activity rather than returning zeros: report an absent post or an unavailable section as MISSING data, never as zero. Read-only, 0 credits. Needs LinkedIn connected with the organization scopes.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Organic performance of a LinkedIn company Page
    • idempotentHint: true
  • linkedin_profile_followersFollower count of the PERSONAL LinkedIn profile shared with this brand — the lifetime total and, with startDate / endDate, the new followers per day (LinkedIn’s memberFollowersCoun…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Follower count of the PERSONAL LinkedIn profile shared with this brand — the lifetime total and, with startDate / endDate, the new followers per day (LinkedIn’s memberFollowersCount). This is the creator / founder growth number; Company Page followers are in linkedin_page_analytics. It needs a personal profile ticked in Manage accounts (list_connector_accounts provider linkedin, then set_connector_accounts with its id to tick it) and the LinkedIn analytics authorization on the LinkedIn card — if the reply says re-authorize, say exactly that. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Followers of a personal LinkedIn profile
  • list_callsCalls on the brand's own numbers, newest first, read from Twilio or Telnyx: from, to, status, direction, duration, price, plus what Hermoso knows of each (forwarded to, missed, tex…Reads text others write1 finding

    Why it is in this group

    • The name "list_calls" says "list": a word for reading.
    • The description's first verb is "call": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "list_calls" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_calls" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Calls on the brand's own numbers, newest first, read from Twilio or Telnyx: from, to, status, direction, duration, price, plus what Hermoso knows of each (forwarded to, missed, texted back, recording, tracked campaign). number narrows it to one of the brand's numbers; from, status and since filter. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List calls
  • list_instagram_collab_invitesPosts where a creator tagged this Instagram account as a COLLABORATOR and is waiting for an answer.Reads text others write1 finding

    Why it is in this group

    • The name "list_instagram_collab_invites" says "list": a word for reading.
    • The description's first verb is "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "list_instagram_collab_invites" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_instagram_collab_invites" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Posts where a creator tagged this Instagram account as a COLLABORATOR and is waiting for an answer. The post appears on the brand’s profile only once the brand accepts, and Instagram sends no notification here, so this list is the only way to see them. Answer each with respond_instagram_collab_invite. Read-only, free. Instagram allows 300 reads per account per day.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Collab invites waiting on the brand
    • idempotentHint: true
  • list_pinterest_pinsThe Pins on one of the account’s boards — or, with no boardId, the account’s own Pins across all of them.Reads text others write1 finding

    Why it is in this group

    • The name "list_pinterest_pins" says "list": a word for reading.
    • The description's first verb is "pin": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "list_pinterest_pins" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_pinterest_pins" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    The Pins on one of the account’s boards — or, with no boardId, the account’s own Pins across all of them. Each row carries the Pin id, title, description, destination link, alt text, board, creation date, and whether it HAS BEEN PROMOTED in an ad. THIS IS WHERE THE pinId EVERY OTHER PIN TOOL NEEDS COMES FROM: post_to_pinterest returns an id only at the instant it pins, so an agent that did not itself just pin had no way to name a Pin. Prefer passing a boardId — Pinterest’s own spec warns the account-wide listing has known timeouts. Read-only, 0 credits. Needs Pinterest connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pins on a Pinterest board
    • idempotentHint: true
  • list_product_photosList the product photos ALREADY saved in your workspace — the brand's product library plus any app-store screens (also surfaces photos locked in your OTHER creations, since a set p…1 finding

    Why it is in this group

    • The name "list_product_photos" says "list": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    Findings

    • Warn

      The server marks "list_product_photos" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "list_product_photos" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    List the product photos ALREADY saved in your workspace — the brand's product library plus any app-store screens (also surfaces photos locked in your OTHER creations, since a set product lands in the shared library). FREE — returns each photo's url + the product it shows (the shop's own title when one is on file). These are already saved: never ask the user to upload them again. Reads YOUR saved brand (pass brandId to target a specific profile — that switches this key's active profile like use_brand).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List product photos
  • list_threads_mentionsPosts where someone MENTIONED the brand on Threads — anywhere, not just under your own posts.Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "list_threads_mentions" says "list": a word for reading.
    • The description's first verb is "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • private-dataThe name "list_threads_mentions" says "list" and "thread": it reads messages.
    • private-dataThe description's first sentence says "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_threads_mentions" says "list" and "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "post" and "thread": it reads messages, which other people can write.

    Findings

    • Warn

      The server marks "list_threads_mentions" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_threads_mentions" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Posts where someone MENTIONED the brand on Threads — anywhere, not just under your own posts. Use list_threads_replies instead when you want the conversation under one specific post.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Threads mentions of the brand
    • idempotentHint: true
  • list_tiktok_mention_commentsComments and replies anywhere on TikTok whose TEXT @-mentions the connected account's handle.Reads text others write1 finding

    Why it is in this group

    • The name "list_tiktok_mention_comments" says "list": a word for reading.
    • The description's first verb is "comment": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_mention_comments" says "list" and "mention": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "comment" and "reply": it reads comments, which other people can write.

    Findings

    • Warn

      The server marks "list_tiktok_mention_comments" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_tiktok_mention_comments" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Comments and replies anywhere on TikTok whose TEXT @-mentions the connected account's handle. This is the conversational half of brand monitoring, where list_tiktok_mentions covers post captions. Same four preconditions as that tool (public post, 90 days, adult author, BUSINESS account), so an empty list is not the same as silence. Capped at the top 1,000 by comment likes, and TIKTOK DELIBERATELY DEPRIORITISES a comment that is nothing but the @-mention with no other text, so bare tags may not appear at all. Sorts on different keys from the post list: VIDEO_LIKES, COMMENT_CREATE_TIME or COMMENT_LIKES. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights and comment-list permissions. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Comments that mention the brand on TikTok
    • idempotentHint: true
  • list_voice_agent_callsThe calls the brand's voice agents handled, newest first, across every connected platform: direction, the other number, status, length, the platform's summary and whether the call …Reads text others write1 finding

    Why it is in this group

    • The name "list_voice_agent_calls" says "list": a word for reading.
    • The description's first verb is "call": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "list_voice_agent_calls" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_voice_agent_calls" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    The calls the brand's voice agents handled, newest first, across every connected platform: direction, the other number, status, length, the platform's summary and whether the call met its goal. agentId, since (ISO), batchId (Retell) narrow it. Read live from the platform. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List voice-agent calls
  • mailchimp_reportMailchimp campaign PERFORMANCE: emails sent, unique opens and open rate (and the rate without machine opens), unique clicks and click rate, unsubscribes, bounces, abuse reports and…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Mailchimp campaign PERFORMANCE: emails sent, unique opens and open rate (and the rate without machine opens), unique clicks and click rate, unsubscribes, bounces, abuse reports and, where a store is connected to Mailchimp, orders and REVENUE, per campaign sent in the last `days` (default 30), or one campaign by campaignId. Rates are fractions (0.25 = 25%). Read-only, free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Mailchimp campaign performance
  • manage_tiktok_brand_hashtagsEnable or disable the hashtags TikTok counts as this brand's.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "enable": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Enable or disable the hashtags TikTok counts as this brand's. ADD takes a LIST of up to 10 per call (50 enabled per brand in total); REMOVE takes exactly ONE, because TikTok publishes no bulk removal and a list would silently drop all but one. TWO TIMING RULES THAT ARE EASY TO TRIP: a newly enabled hashtag is not counted for 24 HOURS, so list_tiktok_brand_hashtag_posts shows nothing for it until then; and it CANNOT BE REMOVED FOR 7 DAYS after being enabled, so this tool reads the enable date first and reports the exact wait rather than relaying TikTok's undated refusal. A tag must either be on the AVAILABLE list or contain the account handle as a substring, or TikTok rejects it. THE ANSWER IS THE READ-BACK, not the 200: TikTok's remove response is an empty body, so success means the tag has left the enabled list. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights permission.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn a brand hashtag on or off for TikTok tracking
  • mark_bluesky_convo_readClear the unread count on Bluesky DMs — ONE conversation, or the WHOLE ACCOUNT when convoId is omitted (Bluesky’s own mark-all, narrowable with status to just the message requests …Reads text others writeNo findings

    Why it is in this group

    • The name "mark_bluesky_convo_read" says "mark": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Clear the unread count on Bluesky DMs — ONE conversation, or the WHOLE ACCOUNT when convoId is omitted (Bluesky’s own mark-all, narrowable with status to just the message requests or just the accepted threads). Useful after triaging an inbox so the next list_bluesky_convos does not surface the same threads again. Reports the unread count — or the number of conversations — Bluesky reads back, not the one requested. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Mark Bluesky conversations as read
    • idempotentHint: false
  • meta_page_insightsOrganic 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 fa…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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), post engagements, video views, daily follows, plus follower and Page-like counts — with the linked Instagram account’s headline numbers alongside. This is ORGANIC reach. Any metric Meta returns no value for is named as MISSING data, which must never be reported as zero.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Facebook Page + Instagram insights
    • idempotentHint: true
  • meta_page_reviewsThe reviews (recommendations) people left on the brand’s Facebook Page: recommends or not, the stars when given, the words, who wrote it and when.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The reviews (recommendations) people left on the brand’s Facebook Page: recommends or not, the stars when given, the words, who wrote it and when. action "list" reads them (cursor pages on); action "reply" posts a PUBLIC reply as the Page under one review (reviewId from the list) and is confirm-gated. Meta documents reading reviews and does not document replying to them, so a reply is tried, read back, and when Meta refuses it the answer says to reply from the Page on Facebook. Also in list_inbox as source facebook_review. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Facebook Page reviews: read and reply
  • meta_post_insightsPerformance 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…Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "meta_post_insights" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "meta_post_insights" says "post": it sends or publishes something to other people.

    Findings

    • Warn

      The server marks "meta_post_insights" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "meta_post_insights" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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 video watch time; on Instagram views, reach, likes, comments, saves, shares, total interactions and (where the media type has them) follows, profile visits, story navigation and reel watch time. Use it to find which organic posts earned their reach before turning one into a paid ad. A metric Meta returns no value for is reported by name as MISSING — never read it as zero.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Insights for one Facebook/Instagram post
    • idempotentHint: true
  • pin_discord_messagePin a message to the top of its Discord channel (any message in a channel the bot can see, not only Hermoso's own).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "pin_discord_message" says "pin": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "pin_discord_message" says "pin" and "message": it writes something other people read.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Pin a message to the top of its Discord channel (any message in a channel the bot can see, not only Hermoso's own). A channel holds at most 250 pins. Undo it with unpin_discord_message. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Pin a Discord message
  • pin_telegram_messagePin a message to the top of a Telegram channel or group, or unpin one.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "pin_telegram_message" says "pin": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "pin_telegram_message" says "pin" and "message": it writes something other people read.
    • outboundThe input takes a destination (input.chatId): what the tool writes goes there.
    Description, as the server wrote it
    Pin a message to the top of a Telegram channel or group, or unpin one. A channel’s pinned message is its most valuable real estate and its de-facto call to action. Pinning is SILENT by default (no member notification) — pass notify:true to ping. To unpin, pass unpin:true; omitting messageId then unpins the most recently pinned message, which is what “unpin” usually means. The bot must be an administrator with pin rights. Free, 0 credits. Needs Telegram connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Pin or unpin a Telegram message
  • pinterest_analyticsORGANIC Pinterest performance — impressions, saves, Pin clicks, outbound clicks and their rates, for the whole ACCOUNT, for the TOP PINS, for the TOP VIDEO PINS (with view-through …Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ORGANIC Pinterest performance — impressions, saves, Pin clicks, outbound clicks and their rates, for the whole ACCOUNT, for the TOP PINS, for the TOP VIDEO PINS (with view-through and average watch time), or for ONE Pin. This is unpaid reach; paid Pinterest ads have their own report. Use scope:"top_pins" to answer "what is actually working on our Pinterest" — it ranks the account’s own Pins by whichever metric you sort on. NOTE Pinterest keeps only 90 DAYS of organic analytics and refuses a longer window, which is refused here with the reason rather than as an opaque error. A VIDEO Pin takes a different metric set from a static one (pass video:true for scope:"pin"). THERE IS NO BOARD ANALYTICS: Pinterest’s v5 API publishes no such endpoint, so board-level performance genuinely does not exist in any API — do not promise it. An unknown metric is refused by name, and a metric Pinterest omits from a row is MISSING data ("if a column has no value, it may not be returned"), never a measured zero. Works on Pinterest’s Trial access tier — unlike creating Pins, every read row in Pinterest’s access-tier table is available on Trial. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest organic analytics
    • idempotentHint: true
  • pinterest_audience_insightsWHO the Pinterest audience IS, rather than what it did — interest categories each carrying an affinity INDEX, plus demographics (ages, countries, devices, genders, metros).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHO the Pinterest audience IS, rather than what it did — interest categories each carrying an affinity INDEX, plus demographics (ages, countries, devices, genders, metros). Three audiences: YOUR_TOTAL_AUDIENCE, YOUR_ENGAGED_AUDIENCE, and PINTEREST_TOTAL_AUDIENCE as the baseline to compare the other two against. This is an input to a creative brief, not a performance report. SAY THIS WHEN REPORTING: an affinity index is how much MORE likely this audience is to engage with a category than Pinterest’s baseline — it is a comparison, never a count — and when Pinterest flags size_is_upper_bound the audience size is an upper bound, not a measurement. There is no date range: Pinterest returns its current snapshot and names the date it is for. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest audience insights
    • idempotentHint: true
  • pinterest_targeting_analyticsWHICH AUDIENCE SEGMENT actually delivered on Pinterest — ad performance broken down by keyword, targeted interest, age bucket, gender, location, region, country, placement, app typ…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHICH AUDIENCE SEGMENT actually delivered on Pinterest — ad performance broken down by keyword, targeted interest, age bucket, gender, location, region, country, placement, app type, media type and more. targetingTypes is REQUIRED because it is what the report breaks down BY. scope:"account" covers the whole ad account; "campaign" / "adGroup" / "ad" each REQUIRE their own id list, because Pinterest publishes no all-of-them form at those levels — that is Pinterest’s shape, not a limitation here. 90 days back in windows of at most 90 days, refused locally with the reason. An unknown targeting type is refused BY NAME; note Pinterest’s four per-level enums differ slightly, so a value valid at one level can still be refused at another. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest ads by audience segment
    • idempotentHint: true
  • plan_weekUse this when the user wants a week of social posts planned, or answers yes or no to planning their week.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Use this when the user wants a week of social posts planned, or answers yes or no to planning their week. It drafts one batch of 5 posts for the active brand: a new image, a caption and a suggested day and time for each. Without confirm it returns the price and whether the batch fits the account’s posting allowance, and spends nothing. confirm:true starts the batch and bills credits; read the posts with get_job. The posts stay drafts until the user approves them with run_post_refill, and this tool publishes nothing. decline:true records that the user said no.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Plan a week of posts
  • post_performanceUse this when the user asks which of their posts, hooks or subjects work best.Can send data out1 finding

    Why it is in this group

    • The name "post_performance" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • outboundThe name "post_performance" says "post": it sends or publishes something to other people.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.

    Findings

    • Warn

      The server marks "post_performance" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "post_performance" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Use this when the user asks which of their posts, hooks or subjects work best. It groups this brand's published posts by hook (default), subject, format (recipe), channel, media format or posting hour, reports the engagement RATE within each channel, and ranks the best and worst POSTS in each channel. Describe a post by the creative it carried (what it shows, its format, its link), not by its caption — the caption is the least important part of a post. THREE THINGS IT WILL NOT DO, to repeat rather than paper over: (1) it never sums metrics across channels — a LinkedIn impression and a TikTok view are different units, so every comparison is within one channel; (2) it SUPPRESSES a verdict below 5 measured posts and says so, because a confident recommendation from 3 posts is worse than none; (3) a post with no recorded hook (published outside Hermoso, or backfilled without a creation match) counts toward channel and format totals but never votes on which hook works. Present the `finding` verbatim if there is one, and the reason if there is not. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Which hooks and subjects are getting traction
    • idempotentHint: true
  • promote_campaign_postRun an APPROVED campaign post as an ad, from the creator's own code.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "promote_campaign_post" says "post": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "promote_campaign_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Run an APPROVED campaign post as an ad, from the creator's own code. Instagram / Facebook post: a Meta partnership ad on a new paused campaign + ad set (adCode = the creator's partnership ad code: post > ... > Partnership label and ads > Ad code). TikTok post: a Spark Ad in an existing ad group (adCode = the Spark Ads code the creator shares from that post; adgroupId required). Created PAUSED and read back; nothing spends until switched on. Without confirm:true, a preview that builds nothing. Usage rights never block it: if the rights this creator agreed to on the join page do not list that platform or have ended, the note carries a one-line heads-up the brand may ignore (they may have agreed elsewhere).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Run an approved creator post as a paused ad
  • react_to_bluesky_dmAdd or remove an emoji reaction on one message in a Bluesky DM — the light acknowledgement that does not need a written reply, and the thing to reach for when someone says “thanks”…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "react_to_bluesky_dm" says "react": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "react_to_bluesky_dm" says "react" and "dm": it writes something other people read.
    Description, as the server wrote it
    Add or remove an emoji reaction on one message in a Bluesky DM — the light acknowledgement that does not need a written reply, and the thing to reach for when someone says “thanks” and a paragraph back would be worse than a thumbs-up. A REACTION IS EXACTLY ONE EMOJI: that is Bluesky’s own rule, so a word or a phrase is refused here rather than by the service (where it comes back as an opaque ReactionInvalidValue). Reports the reactions Bluesky reads the message back carrying, not the one requested. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: React to a Bluesky direct message
    • idempotentHint: false
  • react_to_linkedin_postReact to a LinkedIn post or comment AS your company Page: LIKE, PRAISE (Celebrate), EMPATHY (Love), INTEREST (Insightful), APPRECIATION (Support) or ENTERTAINMENT (Funny); remove:t…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "react_to_linkedin_post" says "react": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "react_to_linkedin_post" says "react" and "post": it writes something other people read.
    Description, as the server wrote it
    React to a LinkedIn post or comment AS your company Page: LIKE, PRAISE (Celebrate), EMPATHY (Love), INTEREST (Insightful), APPRECIATION (Support) or ENTERTAINMENT (Funny); remove:true takes the Page's reaction away. Public: say which post first. Same LinkedIn comments authorization as the comment tools (provider linkedin_community). Read back from LinkedIn. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: React to a LinkedIn post as the Page
  • react_to_slack_messageAdd an emoji reaction to a Slack message as the Hermoso app, or take one away (remove:true).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "react_to_slack_message" says "react": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "react_to_slack_message" says "react" and "message": it writes something other people read.
    Description, as the server wrote it
    Add an emoji reaction to a Slack message as the Hermoso app, or take one away (remove:true). messageId is what post_to_slack or read_slack_channel gave ("<channel>/<ts>"). Read back from Slack. A workspace that added the app before 2026-11-15 adds it again once (the tool says so). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: React to a Slack message
  • read_line_inboxThe chats people sent to the brand’s LINE Official Account, and its answers.Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "read_line_inbox" says "read": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    What it can reach

    • private-dataThe name "read_line_inbox" says "read" and "inbox": it reads mail.
    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_line_inbox" says "read" and "inbox": it reads inbound email, which other people can write.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.

    Findings

    • Warn

      The server marks "read_line_inbox" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "read_line_inbox" says "read": a word for reading.

      What this check looks for
    Description, as the server wrote it
    The chats people sent to the brand’s LINE Official Account, and its answers. With no argument: every conversation from the last 7 days, newest first, each with who wrote, the last thing they said and whether the brand has answered. With conversationId: that whole conversation, oldest first, with a link to any photo, video, voice message or file the person sent. WHY ONLY 7 DAYS: LINE cannot return a message again after delivering it, so Hermoso keeps what arrives for 7 days and then deletes it, files included. TO REPLY: pass conversationId and reply. Inside a minute of the person’s message it goes as a free reply; after that it is a push message, which uses one message of the account’s monthly LINE quota (line_quota). A person who removed or blocked the account is refused, because LINE would accept the message and deliver nothing. A reply reaches a real person: show the user the exact words and get a yes first. 1:1 chats only, no group chats. Free, 0 credits. Needs LINE connected (Connectors > LINE, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Read and answer LINE messages
  • read_whatsapp_inboxThe WhatsApp messages people sent to the brand’s WhatsApp Business numbers, and its answers to them.Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "read_whatsapp_inbox" says "read": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    What it can reach

    • private-dataThe name "read_whatsapp_inbox" says "read" and "inbox": it reads mail.
    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_whatsapp_inbox" says "read" and "inbox": it reads inbound email, which other people can write.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.

    Findings

    • Warn

      The server marks "read_whatsapp_inbox" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "read_whatsapp_inbox" says "read": a word for reading.

      What this check looks for
    Description, as the server wrote it
    The WhatsApp messages people sent to the brand’s WhatsApp Business numbers, and its answers to them. With no argument: every conversation from the last 48 hours, newest first, each with who wrote, the last thing they said, whether the brand has answered, and whether the 24-hour reply window is still open. With conversationId: that whole conversation, oldest first, with the delivery status of each reply. With messageId (a wamid. id a send or broadcast row returned): its latest delivery report (sent, delivered, read, or failed with WhatsApp’s reason); never call a message delivered unless this says so. WHY ONLY 48 HOURS: WhatsApp has no message history an app can read, so Hermoso keeps what arrives for 48 hours (long enough to answer inside the window) and then deletes it; older messages are in the WhatsApp Business app or WhatsApp Manager. TO REPLY: pass conversationId and reply. It goes out ONLY while the window is open (the person wrote in the last 24 hours) and is refused for free otherwise, because WhatsApp then accepts only an approved template (send_whatsapp_message with template). A reply reaches a real phone: show the user the exact words and get a yes first. Free, 0 credits. Needs WhatsApp connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Read and answer WhatsApp messages
  • refresh_campaign_viewsRead the latest platform-reported numbers for tracked posts now (they are read twice a day on their own while their window is open).Reads text others write1 finding

    Why it is in this group

    • The name "refresh_campaign_views" says "view": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.

    Findings

    • Warn

      The server marks "refresh_campaign_views" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "refresh_campaign_views" says "view": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Read the latest platform-reported numbers for tracked posts now (they are read twice a day on their own while their window is open). One campaign's posts, or the submissionIds given; up to 50 per call; each read costs credits. Approved posts earn on the new views.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Re-read campaign posts' views now
  • register_sms_brandFile the business's US A2P 10DLC brand on its own account.Reads text others writeCan send data outNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.phone): what the tool writes goes there.
    Description, as the server wrote it
    File the business's US A2P 10DLC brand on its own account. Twilio: customerProfileBundleSid and a2pProfileBundleSid (the Trust Hub bundles from Twilio's guided registration), brandType STANDARD or SOLE_PROPRIETOR. Telnyx: entityType, displayName, companyName, email, vertical, plus ein, phone, street, city, state, postalCode, website as the business has them. The provider bills its registration fee to the account. Without confirm:true nothing is filed. Free in credits. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Register a 10DLC brand
  • register_sms_campaignSubmit a US A2P 10DLC campaign for a registered brand: smsBrandId (the 10DLC brand id sms_registration_status lists), useCase (e.g.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Submit a US A2P 10DLC campaign for a registered brand: smsBrandId (the 10DLC brand id sms_registration_status lists), useCase (e.g. MARKETING, MIXED, CUSTOMER_CARE, 2FA), description, messageFlow (how people opt in), samples (2 to 5 example texts), optInMessage / optOutMessage / helpMessage, hasLinks, hasPhone, privacyPolicyUrl, termsUrl; on Twilio also messagingServiceSid. Carriers review it; the provider bills the vetting and monthly fees to the account. Without confirm:true nothing is filed. Free in credits. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Register a 10DLC campaign
  • rememberSave a durable fact or PREFERENCE about the brand, audience, or the user’s creative TASTE (e.g.No findings

    Why it is in this group

    • The description's first verb is "save": a word for a change.
    Description, as the server wrote it
    Save a durable fact or PREFERENCE about the brand, audience, or the user’s creative TASTE (e.g. “audience is first-time homebuyers”, “prefers bold lime accents”, “always captions off”) into the workspace Memory so it shapes FUTURE ads. For lasting things, not one-off requests. Merges into the existing Memory (never overwrites); de-dupes on identical text. NEVER how Hermoso, a tool, a connector or a platform API behaves (what a call returns, errors, permissions, limits, ids) and never a phone number or email — those are refused.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Remember a fact
  • report_bugReport a bug in Hermoso to the team.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Report a bug in Hermoso to the team. Use this when something in Hermoso genuinely misbehaves — a tool errors unexpectedly, returns a wrong or malformed result, a render comes back broken, or documented behaviour doesn't match what happened. Include what you were trying to do, the exact tool call and arguments, and what came back. Do NOT use it for out-of-credits, a policy refusal, or a missing capability (use request_feature for that). Free, no credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Report a bug
  • request_featureAsk the Hermoso team for a capability that doesn't exist yet.Reads text others writeNo findings

    Why it is in this group

    • The name "request_feature" says "request": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Ask the Hermoso team for a capability that doesn't exist yet. Use this when you need something Hermoso genuinely can't do — an unsupported platform or channel, a missing model, an export format, a tool that would have completed the user's task but isn't available. Say what the user was trying to achieve, not just the feature name — the use case is what gets built. Free, no credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Request a feature
  • save_contactsAdd or update contacts (up to 1,000 a call): contacts [{ id?, name, email, phone, company, tags, removeTags, fields { key: value, or null to remove }, notes, channels [{ platform, …Reads text others writeNo findings

    Why it is in this group

    • The name "save_contacts" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add or update contacts (up to 1,000 a call): contacts [{ id?, name, email, phone, company, tags, removeTags, fields { key: value, or null to remove }, notes, channels [{ platform, id?, handle? }], consent { <channel>: "opted_in"|"opted_out" }, subscribed }]. A row matching an existing person by id, email, phone or channel updates them, and two records found to be one person are merged. consent and subscribed record what the person told you (subscribed:false = opted out of everything); a recorded opt-out skips sequence steps on that channel. sync: true (or a list of email_leads, sms_consents, inbox, creators, shopify, stripe, hubspot) pulls people in from those, each source saying what it read or why not. Sends nothing. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Add, update or sync contacts
  • save_creatorAdd a portrait to this workspace’s reusable CAST so the SAME person can star in future ads.Reads text others writeNo findings

    Why it is in this group

    • The name "save_creator" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add a portrait to this workspace’s reusable CAST so the SAME person can star in future ads. Pass the portrait’s public url plus a name to call them by. Saving is FREE and renders nothing (the one paid option is makeSheet, which makes their 16:9 character sheet). LIKENESS: leave `source` "generated" for an AI-made person (free on every plan) and use "upload"/"social" for a REAL person. Using a real person’s face, likeness or voice confirms you are them or have their consent, take full, unlimited responsibility for its use and will cover any claim against Hermoso (hermoso.ai/terms). Paid plan only; recorded.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save a creator
  • save_locationSave a PLACE (a room, a set, a storefront) so any image, video or ad can be staged there by its @name.No findings

    Why it is in this group

    • The name "save_location" says "save": a word for a change.
    Description, as the server wrote it
    Save a PLACE (a room, a set, a storefront) so any image, video or ad can be staged there by its @name. FREE. A name and a public photo url of the empty place.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Save a place
  • save_pinterest_pinSave an existing Pin onto another of the account’s boards.Reads text others writeNo findings

    Why it is in this group

    • The name "save_pinterest_pin" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Save an existing Pin onto another of the account’s boards. This is the GENERALLY AVAILABLE way to get a Pin onto the right board — unlike update_pinterest_pin, which Pinterest keeps in a limited beta — so reach for it first when a Pin is on the wrong board. It COPIES rather than moves: Pinterest’s save endpoint creates a new Pin and the original stays where it is, so delete that one with delete_pinterest_pin if it should not be in two places. Let the USER pick the destination board (list_pinterest_boards) — a Pin on the wrong board is a public mistake. 0 credits. Needs Pinterest connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save a Pin to another board
  • save_playbookSave a reusable PLAYBOOK — the strategy takeaways worth re-running: the hooks that work, the angles, the formats, and the concrete plays.No findings

    Why it is in this group

    • The name "save_playbook" says "save": a word for a change.
    Description, as the server wrote it
    Save a reusable PLAYBOOK — the strategy takeaways worth re-running: the hooks that work, the angles, the formats, and the concrete plays. Lands in the same Playbooks library the web app lists, runs and manages. Distinct from save_skill (a directive applied to every ad) and from the swipefile (raw saved creative). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Save a playbook
  • save_skillSave a reusable custom SKILL — a named creative directive/playbook applied to future ads (a hook formula, a UGC recipe, a compliance rule, a named specialist persona like “our foun…No findings

    Why it is in this group

    • The name "save_skill" says "save": a word for a change.
    Description, as the server wrote it
    Save a reusable custom SKILL — a named creative directive/playbook applied to future ads (a hook formula, a UGC recipe, a compliance rule, a named specialist persona like “our founder-story style” or “short-form ad strategist”). Distill an imperative, self-contained directive. Merges into the workspace Skills library (list_skills shows built-ins + your custom skills).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Save a skill
  • save_to_driveSave a Hermoso render — or ANY file — into the user’s connected Google Drive.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "save_to_drive" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Save a Hermoso render — or ANY file — into the user’s connected Google Drive. Pass a Hermoso render URL as url (or urls[] for several); for a local/external file, call upload_file first and pass the url it returns. Optional folder (created if new) + name. Returns the Drive file(s) with a webViewLink. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs). NOTE: Hermoso uses the drive.file scope, so it reaches ONLY the files it created plus any the user explicitly handed over with the Google file picker in the app — never their whole Drive.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save file(s) to Google Drive
  • save_to_notionSave to the user's Notion as a NEW page: a research report, competitor teardown or campaign report as `content` (markdown: headings, lists, links, and an image or video URL on its …Reads text others writeNo findings

    Why it is in this group

    • The name "save_to_notion" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Save to the user's Notion as a NEW page: a research report, competitor teardown or campaign report as `content` (markdown: headings, lists, links, and an image or video URL on its own line becomes the media), a swipefile collection (swipefileCollection: name or id; each ad with its creative, copy, run dates and link), the content calendar (includeSchedule:true), or a mix. Put it under parentPageId, as a row in databaseId, or omit both for a private page in their workspace. Long text is split across blocks, never cut. The answer is read back from Notion. Free; never overwrites anything.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save to Notion
  • save_to_onedriveSave a Hermoso render — or ANY file — into the user’s connected Microsoft OneDrive.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "save_to_onedrive" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Save a Hermoso render — or ANY file — into the user’s connected Microsoft OneDrive. Pass a Hermoso render URL as url (or urls[] for several); for a local/external file, call upload_file first and pass the url it returns. Optional folder (created if new) + name. Returns the OneDrive file(s) with a webViewLink. Needs OneDrive connected (Connectors > OneDrive).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save file(s) to OneDrive
  • save_to_swipefileSave one or more ads/creatives to a named SWIPEFILE collection, creating the collection if it does not exist.No findings

    Why it is in this group

    • The name "save_to_swipefile" says "save": a word for a change.
    Description, as the server wrote it
    Save one or more ads/creatives to a named SWIPEFILE collection, creating the collection if it does not exist. Saved ads persist to the workspace board the web Swipefile tab shows, and feed the taste signal every future ad is planned against. De-dupes: re-saving the same ad (same key/link/media) MOVES it into the named collection instead of duplicating it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Save ads to the swipefile
  • set_auto_reloadTurn 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.No findings

    Why it is in this group

    • The name "set_auto_reload" says "set": a word for a change.
    Description, as the server wrote it
    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. Requires a saved card, added once in the app at first checkout/top-up; if there's none the tool tells you exactly where to add it. After that one-time card setup, agents can manage auto-reload, top-ups and plan links fully. Members (read-only billing) get an 'ask an admin' message.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Set auto-reload
  • set_credit_limitSet, change or remove a monthly credit limit on one brand, or on one member of a shared brand (ACCOUNT OWNER ONLY: a brand’s admins and members are refused).No findings

    Why it is in this group

    • The name "set_credit_limit" says "set": a word for a change.
    Description, as the server wrote it
    Set, change or remove a monthly credit limit on one brand, or on one member of a shared brand (ACCOUNT OWNER ONLY: a brand’s admins and members are refused). When a brand or member would go over its limit this month, paid work there is refused with the numbers and the reset date; free work keeps going and other brands are unaffected. The month is the UTC calendar month. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Set a credit limit
  • set_discord_channelChoose 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.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "set_discord_channel" says "set": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    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. Shared with everyone on the brand. Ask the user which channel; never pick one for them. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Set the default Discord channel
  • set_slack_channelChoose 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.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "set_slack_channel" says "set": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    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. Shared with everyone on the brand. Ask the user which channel; never pick one for them. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Set the default Slack channel
  • set_sms_opt_outPut a phone number on the brand's opt-out list (action add, the default) or take it off (action remove).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "set_sms_opt_out" says "set": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "set_sms_opt_out" says "set" and "sms": it writes something other people read.
    • outboundThe input takes a destination (input.phone): what the tool writes goes there.
    Description, as the server wrote it
    Put a phone number on the brand's opt-out list (action add, the default) or take it off (action remove). The list is applied to sends when set_sms_settings has optOutList on. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Add or remove an opt-out
  • set_webflow_collectionChoose which CMS collection on the brand's Webflow site holds its blog posts.Reads text others writeNo findings

    Why it is in this group

    • The name "set_webflow_collection" says "set": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Choose which CMS collection on the brand's Webflow site holds its blog posts. It is remembered, so post_to_webflow and scheduled Webflow posts go there. The collection must have a rich text field for the body. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Choose the Webflow blog collection
  • share_campaign_reportA public, read-only link to one campaign's report, or turn it off.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    A public, read-only link to one campaign's report, or turn it off. on: make (or keep) the link; showCreators (names, posts, views; default true) and showMoney (earnings; default false) choose what it shows. Emails, handles and payout details never show. off: the link stops working for everyone.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Share a creator campaign report (public link)
  • sms_conversationEvery text between the brand and one person, oldest first: on Twilio read from Twilio's own message log, on Telnyx from the messages Hermoso keeps from the Inbox (30 days).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Every text between the brand and one person, oldest first: on Twilio read from Twilio's own message log, on Telnyx from the messages Hermoso keeps from the Inbox (30 days). with is their number; number narrows it to one of the brand's numbers. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: SMS conversation history
  • store_getRead one of this workspace’s data stores by key, for visibility into what the app holds — playbooks, swipefile, saved locations, avatars, creations, chats, brand, memory, skills.1 finding

    Why it is in this group

    • The name "store_get" says "store": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "store_get" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "store_get" says "store": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Read one of this workspace’s data stores by key, for visibility into what the app holds — playbooks, swipefile, saved locations, avatars, creations, chats, brand, memory, skills. Read-only, free. Allowed keys: heist.memory.v1, heist.skills.v1, heist.playbooks.v1, heist.avatars.v1, heist.locations.v1, heist.chats.v1, heist.creations.v1, heist.assets.v1, heist.brand.v1, adInspo.swipefile.v1. (The typed tools — list_memory / list_skills / get_brand — are friendlier for those; use store_get for the rest.)

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Read a workspace store
    • idempotentHint: true
  • submit_tollfree_verificationSubmit a toll-free number's verification so it can text US and Canadian phones: number, businessName, website, email, useCaseCategories / useCase, useCaseSummary, messageSample, op…Reads text others writeNo findings

    Why it is in this group

    • The name "submit_tollfree_verification" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Submit a toll-free number's verification so it can text US and Canadian phones: number, businessName, website, email, useCaseCategories / useCase, useCaseSummary, messageSample, optInType / optInWorkflow, optInImageUrls, messageVolume (e.g. 1,000), and the business address, contact and registration details the provider asks for. Without confirm:true nothing is submitted. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Submit toll-free verification
  • subscribe_linkedin_leadsHave LinkedIn push every new lead to Hermoso the moment it is submitted, and optionally relay each event on to the user’s own CRM.Reads text others writeNo findings

    Why it is in this group

    • The name "subscribe_linkedin_leads" says "subscribe": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Have LinkedIn push every new lead to Hermoso the moment it is submitted, and optionally relay each event on to the user’s own CRM. THE WEBHOOK LINKEDIN VALIDATES IS ALWAYS HERMOSO’S OWN: LinkedIn challenges it with our app secret (and re-challenges every ~2 hours), which no CRM, Zapier or Make endpoint can answer — so never promise a customer URL as the LinkedIn webhook. Pass forwardTo (public HTTPS) to have Hermoso relay each lead event there; leave it off to keep events in Hermoso only (list_linkedin_lead_events). The reply is read back from LinkedIn, not from the 201. Leads stay readable with list_linkedin_leads either way. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn on real-time LinkedIn lead delivery
  • subscribe_meta_webhooksHave Meta PUSH events to Hermoso instead of Hermoso polling for them.Reads text others writeNo findings

    Why it is in this group

    • The name "subscribe_meta_webhooks" says "subscribe": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Have Meta PUSH events to Hermoso instead of Hermoso polling for them. Subscribe a Page to `feed` (comments, posts, likes and shares — this is what makes a new comment ARRIVE rather than be polled for), `mention` (someone mentions the Page), `leadgen` (a lead-ad form submission delivered the moment it happens, which turns "read the leads when asked" into "the leads arrive"), and `messages` (an inbound Messenger or Instagram DM — THE ONLY WAY to be told about one, and Meta’s 24-hour reply window starts the moment it arrives, so being told rather than polling is time on the clock). Read what has arrived with list_meta_webhook_events. THE ANSWER IS READ BACK FROM META, never the 200: Meta can accept a subscription and record FEWER fields than you asked for, and a caller told "subscribed to leadgen" whose leads never arrive has no way to discover why — so any field Meta did not record is named. Fields Hermoso does not consume (message_reactions, messaging_postbacks, message_echoes) are refused by name with the reason, so an agent gets a fact rather than "unsupported". 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Subscribe a Facebook Page to real-time events
  • sync_leads_to_klaviyoPut the leads the brand's LEAD FORMS collected (Meta, LinkedIn, TikTok, X Ads, Snapchat, ChatGPT Ads) into a Klaviyo LIST: each lead with an email becomes a Klaviyo profile (name a…Reads text others writeNo findings

    Why it is in this group

    • The name "sync_leads_to_klaviyo" says "sync": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Put the leads the brand's LEAD FORMS collected (Meta, LinkedIn, TikTok, X Ads, Snapchat, ChatGPT Ads) into a Klaviyo LIST: each lead with an email becomes a Klaviyo profile (name and the form it came from) and joins listId. Nobody is SUBSCRIBED to marketing: a lead form is not consent Hermoso can vouch for, so their consent status is unchanged. Synced leads are remembered per list, so a re-run never repeats a write. since (default 7 days ago), platforms narrows it, dryRun:true lists what would be synced. Needs profiles:write and lists:write on the key. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Sync lead-form leads to a Klaviyo list
  • sync_leads_to_mailchimpPut the leads the brand's LEAD FORMS collected (Meta, LinkedIn, TikTok, X Ads, Snapchat, ChatGPT Ads) into a Mailchimp AUDIENCE: each lead with an email is added with their name.Reads text others writeNo findings

    Why it is in this group

    • The name "sync_leads_to_mailchimp" says "sync": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Put the leads the brand's LEAD FORMS collected (Meta, LinkedIn, TikTok, X Ads, Snapchat, ChatGPT Ads) into a Mailchimp AUDIENCE: each lead with an email is added with their name. By default they are NOT subscribed (a non-marketing 'transactional' contact), because a lead form is not consent Hermoso can vouch for; pass consented:true only when the user confirms the form asked for marketing consent. An existing contact's status is never changed, and synced leads are remembered per audience so a re-run never repeats a write. since (default 7 days ago), platforms narrows it, dryRun:true lists what would be synced. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Sync lead-form leads to a Mailchimp audience
  • telegram_accountACCOUNT-LEVEL numbers for a Telegram channel, group or chat — its SUBSCRIBER / MEMBER COUNT — plus title, @username, description, invite link and linked discussion group.Reads text others writeCan send data outNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.chatId): what the tool writes goes there.
    Description, as the server wrote it
    ACCOUNT-LEVEL numbers for a Telegram channel, group or chat — its SUBSCRIBER / MEMBER COUNT — plus title, @username, description, invite link and linked discussion group. This is the answer to “how many subscribers does our Telegram channel have”. WHICH CHAT IS ALWAYS ASKED FOR: pass chatId (a public channel’s @username, or the numeric id) — the Bot API publishes no method that lists the chats a bot is in, so there is no default and guessing would report another channel’s numbers as this one’s; list_telegram_chats reports any chat that messaged the bot in the last 24 hours. Warning: TELEGRAM HAS NO PER-POST ANALYTICS AT ANY PERMISSION LEVEL: its Message object carries no `views` field and the Bot API has no history method, so post views and a post list are genuinely unavailable to a bot — both come back under `absent` with the reason, and neither is ever reported as zero. The bot must be a member of the chat. Read-only, 0 credits. Needs Telegram connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Telegram channel or group
    • idempotentHint: true
  • test_dm_automationCheck whether a sample comment, mention or DM would trigger a rule (saved by id, or unsaved) on any of the seven channels and exactly what it would send, and how (a DM, or a public…Can send data outNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Check whether a sample comment, mention or DM would trigger a rule (saved by id, or unsaved) on any of the seven channels and exactly what it would send, and how (a DM, or a public reply); on X it also quotes what X charges for the send. Sends nothing. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Test a DM automation
  • test_instagram_dm_automationCheck whether a sample comment or DM would trigger a saved rule and exactly what it would send.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Check whether a sample comment or DM would trigger a saved rule and exactly what it would send. Sends nothing. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Test an Instagram DM automation
  • threads_insightsPerformance 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…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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 CLICKS, follower count, and follower_demographics broken down by country, city, age or gender. Note the two metric sets differ: "clicks" exists only at account level and "shares" only on a single post, and an unknown metric is refused by name rather than dropped. since/until narrow the account window (Threads has no data before 2024-04-13, and followers_count / follower_demographics are lifetime metrics that ignore a window — the reply says so when that happens). Threads returns no demographics below 100 followers; an absent block means the account is under Meta’s floor, NOT that the audience is empty.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Threads insights
    • idempotentHint: true
  • threads_publishing_limitHow 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 R…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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. Check it before any bulk operation, and read it the moment Threads starts refusing: a quota refusal is otherwise indistinguishable from a broken connection or a missing permission, and reconnecting cannot fix it. A number comes back null when Threads did not report it, never as 0 — "none left" and "we could not tell" are different answers. Read-only, 0 credits. Needs Threads connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Threads quota remaining
    • idempotentHint: true
  • tiktok_account_insightsThe connected TikTok account's OWN analytics: follower demographics broken down by AGE, GENDER, COUNTRY and CITY, the daily series (video views, profile views, likes, comments, sha…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The connected TikTok account's OWN analytics: follower demographics broken down by AGE, GENDER, COUNTRY and CITY, the daily series (video views, profile views, likes, comments, shares, reached audience, engaged audience, follower gained/lost/net, and the profile-button clicks a verified Business account collects), and the lifetime counters. TWO PRECONDITIONS TIKTOK ENFORCES ON THE DEMOGRAPHICS, and this tool reports which one is in the way instead of returning an empty breakdown: the account must be a BUSINESS account, and it must have at least 100 FOLLOWERS. Below that TikTok withholds the distributions for privacy, which is not the same as an audience it could not measure. The look-back is capped at 60 DAYS, which is SHORTER than the 90 days the brand-mentions tools cover, and daily numbers lag by up to 48 hours. The bio, verified badge and profile link are deliberately not readable here. That needs a TikTok permission this authorization does not request, and tiktok_account on the TikTok posting connector already returns all three. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the audience-insights permission (tiktok_account_status says whether this profile has it). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok follower demographics and daily performance
    • idempotentHint: true
  • tiktok_category_benchmarkWhat an average TikTok Business account in a given industry looks like: mean likes, comments, shares, video count, follower count, 30-day follower growth, engagement rate and video…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What an average TikTok Business account in a given industry looks like: mean likes, comments, shares, video count, follower count, 30-day follower growth, engagement rate and video views. Pair it with tiktok_account_insights to answer 'are we ahead of our category or behind it', which neither number answers alone. These are TikTok's own cross-account averages, not this brand's numbers. businessCategory must be one of TikTok's twenty-five published values. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok industry averages for a business category
    • idempotentHint: true
  • tiktok_hashtag_suggestionsHashtag ideas for a TikTok caption: 10 suggestions for a keyword, exact matches first and then by how many posts use them, with each tag’s post count.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Hashtag ideas for a TikTok caption: 10 suggestions for a keyword, exact matches first and then by how many posts use them, with each tag’s post count. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok hashtag ideas
    • idempotentHint: true
  • tiktok_mention_top_termsThe top 20 KEYWORDS and the top 20 HASHTAGS appearing in the captions of the posts that mention this brand.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The top 20 KEYWORDS and the top 20 HASHTAGS appearing in the captions of the posts that mention this brand. It is what people say when they talk about it, rather than which posts they said it in. Two TikTok endpoints behind one tool because they take identical parameters and answer the same question at two granularities; kind:'KEYWORDS' or kind:'HASHTAGS' calls only one. Counted across the top 1,000 mentioning posts of the last 90 days, so this is the language of the mentions and not of TikTok at large. Same BUSINESS-account precondition as every mentions tool. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights permission. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: The words and hashtags inside the brand’s TikTok mentions
    • idempotentHint: true
  • tiktok_post_statusFollow a TikTok post that post_to_tiktok sent but TikTok was still processing (it came back pending:true).Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "tiktok_post_status" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "tiktok_post_status" says "post": it sends or publishes something to other people.

    Findings

    • Warn

      The server marks "tiktok_post_status" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "tiktok_post_status" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Follow a TikTok post that post_to_tiktok sent but TikTok was still processing (it came back pending:true). Pass the publishId it returned. Answers one of three states: done (PUBLISH_COMPLETE, with the public `url` once TikTok’s moderation has named it; `urlStatus` is ready, pending, private or draft), failed (with TikTok’s reason), or still processing, which is normal for a few minutes and is NOT a failure. Never post the video again while it is processing. Free, read-only. Needs TikTok connected (Connectors > TikTok).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check whether a TikTok post finished publishing
  • tiktok_spark_recommendationsWhich organic TikTok posts are worth running as Spark Ads: TikTok rates the connected account’s posts HIGH / MEDIUM / LOW, optionally for an objective (REACH, TRAFFIC, VIDEO_VIEWS,…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Which organic TikTok posts are worth running as Spark Ads: TikTok rates the connected account’s posts HIGH / MEDIUM / LOW, optionally for an objective (REACH, TRAFFIC, VIDEO_VIEWS, ENGAGEMENT, APP_PROMOTION, LEAD_GENERATION, WEB_CONVERSIONS, PRODUCT_SALES) and period (PAST_ONE_MONTH / THREE / SIX). Pass ttoAccountId to rate TikTok One creator-marketplace posts instead. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Which TikTok posts to boost
    • idempotentHint: true
  • tiktok_video_insightsPer-POST analytics for the connected TikTok account: views, reach, likes, comments, shares, saves, average watch time, full-watch rate, the RETENTION CURVE (share still watching at…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Per-POST analytics for the connected TikTok account: views, reach, likes, comments, shares, saves, average watch time, full-watch rate, the RETENTION CURVE (share still watching at each second — the hook read), traffic sources (For You, Follow, Search, Sound, profile…), new followers, profile views, website clicks, lead submissions and the audience by country, gender and new-vs-returning. Newest posts first, up to 20 a page (cursor for more), or name videoIds. Data lags 24-48 hours. Needs the TikTok ACCOUNT authorization; an older one says which permission to re-authorize for. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok post insights
    • idempotentHint: true
  • transcribe_callA verbatim transcript of a call recording (callId, optional recordingId), one line per turn, labelled caller and business.Reads text others writeNo findings

    Why it is in this group

    • The name "transcribe_call" says "call": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    A verbatim transcript of a call recording (callId, optional recordingId), one line per turn, labelled caller and business. A transcript the provider already made is returned free; otherwise Hermoso transcribes the audio, which costs credits. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Transcribe a call recording
  • update_creator_campaignChange a campaign's brief, money (budgetUsd: raise only once live; economics while a draft), visibility, usage rights, dates, caps, requirements, hold or sign-up page (page, questi…No findings

    Why it is in this group

    • The name "update_creator_campaign" says "update": a word for a change.
    Description, as the server wrote it
    Change a campaign's brief, money (budgetUsd: raise only once live; economics while a draft), visibility, usage rights, dates, caps, requirements, hold or sign-up page (page, questions, slug), Everything stays editable while live: a change to pay, the hold or usage rights becomes a new terms version (the answer says who it applies to). Status: active (live: creators can join and submit), paused (no new posts; tracking continues), closed (the join link stops, no new posts or views count, approved earnings stay payable, a pool campaign splits its pool among approved posts by views; a budget is a limit, so nothing is refunded) or reopen (a closed campaign goes live again, or back to draft if it never went live; not possible once a pool share was paid). CLOSE AND REOPEN ARE CONFIRM-GATED: without confirm:true nothing changes and the answer lists exactly what the step does; show the user, then call again with confirm:true. A closed campaign's settings are read-only until it is reopened. The budget can go down only to what creators already earned.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Change a creator campaign, or set it live, paused, closed or reopened
  • update_discord_threadChange a Discord thread: archived (true closes it out of the channel list, false reopens it), locked (true means only moderators can reopen it), name, autoArchiveMinutes (60, 1440,…Reads text others writeNo findings

    Why it is in this group

    • The name "update_discord_thread" says "update": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Discord thread: archived (true closes it out of the channel list, false reopens it), locked (true means only moderators can reopen it), name, autoArchiveMinutes (60, 1440, 4320, 10080) or slowmodeSeconds. Archiving and locking can be reversed by calling this again. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Archive, lock or rename a Discord thread
  • update_mailchimp_campaignEdit a Mailchimp campaign that is still a DRAFT: name, subject, previewText, fromName, replyTo, templateId, or its audience / segment.Reads text others writeNo findings

    Why it is in this group

    • The name "update_mailchimp_campaign" says "update": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit a Mailchimp campaign that is still a DRAFT: name, subject, previewText, fromName, replyTo, templateId, or its audience / segment. A scheduled one must be unscheduled first (cancel_mailchimp_campaign). Read back with its send checklist. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Update a Mailchimp campaign draft
  • update_mailchimp_templateReplace a Mailchimp template's HTML (Mailchimp's update replaces the whole template, so pass the full html), optionally with a new name.Reads text others writeNo findings

    Why it is in this group

    • The name "update_mailchimp_template" says "update": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Replace a Mailchimp template's HTML (Mailchimp's update replaces the whole template, so pass the full html), optionally with a new name. The unsubscribe footer is added if the html has none. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Update a Mailchimp template
  • update_voice_agentChange fields of a voice agent: prompt, firstMessage, voiceId, llm, language, maxDurationSeconds, outcomeFields, successCriteria, name, or any platform field through raw.Reads text others writeNo findings

    Why it is in this group

    • The name "update_voice_agent" says "update": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change fields of a voice agent: prompt, firstMessage, voiceId, llm, language, maxDurationSeconds, outcomeFields, successCriteria, name, or any platform field through raw. Only what is passed changes. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Update a voice agent
  • upgrade_planChange the SUBSCRIPTION plan (admin only).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change the SUBSCRIPTION plan (admin only). No argument lists the monthly plans. Basic ($19.99) is the posting plan: Autopilot, plus unlimited posting and scheduling with NO monthly credits (it includes the same 160+ free credits as the Free plan, and monthly credits start on Starter). Starter, Pro and Studio include monthly credits and no markup on models. Every paid plan posts without a limit (Free: 5 posts a month on 3 channels). New subscriber: a Checkout URL for the human. Existing subscriber upgrading: a quote + quote_token; once the human agrees, call again with confirm:true and quote_token to charge the card on file. Downgrade: a billing-page link; it starts at the term's end.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upgrade plan
  • upload_filePersist 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 acc…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_file" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    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. Kept in the Library. THIS IS THE BRING-YOUR-OWN-CREATIVE PATH: it is for files that have NOTHING to do with a Hermoso render (media on the user's desktop, an agency's finished ad, a photo they shot), and it means you can publish, schedule and run ads through Hermoso without generating anything here. Provide exactly ONE source — passing two is an error, never a silent preference: `url` (ANY public http(s) link — Hermoso fetches it server-side, so nothing crosses this connection and there is no practical size limit; THIS IS THE ONE THAT ALWAYS WORKS, including on the hosted connector), `dataUri` (a base64 data: URI — keep it under ~15MB, since the bytes travel over this connection). If the file is already at a public https URL, the Meta, Reddit and ChatGPT-Ads tools take it directly and re-host it safely. When in doubt, use this: its URL works everywhere. (Calling the underlying HTTP route directly? POST /api/upload takes the file's RAW BYTES as the request body with its own content-type — NOT multipart/form-data — or ?url=<link> with no body.) Returns {url, kind, bytes}.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a local file -> durable public URL
  • upload_klaviyo_imagePut a picture into the brand's Klaviyo IMAGE LIBRARY for use in emails: a Hermoso render or Library id (list_library gives L0, L1…), a Hermoso link, an upload_file URL, or a public…Reads text others writeNo findings

    Why it is in this group

    • The name "upload_klaviyo_image" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Put a picture into the brand's Klaviyo IMAGE LIBRARY for use in emails: a Hermoso render or Library id (list_library gives L0, L1…), a Hermoso link, an upload_file URL, or a public https image link (Klaviyo fetches an outside link itself). Klaviyo takes JPEG, PNG or GIF up to 5 MB, so another format or a bigger file is converted to a JPEG first; a video is refused. Returns Klaviyo's own image row (id and hosted URL). create_klaviyo_template uploads its image itself, so call this only to stock the library. Free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload an image to Klaviyo
  • upload_mailchimp_imagePut a picture into the brand's Mailchimp FILE MANAGER for use in emails: a Hermoso render or Library id (list_library gives L0, L1...), a Hermoso link, or an upload_file URL (for a…Reads text others writeNo findings

    Why it is in this group

    • The name "upload_mailchimp_image" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Put a picture into the brand's Mailchimp FILE MANAGER for use in emails: a Hermoso render or Library id (list_library gives L0, L1...), a Hermoso link, or an upload_file URL (for an outside picture, call upload_file first). JPEG, PNG and GIF go up as they are; another format or a file over 5 MB is converted to a JPEG first; a video is refused. Returns Mailchimp's own file row (id and hosted URL). create_mailchimp_template uploads its image itself, so call this only to stock the File Manager. Free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload an image to Mailchimp
  • upload_tiktok_comment_imageTurn a public image URL into the imageUri that comment_on_tiktok_video needs — TikTok will not take a raw URL on a new comment, only on a reply.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_tiktok_comment_image" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "upload_tiktok_comment_image" says "upload" and "comment": it writes something other people read.
    Description, as the server wrote it
    Turn a public image URL into the imageUri that comment_on_tiktok_video needs — TikTok will not take a raw URL on a new comment, only on a reply. Returns imageUri, imageWidth and imageHeight, and ALL THREE must be passed back together: TikTok rejects dimensions that do not match what it stored. Limits are TikTok's own — at most 5 MB, JPG/JPEG/PNG/WebP, between 360x360 and 1080x1920 (or 1920x1080). upload_file turns a local file into a URL this accepts. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Upload an image for a TikTok comment
    • idempotentHint: false
  • use_brandPin which profile this connection acts on.No findings

    Why it is in this group

    • The description's first verb is "pin": a word for a change.
    Description, as the server wrote it
    Pin which profile this connection acts on. Pass the profile id or exact name from list_brands. Works for your own profiles AND one another account SHARED with you (pass its name or the profile id list_brands prints); access is verified against your real membership before it is pinned. Persists for this API key until changed, on every surface (hosted connector included — no environment variables, no restart). On a signed-in connector it also moves every other Hermoso connector the same person signed in from the same app (e.g. all the Hermoso connectors in Claude), so they act on one profile.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Switch profile
  • x_accountACCOUNT-LEVEL numbers for the connected X account — FOLLOWERS, following, total posts, listed count, media count — plus display name, bio, location, verified status and when the ac…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ACCOUNT-LEVEL numbers for the connected X account — FOLLOWERS, following, total posts, listed count, media count — plus display name, bio, location, verified status and when the account was created. This is the tool for “how many followers do we have on X”, “is our X growing”, or to confirm whose account is linked before posting; for a single post use x_post_metrics or x_post_insights instead. A counter X does not return comes back under `absent` with the reason and is NEVER reported as zero. Read-only. Rides the account lookup Hermoso already makes when it posts — X bills per request and not per field — so it costs at most one User: Read and is free on a cached lookup. Needs X connected (Connectors > X).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the connected X account
    • idempotentHint: true
  • x_chat_settingsThe connected X account's X Chat (direct message) PRIVACY SETTINGS: who can message the brand (allowDmsFrom: all / verified / following), whether subscribers can always message it,…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The connected X account's X Chat (direct message) PRIVACY SETTINGS: who can message the brand (allowDmsFrom: all / verified / following), whether subscribers can always message it, the low-quality request filter, read receipts, and audio/video call permissions. Use it before changing them with update_x_chat_settings, or to answer 'can customers DM us on X'. Read-only. Needs X connected with direct-message access: an X connection made before 2026-08-25 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read the X Chat privacy settings
  • x_followsThe follower or following LIST for an X account — handles, names, bios, locations and each one’s own follower/following/post counts.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The follower or following LIST for an X account — handles, names, bios, locations and each one’s own follower/following/post counts. The COUNTS are already free on x_account and x_user; this is WHO, which is what audience analysis and creator vetting actually need. With no username it reads the CONNECTED account (“who follows us”); pass a handle to read anyone public (“who follows our competitor”). Warning: NEEDS THE follows.read PERMISSION, added 2026-08-31: an X connection authorized before that date does NOT carry it and cannot have it added — the tool says so and asks for a reconnect rather than surfacing X’s raw refusal. Default 20, max 100 per call (X bills per account returned); page with nextToken. Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Who follows an X account (or who it follows)
    • idempotentHint: true
  • x_post_insightsAdvertiser-grade analytics for the connected account’s OWN posts on X — impressions, engagements, LINK CLICKS, profile visits, video views and video completion quartiles.Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "x_post_insights" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "x_post_insights" says "post": it sends or publishes something to other people.

    Findings

    • Warn

      The server marks "x_post_insights" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "x_post_insights" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Advertiser-grade analytics for the connected account’s OWN posts on X — impressions, engagements, LINK CLICKS, profile visits, video views and video completion quartiles. This is the read that answers “did the creative work”, which x_post_metrics cannot: public metrics show likes and reposts, never clicks or video retention. Takes up to 25 post ids in one call. COSTS CREDITS PER POST READ, so ask about the posts that matter rather than everything. If X returns no rows, say so — that is missing data, not zero performance. Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Advertiser analytics for your own posts on X
    • idempotentHint: true
  • x_post_insights_historicalThe same advertiser-grade X analytics as x_post_insights — impressions, engagements, LINK CLICKS, profile visits, video views and video completion quartiles — over ANY date range i…Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "x_post_insights_historical" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "x_post_insights_historical" says "post": it sends or publishes something to other people.

    Findings

    • Warn

      The server marks "x_post_insights_historical" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "x_post_insights_historical" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    The same advertiser-grade X analytics as x_post_insights — impressions, engagements, LINK CLICKS, profile visits, video views and video completion quartiles — over ANY date range instead of only the last 28 hours. This is the one to use for “how did last week’s post do”, “compare these three posts over the month”, or any retrospective: x_post_insights physically cannot see past yesterday, so asking it about an older post returns nothing and that is not zero performance. Takes up to 25 post ids at once; the window defaults to the last 28 days when you name none, and the window actually queried is reported back. COSTS CREDITS PER POST READ — X bills us per API call — so say the cost before pulling a big batch and ask about the posts that matter. Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Advertiser analytics for your own X posts, over any date range
    • idempotentHint: true
  • x_post_metricsTHE X ANALYTICS TOOL THAT WORKS — impressions, likes, reposts, replies, quotes and bookmarks for any post, PLUS the advertiser numbers (link clicks, profile clicks, engagements) fo…Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "x_post_metrics" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "x_post_metrics" says "post": it sends or publishes something to other people.

    Findings

    • Warn

      The server marks "x_post_metrics" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "x_post_metrics" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    THE X ANALYTICS TOOL THAT WORKS — impressions, likes, reposts, replies, quotes and bookmarks for any post, PLUS the advertiser numbers (link clicks, profile clicks, engagements) for YOUR OWN posts published in the last 30 days. X serves those private metrics on this same lookup with the user-context connection you already have; that is X's own design, not a workaround. Use this rather than x_post_insights, whose endpoint family X has retired. If a post is deleted, protected or suspended, X answers with no data at all and this says so — that is MISSING DATA, never zero engagement, and must never be reported as a measured zero. Costs a small number of credits (X bills per API read). Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read performance of a post on X
    • idempotentHint: true
  • x_userACCOUNT-LEVEL numbers for ANY public X account by handle — followers, following, posts, listed and media counts, plus bio, location, verified status and account age.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ACCOUNT-LEVEL numbers for ANY public X account by handle — followers, following, posts, listed and media counts, plus bio, location, verified status and account age. Reads any public X account (x_account reads the connected one): use this to size a competitor or vet a creator before working with them. Returns the identical shape as x_account, so the two are never described differently, and a counter X does not return is reported as unknown rather than zero. Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up any public X account
    • idempotentHint: true
  • youtube_bulk_reportTHE ONLY PLACE YOUTUBE PUBLISHES THUMBNAIL IMPRESSIONS AND THUMBNAIL CTR.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE ONLY PLACE YOUTUBE PUBLISHES THUMBNAIL IMPRESSIONS AND THUMBNAIL CTR. This is a different API from youtube_channel_report — YouTube’s bulk Reporting API — and for a product that generates thumbnails it is the number that says whether the thumbnail actually worked. Reports: thumbnails (impressions + CTR per video per day) · thumbnails_by_source (the same, split by traffic source, traffic source DETAIL, device and OS) · cards (per-card impressions, clicks and click rate by card_id) · end_screens (per end-screen element) · traffic_source (with the UNCAPPED traffic_source_detail — youtube_channel_report caps that at 25 rows) · basic. IT IS SCHEDULED, NOT ON-DEMAND, AND THIS IS THE ONE THING YOU MUST EXPLAIN TO THE USER: the first call SCHEDULES a job and returns NO DATA. YouTube then writes one CSV per 24-hour Pacific day — the first within 48 hours — plus a backfill of the 30 days before scheduling, and files expire after 60 days. It can NEVER answer about a period before the job existed, so "we have no thumbnail history yet" is a real and correct answer on day one. An unknown report name is refused with the list. Zero rows means missing data for that window, never zero impressions. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: YouTube bulk report (thumbnail CTR, cards, end screens)
    • idempotentHint: false
  • youtube_channel_reportThe YouTube Analytics reports that say WHERE views came from, WHO watched and WHERE they stopped watching — the questions youtube_channel (totals) and youtube_video_insights (one v…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The YouTube Analytics reports that say WHERE views came from, WHO watched and WHERE they stopped watching — the questions youtube_channel (totals) and youtube_video_insights (one video, flat) cannot answer. Pick a report: day / month (time series) · country / province (US states) / city / dma (geography) · trafficSource (search vs browse vs suggested vs shorts feed vs external — the single most useful one for judging a thumbnail and title) · trafficSourceDetail (the actual search terms, inside ONE source — pass parent, e.g. "YT_SEARCH") · playbackLocation / playbackLocationDetail (which sites embedded it) · device / operatingSystem · demographics (age + gender) · sharingService · subscribedStatus · audienceRetention (the drop-off CURVE, 100 points across ONE video — the read that tells you whether the hook held and exactly when people left) · topVideos (the channel’s best in the window) · contentType (SHORTS vs long-form vs live; contentType:"shorts" narrows most reports to Shorts, and engagedViews — views past the first frame — is the honest Shorts number). Scope it to one or more videoIds, or omit for the whole channel. An unknown report name is refused WITH the list rather than quietly swapped. TWO THINGS TO SAY OUT LOUD WHEN REPORTING: demographics returns viewerPercentage and NOTHING else — YouTube publishes no absolute demographic counts, so never convert it into a number of viewers — and a capped report (city 250, topVideos 200, the *Detail reports 25) is the TOP N, not the whole set. Zero rows means missing data for that window, never zero views. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: YouTube analytics broken down by dimension
    • idempotentHint: true
  • youtube_video_insightsPer-VIDEO performance for a video on the connected channel — views, estimated minutes watched, average view duration, average view PERCENTAGE (the retention number that tells you w…Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Per-VIDEO performance for a video on the connected channel — views, estimated minutes watched, average view duration, average view PERCENTAGE (the retention number that tells you whether the hook held), likes, comments, shares and subscribers gained. Use it for "how did that video do", "which upload performed best", or to judge an ad before spending more behind it. youtube_channel only returns channel-wide totals and cannot answer this. Defaults to the last 28 days; pass startDate/endDate (YYYY-MM-DD) for another window. Read-only, 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Performance of one of your YouTube videos
    • idempotentHint: true
Only reads 201Show 201 read-only tools
  • billing_statusShow 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 (…Reads private dataNo findings

    Why it is in this group

    • The name "billing_status" says "status": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "show" and "file": it reads files.
    Description, as the server wrote it
    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 ADMIN rights to change billing. Read-only, free. Call it before upgrade_plan / set_auto_reload to know what's possible — members have read-only billing. IN A SHARED TEAM WORKSPACE A MEMBER SEES THE PLAN AND THE BALANCE ONLY: the workspace owner's payment card and auto-reload belong to them and are not reported (billingScope:'member'). Never tell a member there is no card on file — the honest answer is that you cannot see it. plan.memberRate: media models at cost + 10%; plan.legacy: an older plan kept at its price. posting: this month's posting allowance ("N of 5 posts used this month" on Free, unlimited on every paid plan).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Billing status
    • idempotentHint: true
  • fetch_assetResolve a generated asset reference (a /generated/… path or any URL) to a clickable absolute URL + a direct download URL.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "fetch_asset" says "fetch": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "resolve" and "url": it reads web pages, which anyone can write.
    • untrusted-inputThe input takes a URL (input.url), and the tool reads it: it reads web pages, which anyone can write.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.

    Claude Code: ask, because it is tagged outbound.

    Description, as the server wrote it
    Resolve a generated asset reference (a /generated/… path or any URL) to a clickable absolute URL + a direct download URL.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Fetch asset
    • idempotentHint: true
  • find_instagram_marketplace_creatorsSEARCH 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…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "find_instagram_marketplace_creators" says "find": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "search" and "directory": it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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. Use it when the user wants creators with first-party data (followers, audience, badges such as Partnership ads / Branded content / Strong hooks / Responsive, marketplace email) or Meta's recommendations. Search by query (keywords), by similarTo (up to 5 handles, not with query), by recommendation (most_relevant_for_me, high_ad_performance, most_ads_experience, similar_brands, similar_audience, interested_in_collaboration), or filters on the creator (countries, states with exactly one country, minFollowers/maxFollowers bands, ageBucket, gender, up to 5 interests, minEngaged/maxEngaged, language, followerGrowth, lastPostWithin, verifiedAccount, hasPortfolio, hasPublicContactEmail, featuredInPaidAds, excludeMessagedCreators) and their audience (audienceCountries, audienceStates, audienceAgeBucket, audienceGender, audienceDevices), or customAudienceId from list_instagram_marketplace_audiences. Username looks up one creator (no other filter allowed). Needs the Meta (Facebook Login) connector with the Page linked to the brand's Instagram, and Meta's instagram_creator_marketplace_discovery permission; when it cannot run it says exactly why and what fixes it, and when the reason is that Meta has not approved Hermoso's app for that permission yet (read LIVE from Meta, and named under Meta by list_connectors) it says so: that is Meta's decision about Hermoso, never a reason to tell the user to reconnect. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search Instagram’s creator marketplace
    • idempotentHint: true
  • find_toolsSearch EVERY Hermoso tool — your starting list is deliberately short, and everything else in the product is here — by name, task or group.No findings

    Why it is in this group

    • The name "find_tools" says "find": a word for reading.
    Description, as the server wrote it
    Search EVERY Hermoso tool — your starting list is deliberately short, and everything else in the product is here — by name, task or group. Each row gives the tool's PARAMETERS in one line, its CREDIT COST (free means free on every plan; a tool that runs a model quotes the live per-model figure) and its recent HEALTH on this server (failure rate and typical duration, or "no recent calls", which means unseen and not broken). Use it the moment the user asks for something you do not see a tool for (a campaign, an ad set, a lead form, a click-to-WhatsApp ad, a report, keywords, audiences): a tool missing from your list is NEVER proof the feature is missing. Then RUN the tool you found with call_tool({name, args}): search, then run, two calls for any tool in the product. A tool that is failing or needs a connector this workspace has not made is ranked last and marked, never hidden — pass onlyHealthy:true if you want those left out. Free, read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Find a Hermoso tool by name or task
  • get_brandWhat Hermoso ALREADY KNOWS for the active profile: the same saved profile (products, logos, palette, fonts, positioning) + learned memory the web Studio uses.Reads text others writeNo findings

    Why it is in this group

    • The name "get_brand" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "web": it reads web pages, which anyone can write.
    Description, as the server wrote it
    What Hermoso ALREADY KNOWS for the active profile: the same saved profile (products, logos, palette, fonts, positioning) + learned memory the web Studio uses. Call it when you need to know whether a brand is on file: if hasBrand is true you can omit brand everywhere; if false, onboard with draft_brand. Not a required first step before a render: the create tools read the saved brand by themselves. 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Get saved profile
    • idempotentHint: true
  • get_business_locationRead everything Google holds on one of the brand’s Google Business Profile listings — business name, address, phone numbers, website, categories, description, regular and special h…Reads text others writeNo findings

    Why it is in this group

    • The name "get_business_location" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "website": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Read everything Google holds on one of the brand’s Google Business Profile listings — business name, address, phone numbers, website, categories, description, regular and special hours, service area, labels, store code, open state, and whether the listing can carry a Post at all. This is the listing AS THE MERCHANT LAST SET IT, which is exactly what update_business_location edits; it can differ from what Google Maps shows today, because Google and the public can suggest changes on top. Call it before offering to change anything, and to answer “what does our Google listing actually say?”. Read-only, 0 credits. Needs Google Business Profile connected (Connectors > Google Business Profile).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Google Business Profile listing
    • idempotentHint: true
  • get_credit_limitsMonthly credit limits and this month’s usage, per brand and per member of a shared brand.No findings

    Why it is in this group

    • The name "get_credit_limits" says "get": a word for reading.
    Description, as the server wrote it
    Monthly credit limits and this month’s usage, per brand and per member of a shared brand. Credits belong to the account and every brand spends the same balance; the account owner can cap what one brand, or one invited person, spends in a calendar month (UTC, resets on the 1st). The owner sees every brand; inside a shared brand an admin sees that brand and its members, a member sees the brand and their own limit. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Credit limits
    • idempotentHint: true
  • get_discord_messageRead back a Discord message: text, embeds, poll or poll result, what kind it is, who posted it, link and REACTIONS (Discord has no view count).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_discord_message" says "get": a word for reading.

    What it can reach

    • private-dataThe name "get_discord_message" says "get" and "message": it reads messages.
    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_discord_message" says "get" and "message": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Read back a Discord message: text, embeds, poll or poll result, what kind it is, who posted it, link and REACTIONS (Discord has no view count). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Discord announcement
  • get_discord_pollRead a Discord poll's results: the question, each answer with its vote count, whether it is still open and when it closes.Reads text others writeNo findings

    Why it is in this group

    • The name "get_discord_poll" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read a Discord poll's results: the question, each answer with its vote count, whether it is still open and when it closes. voters:true also lists who voted for each answer (first 100 each). Discord sometimes leaves the counts out of a read; that is reported as unknown, never as zero votes. Needs the Hermoso bot. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Discord poll
  • get_drive_fileFetch one Drive file’s metadata — name, type, size, modified time, a webViewLink to open it and a webContentLink to download it.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_drive_file" says "get": a word for reading.

    What it can reach

    • private-dataThe name "get_drive_file" says "get" and "drive": it reads files.
    • private-dataThe description's first sentence says "fetch" and "drive": it reads files.
    • private-dataThe input names a file (input.fileId), and the tool reads: it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "fetch" and "web": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Fetch one Drive file’s metadata — name, type, size, modified time, a webViewLink to open it and a webContentLink to download it. Pass fileId (from list_drive_files). Read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Get a Drive file’s details
    • idempotentHint: true
  • get_instructionsFree.No findings

    Why it is in this group

    • The name "get_instructions" says "get": a word for reading.
    Description, as the server wrote it
    Free. Hermoso's instructions on demand: a topic (areas, instagram, capabilities, roster, safety, credits, setup, all) for the rest of the session instructions, any tool's name for its FULL rules, or "paid-calls" for get_cost, expected_credits, idempotency_key, revision and context.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Read Hermoso's full instructions
  • get_jobPoll a render job by id.No findings

    Why it is in this group

    • The name "get_job" says "get": a word for reading.
    Description, as the server wrote it
    Poll a render job by id. Returns status (queued|running|done|error), progress, and on done the served media URL. Renders take 1–3 minutes: keep calling this until done/error without asking the user — several calls is normal, not a stall. An id that does not exist on this account answers status "not_found" — that is FINAL: stop polling it, and do not re-fire the render (that double-charges).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Get render job
    • idempotentHint: true
  • get_linkedin_leadOne LinkedIn lead by id (from list_linkedin_leads), with every answer named by field.Reads text others writeNo findings

    Why it is in this group

    • The name "get_linkedin_lead" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One LinkedIn lead by id (from list_linkedin_leads), with every answer named by field. Personal data — show, never republish. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read one LinkedIn lead
  • get_messenger_marketing_message_statusWhether a paid Messenger marketing message was delivered.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_messenger_marketing_message_status" says "get": a word for reading.

    What it can reach

    • private-dataThe name "get_messenger_marketing_message_status" says "get" and "message": it reads messages.
    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_messenger_marketing_message_status" says "get" and "message": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Whether a paid Messenger marketing message was delivered. send_messenger_marketing_message returns a tracking id, which only means Meta ACCEPTED it; this reads what Meta pushed back on the Page webhook for each tracking id: sent, delivered (the event Meta bills on), read, clicked (with count), or failed (with Meta’s reason). "unknown" means NO event has arrived, never that it failed: events arrive only when the Page is subscribed to the marketing_message_* fields (the reply says whether it is, read back from Meta; fix with subscribe_meta_webhooks fields ["marketing_messages"]) and only for messages sent after Hermoso began recording them on 2026-09-22. A failure carries no tracking id, so it is matched through Hermoso’s own send log. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Did a Messenger marketing message land?
    • idempotentHint: true
  • get_meta_storyWhat 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 expire…Reads private dataReads text others writeCan send data outNo findings

    Why it is in this group

    • The name "get_meta_story" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "inbox": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "reply": it reads comments, which other people can write.
    • untrusted-inputThe input takes a URL (input.url), and the tool reads it: it reads web pages, which anyone can write.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.

    Claude Code: ask, because it is tagged outbound.

    Description, as the server wrote it
    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. `state` is live, readable, not_a_story, expired, not_found or unknown. Meta serves a Story for 24 hours and answers an expired one with the same error as a wrong id, so pass repliedAt (the item’s `at`) and the url so an expiry can be stated and a match found. unknown means a read failed, not that the Story is gone. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up one Story by id
    • idempotentHint: true
  • get_onedrive_fileFetch one OneDrive item’s metadata — name, type, size, modified time, a webViewLink to open it and a webContentLink to download it.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_onedrive_file" says "get": a word for reading.

    What it can reach

    • private-dataThe name "get_onedrive_file" says "get" and "file": it reads files.
    • private-dataThe description's first sentence says "fetch" and "drive": it reads files.
    • private-dataThe input names a file (input.fileId), and the tool reads: it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "fetch" and "web": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Fetch one OneDrive item’s metadata — name, type, size, modified time, a webViewLink to open it and a webContentLink to download it. Pass fileId (from list_onedrive_files). Read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Get a OneDrive file’s details
    • idempotentHint: true
  • get_port_orderOne port order in full: status, numbers, the move date, and for an exception exactly what to fix (the fields to correct or the document to upload again).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_port_order" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "document": it reads documents.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One port order in full: status, numbers, the move date, and for an exception exactly what to fix (the fields to correct or the document to upload again). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Get a port order
  • get_post_refillShow 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 fr…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_post_refill" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "show" and "note": it reads notes.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_post_refill" says "get" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "show" and "review": it reads comments, which other people can write.
    Description, as the server wrote it
    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 drafts for approval; auto = fresh posts are scheduled straight away), WHICH CHANNELS it posts to with each one’s posts per day and posting times, roughly what it costs a day, when it next runs, how many posts are queued, the DRAFTS waiting for approval (id, time, channels, caption, the new image or video), and the notes it learned from reviews. It also names the channels that CANNOT be posted to and why. On the Free plan, paidOnly is true and note explains the status. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Autopilot posting status
    • idempotentHint: true
  • get_settingsRead this account's app settings — the LANGUAGE Hermoso writes ads and copy in (chat replies follow the language the user writes in), the app appearance (theme), and which Hermoso …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_settings" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "chat": it reads messages.
    • untrusted-inputThe description's first sentence says "read" and "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Read this account's app settings — the LANGUAGE Hermoso writes ads and copy in (chat replies follow the language the user writes in), the app appearance (theme), and which Hermoso emails are on (tips, product news, credit and plan notices, competitor watch, autopilot reviews, weekly posts, and the all-emails switch). Same settings as the web app's Settings pane. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Read app settings
    • idempotentHint: true
  • get_shopify_articleRead one Shopify blog article back: Shopify's own title, status, public address, excerpt, body, tags and search title and description.Reads text others writeNo findings

    Why it is in this group

    • The name "get_shopify_article" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read one Shopify blog article back: Shopify's own title, status, public address, excerpt, body, tags and search title and description. Use it to confirm an article really published. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Shopify blog article
  • get_shopify_inventoryStock on the merchant's Shopify store per variant and location: available, on hand, committed to orders and incoming.Reads text others writeNo findings

    Why it is in this group

    • The name "get_shopify_inventory" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Stock on the merchant's Shopify store per variant and location: available, on hand, committed to orders and incoming. Pass productId (every variant of it), variantId or sku. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Get Shopify stock
  • get_skillLoad a bundled skill’s full SKILL.md workflow instructions by name (from list_skills), or a built-in in-app skill by its id (e.g.No findings

    Why it is in this group

    • The name "get_skill" says "get": a word for reading.
    Description, as the server wrote it
    Load a bundled skill’s full SKILL.md workflow instructions by name (from list_skills), or a built-in in-app skill by its id (e.g. youtube_script, retention_skeleton). Follow the loaded instructions to run that workflow with the other tools. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Get skill
    • idempotentHint: true
  • get_slack_messageRead back a Slack message the Hermoso app posted: text, link, REACTIONS and thread REPLIES — the engagement Slack exposes (there is no view count).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_slack_message" says "get": a word for reading.

    What it can reach

    • private-dataThe name "get_slack_message" says "get" and "message": it reads messages.
    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_slack_message" says "get" and "message": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Read back a Slack message the Hermoso app posted: text, link, REACTIONS and thread REPLIES — the engagement Slack exposes (there is no view count). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Slack message
  • get_sms_statusThe delivery status of one message send_sms sent (queued, sent, delivered, undelivered, failed …) with the provider's error in words, read live from Twilio or Telnyx.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_sms_status" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The delivery status of one message send_sms sent (queued, sent, delivered, undelivered, failed …) with the provider's error in words, read live from Twilio or Telnyx. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: SMS delivery status
  • get_tiktok_mentionRead the full detail of a SINGLE mention: a mentioning post, or a mentioning comment if you pass commentId as well.Reads text others writeNo findings

    Why it is in this group

    • The name "get_tiktok_mention" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_tiktok_mention" says "get" and "mention": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "mention": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the full detail of a SINGLE mention: a mentioning post, or a mentioning comment if you pass commentId as well. This exists for the TikTok mentions WEBHOOK: the event carries only ids, and this turns one into the caption, the creator, the engagement and the thumbnail. TIKTOK ONLY GUARANTEES THE DATA FOR 48 HOURS after the event fires, so a queue that retries tomorrow gets nothing. For anything older read it out of list_tiktok_mentions or list_tiktok_mention_comments instead. itemId is required either way, comment or not. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights permission. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read one mention from the TikTok mentions webhook
    • idempotentHint: true
  • get_tiktok_post_ad_authorizationRead the Spark-Ads authorization status of a post the authorized account owns — whether it is promotable, its authorization CODE, and the window the authorization runs for.Reads text others writeNo findings

    Why it is in this group

    • The name "get_tiktok_post_ad_authorization" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_tiktok_post_ad_authorization" says "get" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Read the Spark-Ads authorization status of a post the authorized account owns — whether it is promotable, its authorization CODE, and the window the authorization runs for. A SPARK AD CANNOT OUTLIVE ITS AUTHORIZATION, so check the end time before building a campaign around a post. TIKTOK ERRORS RATHER THAN ANSWERING when a post has no authorization code at all, so a not-found style refusal from here almost always means Ad authorization was never turned on (or the code was deleted) — turn it on with set_tiktok_post_ad_authorization — and not that anything is broken. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a post’s Spark-Ads authorization status
    • idempotentHint: true
  • get_voice_agentOne voice agent in full: its instructions, first line, voice, model, language, longest call and where it reports calls.Reads text others writeNo findings

    Why it is in this group

    • The name "get_voice_agent" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One voice agent in full: its instructions, first line, voice, model, language, longest call and where it reports calls. includeRaw:true adds the platform's own record. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a voice agent
  • get_voice_agent_callOne voice-agent call in full: the transcript turn by turn, the summary, the structured outcome the agent pulled out, whether it met its goal, why it ended, its cost on the platform…Reads text others writeNo findings

    Why it is in this group

    • The name "get_voice_agent_call" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One voice-agent call in full: the transcript turn by turn, the summary, the structured outcome the agent pulled out, whether it met its goal, why it ended, its cost on the platform and a link to play the recording through Hermoso. callId from list_voice_agent_calls or the call inbox. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a voice-agent call
  • get_webflow_itemRead one Webflow blog item back: Webflow's own title, status, public address, body and every field of the item.Reads text others writeNo findings

    Why it is in this group

    • The name "get_webflow_item" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read one Webflow blog item back: Webflow's own title, status, public address, body and every field of the item. Use it to confirm a post really published. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Webflow blog item
  • get_wix_blogThe brand's Wix blog at a glance: its categories and tags, each with its id and post count, and which site member new posts are credited to.Reads text others writeNo findings

    Why it is in this group

    • The name "get_wix_blog" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The brand's Wix blog at a glance: its categories and tags, each with its id and post count, and which site member new posts are credited to. Use it before choosing categories by name. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read the Wix blog’s categories and tags
  • get_wix_postRead one Wix blog post back: Wix's own title, status, public address, excerpt and the words of its body.Reads text others writeNo findings

    Why it is in this group

    • The name "get_wix_post" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_wix_post" says "get" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Read one Wix blog post back: Wix's own title, status, public address, excerpt and the words of its body. Use it to confirm a post really published. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Wix blog post
  • get_wordpress_postRead one WordPress post back — WordPress's own title, status, live URL, excerpt and body.Reads text others writeNo findings

    Why it is in this group

    • The name "get_wordpress_post" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_wordpress_post" says "get" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Read one WordPress post back — WordPress's own title, status, live URL, excerpt and body. Use it to confirm a post really published. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a WordPress post
  • google_business_accountRead the Google Business Profile ACCOUNT that owns one of the brand’s listings — the account name, its type (a personal Google account, a location group, a user group or an organiz…Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the Google Business Profile ACCOUNT that owns one of the brand’s listings — the account name, its type (a personal Google account, a location group, a user group or an organization), the connected user’s role on it (primary owner / owner / manager / site manager), the account’s verification state and the permission level. Use it to answer “can we actually edit this listing?” and “whose account is it on?” before offering an edit that Google would refuse anyway. It reads exactly ONE account — the parent of a listing already shared with this profile — and never lists the other accounts the connected Google login can reach; that roster belongs to the account picker (list_connector_accounts). Read-only, 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Google Business Profile account for a listing
    • idempotentHint: true
  • google_business_search_keywordsThe actual search terms people typed on Google Search and Maps before this business listing appeared — the only keyword data a local business gets for free, and the direct input to…Reads text others writeNo findings

    Why it is in this group

    • The name "google_business_search_keywords" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The actual search terms people typed on Google Search and Maps before this business listing appeared — the only keyword data a local business gets for free, and the direct input to their Google Ads keyword set, page titles and profile description. google_business_insights answers HOW MANY people found the listing; this answers WHICH WORDS they used. Warning: LOW-VOLUME TERMS ARE SUPPRESSED: Google withholds an exact count for them and returns only an upper bound, so those rows come back with impressions=null and below=<threshold>. Report those as “fewer than N” — NEVER as zero and never as the threshold itself, both of which are numbers a marketer would act on and neither is true. Counts are UNIQUE USERS per month summed across the window, not impressions; the two are not comparable. Google keeps roughly 12 months of history. Read-only, 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What people searched to find this business
    • idempotentHint: true
  • hermoso_creditsReturn the credit balance, recent priced calls with their credits, and costModel (the one-sentence rule of what costs credits).No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    Return the credit balance, recent priced calls with their credits, and costModel (the one-sentence rule of what costs credits). THE RULE: only AI model runs and Ad Spy research spend credits; publishing, scheduling, ads management, analytics, comments, DMs and connectors cost no credits on any plan (X is the single per-call exception; xCost gives its exact credits per post, with and without a link). Check before kicking off paid generation; answer "does posting cost credits?" with NO. HOW MANY posts is set by the plan, not credits: the Free plan includes 5 posts a month on up to 3 channels, and a post counts once however many channels it goes to (`posting` says how many are used); every paid plan posts without a limit and runs autopilot (Basic $19.99/mo: Autopilot, plus unlimited posting and scheduling, no monthly credits; it includes the same 160+ free credits as the Free plan, and monthly credits start on Starter). Starter, Pro and Studio: media models at cost + 10% (memberRate); Basic and Free pay standard prices.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Credit balance
    • idempotentHint: true
  • list_alert_settingsWhere this brand's ALERTS go and whether they are arriving: for each alert channel (Slack, Discord, a generic webhook) whether it is connected, which events it receives, its health…Reads text others writeNo findings

    Why it is in this group

    • The name "list_alert_settings" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Where this brand's ALERTS go and whether they are arriving: for each alert channel (Slack, Discord, a generic webhook) whether it is connected, which events it receives, its health (delivering / NOT DELIVERING / stopped because the channel was deleted or revoked: reconnect by pasting a new URL in the app), whether the webhook is signed, and the recent deliveries, one per delivery id with its attempts, last HTTP status, outcome and any retry queued (redeliver_webhook resends one). catalog:true adds every event name with its group and payload fields. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Alert settings and recent deliveries
    • idempotentHint: true
  • list_bluesky_convosRead the connected Bluesky account’s DM conversations — who each one is with, how many messages are unread, and whether it is a REQUEST (someone the account does not follow, which …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_bluesky_convos" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "dm": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "dm": it reads messages, which other people can write.
    Description, as the server wrote it
    Read the connected Bluesky account’s DM conversations — who each one is with, how many messages are unread, and whether it is a REQUEST (someone the account does not follow, which Bluesky holds separately, the same idea as a message request). Free, no credits, no vendor approval: AT Protocol app passwords are not scoped. It DOES need a PRIVILEGED app password — one created with direct-message access ticked — and says so precisely if the saved one cannot chat, which is a property of the password and NOT a broken connection. Filters: readState "unread", status "request" or "accepted", kind "direct" or "group". An unknown filter value is refused by name, never silently dropped.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Bluesky direct-message conversations
    • idempotentHint: true
  • list_bluesky_postsThe brand's OWN recent Bluesky posts, newest first — and THIS is where the at:// AT-URI every other Bluesky tool needs comes from.Reads text others writeNo findings

    Why it is in this group

    • The name "list_bluesky_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_bluesky_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The brand's OWN recent Bluesky posts, newest first — and THIS is where the at:// AT-URI every other Bluesky tool needs comes from. bluesky_post_metrics and delete_bluesky_post both address a post by AT-URI, so without this the only way to hold one was to have just published it in the same conversation; an agent reviewing past work had no way to name anything. Each row carries the text, when it went out, its web URL, its live like/repost/reply/quote/bookmark counts, and whether it is a REPOST of someone else's post or a reply — a repost is not the brand's own creative and must not be reported as its performance. Optional filter: posts_no_replies, posts_with_media, posts_with_replies, posts_and_author_threads (an unknown one is refused by name). Bluesky publishes NO impression or view count in any lexicon, so these are counts with no denominator and no engagement rate can be computed from them. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the brand's own Bluesky posts
    • idempotentHint: true
  • list_brandsList 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 shar…No findings

    Why it is in this group

    • The name "list_brands" says "list": a word for reading.
    Description, as the server wrote it
    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. Call this, then use_brand to switch; a SHARED profile switches the same way (pass its name or the profile id printed here). If a profile looks empty when the app shows it full, you are acting on a different one: call this first. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List profiles
    • idempotentHint: true
  • list_business_attributesThe ATTRIBUTES a Business Profile can set — accessibility, amenities, service options, payment types — with the valid values for each.Reads text others writeNo findings

    Why it is in this group

    • The name "list_business_attributes" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The ATTRIBUTES a Business Profile can set — accessibility, amenities, service options, payment types — with the valid values for each. These are what local searchers FILTER on, so a listing with none set is invisible to those filters. Scope it ONE of three ways: locationName (`locations/123`) alone for what THAT listing may set; categoryName (`categories/gcid:…`, from list_business_categories) for a category, where regionCode and languageCode are filled from the brand’s listing if left out (the reply says so); or regionCode with showAll:true for a country. locationName with the others is refused by name. Read-only, 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Google Business attributes available for a listing
    • idempotentHint: true
  • list_business_categoriesGoogle’s CATEGORY vocabulary for a country — the primary category is a required field on a Business Profile and one of the strongest LOCAL RANKING signals, and Google accepts only …Reads text others writeNo findings

    Why it is in this group

    • The name "list_business_categories" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Google’s CATEGORY vocabulary for a country — the primary category is a required field on a Business Profile and one of the strongest LOCAL RANKING signals, and Google accepts only its own stable ids (`categories/gcid:coffee_shop`), never a display name. So this is the lookup you run BEFORE setting a category, and `filter` searches the START of display names (“pizza”, or Google’s `displayName=pizza`). regionCode is REQUIRED because Google’s list genuinely differs by country — there is no worldwide answer. view:"FULL" additionally returns the service types and the attributes valid for each category, which is how you join this to list_business_attributes. Read-only, 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Google Business categories for a country
    • idempotentHint: true
  • list_business_locationsList the Google Business Profile listings SHARED WITH THIS PROFILE — id, title, address, website and Maps link.Reads text others writeNo findings

    Why it is in this group

    • The name "list_business_locations" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "website": it reads web pages, which anyone can write.
    Description, as the server wrote it
    List the Google Business Profile listings SHARED WITH THIS PROFILE — id, title, address, website and Maps link. These are the only listings anything here can post to or read: one Google login often manages several businesses (an agency manages its clients’), and the user ticks which of them belong to this profile. Call this before posting whenever more than one is shared and let the USER pick: a Post on the wrong storefront is a public mistake Hermoso will not make for them. If nothing is shared, ask the user to choose — list_connector_accounts("google_business") then set_connector_accounts — and never name or guess a listing. Read-only, 0 credits. Needs Google Business Profile connected (Connectors > Google Business Profile).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Google business listings
    • idempotentHint: true
  • list_call_recordingsThe recordings of one call (callId from list_calls) with their length, a link to play each through Hermoso, and on Telnyx the provider's transcript when it made one.Reads text others writeNo findings

    Why it is in this group

    • The name "list_call_recordings" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The recordings of one call (callId from list_calls) with their length, a link to play each through Hermoso, and on Telnyx the provider's transcript when it made one. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List a call's recordings
  • list_campaign_postsUse this when the user asks which creator posts are waiting for review, or how submitted posts are doing.Reads text others writeNo findings

    Why it is in this group

    • The name "list_campaign_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe name "list_campaign_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Use this when the user asks which creator posts are waiting for review, or how submitted posts are doing. Submitted posts with their platform-reported views, authenticity score (0-100, with the reasons points were taken off), flags (no_disclosure, missing_hashtag, missing_mention, views_hidden, low_authenticity), status and what each has earned. Filter by campaign and status (pending_review to see what needs a decision).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List posts submitted to creator campaigns
  • list_connector_accountsShow every identity a connected account can act as, and which ones this PROFILE is currently allowed to use — Facebook Pages + Instagram + Meta ad accounts, Google Ads customers, L…Reads text others writeNo findings

    Why it is in this group

    • The name "list_connector_accounts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Show every identity a connected account can act as, and which ones this PROFILE is currently allowed to use — Facebook Pages + Instagram + Meta ad accounts, Google Ads customers, LinkedIn company Pages (and the personal profile), Pinterest ad accounts, Microsoft Advertising accounts. One person often administers several; only the ticked ones can be posted to or spent from. Call this before set_connector_accounts, and let the USER pick — never guess. Providers: tiktok, x, youtube, threads, bluesky, telegram, pinterest, instagram, meta, google_ads, linkedin, pinterest_ads, linkedin_ads, reddit_ads, apple_ads, amazon_ads, microsoft_ads, google_business, google_analytics, snapchat_ads, x_ads, tiktok_ads, google_tag_manager, google_search_console, bing_webmaster. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a connector’s accounts
    • idempotentHint: true
  • list_connectorsList the third-party accounts connected to this workspace (Meta, Google Ads, Google Drive/Sheets/Docs, YouTube, LinkedIn, OneDrive, Slack, …) — provider, status and the connected a…Reads private dataNo findings

    Why it is in this group

    • The name "list_connectors" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "list" and "drive": it reads files.
    Description, as the server wrote it
    List the third-party accounts connected to this workspace (Meta, Google Ads, Google Drive/Sheets/Docs, YouTube, LinkedIn, OneDrive, Slack, …) — provider, status and the connected account label — PLUS which providers are available to connect. IT ALSO FLAGS A CONNECTION WHOSE PERMISSIONS ARE OUT OF DATE: a provider writes its granted permission set into the token at consent time, so a connection authorized before a permission was approved does not carry it and never will — those calls are refused by the provider and no retry or wait can change it. Check this FIRST when a connected provider starts refusing things. The fix is a browser: the user reconnects under Connectors. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List connectors
    • idempotentHint: true
  • list_contactsThe brand's ONE contact list across channels: each person's emails, phones, channels (Instagram, Messenger, WhatsApp, Telegram, X… ids and handles), tags, custom fields, where they…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_contacts" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_contacts" says "list" and "contact": it reads contacts.
    • private-dataThe description's first sentence says "contact": it reads contacts.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The brand's ONE contact list across channels: each person's emails, phones, channels (Instagram, Messenger, WhatsApp, Telegram, X… ids and handles), tags, custom fields, where they came from (email list, inbox, SMS opt-ins, creator campaigns, Shopify, Stripe, HubSpot) and their recorded opt-ins and opt-outs per channel. Filter by search, tag, platform (reachable on it), source, subscribed, optedOut (a channel). id: one contact in full, with the sequences they are in. Read-only. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List the brand's contacts
  • list_creatorsList this workspace’s SAVED CREATORS — the reusable on-camera cast (AI creators made here, a person pulled from a social profile, a consented photo upload).No findings

    Why it is in this group

    • The name "list_creators" says "list": a word for reading.
    Description, as the server wrote it
    List this workspace’s SAVED CREATORS — the reusable on-camera cast (AI creators made here, a person pulled from a social profile, a consented photo upload). Read-only, FREE. Each entry gives the name, the PORTRAIT URL, where the portrait came from and whether a real person’s likeness consent is on file, how many extra pose plates exist, and any chosen or cloned voice. That casts them for the whole spot. THE PORTRAIT URL IS THE REUSE HANDLE for the raw lanes. CALL THIS BEFORE OFFERING TO GENERATE A NEW PERSON: re-casting somebody the workspace already has keeps the SAME face across every ad, while a fresh person costs credits and breaks that continuity. An empty answer means the workspace genuinely has no cast yet.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List saved creators
    • idempotentHint: true
  • list_discord_channelsThe 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.Reads text others writeNo findings

    Why it is in this group

    • The name "list_discord_channels" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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. Use it before posting when the user has not named a channel, and to show them the choice. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Discord channels
  • list_discord_eventsThe scheduled events in the brand's Discord server (the Events panel): name, kind, status, start and end, location or channel, how many people marked themselves interested, and a l…Reads text others writeNo findings

    Why it is in this group

    • The name "list_discord_events" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The scheduled events in the brand's Discord server (the Events panel): name, kind, status, start and end, location or channel, how many people marked themselves interested, and a link. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Discord events
  • list_discord_membersList the members of the brand's Discord server a page at a time (limit 1 to 1000, default 100; pass the returned nextAfter as after for the next page), each with their id, name and…Reads text others writeNo findings

    Why it is in this group

    • The name "list_discord_members" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the members of the brand's Discord server a page at a time (limit 1 to 1000, default 100; pass the returned nextAfter as after for the next page), each with their id, name and roles. Discord only hands the full list to a bot with the Server Members intent switched on; when it refuses, the answer says so, and search_discord_members still finds people by name. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Discord server members
  • list_discord_pinsThe pinned messages in a Discord channel, newest pin first (up to 50 a page; pass nextBefore as before for older ones), each with its messageId, text and link.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_discord_pins" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The pinned messages in a Discord channel, newest pin first (up to 50 a page; pass nextBefore as before for older ones), each with its messageId, text and link. A channel holds at most 250 pins. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List pinned Discord messages
  • list_discord_rolesThe roles in the brand's Discord server, highest first: name, id, color, what each is allowed to do, how many members hold it, and whether the Hermoso bot can manage it (a role mus…Reads text others writeNo findings

    Why it is in this group

    • The name "list_discord_roles" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The roles in the brand's Discord server, highest first: name, id, color, what each is allowed to do, how many members hold it, and whether the Hermoso bot can manage it (a role must sit BELOW the Hermoso role in the server's role list). Use it before creating, editing, deleting, giving or taking a role. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Discord roles
  • list_dm_automationsThe brand's DM and comment automations on Instagram, Facebook (Page comments, ads, Messenger), X, TikTok, Threads, YouTube and LinkedIn Pages, each with its stats, the recent send …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_dm_automations" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_dm_automations" says "list" and "dm": it reads messages.
    • private-dataThe description's first sentence says "dm": it reads messages.
    • untrusted-inputThe name "list_dm_automations" says "list" and "dm": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "dm": it reads messages, which other people can write.
    Description, as the server wrote it
    The brand's DM and comment automations on Instagram, Facebook (Page comments, ads, Messenger), X, TikTok, Threads, YouTube and LinkedIn Pages, each with its stats, the recent send log and the connected accounts per channel. A rule that was stopped says why. Pass `channel` to narrow, `id` for one rule's log. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: DM automations
  • list_drive_filesList the Google Drive files & folders Hermoso can reach: the ones it created plus any the user picked with the Google file picker in the app (drive.file, never their whole Drive).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_drive_files" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_drive_files" says "list" and "drive": it reads files.
    • private-dataThe description's first sentence says "list" and "drive": it reads files.
    • private-dataThe input names a folder (input.folderId), and the tool reads: it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the Google Drive files & folders Hermoso can reach: the ones it created plus any the user picked with the Google file picker in the app (drive.file, never their whole Drive). This is how you find a picked file's id. Filter by query (name contains …), folderId, or onlyFolders:true; paginate with pageToken. Read-only. A FOLDER: picking a folder hands over the folder alone, not its files, so a folder can list empty or partly; the reply then carries `pickUrl`, an app link that opens the picker inside that folder (Cmd+A / Ctrl+A selects every file and subfolder). Give the user that exact link, then list again. recursive:true walks every subfolder Hermoso can see (each row has its `path`) and reports picked files whose folder it cannot see.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Google Drive files
    • idempotentHint: true
  • list_elementsSaved people, places and products, each with an @name.No findings

    Why it is in this group

    • The name "list_elements" says "list": a word for reading.
    Description, as the server wrote it
    Saved people, places and products, each with an @name. FREE. An @name in an image or video prompt or an ad brief ("@Sarah in @Kitchen") uses that saved picture as the reference.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List saved elements
    • idempotentHint: true
  • list_errorsThe errors actually recorded against this workspace, GROUPED by fingerprint — the same failure at the same call site is one row with a hit count and first/last seen, sorted defects…No findings

    Why it is in this group

    • The name "list_errors" says "list": a word for reading.
    Description, as the server wrote it
    The errors actually recorded against this workspace, GROUPED by fingerprint — the same failure at the same call site is one row with a hit count and first/last seen, sorted defects-first. Each row says whose side it is: `ours` (a defect worth fixing), `user` (a refusal we deliberately authored, e.g. not-connected or out-of-credits), or `unknown` (a vendor 4xx we cannot attribute — never guessed). Free text, tokens, emails and creative are redacted before anything is stored, so an input echo shows shapes and lengths, not content. Filter by surface (http/mcp/agent/job/client) or kind. Read-only, 0 credits. Scoped to your own workspace; an operator whose client carries the admin key sees every account.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List errors users hit
    • idempotentHint: true
  • list_google_business_postsList the Posts currently on the brand’s Google Business Profile listing — text, topic type, state (LIVE / PROCESSING / REJECTED / SCHEDULED / RECURRING), button and timestamps.Reads text others writeNo findings

    Why it is in this group

    • The name "list_google_business_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_google_business_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the Posts currently on the brand’s Google Business Profile listing — text, topic type, state (LIVE / PROCESSING / REJECTED / SCHEDULED / RECURRING), button and timestamps. Use it to see what is already showing before writing another, or to get the id of one to remove. Read-only, 0 credits. Needs Google Business Profile connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Google Business Profile Posts
    • idempotentHint: true
  • list_google_business_questionsThe questions the public has asked on the brand’s Google Business Profile listing, with the answers so far and how many people upvoted each question.Reads text others writeNo findings

    Why it is in this group

    • The name "list_google_business_questions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The questions the public has asked on the brand’s Google Business Profile listing, with the answers so far and how many people upvoted each question. Unanswered questions sit publicly on the listing and are read as "this business does not respond" — the reply names the ones with no answer at all. Read-only, 0 credits. Needs Google Business Profile connected and the project approved.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the Q&A on a Google Business listing
    • idempotentHint: true
  • list_google_business_reviewsThe reviews customers have left on the brand’s Google Business Profile listing — star rating, reviewer, the text, when it landed, and whether the business has replied.Reads text others writeNo findings

    Why it is in this group

    • The name "list_google_business_reviews" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_google_business_reviews" says "list" and "review": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    The reviews customers have left on the brand’s Google Business Profile listing — star rating, reviewer, the text, when it landed, and whether the business has replied. For a local business this is the highest-leverage surface there is: an unanswered review sits on the listing next to the ad you paid for. The reply says which ones have NO answer yet, so you can work the list rather than read it. Google reports the listing’s own average rating and total review count alongside the page — use those for "how are we doing", never a mean you computed over one page. An empty page is an empty PAGE, not proof the listing has no reviews. Read-only, 0 credits. Needs Google Business Profile connected AND the project approved for Google’s Business Profile APIs (a pending access request, not a setting — the error says so).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the reviews on a Google Business listing
    • idempotentHint: true
  • list_inboxUse this when the user asks what they need to reply to, about new comments or DMs, or how people are responding.Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "list_inbox" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_inbox" says "list" and "inbox": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_inbox" says "list" and "inbox": it reads inbound email, which other people can write.
    • untrusted-inputThe description's first sentence says "reply": it reads comments, which other people can write.

    Findings

    • Info

      The description is 2,470 characters long, over the 2,000 this check looks for.

      Matched text

      description ends: "...e X has not already been paid for today (a repeat read with nothing new is free)."

      What this check looks for
    Description, as the server wrote it
    Use this when the user asks what they need to reply to, about new comments or DMs, or how people are responding. It lists everything people said to this brand, across every connected channel: Facebook and Instagram comments, Threads replies and mentions, YouTube comments, TikTok comments, LinkedIn Page comments, Google Business reviews, Bluesky replies and mentions, and X mentions — plus DIRECT MESSAGES on Meta (Messenger and Instagram Direct), Instagram, Bluesky, X, Telegram, WhatsApp, SMS (Twilio, Telnyx), LINE, Slack and Discord. Discord messages that mention the Hermoso bot or reply to it, and replies to the brand's Outlook email. Support tickets too: the open conversations in the brand's Intercom inbox. Phone calls too: the calls the brand's AI voice agents (Vapi, Retell AI, ElevenLabs, Telnyx AI) answered or placed, with their transcripts, read only. Each item carries a composite id you hand straight to reply_to_inbox_item. A channel that is not connected is skipped and named; a channel that FAILS to read is named in `notes` rather than dropped, so a short list is never mistaken for a quiet week. Each DM conversation folds to ONE item (the newest thing the other person said). Messenger and Instagram DMs need no argument; each has a messageKind (text, story_mention, story_reply, share, image, video...), a spoken summary, and unavailable:true when Meta withholds the content. Bluesky DMs need conversationId (list_bluesky_convos). X DMs and Telegram need no argument and read EVERY X account and every Telegram bot on the brand (the last 30 days on X, 24 hours on Telegram); each item's `account` is the one it reached. WhatsApp needs no argument: Hermoso keeps the last 48 hours of each WhatsApp conversation (WhatsApp has no message history to read back), and each item carries windowOpen, its last few messages (recent) and whether a free reply is still allowed. LINE needs no argument either (kept 7 days), nor do Slack DMs (every direct message people sent the Hermoso app) or Discord mentions (the server's busiest channels). Discord DMs are read one member at a time, because Discord gives a bot no list of its DMs: pass discordMember (the member's Discord id). TikTok and LinkedIn comments are read per post: pass tiktokVideoId / linkedinPostUrn. Free on every channel except X: X mentions cost credits per item returned, and X DMs cost credits per message X has not already been paid for today (a repeat read with nothing new is free).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: One inbox for comments, replies, mentions, reviews and DMs
    • idempotentHint: true
  • list_instagram_collab_mediaEvery 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 a…Reads text others writeNo findings

    Why it is in this group

    • The name "list_instagram_collab_media" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    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 Instagram provides them). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Posts this account co-authors
    • idempotentHint: true
  • list_instagram_dm_automationsThe brand's Instagram DM automations (comment keyword -> DM, DM keyword, story reply, ig.me ref), each with its stats, plus the recent send log and the connected Instagram accounts…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_instagram_dm_automations" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_instagram_dm_automations" says "list" and "dm": it reads messages.
    • private-dataThe description's first sentence says "dm": it reads messages.
    • untrusted-inputThe name "list_instagram_dm_automations" says "list" and "dm": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "dm": it reads messages, which other people can write.
    Description, as the server wrote it
    The brand's Instagram DM automations (comment keyword -> DM, DM keyword, story reply, ig.me ref), each with its stats, plus the recent send log and the connected Instagram accounts. Pass `id` for one rule's log. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Instagram DM automations
  • list_instagram_marketplace_audiencesThe brand's custom audiences that Instagram's creator marketplace accepts as a creator filter (Meta's creator_marketplace_brand_info).Reads text others writeNo findings

    Why it is in this group

    • The name "list_instagram_marketplace_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's custom audiences that Instagram's creator marketplace accepts as a creator filter (Meta's creator_marketplace_brand_info). Pass an id from here as customAudienceId to find_instagram_marketplace_creators to find creators whose followers overlap that audience. An agency passes businessId (its Business portfolio id) to see audiences from client ad accounts. Needs the Meta connector, ads_management and Meta's instagram_creator_marketplace_discovery permission. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Custom audiences usable as a creator-marketplace filter
    • idempotentHint: true
  • list_instagram_mediaThe connected Instagram Business account’s own recent media — id, caption, media type (feed / reel / story-era), permalink, timestamp, like and comment counts.Reads text others writeNo findings

    Why it is in this group

    • The name "list_instagram_media" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    The connected Instagram Business account’s own recent media — id, caption, media type (feed / reel / story-era), permalink, timestamp, like and comment counts. This is where the media id every other Instagram tool needs comes from: resolve “my latest reel” yourself instead of asking the user for a link, then pass the id to meta_post_insights. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the brand’s Instagram posts
    • idempotentHint: true
  • list_instagram_shopping_catalogsWhether this Instagram account can tag products at all, and which catalogs its SHOP can tag from.Reads text others writeNo findings

    Why it is in this group

    • The name "list_instagram_shopping_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Whether this Instagram account can tag products at all, and which catalogs its SHOP can tag from. CALL THIS FIRST: product tagging needs an APPROVED INSTAGRAM SHOP, and if the account does not have one, tagging fails AFTER the photo is already uploaded. The reply says which of three things is true — eligible, not eligible (a Commerce Manager approval nothing in Hermoso can grant, and not a sign anything is broken), or "could not tell", which is NOT the same as not eligible. AN EMPTY CATALOG LIST IS NOT AN EMPTY CATALOG: Instagram reaches a catalog through the account's SHOP, while list_meta_catalogs reads the business PORTFOLIO — a merchant can have a full catalog there and nothing available here until the shop is approved. Read-only, 0 credits. Whether Meta has approved Hermoso's app for the permission this needs is read LIVE from Meta: when it has not, list_connectors says so under Meta and this tool's refusal says Meta hasn't approved Hermoso for it yet. That is Meta's decision about Hermoso, not the user's connection, so never tell them to reconnect for it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What Instagram Shopping can tag
    • idempotentHint: true
  • list_intercom_conversationsSupport conversations from the brand's OWN Intercom inbox, newest activity first: subject, state, whether the customer is waiting, assignee, customer email, channel, tags and the f…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_intercom_conversations" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_intercom_conversations" says "list" and "conversation": it reads messages.
    • private-dataThe description's first sentence says "conversation": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_intercom_conversations" says "list" and "conversation": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "conversation": it reads messages, which other people can write.
    Description, as the server wrote it
    Support conversations from the brand's OWN Intercom inbox, newest activity first: subject, state, whether the customer is waiting, assignee, customer email, channel, tags and the first message. One Intercom workspace can serve several products, so every filter below combines with the others. view: open (default), unassigned, waiting (customer waiting on a reply), snoozed, closed, recent or all. days bounds it by last update (default 30), or use updatedAfter / updatedBefore / createdAfter / createdBefore (dates). text matches words in the first message; email is the customer's exact email, customer is part of their name or email; contactId; assigneeId (a teammate) or teamId (ids from list_intercom_teammates); tagId or tagName; channel (conversation is the Messenger, or email, whatsapp, sms and so on); priority true or false; unread true. app is the product the customer wrote from (their contact's current_app, case-insensitive, for example Hermoso); contactAttributes and attributes match other custom attributes of the customer or of the conversation. Intercom's search cannot filter on custom attributes or app, so those are matched on the pages read and the answer says how many it read. Pass cursor from the last answer for the next page. Read-only, free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Intercom conversations
    • idempotentHint: true
  • list_intercom_tagsThe tags in the brand's Intercom workspace (id and name), for tag_intercom_conversation or to filter list_intercom_conversations.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_intercom_tags" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "conversation": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "conversation": it reads messages, which other people can write.
    Description, as the server wrote it
    The tags in the brand's Intercom workspace (id and name), for tag_intercom_conversation or to filter list_intercom_conversations. Read-only, free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Intercom tags
    • idempotentHint: true
  • list_intercom_teammatesThe brand's Intercom teammates and teams with their ids, for assigning a conversation or filtering the list by assignee.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_intercom_teammates" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "conversation": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "conversation": it reads messages, which other people can write.
    Description, as the server wrote it
    The brand's Intercom teammates and teams with their ids, for assigning a conversation or filtering the list by assignee. Read-only, free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Intercom teammates and teams
    • idempotentHint: true
  • list_jobsList the most recent render jobs + how many are currently running, so you can report on or resume in-flight work.No findings

    Why it is in this group

    • The name "list_jobs" says "list": a word for reading.
    Description, as the server wrote it
    List the most recent render jobs + how many are currently running, so you can report on or resume in-flight work.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List render jobs
    • idempotentHint: true
  • list_klaviyo_campaignsThe brand's Klaviyo CAMPAIGNS, newest first: name, status (draft, scheduled, sending, sent or cancelled, read off its messages), send time, and the list / segment ids it targets.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_klaviyo_campaigns" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The brand's Klaviyo CAMPAIGNS, newest first: name, status (draft, scheduled, sending, sent or cancelled, read off its messages), send time, and the list / segment ids it targets. Filter by name (contains), status or archived; or pass campaignId to read ONE in full with its subject line, preview text, sender and template. For opens, clicks and revenue use klaviyo_report. Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Klaviyo campaigns
  • list_klaviyo_flowsThe brand's Klaviyo FLOWS (automations such as a welcome series, abandoned cart, post-purchase): name, status (live, manual, draft), trigger type, archived, created and updated, ne…Reads text others writeNo findings

    Why it is in this group

    • The name "list_klaviyo_flows" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The brand's Klaviyo FLOWS (automations such as a welcome series, abandoned cart, post-purchase): name, status (live, manual, draft), trigger type, archived, created and updated, newest first. Filter by status or name. For a flow's opens, clicks and revenue use klaviyo_report with of:'flows'. Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Klaviyo flows
  • list_klaviyo_imagesThe pictures in the brand's Klaviyo IMAGE LIBRARY: id, name, hosted URL, format and size, newest first.Reads text others writeNo findings

    Why it is in this group

    • The name "list_klaviyo_images" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The pictures in the brand's Klaviyo IMAGE LIBRARY: id, name, hosted URL, format and size, newest first. Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Klaviyo images
  • list_klaviyo_listsThe brand's Klaviyo LISTS with how many profiles each holds (profile count), single or double opt-in, and when each was created and updated, newest first.Reads text others writeNo findings

    Why it is in this group

    • The name "list_klaviyo_lists" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's Klaviyo LISTS with how many profiles each holds (profile count), single or double opt-in, and when each was created and updated, newest first. Klaviyo pages lists 10 at a time: pass nextCursor for more, or name for one exact list. A list id is a campaign audience (create_klaviyo_campaign listIds) or a lead-sync target. Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Klaviyo lists
  • list_klaviyo_segmentsThe brand's Klaviyo SEGMENTS with how many profiles each holds, whether it is active and still processing, newest first, 10 per page (nextCursor for more).Reads text others writeNo findings

    Why it is in this group

    • The name "list_klaviyo_segments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's Klaviyo SEGMENTS with how many profiles each holds, whether it is active and still processing, newest first, 10 per page (nextCursor for more). A segment id is a campaign audience (create_klaviyo_campaign segmentIds). Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Klaviyo segments
  • list_klaviyo_templatesThe brand's Klaviyo EMAIL TEMPLATES (name, id, editor type, created, updated), newest first, 10 per page.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_klaviyo_templates" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The brand's Klaviyo EMAIL TEMPLATES (name, id, editor type, created, updated), newest first, 10 per page. A template id is what create_klaviyo_campaign sends. Read-only, free. Needs Klaviyo connected (Connectors > Klaviyo, or connect_connector with a private API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Klaviyo templates
  • list_libraryThis workspace's Library: every Studio image/video and upload, newest first.No findings

    Why it is in this group

    • The name "list_library" says "list": a word for reading.
    Description, as the server wrote it
    This workspace's Library: every Studio image/video and upload, newest first. Each row: a served URL (fetch_asset gives a download link), its id, a TITLE (headline, concept or file name), kind, a video's length, pixel size, model and age. An ad named by its headline ("the Afternoon fix ad"): pass `query`. Free, read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List library
  • list_linkedin_commentsRead the comments people have left on one of your LinkedIn company Page's posts.Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_comments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_linkedin_comments" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the comments people have left on one of your LinkedIn company Page's posts. Community Management surface, and it needs its OWN connection: LinkedIn grants the comment scopes on a different app from the one that posts, so connecting LinkedIn does NOT connect this — the card is “LinkedIn Community Management” in Connectors. Pass the post's urn, which is what post_to_linkedin_page returns. A post nobody has commented on comes back as an EMPTY LIST with a note, never an error: LinkedIn answers 404 for a post with no social activity, and that means “no comments yet”, not “no such post”. Each comment carries its text, author, time, like and reply counts, and `isOurs` so your Page's own replies are distinguishable from other people's comments; `fromOthers` counts the ones actually awaiting an answer. The connected member must hold an ADMINISTRATOR role on the Page.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read the comments on a LinkedIn Page post
  • list_linkedin_eventsThe events a LinkedIn company Page is organizing — name, link, start and end times, online or in-person, visibility and lifecycle state.Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_events" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The events a LinkedIn company Page is organizing — name, link, start and end times, online or in-person, visibility and lifecycle state. LinkedIn is the one channel where an event is a first-class object rather than a post about one, so this is how you see what a B2B brand actually has scheduled (webinars, launches, live sessions) and pair it with the posts promoting it. Only Pages the user has SHARED with this profile are readable. Warning: Needs the Events permission: an administrator switches it on for the deployment, and because LinkedIn grants permissions at authorise time and never retroactively, every existing LinkedIn connection must RECONNECT once before it works. The tool tells you which of those two applies rather than failing generically. Read-only, 0 credits. Needs LinkedIn connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a LinkedIn Page’s events
    • idempotentHint: true
  • list_linkedin_lead_eventsThe lead events LinkedIn has PUSHED to Hermoso for this brand (new lead / deleted lead, with the form and the lead id), newest first.No findings

    Why it is in this group

    • The name "list_linkedin_lead_events" says "list": a word for reading.
    Description, as the server wrote it
    The lead events LinkedIn has PUSHED to Hermoso for this brand (new lead / deleted lead, with the form and the lead id), newest first. Empty means none have arrived, not that none exist — list_linkedin_leads reads every lead regardless, and subscribe_linkedin_leads is what starts delivery. Read a lead’s answers with get_linkedin_lead. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: LinkedIn lead events received in real time
  • list_linkedin_lead_formsThe LEAD GEN FORMS a LinkedIn company Page or ad account owns — id, name, state, version and the fields each one asks for (firstName, email, company …).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_lead_forms" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The LEAD GEN FORMS a LinkedIn company Page or ad account owns — id, name, state, version and the fields each one asks for (firstName, email, company …). If it answers that the connection must be reconnected, say exactly that: the lead-sync permission is granted at authorise time. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List LinkedIn lead gen forms
  • list_linkedin_lead_subscriptionsThe lead notification webhooks registered on a LinkedIn Page or ad account, with the id delete_linkedin_lead_subscription takes.Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_lead_subscriptions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The lead notification webhooks registered on a LinkedIn Page or ad account, with the id delete_linkedin_lead_subscription takes. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List LinkedIn lead webhooks
  • list_linkedin_leadsThe LEADS a LinkedIn lead gen form collected — every response with its answers keyed by field (firstName, lastName, email, company, …), the campaign and creative that produced it, …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_leads" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The LEADS a LinkedIn lead gen form collected — every response with its answers keyed by field (firstName, lastName, email, company, …), the campaign and creative that produced it, the consents ticked, and whether it was a test lead. Newest first. Filter by formId, a since/until window (ISO date or epoch ms — LinkedIn takes epoch), or testLeadsOnly. THIS IS PERSONAL DATA: show it to the user, hand it to the CRM they name, never repeat it into a post or an unrelated tool. Pass start for the next page. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List LinkedIn leads (form responses)
  • list_linkedin_page_notificationsWhat happened on your LinkedIn company Page: comments, MENTIONS of the Page (SHARE_MENTION), reshares and likes, as far back as LinkedIn keeps them (60 days).Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_page_notifications" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    What happened on your LinkedIn company Page: comments, MENTIONS of the Page (SHARE_MENTION), reshares and likes, as far back as LinkedIn keeps them (60 days). For a Page ADMINISTRATOR. Use it to find who is talking about the brand before replying. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read LinkedIn Page notifications
  • list_linkedin_pagesList the LinkedIn COMPANY PAGES the connected account administers — id, name and the role held on each.Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_pages" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the LinkedIn COMPANY PAGES the connected account administers — id, name and the role held on each. ALWAYS call this before post_to_linkedin_page when there is more than one Page: publishing to the wrong company Page is a public mistake and Hermoso never chooses for the user. If it comes back empty, the account holds no Page admin role, or LinkedIn has not granted this app the organization scopes — say that plainly rather than guessing an id. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the LinkedIn company Pages this account administers
    • idempotentHint: true
  • list_mailchimp_audiencesThe brand's Mailchimp AUDIENCES (lists): subscribed member count, total contacts, unsubscribes, double opt-in, the default from name and email, and when each last sent.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_mailchimp_audiences" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "contact": it reads contacts.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The brand's Mailchimp AUDIENCES (lists): subscribed member count, total contacts, unsubscribes, double opt-in, the default from name and email, and when each last sent. An audience id is what create_mailchimp_campaign and sync_leads_to_mailchimp take. Read-only, free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Mailchimp audiences
  • list_mailchimp_campaignsThe brand's Mailchimp CAMPAIGNS, newest first: title, status (save = draft, schedule, sending, sent, paused), subject, preview text, sender, audience and segment, recipient count, …Reads text others writeNo findings

    Why it is in this group

    • The name "list_mailchimp_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's Mailchimp CAMPAIGNS, newest first: title, status (save = draft, schedule, sending, sent, paused), subject, preview text, sender, audience and segment, recipient count, send time. Filter by status or audienceId; or pass campaignId to read ONE with Mailchimp's own send checklist (is it ready, and what is missing). For opens, clicks and revenue use mailchimp_report. Read-only, free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Mailchimp campaigns
  • list_mailchimp_filesThe pictures in the brand's Mailchimp FILE MANAGER: id, name, hosted URL, size and dimensions, newest first.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_mailchimp_files" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_mailchimp_files" says "list" and "file": it reads files.
    • private-dataThe description's first sentence says "file": it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The pictures in the brand's Mailchimp FILE MANAGER: id, name, hosted URL, size and dimensions, newest first. Read-only, free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Mailchimp File Manager images
  • list_mailchimp_segmentsThe SEGMENTS and tags of one Mailchimp audience with their member counts and type (saved, static/tag, fuzzy).Reads text others writeNo findings

    Why it is in this group

    • The name "list_mailchimp_segments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The SEGMENTS and tags of one Mailchimp audience with their member counts and type (saved, static/tag, fuzzy). A segment id narrows a campaign to part of the audience. Read-only, free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Mailchimp segments
  • list_mailchimp_templatesThe brand's own Mailchimp EMAIL TEMPLATES (name, id, created, edited).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_mailchimp_templates" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The brand's own Mailchimp EMAIL TEMPLATES (name, id, created, edited). A template id is what create_mailchimp_campaign sends. Read-only, free. Needs Mailchimp connected (Connectors > Mailchimp, or connect_connector with an API key).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Mailchimp templates
  • list_memoryList the durable facts & preferences saved in this workspace’s Memory (what the studio remembers about the brand, audience, taste, and do/don’t rules) — the same Memory the web app…Reads text others writeNo findings

    Why it is in this group

    • The name "list_memory" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "list" and "web": it reads web pages, which anyone can write.
    Description, as the server wrote it
    List the durable facts & preferences saved in this workspace’s Memory (what the studio remembers about the brand, audience, taste, and do/don’t rules) — the same Memory the web app shows. These shape every future ad. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List memory
    • idempotentHint: true
  • list_messenger_marketing_campaignsThe marketing-message campaigns on an ad account: name, id, budgets, schedule.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_messenger_marketing_campaigns" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The marketing-message campaigns on an ad account: name, id, budgets, schedule. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Messenger marketing-message campaigns
    • idempotentHint: true
  • list_messenger_subscribersThe people who OPTED IN to marketing messages from a Facebook Page — their subscription tokens, the only address a paid Messenger marketing message can go to (there is no "message …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_messenger_subscribers" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The people who OPTED IN to marketing messages from a Facebook Page — their subscription tokens, the only address a paid Messenger marketing message can go to (there is no "message everyone"). Also reports whether Messenger marketing is turned on for this Meta connection. It is an OPTIONAL add-on, not part of the default Meta connect: when it is off, the Messenger marketing tools answer with the link that turns it on (Connectors > Meta > Enable Messenger marketing), never with 'reconnect Meta'; Meta then asks the user to confirm the Pages and pick an ad account, and lists only ones their own Facebook profile fully controls. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Messenger marketing-message subscribers
    • idempotentHint: true
  • list_meta_catalog_productsA page of the actual PRODUCTS in a catalog — name, retailer id, price, availability, image and, most importantly, Meta’s REVIEW STATUS for each.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_catalog_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    A page of the actual PRODUCTS in a catalog — name, retailer id, price, availability, image and, most importantly, Meta’s REVIEW STATUS for each. A REJECTED product stays in the catalog, is counted by the catalog’s catalog.product_count field, and will never be shown in an ad — so this is how you find out why a catalog ad is serving less than the merchant expects. Use it to confirm a catalog really holds what the merchant thinks before pointing money at it. This is a PAGE, not a count: quote the catalog.product_count list_meta_catalogs reports for the total. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the products inside a Meta catalog
    • idempotentHint: true
  • list_meta_catalogsThe PRODUCT CATALOGS this Meta login can advertise from — id, name, how many products each holds, and which business portfolio owns it, WITH THAT PORTFOLIO’S NUMERIC ID.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The PRODUCT CATALOGS this Meta login can advertise from — id, name, how many products each holds, and which business portfolio owns it, WITH THAT PORTFOLIO’S NUMERIC ID. It also lists every business portfolio this login administers (`portfolios`), whether or not it holds a catalog yet — so this is where the businessId create_meta_catalog needs comes from, and the two tools chain with no trip to Business Manager. A catalog is the input to Advantage+ catalog ads (dynamic product ads): one campaign that shows each person the products they are most likely to buy, with the image, name and price taken from the catalog rather than from a render. START HERE for any "advertise my products" ask, then list_meta_product_sets to pick what to advertise. AN EMPTY LIST IS A FACT ABOUT WHAT THIS LOGIN ADMINISTERS, NEVER ABOUT THE MERCHANT: Meta serves catalogs off the BUSINESS PORTFOLIO, so a full Shopify-synced catalog is invisible here if the connected user is not an admin of the portfolio that owns it — read the `note` and say that, never "you have no catalog". A portfolio that could not be read is reported as `unreadable` rather than dropped. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the merchant’s Meta product catalogs
    • idempotentHint: true
  • list_meta_commentsRead the comments under a Facebook Page post or Instagram media object — customer questions, objections and the exact language real people use about the product.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_comments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_meta_comments" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    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. Good raw material for ad copy, and the first step before replying or moderating. REPLIES: a reply is a comment ON a comment, and its id exists only under its PARENT — it is never returned by the post. Each row says how many replies it has; to read them (and to get the id reply_to_meta_comment / moderate_meta_comment need), call this tool again with postId set to that COMMENT id.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read comments on a Meta post
    • idempotentHint: true
  • list_meta_conversationsThe DM threads on the brand’s Facebook Page and its Instagram account — who wrote, when they last wrote, how many messages and how many are unread.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_meta_conversations" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_meta_conversations" says "list" and "conversation": it reads messages.
    • private-dataThe description's first sentence says "dm": it reads messages.
    • private-dataThe input names a folder (input.folder), and the tool reads: it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_meta_conversations" says "list" and "conversation": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "dm": it reads messages, which other people can write.
    Description, as the server wrote it
    The DM threads on the brand’s Facebook Page and its Instagram account — who wrote, when they last wrote, how many messages and how many are unread. THIS IS WHERE THE BUYING QUESTION GETS ASKED. IT READS THE INBOX AND THE MESSAGE REQUESTS BY DEFAULT (Meta’s "other" folder), which is where a DM from someone who does NOT follow the account lands — every thread says which of the two it came from, because a message request is not an accepted conversation and whoever answers it should know that first. Omit `platform` to read BOTH surfaces (one question to a person, two edges to Meta); name one to narrow. AN EMPTY LIST IS NEVER "nobody has messaged you" — the reply says so and names the MEASURED causes, including one the account holder cannot fix: Instagram Direct on this edge needs an app-level Instagram messaging capability, and without it Meta answers with an empty list rather than an error. Never tell anyone to go and switch something on inside the Instagram app — there is no such setting on a professional account. Read one thread with read_meta_conversation. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: The brand’s Messenger and Instagram DM threads
    • idempotentHint: true
  • list_meta_pagesList the Facebook Pages (with any linked Instagram business account) and ad accounts on the connected Meta account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_pages" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the Facebook Pages (with any linked Instagram business account) and ad accounts on the connected Meta account. Requires the user to have connected Meta (Connectors > Meta); returns a connect hint if not.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Meta pages & ad accounts
    • idempotentHint: true
  • list_meta_partnership_creatorsThe creators this brand has set up for PARTNERSHIP ADS — ads that run from a CREATOR’s handle instead of the brand’s, which is what a paid collaboration looks like in feed.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_partnership_creators" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The creators this brand has set up for PARTNERSHIP ADS — ads that run from a CREATOR’s handle instead of the brand’s, which is what a paid collaboration looks like in feed. TWO SEPARATE LISTS come back and NEITHER IMPLIES THE OTHER: the AD-PERMISSION list is whose content this profile may run as an advert, and the TAG-APPROVAL list is who may tag this brand as a paid partner on their own organic post. Adding a creator to one does nothing for the other, and that is the mistake that makes a partnership ad fail for a reason Meta’s error does not name. Every row carries the status Meta reports VERBATIM. Meta’s own wording on the wire is prose, not the enum its docs publish — measured 2026-08-25, a fresh request reads “Pending Approval” and a revoked one reads “Canceled” (Partnership Ads Hub calls the same two rows “Request sent” and “Inactive”). PENDING means the creator has not accepted yet and this profile cannot advertise their content until they do. REVOKING DOES NOT REMOVE THE ROW: Meta keeps it and flips the status, so read the status rather than the presence of a row. An unrecognised status is passed through as Meta’s own word, never blanked. A list that could not be READ says exactly that; it is never rendered as "this brand has no creators". THE TWO LISTS ANSWER DIFFERENTLY, and Meta is the reason: the ad-permission list can be ENUMERATED, and the tag-approval list CANNOT — Meta requires `user_ids` on that edge and returns "a list of approved creators, filtered by the user IDs provided", i.e. it CHECKS the people you name and cannot report the rest. So pass `creatorIds` to ask about specific creators; anyone already on the ad-permission list is checked for you, which is what makes "on one list but not the other" answerable in a single call. With nobody to check, the reply says Meta publishes no way to list that edge rather than reporting a failed read. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: The brand’s Partnership Ads creators
    • idempotentHint: true
  • list_meta_postsList the connected Facebook Page's or Instagram account's OWN existing posts — id, caption, permalink, publish date and format.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_meta_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the connected Facebook Page's or Instagram account's OWN existing posts — id, caption, permalink, publish date and format. THIS IS THE TOOL THAT GETS YOU THE postId every other Meta read needs: meta_post_insights, list_meta_comments and manage_meta_post all require one. Use it for "how did our last few posts do", to find a post the user describes loosely, or before backfill_posts. Pass target:'instagram' for the linked IG account (Stories are excluded — Meta's media edge does not return them); Facebook hides unpublished drafts unless you ask for them. Only ever reads a Page the brand has connected. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Page’s / Instagram account’s own posts
    • idempotentHint: true
  • list_meta_product_setsThe PRODUCT SETS inside one catalog — a set is a slice of the catalog ("summer dresses", "under $50", "everything"), and it is what an AD SET actually advertises.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_product_sets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The PRODUCT SETS inside one catalog — a set is a slice of the catalog ("summer dresses", "under $50", "everything"), and it is what an AD SET actually advertises. Meta normally auto-creates an "all products" set with every catalog, so an empty list points at the catalog rather than at the request. A set holding ZERO products binds without error and then serves nothing — the ad runs, spends and shows no product — so check the counts. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the product sets in a Meta catalog
    • idempotentHint: true
  • list_meta_storiesThe 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`: reac…Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_stories" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "reply": it reads comments, which other people can write.
    Description, as the server wrote it
    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, link clicks and navigation (forward, back, next story, exit). Use it to check that a post or reel really went to Stories, or to match a story id against what is live. includeEnded also returns `ended`, the Stories that have ended with the numbers kept from before they ended. Meta marks nothing on a Story to say it is a reshared reel, so `origin` appears only when the share went through Hermoso, and says how it was found. Meta serves a Story for 24 hours and leaves live video and reshared stories out of this list. A source that could not be read comes back in `unreadable`, never as an empty list. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Stories live right now
    • idempotentHint: true
  • list_meta_webhook_eventsThe Page events Meta has PUSHED to Hermoso — new comments, mentions, lead-form submissions and inbound Messenger/Instagram DMs — each with the moment it arrived.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_webhook_events" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    The Page events Meta has PUSHED to Hermoso — new comments, mentions, lead-form submissions and inbound Messenger/Instagram DMs — each with the moment it arrived. This is the difference between a brand learning about a comment when someone thinks to look and learning about it when it happens. Scoped to the Pages this profile can actually see, so it never shows another account’s activity. AN EMPTY FEED IS AMBIGUOUS AND THE REPLY SAYS SO: nothing has happened, or the Page is not subscribed (check meta_webhook_status — an unsubscribed Page is silent and looks exactly like a quiet one), or Hermoso restarted and rebuilt the feed from its durable mirror, which keeps recent deliveries rather than all history. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What Meta has pushed to Hermoso
    • idempotentHint: true
  • list_notion_pagesFind the Notion pages and databases the user shared with Hermoso, by title, newest edited first.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_notion_pages" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "find" and "database": it reads databases.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Find the Notion pages and databases the user shared with Hermoso, by title, newest edited first. Gives the page id that save_to_notion, append_to_notion_page and read_notion_page take, or the database id to save rows into. Read-only, free. Needs Notion connected (Connectors > Notion).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Notion pages
    • idempotentHint: true
  • list_onedrive_filesList files & folders in the user’s OneDrive — the root by default, a folder’s contents (folderId), or a name search (query).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_onedrive_files" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_onedrive_files" says "list" and "file": it reads files.
    • private-dataThe description's first sentence says "list" and "file": it reads files.
    • private-dataThe input names a folder (input.folderId), and the tool reads: it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List files & folders in the user’s OneDrive — the root by default, a folder’s contents (folderId), or a name search (query). onlyFolders:true lists folders only. Paginate with pageToken (the cursor from a previous call). Read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List OneDrive files
    • idempotentHint: true
  • list_pending_approvalsScheduled posts waiting for an admin of the brand to approve them before they can go out (the brand’s approval setting holds them), or state "rejected" for the ones turned down.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pending_approvals" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Scheduled posts waiting for an admin of the brand to approve them before they can go out (the brand’s approval setting holds them), or state "rejected" for the ones turned down. Also says whether approval is on. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Posts waiting for approval
  • list_phone_numbersThe phone numbers on the brand's own Twilio or Telnyx account: number, id, SMS / MMS / voice capability, whether its texts come into the Hermoso Inbox, where its calls go (forwarde…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_phone_numbers" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "inbox": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "inbox": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The phone numbers on the brand's own Twilio or Telnyx account: number, id, SMS / MMS / voice capability, whether its texts come into the Hermoso Inbox, where its calls go (forwarded to a phone or a voice agent, recorded, missed-call text-back, the ad campaign it tracks). Read live from the provider. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List phone numbers
  • list_pinterest_board_sectionsList the SECTIONS of a Pinterest board with their ids (the boardSectionId post_to_pinterest and save_pinterest_pin take), or with sectionId the Pins in one section.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_board_sections" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the SECTIONS of a Pinterest board with their ids (the boardSectionId post_to_pinterest and save_pinterest_pin take), or with sectionId the Pins in one section. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest board sections
    • idempotentHint: true
  • list_pinterest_boardsList the boards on the user’s connected Pinterest account — id, name, privacy and pin count.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_boards" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the boards on the user’s connected Pinterest account — id, name, privacy and pin count. ALWAYS call this before post_to_pinterest and let the USER pick: Pinterest requires a board and Hermoso never chooses one for them. Read-only, 0 credits. Needs Pinterest connected (Connectors > Pinterest).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest boards
    • idempotentHint: true
  • list_pinterest_catalogsRead the Pinterest product CATALOG side of the connected account — what a Shopping (CATALOG_SALES) campaign serves from.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the Pinterest product CATALOG side of the connected account — what a Shopping (CATALOG_SALES) campaign serves from. what: catalogs (default), feeds, feed (feedId), processing_results (feedId — did Pinterest ingest the feed, product counts, errors), item_issues (processingResultId — per-product problems), product_groups (optionally feedId / catalogId), product_counts or products (productGroupId), items_batch (batchId). Pinterest catalogs need a BUSINESS account with a claimed website. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the Pinterest product catalog
    • idempotentHint: true
  • list_playbooksList the PLAYBOOKS saved in this workspace — the reusable strategy cards (winning hooks, angles, formats and the concrete plays to run) kept from teardowns, angle mining and creati…No findings

    Why it is in this group

    • The name "list_playbooks" says "list": a word for reading.
    Description, as the server wrote it
    List the PLAYBOOKS saved in this workspace — the reusable strategy cards (winning hooks, angles, formats and the concrete plays to run) kept from teardowns, angle mining and creatives worth repeating. The same Playbooks the web app's Playbooks tab lists. Read one before planning an ad so you re-run what already worked instead of starting cold. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List playbooks
    • idempotentHint: true
  • list_port_ordersThe brand's number port orders with their status (draft, in-process, submitted, exception, foc-date-confirmed, ported, cancelled), the numbers in each, the move date once the carri…Reads text others writeNo findings

    Why it is in this group

    • The name "list_port_orders" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's number port orders with their status (draft, in-process, submitted, exception, foc-date-confirmed, ported, cancelled), the numbers in each, the move date once the carrier sets it, and anything the carrier needs fixed. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List port orders
  • list_provider_opt_outsThe numbers the provider's own opt-out handling has blocked after they texted STOP.Reads text others writeNo findings

    Why it is in this group

    • The name "list_provider_opt_outs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The numbers the provider's own opt-out handling has blocked after they texted STOP. Telnyx publishes this list (by messaging profile); Twilio does not (a send to such a number comes back as Twilio error 21610), and the answer says so. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List the provider's opt-outs
  • list_published_postsList every post Hermoso has recorded publishing for this brand, newest first, across all channels — channel, permalink, caption, format, the HOOK and SUBJECT it was written to, and…Reads text others writeNo findings

    Why it is in this group

    • The name "list_published_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe name "list_published_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List every post Hermoso has recorded publishing for this brand, newest first, across all channels — channel, permalink, caption, format, the HOOK and SUBJECT it was written to, and its measured engagement. The WHOLE history, no cap: pass the reply's nextCursor as `cursor` for older posts. Each row says how it was recorded: 'captured' (written at publish time — the hook is what the author intended) or 'backfilled' (reconstructed from the platform afterwards). A dash for engagement means the platform reported no number — NOT zero. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List what this brand has published
    • idempotentHint: true
  • list_scheduledUse this when the user asks what is scheduled, what already posted, or whether a post went out.Reads text others writeNo findings

    Why it is in this group

    • The name "list_scheduled" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Use this when the user asks what is scheduled, what already posted, or whether a post went out. Show what is queued to post and what already went out. Each fired item reports PER-CHANNEL outcomes, so you can see that (say) Instagram published and TikTok failed on the same item rather than a single misleading verdict. Past items are rebuilt from published-post records, one row per channel; they are not job runs (use list_jobs for those). THE LIST IS COMPACT so it fits in one reply: the next 25 queued and the last 15 fired, captions shortened. Pass `id` for ONE post in full (every caption and setting, which you need before reschedule_post replaces a caption map), `channel` to filter, or `upcoming` / `fired` for more rows. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List scheduled and past posts
  • list_sheet_tabsThe tabs in a Google Spreadsheet, each with its name, numeric sheetId, row/column count and position.Reads text others writeNo findings

    Why it is in this group

    • The name "list_sheet_tabs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The tabs in a Google Spreadsheet, each with its name, numeric sheetId, row/column count and position. Call this BEFORE naming a tab in update_sheet / clear_sheet_range / manage_sheet_tabs / format_sheet, and before proposing to delete one — it is how you learn what the file actually contains instead of guessing at a name. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the tabs in a Google Sheet
    • idempotentHint: true
  • list_shopify_articlesList the blog articles on the brand's Shopify store, most recently changed first: published, scheduled and drafts, each with its id, status, title and public address.Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_articles" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the blog articles on the brand's Shopify store, most recently changed first: published, scheduled and drafts, each with its id, status, title and public address. Free. Shopify has no view counts on an article, so this carries none.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Shopify blog articles
  • list_shopify_blogsList the blogs on the brand's Shopify store (most stores have one), each with its id and handle.Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_blogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the blogs on the brand's Shopify store (most stores have one), each with its id and handle. This is where the `blog` for post_to_shopify_blog comes from when a store has several. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Shopify blogs
  • list_shopify_discount_codesThe discount codes on the merchant's Shopify store, newest first: the code, what it takes off, the minimum purchase, start and end, the use limit, how many times it has been used (…Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_discount_codes" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The discount codes on the merchant's Shopify store, newest first: the code, what it takes off, the minimum purchase, start and end, the use limit, how many times it has been used (Shopify updates that count in the background, so it can lag a few minutes) and its status (ACTIVE, SCHEDULED or EXPIRED). Filter by status (active, scheduled, expired) or search the title. Pass cursor for more. This is where the id for disable_shopify_discount_code comes from. Read-only, free. Works for the Shopify store connected to this brand (Connectors > Shopify, or connect_shopify_store) or the store this account was installed on.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Shopify discount codes
  • list_shopify_locationsThe merchant's Shopify stock locations (warehouses, shops): id, name, whether it is active and whether it fulfils online orders.Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_locations" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The merchant's Shopify stock locations (warehouses, shops): id, name, whether it is active and whether it fulfils online orders. Use the id or the name in set_shopify_inventory. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Shopify locations
  • list_shopify_ordersThe merchant's Shopify orders, newest first: order number, date, total, payment and fulfilment status, discount codes used, where the buyer came from (Shopify's last visit before t…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_orders" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The merchant's Shopify orders, newest first: order number, date, total, payment and fulfilment status, discount codes used, where the buyer came from (Shopify's last visit before the order: its source and UTM tags) and the buyer's name and email. Default the last 30 days; pass days OR from/to (Shopify lets apps read the last 60 days of orders, and an older start is refused with that rule). Filter by status, financialStatus or discountCode. Pass id for ONE order in full: its items, first and last visit, landing page and days to convert. If Shopify has not approved access to customer names and emails for this app yet, the reply says so: a missing name or email is then not an empty one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Shopify orders
  • list_shopify_productsThe merchant's real Shopify products — id, title, description, price, images and storefront URL.Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The merchant's real Shopify products — id, title, description, price, images and storefront URL. This is where the productId for publish_to_shopify_product comes from, and it doubles as ground truth about what the brand actually sells (real titles and real photos, not a guess from the website). Newest-updated first. Works for the Shopify store connected to this brand (Connectors > Shopify, or connect_shopify_store) or the store this account was installed on. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Shopify catalog
    • idempotentHint: true
  • list_shopify_sms_buyersThe connected Shopify store's recent buyers (orders) and open abandoned checkouts that have a phone number, over the last `days` (default 7, up to 60): name, phone, order or checko…Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_sms_buyers" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The connected Shopify store's recent buyers (orders) and open abandoned checkouts that have a phone number, over the last `days` (default 7, up to 60): name, phone, order or checkout link, total, and their SMS marketing consent state in Shopify. kind orders, abandoned or both; subscribedOnly:true keeps only those Shopify marks SUBSCRIBED. send_sms texts the ones chosen. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Shopify buyers with a phone
  • list_shopify_storesThe Shopify store this brand works with: the one connected in Connectors > Shopify (via 'linked', paid from this Hermoso account) or the store this account was installed on from th…No findings

    Why it is in this group

    • The name "list_shopify_stores" says "list": a word for reading.
    Description, as the server wrote it
    The Shopify store this brand works with: the one connected in Connectors > Shopify (via 'linked', paid from this Hermoso account) or the store this account was installed on from the Shopify App Store (via 'app_store'). For each: live (the Hermoso app is still installed), missing (permissions the store has not approved yet, such as read_orders and read_customers for a store that installed before they were added) and openUrl, where the store's owner opens Hermoso in their Shopify admin and approves them. Nothing connected: connect_shopify_store. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Which Shopify store this brand works with
  • list_skillsList the bundled Hermoso SKILLS — multi-step workflow instructions (SKILL.md) that orchestrate the other tools (research an ad space, plan+render a finished ad, product photoshoot,…No findings

    Why it is in this group

    • The name "list_skills" says "list": a word for reading.
    Description, as the server wrote it
    List the bundled Hermoso SKILLS — multi-step workflow instructions (SKILL.md) that orchestrate the other tools (research an ad space, plan+render a finished ad, product photoshoot, raw generation) — plus the in-app strategy skills and creative recipes. Call get_skill to load a bundle. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List skills
    • idempotentHint: true
  • list_slack_channelsThe 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…Reads text others writeNo findings

    Why it is in this group

    • The name "list_slack_channels" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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. Use it before posting when the user has not named a channel, and to show them the choice. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Slack channels
  • list_slack_membersThe people in a Slack workspace the Hermoso app is in: member id, @name, full name, display name and title.Reads text others writeNo findings

    Why it is in this group

    • The name "list_slack_members" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The people in a Slack workspace the Hermoso app is in: member id, @name, full name, display name and title. Bots, apps and deactivated accounts are left out, and no email address is read. Use it to find who to message before send_slack_dm; `query` takes part of a name. Needs the Hermoso app in the Slack workspace with its direct-message permissions: a workspace that added the app before 2026-11-15 adds it again once under Connectors > Slack (the tool says so). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Slack workspace members
  • list_slack_scheduledMessages the Hermoso app scheduled IN SLACK (post_to_slack with postAt) that have not posted yet.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_slack_scheduled" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Messages the Hermoso app scheduled IN SLACK (post_to_slack with postAt) that have not posted yet. Posts queued with schedule_post are in list_scheduled instead. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List messages scheduled in Slack
  • list_sms_consentsThe brand's consent records and opt-out list: each number with where and when it agreed, and whether and when it opted out.Reads text others writeNo findings

    Why it is in this group

    • The name "list_sms_consents" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's consent records and opt-out list: each number with where and when it agreed, and whether and when it opted out. phone reads one number; optedOut:true lists the opt-out list only. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List SMS consent and opt-outs
  • list_swipefileList this workspace's SWIPEFILE — the saved-ad research board: every named collection and the ads/creatives kept in it (advertiser, headline, body copy, media URL, platform, when i…Reads text others writeNo findings

    Why it is in this group

    • The name "list_swipefile" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "list" and "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    List this workspace's SWIPEFILE — the saved-ad research board: every named collection and the ads/creatives kept in it (advertiser, headline, body copy, media URL, platform, when it was saved, and any taste tags). The SAME board the web app's Swipefile tab shows. Use it to answer "what have we saved?", to mine the user's own taste before planning an ad, or to find a reference to remix. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List the swipefile
    • idempotentHint: true
  • list_teamList the members of the current profile — email, role (admin/member) and status.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_team" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "list" and "email": it reads mail.
    • untrusted-inputThe description's first sentence says "list" and "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    List the members of the current profile — email, role (admin/member) and status. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List team members
    • idempotentHint: true
  • list_telegram_chatsFind the chat ids this Telegram bot can be addressed by.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_telegram_chats" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_telegram_chats" says "list" and "chat": it reads messages.
    • private-dataThe description's first sentence says "find" and "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_telegram_chats" says "list" and "chat": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "find" and "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Find the chat ids this Telegram bot can be addressed by. STATE THE LIMIT WHENEVER YOU USE IT: this is NOT the list of chats the bot belongs to — the Bot API publishes no such method — it is every chat that SENT the bot an update in the last 24 hours, which is as long as Telegram keeps an update. A channel the bot posts to every day but nobody messages will NOT appear here, and its absence means nothing at all: post to it by @username or numeric id anyway. If the bot has an outgoing WEBHOOK configured the list is empty for that reason alone (Telegram: getUpdates "will not work if an outgoing webhook is set up"), and the reply says so rather than reading as an empty account. Nothing is consumed — no update offset is confirmed, so this cannot eat the bot’s pending updates. Free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Find Telegram chat ids
  • list_telegram_dmsRead 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.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_telegram_dms" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    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. Reply with post_to_telegram using the chatId shown. Warning: THIS IS A ROLLING 24-HOUR WINDOW, NOT AN INBOX. Telegram keeps undelivered updates for 24 hours and publishes NO history endpoint at all, so anything older is unrecoverable — never report an empty result as 'you have no messages', report it as 'nothing in the last 24 hours'. Two more Telegram rules worth stating before someone concludes the feature is broken: a bot that has an outgoing WEBHOOK configured gets nothing from this at all (Telegram's own rule, and the reply says so), and a bot can never message someone first — they have to write to it. Free — no vendor charge and no credits. Needs Telegram connected (Connectors > Telegram, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read messages sent to your Telegram bot
  • list_threads_postsList recent posts on the brand’s connected Threads account (id, text, media, permalink, timestamp).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_threads_posts" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_threads_posts" says "list" and "thread": it reads messages.
    • private-dataThe description's first sentence says "list" and "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_threads_posts" says "list" and "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List recent posts on the brand’s connected Threads account (id, text, media, permalink, timestamp). Use it to find a post id for threads_insights, list_threads_replies, reply_to_thread or delete_thread.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List your Threads posts
    • idempotentHint: true
  • list_threads_profile_postsThe recent PUBLIC posts of any Threads account.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_threads_profile_posts" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_threads_profile_posts" says "list" and "thread": it reads messages.
    • private-dataThe description's first sentence says "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_threads_profile_posts" says "list" and "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The recent PUBLIC posts of any Threads account. AN EMPTY LIST IS NEVER PROOF THEY HAVE NOT POSTED — Meta returns nothing for a private account, for any account under 100 followers, and when the Threads connection predates the `threads_profile_discovery` permission (approved for the app 2026-09-05; reconnect Threads to grant it); the note says which of those applies. Read-only, 0 credits. Needs Threads connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a public Threads account’s posts
    • idempotentHint: true
  • list_threads_repliesRead the replies on a Threads post.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_threads_replies" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_threads_replies" says "list" and "thread": it reads messages.
    • private-dataThe description's first sentence says "read" and "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_threads_replies" says "list" and "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "reply": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the replies on a Threads post. Set conversation:true to walk the entire thread rather than only direct replies. Use before reply_to_thread so you answer with the actual conversation in view.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List replies on a Threads post
    • idempotentHint: true
  • list_tiktok_brand_hashtag_postsPublic posts whose captions carry one of the brand hashtags this account has enabled.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_brand_hashtag_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_brand_hashtag_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Public posts whose captions carry one of the brand hashtags this account has enabled. It is the hashtag half of brand monitoring, where list_tiktok_mentions covers @-mentions. Omit `hashtag` for the top posts across every enabled tag; pass one to narrow to it. TWO TIKTOK BEHAVIOURS THAT READ AS BUGS IF NOBODY SAYS THEM: the hashtag filter is CASE-SENSITIVE and must exactly match an enabled tag, and filtering to one tag makes matched_hashtags come back EMPTY on every row. NOTHING IS RETURNED UNTIL HASHTAGS ARE ENABLED. That is a setup step rather than a result: use list_tiktok_brand_hashtags and manage_tiktok_brand_hashtags first, and allow 24 hours after enabling. Capped at the top 1,000 posts of the last 90 days. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights permission. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Posts carrying the brand’s hashtags on TikTok
    • idempotentHint: true
  • list_tiktok_brand_hashtagsThe brand hashtags this account curates, in two flavours.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_brand_hashtags" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand hashtags this account curates, in two flavours. kind:'ENABLED' is what TikTok is currently counting (with the date each was turned on, and whether it is old enough to remove). kind:'AVAILABLE' is what TikTok will ACCEPT. A tag qualifies once it has appeared in at least three post captions, either from this account or from a post mentioning its handle. A tag containing the account handle as a substring can also be enabled even when it is not on the available list. AT MOST 50 CAN BE ENABLED PER BRAND. TikTok's own caveat on the available list: test and newly created accounts often return nothing and should not be used to judge whether this works. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights permission. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: The brand hashtags TikTok tracks for this account
    • idempotentHint: true
  • list_tiktok_comment_repliesAll replies to a single comment on a post the authorized TikTok account owns — the complete list, where list_tiktok_comments only ever attaches three.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_comment_replies" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_comment_replies" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "reply": it reads comments, which other people can write.
    Description, as the server wrote it
    All replies to a single comment on a post the authorized TikTok account owns — the complete list, where list_tiktok_comments only ever attaches three. TIKTOK DOES NOT RETURN REPLIES TO A HIDDEN COMMENT AT ALL, so an empty list against a hidden parent means 'cannot read', never 'no replies' — check the parent's status first if the answer looks wrong. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION (see tiktok_account_status). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List every reply to one TikTok comment
    • idempotentHint: true
  • list_tiktok_commentsRead the comments on a TikTok post the AUTHORIZED ACCOUNT OWNS — this is TikTok's answer to list_meta_comments and list_youtube_comments.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_comments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_comments" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the comments on a TikTok post the AUTHORIZED ACCOUNT OWNS — this is TikTok's answer to list_meta_comments and list_youtube_comments. It sees BOTH public and hidden comments, and by default returns both: TikTok's `status` defaults to ALL, so the list mixes comments the owner hid with comments TikTok's own moderation, privacy or spam filters hid, and those are not the same thing (the second kind may refuse to unhide). Pass status:'PUBLIC' for only what the public sees. A row carrying parentCommentId IS A REPLY, not a top-level comment — that is how TikTok distinguishes them. include_replies attaches at most THREE replies per comment; use list_tiktok_comment_replies for all of them. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION, which is a separate consent from the TikTok Ads advertiser connection — tiktok_account_status says whether this profile has it. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List comments on one of the brand’s TikTok posts
    • idempotentHint: true
  • list_tiktok_mentionsWho is talking about the brand on TikTok: every public post whose CAPTION @-mentions the connected account's handle.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_mentions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_mentions" says "list" and "mention": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Who is talking about the brand on TikTok: every public post whose CAPTION @-mentions the connected account's handle. This is TikTok's answer to x_mentions and list_threads_mentions, and it is the brand-monitoring read the product had for every other channel and not for TikTok. FOUR THINGS TIKTOK ENFORCES THAT MAKE AN EMPTY RESULT AMBIGUOUS, so read them before reporting silence: the mentioning post must be PUBLIC, it must be under 90 days old, its author must not be underage or of unknown age, and THE WHOLE FAMILY ONLY WORKS FOR A TIKTOK BUSINESS ACCOUNT, so a personal account returns nothing at all (tiktok_account_insights reports which one this is). Capped at the top 1,000 mentioning posts however many exist. VIEWS AND REACH COME BACK NULL, NOT ZERO, on any post under 1,000 of either. That is TikTok withholding a number, never a measurement of nothing. Thumbnail URLs expire after 48 hours. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION with the brand-insights permission (tiktok_account_status says whether this profile has it). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Posts that mention the brand on TikTok
    • idempotentHint: true
  • list_tiktok_videosThe connected account’s own TikTok posts with per-video stats — views, likes, comments, shares, duration, cover image and link.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_videos" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The connected account’s own TikTok posts with per-video stats — views, likes, comments, shares, duration, cover image and link. TWO WAYS TO ASK: with no arguments it lists the most recent (newest first, up to 20 a page); with videoIds it reads THOSE posts directly however old they are, which is how you answer "how did that specific video do" without paging back through the account. Any id TikTok does not return comes back under `unresolved` — meaning it is not on this account or no longer exists, which TikTok does not distinguish — never as a zero. Only ever the connected user’s OWN videos. Warning: TIKTOK OFFERS NO WAY TO DELETE OR EDIT A PUBLISHED POST through its API — not the caption, not the privacy level, not the comment/duet/stitch settings, not the cover. Every one of those is fixed at the moment of publishing. If the user wants a TikTok changed or taken down, tell them plainly that it has to be done in the TikTok app; do not look for a tool for it. Read-only, 0 credits. Needs TikTok connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the connected account’s TikTok posts
    • idempotentHint: true
  • list_voice_agent_batchesThe platform's batch calls with their status and counts (Vapi campaigns, ElevenLabs batches, Telnyx scheduled calls of an agentId).Reads text others writeNo findings

    Why it is in this group

    • The name "list_voice_agent_batches" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The platform's batch calls with their status and counts (Vapi campaigns, ElevenLabs batches, Telnyx scheduled calls of an agentId). Retell keeps no batch list: pass batchId to read that batch's calls. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List voice-agent batches
  • list_voice_agent_numbersThe phone numbers on the voice platform and the agent each one answers (and calls out as), plus the brand's Twilio or Telnyx numbers Hermoso forwards to an agent.Reads text others writeNo findings

    Why it is in this group

    • The name "list_voice_agent_numbers" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The phone numbers on the voice platform and the agent each one answers (and calls out as), plus the brand's Twilio or Telnyx numbers Hermoso forwards to an agent. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List voice-agent numbers
  • list_voice_agent_voicesThe voices a voice agent can use on the connected platform: Retell's and ElevenLabs' voice libraries (name, id, gender, accent, preview), Telnyx's by voiceProvider (telnyx, aws, az…Reads text others writeNo findings

    Why it is in this group

    • The name "list_voice_agent_voices" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The voices a voice agent can use on the connected platform: Retell's and ElevenLabs' voice libraries (name, id, gender, accent, preview), Telnyx's by voiceProvider (telnyx, aws, azure, elevenlabs, minimax …), and Vapi's own voices (Vapi lists no others over its API; any provider's voiceId can still be set). search, language, gender narrow it. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List voice-agent voices
  • list_voice_agentsThe AI voice agents on the brand's own Vapi, Retell AI, ElevenLabs or Telnyx account (every connected one unless provider is given): name, id, voice, model, last change.Reads text others writeNo findings

    Why it is in this group

    • The name "list_voice_agents" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The AI voice agents on the brand's own Vapi, Retell AI, ElevenLabs or Telnyx account (every connected one unless provider is given): name, id, voice, model, last change. Read live from the platform. Free. Needs Vapi, Retell AI or ElevenLabs connected (Connectors, or connect_connector with the API key), or Telnyx for its AI Assistants.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List voice agents
  • list_webflow_collectionsList the CMS collections on the brand's Webflow site and which one blog posts go to.Reads text others writeNo findings

    Why it is in this group

    • The name "list_webflow_collections" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the CMS collections on the brand's Webflow site and which one blog posts go to. With collectionId it also returns that collection's fields and how a post maps onto them (body, summary, cover image, search fields), which is what fieldData in post_to_webflow is keyed by, and `required`: the fields the collection REQUIRES, split into `auto` (filled from the post: title, summary, cover image) and `ask` (to pass in fieldData), each asked field with its allowed values (a Reference's items by name and id, an Option's options). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Webflow CMS collections
  • list_webflow_itemsList the items in the brand's Webflow blog collection, most recently changed first: published, drafts and items with unpublished changes, each with its id, status, title and public…Reads text others writeNo findings

    Why it is in this group

    • The name "list_webflow_items" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the items in the brand's Webflow blog collection, most recently changed first: published, drafts and items with unpublished changes, each with its id, status, title and public address. Free. Webflow has no view counts on an item, so this carries none.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Webflow blog items
  • list_whatsapp_accountsThe 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…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_whatsapp_accounts" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    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 how many messages Meta will let it send. Start here. A WABA with no number cannot send anything and the reply says so: Hermoso does not register or verify numbers, that is WhatsApp Manager. A business portfolio that could not be read is REPORTED rather than dropped — an account missing from this list would read as "the brand has no WhatsApp", which is a claim about their business and not about our read. TWO ACCOUNTS CAN CARRY THE SAME DISPLAY NAME — always quote the `display` field or the id when naming one to a user, never the bare name. ONLY THE ACCOUNTS SHARED WITH THIS PROFILE ARE REACHABLE. One Meta login often administers WhatsApp for several businesses, so a human ticks which belong to this profile under Connectors > Meta > Manage accounts (or set_connector_accounts(provider:"meta")); nothing else here can see or touch the rest. With none ticked every WhatsApp tool refuses and names that as the way out. With exactly ONE ticked, wabaId is optional — pass it only to disambiguate. Read-only, 0 credits (WhatsApp conversations are billed by META to the business directly, never in Hermoso credits). Needs Meta connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: WhatsApp Business accounts and numbers
    • idempotentHint: true
  • list_whatsapp_templatesThe message templates on one WhatsApp Business Account with the REVIEW STATUS Meta actually holds for each.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_whatsapp_templates" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The message templates on one WhatsApp Business Account with the REVIEW STATUS Meta actually holds for each. THE STATUS IS THE POINT: an APPROVED template is the only thing WhatsApp accepts outside the 24-hour customer-service window, and Meta’s own refusal for anything else says "the template does not exist in the specified language or the template has not been approved" — two completely different problems in one sentence. Each row also reports its LANGUAGE, because Meta treats en and en_US as different templates and sending against the wrong one is refused as if it were unapproved. Each row also reports the VARIABLES the template carries — the distinct {{1}}, {{2}} placeholders per component, with the total — because send_whatsapp_message must supply EXACTLY that many and Meta refuses a mismatch with 132000. Read the count off that field, never off the one-line body preview, which is capped. Read-only, 0 credits. Needs Meta connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: WhatsApp message templates
    • idempotentHint: true
  • list_wix_postsList the posts on the brand's Wix blog, most recently edited first: published, scheduled and drafts, each with its id, status, title and public address.Reads text others writeNo findings

    Why it is in this group

    • The name "list_wix_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_wix_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the posts on the brand's Wix blog, most recently edited first: published, scheduled and drafts, each with its id, status, title and public address. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Wix blog posts
  • list_wordpress_postsList 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.Reads text others writeNo findings

    Why it is in this group

    • The name "list_wordpress_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_wordpress_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    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. Free. WordPress publishes no per-post view counts, so this carries none.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List WordPress posts
  • list_wordpress_termsList the WordPress site's categories or tags (kind), most-used first, each with its id.Reads text others writeNo findings

    Why it is in this group

    • The name "list_wordpress_terms" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the WordPress site's categories or tags (kind), most-used first, each with its id. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List WordPress categories or tags
  • list_x_blocksThe accounts the connected X account has BLOCKED, with handle, name, bio and follower count.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_blocks" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The accounts the connected X account has BLOCKED, with handle, name, bio and follower count. READ-ONLY: X refuses the block and unblock WRITE on the access tier Hermoso's app runs on (measured 2026-09-15: X's own "attached to a Project" refusal with the scope granted), so blocking itself is done on x.com and there is no block tool here. Needs the block.read permission: an X connection made before 2026-09-15 must be reconnected once under Connectors > X. Costs credits (X bills per API call).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Who the connected X account has blocked
    • idempotentHint: true
  • list_x_broadcastsThe connected X account's LIVE VIDEO broadcasts: past and current ones (title, state, share URL, live and total viewers, start/end) and SCHEDULED ones (start, end, whether it goes …Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_broadcasts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The connected X account's LIVE VIDEO broadcasts: past and current ones (title, state, share URL, live and total viewers, start/end) and SCHEDULED ones (start, end, whether it goes live automatically or waits for go_live). kind 'all' (default) reads both, 'live' or 'scheduled' one; pass id for a single broadcast. Read-only. Needs X connected with the broadcast permissions added 2026-09-21: an X connection made before then must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X live broadcasts
    • idempotentHint: true
  • list_x_chatsThe connected X account's X CHAT conversations: id (group ids start with g), type, muted, disappearing-message timer, screenshot controls, admins, members, PENDING join requests, w…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_x_chats" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_x_chats" says "list" and "chat": it reads messages.
    • private-dataThe description's first sentence says "chat": it reads messages.
    • private-dataThe input names an inbox (input.inbox), and the tool reads: it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_x_chats" says "list" and "chat": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The connected X account's X CHAT conversations: id (group ids start with g), type, muted, disappearing-message timer, screenshot controls, admins, members, PENDING join requests, which actions are admin-only, and the active invite link. X Chat is END-TO-END ENCRYPTED, so message text and group names cannot be read here (list_x_dms reads the plain direct-message history). A filtered page can be short or empty while more remain: keep paging with the same filters. view 'admin_requests' (id = a group the brand admins) lists who asked to become an admin; view 'invite' (inviteLink, or id + inviteToken) previews an invite link: group name, member count, whether the brand is in it. view 'message_requests' lists the MESSAGE REQUESTS waiting outside the inbox (inbox 'priority', the default, or 'low_quality' for X's filtered tab): who sent each one (@handle, name, followers, verified), which accounts the brand follows also follow them, and whether they changed their name or picture recently (X's impersonation hint). A message sent in X Chat is encrypted and cannot be read; one sent as a plain direct message can, with list_x_dms participantId = the sender. Show that to the user before manage_x_chat accept_request. withMembers:true resolves member @handles, and each user X returns is billed. Read-only. Billed per conversation or request returned, plus one user lookup per request sender, so keep maxResults small. Needs X connected with direct-message access: an X connection made before 2026-08-25 must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List X Chat conversations
  • list_x_dmsRead the direct messages sent to the connected X account and group them into conversations, newest first — who is waiting on a reply, in their own words.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_x_dms" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Read the direct messages sent to the connected X account and group them into conversations, newest first — who is waiting on a reply, in their own words. Use it for 'any new DMs on X', 'what did they say', 'anything I need to answer'. Reply with send_x_dm. Messages sent in X Chat are end-to-end encrypted and are NOT in this read, so never say someone did not write from it alone: list_x_chats shows which conversations are unread. COSTS CREDITS PER MESSAGE RETURNED plus one account lookup, so keep maxResults small (default 10) and tell the user the cost before pulling a big page. X KEEPS 30 DAYS of direct-message history and offers no date filter, so a short list can mean an old conversation rather than a quiet inbox — say so rather than reporting silence. There is no conversation-list endpoint at X: this builds the thread list by reading events and grouping them, so a conversation whose last message is older than the page you pulled will not appear. Needs X connected, AND an X account connected before direct messages shipped must be reconnected once (Connectors > X) — X only grants permissions at authorize time.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read your X direct messages
    • idempotentHint: true
  • list_youtube_captionsList the caption/subtitle tracks on one of the connected channel’s videos, and optionally DOWNLOAD one as text.Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_captions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the caption/subtitle tracks on one of the connected channel’s videos, and optionally DOWNLOAD one as text. A caption TRACK is not the same thing as burned-in captions: a track is what YouTube indexes the video by, what a viewer toggles on, and what accessibility depends on. Each row says whether YouTube generated it automatically (`isAutoGenerated`, trackKind ASR) — those are read-only and cannot be edited or deleted. Downloading also returns an existing video's full script for repurposing. Read-only, 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List (and read) a video’s caption tracks
    • idempotentHint: true
  • list_youtube_categoriesList the video categories YouTube will accept on an upload in a given country.Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_categories" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the video categories YouTube will accept on an upload in a given country. post_to_youtube takes a `categoryId` and this is the only way to discover a valid one — the id set AND the names differ by country, which is why regionCode is required rather than defaulted. Categories YouTube marks not-assignable are filtered out by default because an upload using one is refused. Read-only, 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the video categories you can publish under
    • idempotentHint: true
  • list_youtube_comment_repliesEvery reply under ONE comment on the connected channel, newest pages first via cursor: check that a reply the brand posted landed, or whether someone already answered a viewer befo…Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_comment_replies" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_youtube_comment_replies" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "reply": it reads comments, which other people can write.
    Description, as the server wrote it
    Every reply under ONE comment on the connected channel, newest pages first via cursor: check that a reply the brand posted landed, or whether someone already answered a viewer before replying. Pass the top-level comment id from list_youtube_comments (each comment line shows its id and reply count); a REPLY id is recognised and its whole thread is returned, with `note` and `requestedId` saying so. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the replies under one YouTube comment
    • idempotentHint: true
  • list_youtube_commentsRead the comments under a video on the connected channel — the questions, objections and exact wording real viewers use.Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_comments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_youtube_comments" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the comments under a video on the connected channel — the questions, objections and exact wording real viewers use. Same raw material for ad copy that list_meta_comments gives you on Meta. Returns author, text, like count, timestamp, reply count and comment id, newest first — plus `imageUrl` when a viewer attached an image or GIF to the comment (a signed YouTube link that expires six hours after the read, so download it then if it needs keeping). Read-only, 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read comments on one of your YouTube videos
    • idempotentHint: true
  • list_youtube_playlistsList the playlists on the connected YouTube channel — id, title, description, privacy and video count.Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_playlists" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the playlists on the connected YouTube channel — id, title, description, privacy and video count. Pass a playlistId to get that ONE playlist plus its entries in order. IMPORTANT: each entry carries BOTH a `videoId` and an `itemId`; `itemId` is the playlist-ENTRY id and is what manage_youtube_playlist_items needs to remove or re-order a row, because one video can appear in a playlist more than once so a videoId does not identify the entry. Read-only, 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the channel’s playlists (and what is in one)
    • idempotentHint: true
  • list_youtube_report_jobsThe YouTube BULK reporting jobs running on this channel — which report each one generates, its report type id, and when it was scheduled.Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_report_jobs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The YouTube BULK reporting jobs running on this channel — which report each one generates, its report type id, and when it was scheduled. Call this to find out whether thumbnail-CTR history is already accumulating, and since when, BEFORE promising a user a number: the bulk API can only answer about days after a job existed. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List YouTube bulk reporting jobs
    • idempotentHint: true
  • list_youtube_video_statsViews, likes and comment counts for up to 50 YouTube videos IN ONE CALL, which is how to answer "how are my last twenty uploads doing" without one youtube_video_insights per video.Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_video_stats" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "view" and "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    Views, likes and comment counts for up to 50 YouTube videos IN ONE CALL, which is how to answer "how are my last twenty uploads doing" without one youtube_video_insights per video. Pass videoIds from list_youtube_videos. IT CARRIES NO TITLES, and that is the resource rather than a bug: VideoStatsSnippet publishes only publishTime, so join on videoId with list_youtube_videos when a name is needed. YouTube calls this endpoint "intentionally not atomic", so a short answer is normal: a video that is private, deleted, or not visible to the connected account simply does not come back, and this tool names the missing ids. Never report a missing id as zero views. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Batch YouTube video stats
  • list_youtube_videosList the connected channel’s OWN recent uploads — video id, title, publish date, privacy and thumbnail (plus shortsThumbnail, 9:16, when YouTube serves one) — so you can resolve a …Reads text others writeNo findings

    Why it is in this group

    • The name "list_youtube_videos" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the connected channel’s OWN recent uploads — video id, title, publish date, privacy and thumbnail (plus shortsThumbnail, 9:16, when YouTube serves one) — so you can resolve a video WITHOUT asking the user for a link. Call this whenever the user names a video loosely ("my latest", "the shorts one", part of a title) and match it yourself; only ask them when two titles are genuinely ambiguous. This is the tool that gets you the videoId every other YouTube tool needs. Includes UNLISTED and PRIVATE videos, which are invisible to any public search. Read-only, 0 credits. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the brand’s own YouTube uploads
    • idempotentHint: true
  • meta_catalog_blast_radiusRead what is INSIDE a product catalog — how many products, which product sets — and get the exact sentence describing what deleting it would destroy.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read what is INSIDE a product catalog — how many products, which product sets — and get the exact sentence describing what deleting it would destroy. Free and read-only. CALL THIS BEFORE PROPOSING A DELETE: deleting a catalog is permanent and Meta offers no archive and no undo, so naming the cost should not require aiming the destructive call at the target and reading its refusal. It also gives you the catalog’s exact name, which delete_meta_catalog requires echoed back. 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What deleting a Meta catalog would destroy
    • idempotentHint: true
  • meta_webhook_statusWhat Meta ACTUALLY has recorded for this app on a Page — the fields it will push, read straight back from Meta rather than from anything we stored.Reads text others writeNo findings

    Why it is in this group

    • The name "meta_webhook_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What Meta ACTUALLY has recorded for this app on a Page — the fields it will push, read straight back from Meta rather than from anything we stored. CHECK THIS BEFORE CONCLUDING THAT WEBHOOKS ARE NOT WORKING: an unsubscribed Page is completely silent and looks identical to a quiet one, so an empty event feed is not evidence of anything until you have seen the subscription. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What a Page is subscribed to
    • idempotentHint: true
  • phone_service_statusWhether Hermoso phone is on for this brand: numbers, texts, calls, AI voice agents and one-time codes on Hermoso's own carrier account, paid in credits, with no outside account to …Reads text others writeNo findings

    Why it is in this group

    • The name "phone_service_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Whether Hermoso phone is on for this brand: numbers, texts, calls, AI voice agents and one-time codes on Hermoso's own carrier account, paid in credits, with no outside account to open. Answers on or off, the numbers it holds and when each renews, any new-account limits still in place, whether sending is paused, and the full price list in credits. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Hermoso phone status
  • pinterest_account_listsRead lists on the connected Pinterest account.Reads text others writeNo findings

    Why it is in this group

    • The name "pinterest_account_lists" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read lists on the connected Pinterest account. what: followers, following, following_boards, websites (each site and whether it is claimed; a site that is not claimed explains a refused link) or website_verification (the code to put on a site to claim it). Claiming itself happens in Pinterest. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest followers, following and websites
    • idempotentHint: true
  • preview_creator_campaignShort-lived, brand-only preview links (30 minutes) for every screen a creator sees: the join page, the invited creator's page, the creator's campaign view (with a sample post, feed…Reads text others writeNo findings

    Why it is in this group

    • The name "preview_creator_campaign" says "preview": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Short-lived, brand-only preview links (30 minutes) for every screen a creator sees: the join page, the invited creator's page, the creator's campaign view (with a sample post, feedback and a draft) and the marketplace card. Built from the saved campaign plus any unsaved settings in overrides (the same fields as update_creator_campaign). Nothing in a preview can be submitted, joined or agreed to; no creator, consent or email is made. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Preview a creator campaign as creators see it
  • query_notion_databaseRead the ROWS of a Notion database the user shared with Hermoso — e.g.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "query_notion_database" says "query": a word for reading.

    What it can reach

    • private-dataThe name "query_notion_database" says "query" and "database": it reads databases.
    • private-dataThe description's first sentence says "read" and "database": it reads databases.
    • private-dataThe input names a database (input.databaseId), and the tool reads: it reads databases.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the ROWS of a Notion database the user shared with Hermoso — e.g. the team's content calendar: each row's title, id, link and every property as a plain value (status, date, channels, caption, links), plus the database's columns with their types and options. Filter with match {"Status": "Scheduled"} (typed from the database's own columns) or a raw Notion filter object; sort with sortBy (a column, or created_time / last_edited_time) and direction. Up to 100 rows per call, cursor for more; the answer says when Notion stopped at its 10,000-result limit. Use it to import a calendar and schedule its posts, or to find the row update_notion_row changes. Read-only, free. Needs Notion connected (Connectors > Notion).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Notion database
    • idempotentHint: true
  • read_bluesky_dmRead a Bluesky DM conversation in CHRONOLOGICAL order (Bluesky returns newest-first on the wire; this reverses it so the conversation reads top to bottom).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_bluesky_dm" says "read": a word for reading.

    What it can reach

    • private-dataThe name "read_bluesky_dm" says "read" and "dm": it reads messages.
    • private-dataThe description's first sentence says "read" and "dm": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_bluesky_dm" says "read" and "dm": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "dm": it reads messages, which other people can write.
    Description, as the server wrote it
    Read a Bluesky DM conversation in CHRONOLOGICAL order (Bluesky returns newest-first on the wire; this reverses it so the conversation reads top to bottom). Each message says whether it was sent by this account. A message with no text is reported as DELETED rather than as an empty message — “they unsent it” and “they sent nothing” are different facts. Get a convoId from list_bluesky_convos.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the messages in one Bluesky conversation
    • idempotentHint: true
  • read_creator_campaignsThe brand's creator campaigns with their payout model, budget used, creators, posts to review, approved views and money held / payable / paid.Reads text others writeNo findings

    Why it is in this group

    • The name "read_creator_campaigns" says "read": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The brand's creator campaigns with their payout model, budget used, creators, posts to review, approved views and money held / payable / paid. With campaignId: that campaign's creators, latest posts and payout batches too. Also says whether payouts through Hermoso are switched on and the fee.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List creator campaigns, or read one in full
  • read_discord_channelRead a Discord channel's recent messages, newest first, for context — what members are saying before you write.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_discord_channel" says "read": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Read a Discord channel's recent messages, newest first, for context — what members are saying before you write. Other people’s text needs Discord’s Message Content intent; a message Discord withholds is marked contentHidden. member reads the bot’s direct messages with that person instead (answer with send_discord_dm); mentions:true reads what people said TO the bot (messages that mention it or reply to its posts) in the busiest channels. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Discord channel
  • read_docRead the text of a Google Doc Hermoso can reach — one it created, or one the user handed over with the Google file picker in the app (that is how an EXISTING doc becomes readable; …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_doc" says "read": a word for reading.

    What it can reach

    • private-dataThe name "read_doc" says "read" and "doc": it reads documents.
    • private-dataThe description's first sentence says "read" and "doc": it reads documents.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the text of a Google Doc Hermoso can reach — one it created, or one the user handed over with the Google file picker in the app (that is how an EXISTING doc becomes readable; find its id with list_drive_files). Pass documentId (from create_doc) OR paste a Google Docs URL as docUrl. Under the drive.file scope it reaches nothing else in the user’s Drive; if Google answers that the file was not found, the user has not picked it yet — ask them to pick it in the app rather than retrying. Returns the plain text of EVERY tab (each headed by its tab name when there are several), with smart chips (dropdowns, people, dates, rich links) shown as the text Docs displays, plus `dropdowns[]` — each chip with its title, current value and options, which is what update_doc dropdowns sets. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Google Doc
    • idempotentHint: true
  • read_intercom_conversationOne Intercom conversation in full: every message in order (customer, teammate, bot, internal note) as plain text, plus its state, assignee and tags.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_intercom_conversation" says "read": a word for reading.

    What it can reach

    • private-dataThe name "read_intercom_conversation" says "read" and "conversation": it reads messages.
    • private-dataThe description's first sentence says "conversation": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_intercom_conversation" says "read" and "conversation": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "conversation": it reads messages, which other people can write.
    Description, as the server wrote it
    One Intercom conversation in full: every message in order (customer, teammate, bot, internal note) as plain text, plus its state, assignee and tags. Read it before drafting a reply. Read-only, free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read an Intercom conversation
    • idempotentHint: true
  • read_meta_conversationThe messages in one DM thread, oldest to newest, each marked inbound or outbound — plus WHETHER A REPLY IS ALLOWED RIGHT NOW.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_meta_conversation" says "read": a word for reading.

    What it can reach

    • private-dataThe name "read_meta_conversation" says "read" and "conversation": it reads messages.
    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_meta_conversation" says "read" and "conversation": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "message": it reads messages, which other people can write.
    Description, as the server wrote it
    The messages in one DM thread, oldest to newest, each marked inbound or outbound — plus WHETHER A REPLY IS ALLOWED RIGHT NOW. Meta only permits a reply within 24 hours of the person acting, and the window is computed from their LAST MESSAGE rather than from the thread’s updated time (which includes our own replies and would report the window open for a day after WE spoke). Read this before drafting: "can I answer this?" is the question a person actually has, and finding out by being refused is the worst way to learn it. It also hands back `replyTo`, the id a reply goes to, so nobody has to guess which participant is the customer. EVERY MESSAGE SAYS WHAT IT IS: `kind` (text, story_mention, story_reply, share, image, video, audio, file, sticker, gif, template, unsupported, empty), a one-line `summary` to read out, and `attachments` / `story` / `share` / `inReplyTo` / `reactions`; content Meta withholds (unsupported, or a "use the latest app" placeholder) is `unavailable: true` with `unavailableReason`, never blank text. ON INSTAGRAM Meta serves only the 20 most recent messages — a truncated thread is unreachable history, not a short conversation, and the reply says so. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read one Messenger / Instagram DM thread
    • idempotentHint: true
  • read_notion_pageRead a Notion page the user shared with Hermoso, as markdown (pageId or a Notion link).Reads text others writeNo findings

    Why it is in this group

    • The name "read_notion_page" says "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read a Notion page the user shared with Hermoso, as markdown (pageId or a Notion link). A database id answers with its data sources instead. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Notion page
    • idempotentHint: true
  • read_sheetRead cells from a Google Sheet Hermoso can reach — one it created, or one the user handed over with the Google file picker in the app (that is how an EXISTING spreadsheet becomes r…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_sheet" says "read": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "file": it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read cells from a Google Sheet Hermoso can reach — one it created, or one the user handed over with the Google file picker in the app (that is how an EXISTING spreadsheet becomes readable; find its id with list_drive_files). Pass the spreadsheetId (from create_sheet) OR paste a Google Sheets URL as sheetUrl. If Google answers that the file was not found, the user has not picked it yet — ask them to pick it in the app rather than retrying. Returns a 2-D array of values.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Google Sheet range
    • idempotentHint: true
  • read_slack_channelRead a Slack channel's recent messages, newest first, for context — what the team is discussing before you write.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_slack_channel" says "read": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Read a Slack channel's recent messages, newest first, for context — what the team is discussing before you write. A public channel is joined first if needed; a private one needs /invite @Hermoso. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Slack channel
  • read_slack_dmRead the direct messages between the Hermoso app and ONE workspace member, newest first: what they answered after send_slack_dm, or what they wrote to the app.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_slack_dm" says "read": a word for reading.

    What it can reach

    • private-dataThe name "read_slack_dm" says "read" and "dm": it reads messages.
    • private-dataThe description's first sentence says "read" and "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_slack_dm" says "read" and "dm": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "message": it reads messages, which other people can write.
    Description, as the server wrote it
    Read the direct messages between the Hermoso app and ONE workspace member, newest first: what they answered after send_slack_dm, or what they wrote to the app. Leave member out to list EVERY direct message people sent the app, one line per person with whether it was answered (this needs the app’s im:read permission; an install made before 2026-11-16 is told to add Hermoso again). It reads only the app’s own DMs, never anyone else’s conversations. No DM yet is an empty list, said in words. Needs the Hermoso app in the Slack workspace with its direct-message permissions: a workspace that added the app before 2026-11-15 adds it again once under Connectors > Slack (the tool says so). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a Slack direct message thread
  • read_x_broadcast_chatThe chat on one of the connected X account's live broadcasts, newest first: message id, text, author handle, time and reply-to.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "read_x_broadcast_chat" says "read": a word for reading.

    What it can reach

    • private-dataThe name "read_x_broadcast_chat" says "read" and "chat": it reads messages.
    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "read_x_broadcast_chat" says "read" and "chat": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The chat on one of the connected X account's live broadcasts, newest first: message id, text, author handle, time and reply-to. Use it to answer viewers or find a message to moderate. Read-only. Needs X connected with the broadcast permissions added 2026-09-21: an X connection made before then must be reconnected once under Connectors > X (the tool says so without calling X). Costs credits (X bills per call).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read an X broadcast chat
    • idempotentHint: true
  • search_discord_membersFind members of the brand's Discord server by name: query matches the START of a username or nickname.Reads text others writeNo findings

    Why it is in this group

    • The name "search_discord_members" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Find members of the brand's Discord server by name: query matches the START of a username or nickname. Or read one member by userId. Returns each member's id (what send_discord_dm, assign_discord_role and remove_discord_role take), name and roles. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Find a Discord server member
  • search_instagram_audioAudio 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.Reads text others writeNo findings

    Why it is in this group

    • The name "search_instagram_audio" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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. Omit the query for what is TRENDING right now; pass one to search. Everything returned is audio Instagram has authorized for third-party use. Instagram offers this library only to an account linked to a Facebook Page and connected through Meta; an account connected through Instagram Login alone has none, and this says so. TO USE ONE, pass its `id` as `audioId` on post_to_meta or schedule_post (target instagram, a video): Instagram puts the track under the Reel itself. Download links expire after roughly 1.5 days. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Trending or searched Instagram audio
    • idempotentHint: true
  • search_instagram_hashtagRead 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 scrap…Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "search_instagram_hashtag" says "search": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "credential": it reads secrets.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...omment counts — on the brand’s own Meta credentials rather than a scraper. This is category..."

      What this check looks for
    Description, as the server wrote it
    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. This is category and competitor listening: find how a market actually talks about a product, then USE it. TWO EDGES AND THEY ANSWER DIFFERENT QUESTIONS: edge:"recent" (default) is what has been posted in the LAST 24 HOURS, which is Meta’s own hard limit, so a hashtag with millions of posts legitimately returns ZERO on a quiet day — never report that as "nobody is posting about this", ask again with edge:"top", which has no time limit. Only PUBLIC, non-promoted posts are ever returned, from public accounts only, and never in chronological order. A SHORT RESULT IS NOT A SMALL HASHTAG: Instagram limits a page by total response SIZE rather than by post count, so a tag whose posts are carousels returns fewer rows per page than a tag whose posts are single images — never compare two tags by how many rows came back. BUDGET: Instagram allows each Instagram account 30 UNIQUE hashtags in any rolling 7 days, so choose the tags deliberately; re-querying one already used in the window is free. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search a public Instagram hashtag
    • idempotentHint: true
  • search_instagram_shopping_productsThe products in one catalog that can actually be TAGGED on an Instagram post — this is where the product_id for a product tag comes from.Reads text others writeNo findings

    Why it is in this group

    • The name "search_instagram_shopping_products" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The products in one catalog that can actually be TAGGED on an Instagram post — this is where the product_id for a product tag comes from. Omit `q` to see everything tag-eligible; pass a product name or SKU to narrow it. THIS IS A SMALLER SET THAN THE CATALOG HOLDS: a product can be in the catalog, counted by list_meta_catalog_products, and still not be taggable, so an empty answer here is never evidence the catalog is empty. Meta only SHOWS a tag whose product review_status is "approved" — an unapproved one is accepted, stored and shown to nobody, so the reply flags them. Read-only, 0 credits. Whether Meta has approved Hermoso's app for the permission this needs is read LIVE from Meta: when it has not, list_connectors says so under Meta and this tool's refusal says Meta hasn't approved Hermoso for it yet. That is Meta's decision about Hermoso, not the user's connection, so never tell them to reconnect for it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find products to tag on Instagram
    • idempotentHint: true
  • search_intercom_contactsFind people in the brand's Intercom: by exact email, or by part of a name or email (query).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "search_intercom_contacts" says "search": a word for reading.

    What it can reach

    • private-dataThe name "search_intercom_contacts" says "search" and "contact": it reads contacts.
    • private-dataThe description's first sentence says "find" and "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "find" and "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Find people in the brand's Intercom: by exact email, or by part of a name or email (query). Returns id, role (user or lead), name, email, phone, created and last seen. Read-only, free. Needs Intercom connected (Connectors > Intercom, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search Intercom contacts
    • idempotentHint: true
  • search_linkedin_ad_librarySearch the ads running on LinkedIn, from LinkedIn’s OWN Ad Library, and get three things LinkedIn publishes for each ad: the advertiser’s actual TARGETING (location, language, audi…Reads text others writeNo findings

    Why it is in this group

    • The name "search_linkedin_ad_library" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Search the ads running on LinkedIn, from LinkedIn’s OWN Ad Library, and get three things LinkedIn publishes for each ad: the advertiser’s actual TARGETING (location, language, audience, company, job, age, gender, interests, traits — both the segments they INCLUDED and the ones they EXCLUDED), estimated impressions as a range plus the percentage split BY COUNTRY, and, for ads LinkedIn REMOVED, the advertising policy that was violated and how it was caught. Coverage is global. COVERAGE IS BOUNDED and the reply always says so: nothing created before 2023-06-01, and an ad is dropped one year after its last impression, so an empty result usually means the window rather than the market. 25 ads per page. Needs LinkedIn connected — no extra permission, any LinkedIn connection works. 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search LinkedIn’s official Ad Library
    • idempotentHint: true
  • search_linkedin_brand_partnershipsSearch ORGANIC LinkedIn posts that creators have themselves disclosed as brand partnerships — paid influencer content, not ads bought through Campaign Manager.Reads text others writeNo findings

    Why it is in this group

    • The name "search_linkedin_brand_partnerships" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "search" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Search ORGANIC LinkedIn posts that creators have themselves disclosed as brand partnerships — paid influencer content, not ads bought through Campaign Manager. Use it to see which creators a competitor is paying, what a sponsored post in your category actually looks like, or to vet a creator’s existing brand relationships before approaching them. DIFFERENT CONTRACT from the ad search, so do not carry parameters across: `keyword` is REQUIRED here, `dateRange` is an ENUM (PAST_24H / PAST_WEEK / PAST_MONTH) rather than a date range, and the reply is POST URLS ONLY — no advertiser, no targeting, no impressions. Posts are queryable for one year after publication. 25 per page. Needs LinkedIn connected, no extra permission. 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find sponsored creator posts on LinkedIn
    • idempotentHint: true
  • search_phone_numbersSearch the numbers available to buy on the brand's own Twilio or Telnyx account: by country (2-letter, default US), type (local, toll_free, mobile), areaCode, digits the number con…Reads text others writeNo findings

    Why it is in this group

    • The name "search_phone_numbers" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Search the numbers available to buy on the brand's own Twilio or Telnyx account: by country (2-letter, default US), type (local, toll_free, mobile), areaCode, digits the number contains, region (state), postalCode or locality, and capability (sms, mms, voice). Returns each number with its place, capabilities and, on Telnyx, its monthly cost. Nothing is bought. Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Search phone numbers to buy
  • search_threads_keywordSearch 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.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "search_threads_keyword" says "search": a word for reading.

    What it can reach

    • private-dataThe name "search_threads_keyword" says "search" and "thread": it reads messages.
    • private-dataThe description's first sentence says "search" and "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "search_threads_keyword" says "search" and "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "search" and "thread": it reads messages, which other people can write.
    Description, as the server wrote it
    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. Each post carries Meta’s is_reply, has_replies, is_quote_post and media_type. ExcludeReplies:true keeps original posts only; Threads has no reply filter, so replies are removed from its page, the result can be shorter than limit, and repliesExcluded counts them.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search Threads by keyword
    • idempotentHint: true
  • search_threads_locationsSearch Threads’ public place index by name (or by latitude+longitude) and get location ids.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "search_threads_locations" says "search": a word for reading.

    What it can reach

    • private-dataThe name "search_threads_locations" says "search" and "thread": it reads messages.
    • private-dataThe description's first sentence says "search" and "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "search_threads_locations" says "search" and "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "search" and "thread": it reads messages, which other people can write.
    Description, as the server wrote it
    Search Threads’ public place index by name (or by latitude+longitude) and get location ids. Use this when the brand has a PHYSICAL location — a restaurant, salon, gym, store — so the post can be geotagged to it. Pass the chosen id as post_to_meta(locationId) with target:"threads".

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find a place to tag on Threads
    • idempotentHint: true
  • search_xKeyword search across the PUBLIC X index — the last 7 days.Reads text others writeNo findings

    Why it is in this group

    • The name "search_x" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Keyword search across the PUBLIC X index — the last 7 days. X’s own search OPERATORS work and are the point: `from:nike`, `-is:retweet`, `has:media`, `has:links`, `lang:en`, `"exact phrase"`, `(a OR b)`. Every post comes back with impressions, likes, reposts, replies, quotes and bookmarks, so you can rank what actually landed rather than what merely exists. ONLY THE LAST 7 DAYS: the full archive needs a tier we do not hold, and an older window is refused by name rather than silently truncated. Costs a small number of credits (X bills per post read and per distinct author returned with them, and this bills the ACTUAL count returned, never the number asked for). Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search X (Twitter)
    • idempotentHint: true
  • sms_registration_statusThe brand's US A2P registrations on its own Twilio or Telnyx account, read live: 10DLC brands (status, identity status), campaigns (use case, status) and their Messaging Services o…Reads text others writeNo findings

    Why it is in this group

    • The name "sms_registration_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's US A2P registrations on its own Twilio or Telnyx account, read live: 10DLC brands (status, identity status), campaigns (use case, status) and their Messaging Services on Twilio, and toll-free verifications (number, status, rejection reason). Free. Needs Hermoso phone on (activate_phone_service) or Twilio or Telnyx connected (Connectors, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: 10DLC and toll-free status
  • threads_profileRead ANY public Threads account by handle — name, bio, avatar, verified badge, follower count, and its lifetime likes / quotes / reposts / views.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • private-dataThe name "threads_profile" says "thread": it reads messages.
    • private-dataThe description's first sentence says "read" and "thread": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "threads_profile" says "thread": it reads messages, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "thread": it reads messages, which other people can write.
    Description, as the server wrote it
    Read ANY public Threads account by handle — name, bio, avatar, verified badge, follower count, and its lifetime likes / quotes / reposts / views. This is competitor and creator research on Meta’s own data rather than a scraper: read a rival’s positioning straight off their profile instead of guessing it, then read what they are posting with list_threads_profile_posts and draft the brand’s answer. A bare handle ("nike"), an "@nike" and a threads.net profile link all resolve — Meta matches the handle EXACTLY, so a display name will not. IF NOTHING COMES BACK, DO NOT SAY THE ACCOUNT DOES NOT EXIST: read the note, which says whether that is a real absence or our app’s approval state. Meta looks up only accounts with 1,000 or more followers: a refusal for a smaller one is final, so do not retry it. Read-only, 0 credits. Needs Threads connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up a public Threads profile
    • idempotentHint: true
  • tiktok_accountRead the connected TikTok account: display name, username, bio, verified status, and their follower / following / total-likes / video counts.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the connected TikTok account: display name, username, bio, verified status, and their follower / following / total-likes / video counts. Use it for “how many followers do we have on TikTok”, “how is our TikTok doing”, or to confirm whose account is linked before posting. Read-only. Needs TikTok connected (Connectors > TikTok).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the connected TikTok account
    • idempotentHint: true
  • tiktok_account_statusReport whether this profile holds the TikTok ACCOUNT-HOLDER authorization — the SECOND, separate consent on the same TikTok app that the TikTok Ads connection uses.Reads text others write1 finding

    Why it is in this group

    • The name "tiktok_account_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The description contains "every other tool", wording about other tools or servers.

      Matched text

      description: "...ports the state, the TikTok business id every other tool in this family uses, the scopes the gra..."

      What this check looks for
    Description, as the server wrote it
    Report whether this profile holds the TikTok ACCOUNT-HOLDER authorization — the SECOND, separate consent on the same TikTok app that the TikTok Ads connection uses. TikTok issues two different grants: the ADVERTISER one (campaigns, budgets, reporting — that is `tiktok_ads`) and this ACCOUNT one, which is what lets Hermoso read and manage the comments on the brand's own TikTok posts and mint Spark-Ads authorization codes for them. Holding one does NOT give you the other, so a workspace can be fully connected for ads and still answer 'not connected' here — that is a real third state, not a broken session. Reports the state, the TikTok business id every other tool in this family uses, the scopes the grant actually carries, and any scope MISSING from it (TikTok binds scopes at authorize time and never retroactively, so a grant made before a scope was added simply does not have it and only a reconnect fixes that). Connecting is the one step that needs a browser — the reply carries the exact URL to send the user to. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check the TikTok account authorization
    • idempotentHint: true
  • tiktok_creator_infoRead the connected TikTok creator’s REAL posting options BEFORE posting: which privacy levels THEY are allowed to use, whether comments / duet / stitch are available on their accou…Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the connected TikTok creator’s REAL posting options BEFORE posting: which privacy levels THEY are allowed to use, whether comments / duet / stitch are available on their account, their maximum video length, and their nickname. TikTok REQUIRES that the user is shown these actual options and picks a privacy level — never assume or default one. Call this first, show the options, get the user’s pick, then call post_to_tiktok with destination:"post". The SAME privacy options govern PHOTO posts (slideshows), not just video — TikTok takes the same four levels on both. Needs TikTok connected (Connectors > TikTok).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the connected TikTok creator’s posting options
    • idempotentHint: true
  • x_mentionsRead the posts mentioning the connected X account — who is talking to the brand, in their own words, newest first.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "x_mentions" says "mention": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Read the posts mentioning the connected X account — who is talking to the brand, in their own words, newest first. Use it to find what deserves a reply (reply with post_to_x + replyToId) and to mine real objections and customer language for ad copy. COSTS CREDITS PER MENTION RETURNED and per distinct author X returns with them, plus one account lookup — keep maxResults small (default 10) and tell the user the cost before pulling a big page. Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read who is mentioning you on X
    • idempotentHint: true
  • x_search_countsThe VOLUME of a query on X over time — counts per day, hour or minute for the last 7 days, plus the total.Reads text others writeNo findings

    Why it is in this group

    • The name "x_search_counts" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The VOLUME of a query on X over time — counts per day, hour or minute for the last 7 days, plus the total. Use it to size a topic BEFORE spending behind it, or to tell a real spike from a flat line. Cheaper than search_x because it returns numbers rather than posts: one read regardless of volume. Needs X connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: How often a query is posted on X
    • idempotentHint: true
  • youtube_channelRead the brand’s connected YouTube channel — title + subscriber / view / video counts (for reporting), and whether CUSTOM THUMBNAILS are on (customThumbnails: enabled | needs_verif…Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the brand’s connected YouTube channel — title + subscriber / view / video counts (for reporting), and whether CUSTOM THUMBNAILS are on (customThumbnails: enabled | needs_verification | unavailable | unknown). When they are not on, the reply carries YouTube’s own step-by-step to turn them on (a phone verification in YouTube Studio), so check this before promising a custom thumbnail. Needs a connected YouTube channel.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Get the connected YouTube channel
    • idempotentHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

4589046 paths in this server alone from private data, through text someone else wrote, to a way out. Denying 66 private-data tools breaks every one.

deny to break every path
{
  "permissions": {
    "deny": [
      "mcp__hermoso-social-media-manager__billing_status",
      "mcp__hermoso-social-media-manager__find_instagram_marketplace_creators",
      "mcp__hermoso-social-media-manager__get_discord_message",
      "mcp__hermoso-social-media-manager__get_drive_file",
      "mcp__hermoso-social-media-manager__get_messenger_marketing_message_status",
      "mcp__hermoso-social-media-manager__get_meta_story",
      "mcp__hermoso-social-media-manager__get_onedrive_file",
      "mcp__hermoso-social-media-manager__get_port_order",
      "mcp__hermoso-social-media-manager__get_post_refill",
      "mcp__hermoso-social-media-manager__get_settings",
      "mcp__hermoso-social-media-manager__get_slack_message",
      "mcp__hermoso-social-media-manager__get_sms_status",
      "mcp__hermoso-social-media-manager__list_bluesky_convos",
      "mcp__hermoso-social-media-manager__list_connectors",
      "mcp__hermoso-social-media-manager__list_contacts",
      "mcp__hermoso-social-media-manager__list_discord_pins",
      "mcp__hermoso-social-media-manager__list_dm_automations",
      "mcp__hermoso-social-media-manager__list_drive_files",
      "mcp__hermoso-social-media-manager__list_inbox",
      "mcp__hermoso-social-media-manager__list_instagram_dm_automations",
      "mcp__hermoso-social-media-manager__list_intercom_conversations",
      "mcp__hermoso-social-media-manager__list_intercom_tags",
      "mcp__hermoso-social-media-manager__list_intercom_teammates",
      "mcp__hermoso-social-media-manager__list_klaviyo_campaigns",
      "mcp__hermoso-social-media-manager__list_klaviyo_templates",
      "mcp__hermoso-social-media-manager__list_linkedin_lead_forms",
      "mcp__hermoso-social-media-manager__list_linkedin_leads",
      "mcp__hermoso-social-media-manager__list_mailchimp_audiences",
      "mcp__hermoso-social-media-manager__list_mailchimp_files",
      "mcp__hermoso-social-media-manager__list_mailchimp_templates",
      "mcp__hermoso-social-media-manager__list_messenger_marketing_campaigns",
      "mcp__hermoso-social-media-manager__list_messenger_subscribers",
      "mcp__hermoso-social-media-manager__list_meta_conversations",
      "mcp__hermoso-social-media-manager__list_notion_pages",
      "mcp__hermoso-social-media-manager__list_onedrive_files",
      "mcp__hermoso-social-media-manager__list_phone_numbers",
      "mcp__hermoso-social-media-manager__list_shopify_orders",
      "mcp__hermoso-social-media-manager__list_slack_scheduled",
      "mcp__hermoso-social-media-manager__list_team",
      "mcp__hermoso-social-media-manager__list_telegram_chats",
      "mcp__hermoso-social-media-manager__list_telegram_dms",
      "mcp__hermoso-social-media-manager__list_threads_mentions",
      "mcp__hermoso-social-media-manager__list_threads_posts",
      "mcp__hermoso-social-media-manager__list_threads_profile_posts",
      "mcp__hermoso-social-media-manager__list_threads_replies",
      "mcp__hermoso-social-media-manager__list_whatsapp_accounts",
      "mcp__hermoso-social-media-manager__list_whatsapp_templates",
      "mcp__hermoso-social-media-manager__list_x_chats",
      "mcp__hermoso-social-media-manager__list_x_dms",
      "mcp__hermoso-social-media-manager__query_notion_database",
      "mcp__hermoso-social-media-manager__read_bluesky_dm",
      "mcp__hermoso-social-media-manager__read_discord_channel",
      "mcp__hermoso-social-media-manager__read_doc",
      "mcp__hermoso-social-media-manager__read_intercom_conversation",
      "mcp__hermoso-social-media-manager__read_line_inbox",
      "mcp__hermoso-social-media-manager__read_meta_conversation",
      "mcp__hermoso-social-media-manager__read_sheet",
      "mcp__hermoso-social-media-manager__read_slack_channel",
      "mcp__hermoso-social-media-manager__read_slack_dm",
      "mcp__hermoso-social-media-manager__read_whatsapp_inbox",
      "mcp__hermoso-social-media-manager__read_x_broadcast_chat",
      "mcp__hermoso-social-media-manager__search_instagram_hashtag",
      "mcp__hermoso-social-media-manager__search_intercom_contacts",
      "mcp__hermoso-social-media-manager__search_threads_keyword",
      "mcp__hermoso-social-media-manager__search_threads_locations",
      "mcp__hermoso-social-media-manager__threads_profile"
    ]
  }
}

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Tools listed without sign-in

Looked at Nov 14, 2026, 12:23 UTC, unchanged since Nov 14, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
277
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
not observed
RFC 9728 protected resource metadata
https://app.hermoso.ai/.well-known/oauth-protected-resource/mcp
Authorization servers
https://app.hermoso.ai
Legacy HTTP+SSE transport
no
Dynamic client registration
yes
Client ID metadata documents
yes
  • HighThe whole server

    The endpoint served tools/list without credentials, and the list has 277 tools that change things (139 destructive, 14 irreversible, 124 write). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://app.hermoso.ai/mcp?tools=app-social&src=registry: tools/list returned 432 tools to an anonymous client, including call_tool (destructive), post_to_bluesky (destructive), delete_bluesky_post (destructive), post_to_telegram (destructive), delete_telegram_message (destructive) and 272 more

    What this check looks for

Posture changes

  1. Nov 14, 2026
    • Tools that change things, listed without credentials: 271 to 277

Findings

Matches of fixed checks, with the text they matched.

5 high25 warn11 info
  • The description contains "never tell the user", an instruction to keep something from the user.

    Matched text

    description: "...box shows it as the message status), so never tell the user it was delivered. THE VARIABLE COUNT IS..."

    What this check looks for
  • The description contains "never tell the user", an instruction to keep something from the user.

    Matched text

    description: "...d the account without delivering it, so never tell the user it was delivered. LINE has no API for L..."

    What this check looks for
  • The description contains "do not tell the user", an instruction to keep something from the user.

    Matched text

    description: "...o YouTube — a REPORT, not a removal, so do not tell the user it is gone) · delete (permanent; YouTub..."

    What this check looks for
  • The description contains "do not tell the user", an instruction to keep something from the user.

    Matched text

    description: "...write that HAPPENED: do not retry, and do not tell the user it failed. The reply’s `verdict` is one..."

    What this check looks for
  • The description contains "never tell a user", an instruction to keep something from the user.

    Matched text

    description: "...eturns one error code for all four — so never tell a user which of them it was. Read-only, 0 cred..."

    What this check looks for
  • The description contains "Every other tool", wording about other tools or servers.

    Matched text

    description: "...few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone —..."

    What this check looks for
Show 35 more findings
  • The server marks "meta_post_insights" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "meta_post_insights" says "post": a word for a change.

    What this check looks for
  • The server marks "list_instagram_collab_invites" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_instagram_collab_invites" says "list": a word for reading.

    What this check looks for
  • The server marks "list_threads_mentions" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_threads_mentions" says "list": a word for reading.

    What this check looks for
  • The server marks "read_whatsapp_inbox" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "read_whatsapp_inbox" says "read": a word for reading.

    What this check looks for
  • The server marks "read_line_inbox" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "read_line_inbox" says "read": a word for reading.

    What this check looks for
  • The server marks "x_post_metrics" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "x_post_metrics" says "post": a word for a change.

    What this check looks for
  • The server marks "x_post_insights" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "x_post_insights" says "post": a word for a change.

    What this check looks for
  • The server marks "x_post_insights_historical" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "x_post_insights_historical" says "post": a word for a change.

    What this check looks for
  • The server marks "list_pinterest_pins" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_pinterest_pins" says "list": a word for reading.

    What this check looks for
  • The server marks "bluesky_post_metrics" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "bluesky_post_metrics" says "post": a word for a change.

    What this check looks for
  • The server marks "tiktok_post_status" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "tiktok_post_status" says "post": a word for a change.

    What this check looks for
  • The server marks "shopify_sales_report" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The input addresses people (input.to): what it sends cannot be taken back.

    What this check looks for
  • The server marks "list_calls" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_calls" says "list": a word for reading.

    What this check looks for
  • The server marks "call_tracking_report" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "call_tracking_report" says "call": a word for a change.

    What this check looks for
  • The server marks "list_voice_agent_calls" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_voice_agent_calls" says "list": a word for reading.

    What this check looks for
  • The server marks "cancel_mailchimp_campaign" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "cancel_mailchimp_campaign" says "cancel": a word for removing or ending something.

    What this check looks for
  • The server marks "refresh_campaign_views" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "refresh_campaign_views" says "view": a word for reading.

    What this check looks for
  • The description contains "every other tool", wording about other tools or servers.

    Matched text

    description: "...ports the state, the TikTok business id every other tool in this family uses, the scopes the gra..."

    What this check looks for
  • The server marks "list_tiktok_mention_comments" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "list_tiktok_mention_comments" says "list": a word for reading.

    What this check looks for
  • The server marks "store_get" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "store_get" says "store": a word for a change.

    What this check looks for
  • The server marks "list_products" destructive (destructiveHint: true), and its name says "list", a word for reading.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}; The name "list_products" says "list": a word for reading.

    What this check looks for
  • The server marks "list_product_photos" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "list_product_photos" says "list": a word for reading.

    What this check looks for
  • The server marks "post_performance" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "post_performance" says "post": a word for a change.

    What this check looks for
  • The server marks "diagnose_posts" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "diagnose_posts" says "post": a word for a change.

    What this check looks for
  • The description is 2,470 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...e X has not already been paid for today (a repeat read with nothing new is free)."

    What this check looks for
  • The description mentions "CREDENTIAL".

    Matched text

    description: "...U ARE AN AGENT HOLDING YOUR OWN PAYMENT CREDENTIAL, there is a third path that needs no hu..."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...omment counts — on the brand’s own Meta credentials rather than a scraper. This is category..."

    What this check looks for
  • The description is 2,057 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...d a PRODUCT card carousel takes its pictures from a connected catalog. 0 credits."

    What this check looks for
  • The description is 2,042 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...PTED IS NOT DELIVERED — never report a broadcast as delivered. 0 Hermoso credits."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...logId, schedule {time HH:MM, timezone}, credentials. action:"update" changes those on feedI..."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...lio number with the Twilio connection's credentials; a Telnyx number needs credentialId on..."

    What this check looks for
  • The input schema at properties.credentialId.description mentions "credential".

    Matched text

    inputSchema.properties.credentialId.description: "Vapi: a Telnyx credential made in the Vapi dashboard"

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...Slack, …). This always drops the stored credentials, so every tool for that provider stops..."

    What this check looks for
  • The description is 2,485 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...ceWebhookUrl} · discord {webhookUrl, announceWebhookUrl} · webhook {webhookUrl*}."

    What this check looks for
  • The description mentions "credential".

    Matched text

    description: "...ve YOURS from this profile: your stored credential is dropped and the accounts you shared..."

    What this check looks for

History

Changes to its tool definitions and to its remote endpoint, newest first.

  1. Tools181 added, 225 changed.+181 added~225 changedView diff
  2. PostureRemote posture changed. Tools that change things, listed without credentials: 271 -> 277.View diff
    • Tools that change things, listed without credentials: 271 to 277

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http hermoso-social-media-manager https://app.hermoso.ai/mcp?tools=app-social&src=registry
claude mcp add --transport http hermoso-social-media-manager https://app.hermoso.ai/mcp?tools=app-social&src=registry

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__hermoso-social-media-manager__get_instructions",
      "mcp__hermoso-social-media-manager__find_tools",
      "mcp__hermoso-social-media-manager__list_telegram_chats",
      "mcp__hermoso-social-media-manager__list_telegram_dms",
      "mcp__hermoso-social-media-manager__list_wordpress_posts",
      "mcp__hermoso-social-media-manager__get_wordpress_post",
      "mcp__hermoso-social-media-manager__list_wordpress_terms",
      "mcp__hermoso-social-media-manager__list_shopify_articles",
      "mcp__hermoso-social-media-manager__get_shopify_article",
      "mcp__hermoso-social-media-manager__list_shopify_blogs",
      "mcp__hermoso-social-media-manager__list_webflow_items",
      "mcp__hermoso-social-media-manager__get_webflow_item",
      "mcp__hermoso-social-media-manager__list_webflow_collections",
      "mcp__hermoso-social-media-manager__list_wix_posts",
      "mcp__hermoso-social-media-manager__get_wix_post",
      "mcp__hermoso-social-media-manager__get_wix_blog",
      "mcp__hermoso-social-media-manager__get_discord_message",
      "mcp__hermoso-social-media-manager__list_slack_channels",
      "mcp__hermoso-social-media-manager__read_slack_channel",
      "mcp__hermoso-social-media-manager__list_slack_members",
      "mcp__hermoso-social-media-manager__read_slack_dm",
      "mcp__hermoso-social-media-manager__list_discord_channels",
      "mcp__hermoso-social-media-manager__read_discord_channel",
      "mcp__hermoso-social-media-manager__get_discord_poll",
      "mcp__hermoso-social-media-manager__list_discord_roles",
      "mcp__hermoso-social-media-manager__list_discord_members",
      "mcp__hermoso-social-media-manager__search_discord_members",
      "mcp__hermoso-social-media-manager__list_discord_pins",
      "mcp__hermoso-social-media-manager__list_discord_events",
      "mcp__hermoso-social-media-manager__get_slack_message",
      "mcp__hermoso-social-media-manager__list_slack_scheduled",
      "mcp__hermoso-social-media-manager__list_inbox",
      "mcp__hermoso-social-media-manager__hermoso_credits",
      "mcp__hermoso-social-media-manager__billing_status",
      "mcp__hermoso-social-media-manager__list_brands",
      "mcp__hermoso-social-media-manager__list_instagram_media",
      "mcp__hermoso-social-media-manager__list_meta_stories",
      "mcp__hermoso-social-media-manager__search_instagram_audio",
      "mcp__hermoso-social-media-manager__list_instagram_collab_media",
      "mcp__hermoso-social-media-manager__list_meta_comments",
      "mcp__hermoso-social-media-manager__find_instagram_marketplace_creators",
      "mcp__hermoso-social-media-manager__list_instagram_marketplace_audiences",
      "mcp__hermoso-social-media-manager__list_threads_posts",
      "mcp__hermoso-social-media-manager__list_threads_replies",
      "mcp__hermoso-social-media-manager__search_threads_keyword",
      "mcp__hermoso-social-media-manager__list_meta_pages",
      "mcp__hermoso-social-media-manager__search_threads_locations",
      "mcp__hermoso-social-media-manager__threads_profile",
      "mcp__hermoso-social-media-manager__list_threads_profile_posts",
      "mcp__hermoso-social-media-manager__search_instagram_hashtag",
      "mcp__hermoso-social-media-manager__list_whatsapp_accounts",
      "mcp__hermoso-social-media-manager__list_whatsapp_templates",
      "mcp__hermoso-social-media-manager__list_scheduled",
      "mcp__hermoso-social-media-manager__get_post_refill",
      "mcp__hermoso-social-media-manager__list_pending_approvals",
      "mcp__hermoso-social-media-manager__x_mentions",
      "mcp__hermoso-social-media-manager__list_x_dms",
      "mcp__hermoso-social-media-manager__list_pinterest_boards",
      "mcp__hermoso-social-media-manager__list_pinterest_catalogs",
      "mcp__hermoso-social-media-manager__list_pinterest_board_sections",
      "mcp__hermoso-social-media-manager__pinterest_account_lists",
      "mcp__hermoso-social-media-manager__list_business_locations",
      "mcp__hermoso-social-media-manager__list_google_business_posts",
      "mcp__hermoso-social-media-manager__list_google_business_reviews",
      "mcp__hermoso-social-media-manager__list_google_business_questions",
      "mcp__hermoso-social-media-manager__get_business_location",
      "mcp__hermoso-social-media-manager__google_business_account",
      "mcp__hermoso-social-media-manager__youtube_channel",
      "mcp__hermoso-social-media-manager__list_youtube_videos",
      "mcp__hermoso-social-media-manager__list_youtube_report_jobs",
      "mcp__hermoso-social-media-manager__list_youtube_video_stats",
      "mcp__hermoso-social-media-manager__list_youtube_comments",
      "mcp__hermoso-social-media-manager__list_youtube_comment_replies",
      "mcp__hermoso-social-media-manager__list_youtube_playlists",
      "mcp__hermoso-social-media-manager__list_youtube_captions",
      "mcp__hermoso-social-media-manager__list_youtube_categories",
      "mcp__hermoso-social-media-manager__google_business_search_keywords",
      "mcp__hermoso-social-media-manager__list_bluesky_posts",
      "mcp__hermoso-social-media-manager__search_x",
      "mcp__hermoso-social-media-manager__x_search_counts",
      "mcp__hermoso-social-media-manager__list_x_blocks",
      "mcp__hermoso-social-media-manager__list_x_broadcasts",
      "mcp__hermoso-social-media-manager__read_x_broadcast_chat",
      "mcp__hermoso-social-media-manager__list_x_chats",
      "mcp__hermoso-social-media-manager__list_linkedin_events",
      "mcp__hermoso-social-media-manager__search_linkedin_ad_library",
      "mcp__hermoso-social-media-manager__search_linkedin_brand_partnerships",
      "mcp__hermoso-social-media-manager__list_business_categories",
      "mcp__hermoso-social-media-manager__list_business_attributes",
      "mcp__hermoso-social-media-manager__list_bluesky_convos",
      "mcp__hermoso-social-media-manager__read_bluesky_dm",
      "mcp__hermoso-social-media-manager__tiktok_creator_info",
      "mcp__hermoso-social-media-manager__tiktok_account",
      "mcp__hermoso-social-media-manager__list_tiktok_videos",
      "mcp__hermoso-social-media-manager__list_meta_conversations",
      "mcp__hermoso-social-media-manager__read_meta_conversation",
      "mcp__hermoso-social-media-manager__meta_webhook_status",
      "mcp__hermoso-social-media-manager__list_meta_webhook_events",
      "mcp__hermoso-social-media-manager__list_instagram_dm_automations",
      "mcp__hermoso-social-media-manager__list_dm_automations",
      "mcp__hermoso-social-media-manager__list_meta_partnership_creators",
      "mcp__hermoso-social-media-manager__list_instagram_shopping_catalogs",
      "mcp__hermoso-social-media-manager__search_instagram_shopping_products",
      "mcp__hermoso-social-media-manager__list_meta_catalogs",
      "mcp__hermoso-social-media-manager__list_meta_product_sets",
      "mcp__hermoso-social-media-manager__list_meta_catalog_products",
      "mcp__hermoso-social-media-manager__meta_catalog_blast_radius",
      "mcp__hermoso-social-media-manager__list_messenger_subscribers",
      "mcp__hermoso-social-media-manager__list_messenger_marketing_campaigns",
      "mcp__hermoso-social-media-manager__get_messenger_marketing_message_status",
      "mcp__hermoso-social-media-manager__list_shopify_stores",
      "mcp__hermoso-social-media-manager__list_shopify_products",
      "mcp__hermoso-social-media-manager__list_shopify_discount_codes",
      "mcp__hermoso-social-media-manager__list_shopify_orders",
      "mcp__hermoso-social-media-manager__list_shopify_locations",
      "mcp__hermoso-social-media-manager__get_shopify_inventory",
      "mcp__hermoso-social-media-manager__list_phone_numbers",
      "mcp__hermoso-social-media-manager__search_phone_numbers",
      "mcp__hermoso-social-media-manager__get_sms_status",
      "mcp__hermoso-social-media-manager__list_sms_consents",
      "mcp__hermoso-social-media-manager__list_provider_opt_outs",
      "mcp__hermoso-social-media-manager__sms_registration_status",
      "mcp__hermoso-social-media-manager__list_call_recordings",
      "mcp__hermoso-social-media-manager__list_shopify_sms_buyers",
      "mcp__hermoso-social-media-manager__phone_service_status",
      "mcp__hermoso-social-media-manager__list_port_orders",
      "mcp__hermoso-social-media-manager__get_port_order",
      "mcp__hermoso-social-media-manager__list_voice_agents",
      "mcp__hermoso-social-media-manager__get_voice_agent",
      "mcp__hermoso-social-media-manager__list_voice_agent_voices",
      "mcp__hermoso-social-media-manager__list_voice_agent_numbers",
      "mcp__hermoso-social-media-manager__list_voice_agent_batches",
      "mcp__hermoso-social-media-manager__get_voice_agent_call",
      "mcp__hermoso-social-media-manager__list_mailchimp_audiences",
      "mcp__hermoso-social-media-manager__list_mailchimp_segments",
      "mcp__hermoso-social-media-manager__list_mailchimp_campaigns",
      "mcp__hermoso-social-media-manager__list_mailchimp_templates",
      "mcp__hermoso-social-media-manager__list_mailchimp_files",
      "mcp__hermoso-social-media-manager__list_klaviyo_lists",
      "mcp__hermoso-social-media-manager__list_klaviyo_segments",
      "mcp__hermoso-social-media-manager__list_klaviyo_campaigns",
      "mcp__hermoso-social-media-manager__list_klaviyo_flows",
      "mcp__hermoso-social-media-manager__list_klaviyo_templates",
      "mcp__hermoso-social-media-manager__list_klaviyo_images",
      "mcp__hermoso-social-media-manager__list_contacts",
      "mcp__hermoso-social-media-manager__read_creator_campaigns",
      "mcp__hermoso-social-media-manager__list_campaign_posts",
      "mcp__hermoso-social-media-manager__preview_creator_campaign",
      "mcp__hermoso-social-media-manager__list_intercom_conversations",
      "mcp__hermoso-social-media-manager__read_intercom_conversation",
      "mcp__hermoso-social-media-manager__list_intercom_tags",
      "mcp__hermoso-social-media-manager__search_intercom_contacts",
      "mcp__hermoso-social-media-manager__list_intercom_teammates",
      "mcp__hermoso-social-media-manager__tiktok_account_status",
      "mcp__hermoso-social-media-manager__list_tiktok_comments",
      "mcp__hermoso-social-media-manager__list_tiktok_comment_replies",
      "mcp__hermoso-social-media-manager__get_tiktok_post_ad_authorization",
      "mcp__hermoso-social-media-manager__list_tiktok_mentions",
      "mcp__hermoso-social-media-manager__get_tiktok_mention",
      "mcp__hermoso-social-media-manager__list_tiktok_brand_hashtags",
      "mcp__hermoso-social-media-manager__list_tiktok_brand_hashtag_posts",
      "mcp__hermoso-social-media-manager__list_linkedin_pages",
      "mcp__hermoso-social-media-manager__list_linkedin_comments",
      "mcp__hermoso-social-media-manager__list_linkedin_page_notifications",
      "mcp__hermoso-social-media-manager__list_linkedin_lead_forms",
      "mcp__hermoso-social-media-manager__list_linkedin_leads",
      "mcp__hermoso-social-media-manager__get_linkedin_lead",
      "mcp__hermoso-social-media-manager__list_linkedin_lead_events",
      "mcp__hermoso-social-media-manager__list_linkedin_lead_subscriptions",
      "mcp__hermoso-social-media-manager__list_drive_files",
      "mcp__hermoso-social-media-manager__get_drive_file",
      "mcp__hermoso-social-media-manager__read_sheet",
      "mcp__hermoso-social-media-manager__list_notion_pages",
      "mcp__hermoso-social-media-manager__read_notion_page",
      "mcp__hermoso-social-media-manager__query_notion_database",
      "mcp__hermoso-social-media-manager__read_doc",
      "mcp__hermoso-social-media-manager__list_sheet_tabs",
      "mcp__hermoso-social-media-manager__list_onedrive_files",
      "mcp__hermoso-social-media-manager__get_onedrive_file",
      "mcp__hermoso-social-media-manager__get_job",
      "mcp__hermoso-social-media-manager__list_skills",
      "mcp__hermoso-social-media-manager__get_skill",
      "mcp__hermoso-social-media-manager__list_memory",
      "mcp__hermoso-social-media-manager__list_swipefile",
      "mcp__hermoso-social-media-manager__list_playbooks",
      "mcp__hermoso-social-media-manager__list_creators",
      "mcp__hermoso-social-media-manager__list_elements",
      "mcp__hermoso-social-media-manager__get_settings",
      "mcp__hermoso-social-media-manager__list_connectors",
      "mcp__hermoso-social-media-manager__list_alert_settings",
      "mcp__hermoso-social-media-manager__list_connector_accounts",
      "mcp__hermoso-social-media-manager__list_team",
      "mcp__hermoso-social-media-manager__get_credit_limits",
      "mcp__hermoso-social-media-manager__list_jobs",
      "mcp__hermoso-social-media-manager__list_errors",
      "mcp__hermoso-social-media-manager__get_brand",
      "mcp__hermoso-social-media-manager__list_library",
      "mcp__hermoso-social-media-manager__list_meta_posts",
      "mcp__hermoso-social-media-manager__list_published_posts"
    ],
    "ask": [
      "mcp__hermoso-social-media-manager__enable_tools",
      "mcp__hermoso-social-media-manager__create_wordpress_term",
      "mcp__hermoso-social-media-manager__set_webflow_collection",
      "mcp__hermoso-social-media-manager__set_slack_channel",
      "mcp__hermoso-social-media-manager__set_discord_channel",
      "mcp__hermoso-social-media-manager__create_discord_thread",
      "mcp__hermoso-social-media-manager__update_discord_thread",
      "mcp__hermoso-social-media-manager__create_discord_role",
      "mcp__hermoso-social-media-manager__pin_discord_message",
      "mcp__hermoso-social-media-manager__create_discord_event",
      "mcp__hermoso-social-media-manager__check_discord_permissions",
      "mcp__hermoso-social-media-manager__react_to_slack_message",
      "mcp__hermoso-social-media-manager__hermoso_capabilities",
      "mcp__hermoso-social-media-manager__hermoso_other_capabilities",
      "mcp__hermoso-social-media-manager__buy_credits",
      "mcp__hermoso-social-media-manager__report_bug",
      "mcp__hermoso-social-media-manager__request_feature",
      "mcp__hermoso-social-media-manager__contact_support",
      "mcp__hermoso-social-media-manager__upgrade_plan",
      "mcp__hermoso-social-media-manager__set_auto_reload",
      "mcp__hermoso-social-media-manager__use_brand",
      "mcp__hermoso-social-media-manager__create_brand",
      "mcp__hermoso-social-media-manager__meta_page_insights",
      "mcp__hermoso-social-media-manager__meta_post_insights",
      "mcp__hermoso-social-media-manager__instagram_insights",
      "mcp__hermoso-social-media-manager__instagram_story_insights",
      "mcp__hermoso-social-media-manager__get_meta_story",
      "mcp__hermoso-social-media-manager__instagram_collaborators",
      "mcp__hermoso-social-media-manager__list_instagram_collab_invites",
      "mcp__hermoso-social-media-manager__like_instagram",
      "mcp__hermoso-social-media-manager__instagram_marketplace_creator",
      "mcp__hermoso-social-media-manager__threads_insights",
      "mcp__hermoso-social-media-manager__threads_publishing_limit",
      "mcp__hermoso-social-media-manager__list_threads_mentions",
      "mcp__hermoso-social-media-manager__threads_trending_topics",
      "mcp__hermoso-social-media-manager__embed_threads",
      "mcp__hermoso-social-media-manager__upload_file",
      "mcp__hermoso-social-media-manager__read_whatsapp_inbox",
      "mcp__hermoso-social-media-manager__read_line_inbox",
      "mcp__hermoso-social-media-manager__send_line_message",
      "mcp__hermoso-social-media-manager__line_quota",
      "mcp__hermoso-social-media-manager__line_account",
      "mcp__hermoso-social-media-manager__line_profile",
      "mcp__hermoso-social-media-manager__x_post_metrics",
      "mcp__hermoso-social-media-manager__x_post_insights",
      "mcp__hermoso-social-media-manager__x_post_insights_historical",
      "mcp__hermoso-social-media-manager__pinterest_analytics",
      "mcp__hermoso-social-media-manager__pinterest_trends",
      "mcp__hermoso-social-media-manager__create_pinterest_catalog",
      "mcp__hermoso-social-media-manager__create_pinterest_board",
      "mcp__hermoso-social-media-manager__list_pinterest_pins",
      "mcp__hermoso-social-media-manager__save_pinterest_pin",
      "mcp__hermoso-social-media-manager__pinterest_targeting_analytics",
      "mcp__hermoso-social-media-manager__pinterest_audience_insights",
      "mcp__hermoso-social-media-manager__google_business_insights",
      "mcp__hermoso-social-media-manager__youtube_video_insights",
      "mcp__hermoso-social-media-manager__youtube_channel_report",
      "mcp__hermoso-social-media-manager__youtube_bulk_report",
      "mcp__hermoso-social-media-manager__x_trends",
      "mcp__hermoso-social-media-manager__x_follows",
      "mcp__hermoso-social-media-manager__bookmark_x_post",
      "mcp__hermoso-social-media-manager__x_chat_settings",
      "mcp__hermoso-social-media-manager__x_user",
      "mcp__hermoso-social-media-manager__x_account",
      "mcp__hermoso-social-media-manager__pin_telegram_message",
      "mcp__hermoso-social-media-manager__create_telegram_invite_link",
      "mcp__hermoso-social-media-manager__create_linkedin_event",
      "mcp__hermoso-social-media-manager__business_google_updated",
      "mcp__hermoso-social-media-manager__telegram_account",
      "mcp__hermoso-social-media-manager__bluesky_account",
      "mcp__hermoso-social-media-manager__bluesky_post_metrics",
      "mcp__hermoso-social-media-manager__mark_bluesky_convo_read",
      "mcp__hermoso-social-media-manager__react_to_bluesky_dm",
      "mcp__hermoso-social-media-manager__tiktok_post_status",
      "mcp__hermoso-social-media-manager__meta_page_reviews",
      "mcp__hermoso-social-media-manager__instagram_mentions",
      "mcp__hermoso-social-media-manager__subscribe_meta_webhooks",
      "mcp__hermoso-social-media-manager__test_instagram_dm_automation",
      "mcp__hermoso-social-media-manager__test_dm_automation",
      "mcp__hermoso-social-media-manager__instagram_profile",
      "mcp__hermoso-social-media-manager__create_meta_catalog",
      "mcp__hermoso-social-media-manager__estimate_messenger_marketing_delivery",
      "mcp__hermoso-social-media-manager__connect_shopify_store",
      "mcp__hermoso-social-media-manager__shopify_sales_report",
      "mcp__hermoso-social-media-manager__import_shopify_buyers_to_email_leads",
      "mcp__hermoso-social-media-manager__buy_phone_number",
      "mcp__hermoso-social-media-manager__send_sms",
      "mcp__hermoso-social-media-manager__sms_conversation",
      "mcp__hermoso-social-media-manager__record_sms_consent",
      "mcp__hermoso-social-media-manager__set_sms_opt_out",
      "mcp__hermoso-social-media-manager__create_sms_registration_bundles",
      "mcp__hermoso-social-media-manager__register_sms_brand",
      "mcp__hermoso-social-media-manager__register_sms_campaign",
      "mcp__hermoso-social-media-manager__assign_number_to_campaign",
      "mcp__hermoso-social-media-manager__submit_tollfree_verification",
      "mcp__hermoso-social-media-manager__list_calls",
      "mcp__hermoso-social-media-manager__transcribe_call",
      "mcp__hermoso-social-media-manager__place_call",
      "mcp__hermoso-social-media-manager__call_tracking_report",
      "mcp__hermoso-social-media-manager__activate_phone_service",
      "mcp__hermoso-social-media-manager__send_verification_code",
      "mcp__hermoso-social-media-manager__check_verification_code",
      "mcp__hermoso-social-media-manager__check_number_portability",
      "mcp__hermoso-social-media-manager__create_port_order",
      "mcp__hermoso-social-media-manager__draft_voice_agent",
      "mcp__hermoso-social-media-manager__create_voice_agent",
      "mcp__hermoso-social-media-manager__update_voice_agent",
      "mcp__hermoso-social-media-manager__attach_voice_agent_number",
      "mcp__hermoso-social-media-manager__place_voice_agent_call",
      "mcp__hermoso-social-media-manager__batch_voice_agent_calls",
      "mcp__hermoso-social-media-manager__list_voice_agent_calls",
      "mcp__hermoso-social-media-manager__upload_mailchimp_image",
      "mcp__hermoso-social-media-manager__create_mailchimp_template",
      "mcp__hermoso-social-media-manager__update_mailchimp_template",
      "mcp__hermoso-social-media-manager__send_mailchimp_test_email",
      "mcp__hermoso-social-media-manager__create_mailchimp_campaign",
      "mcp__hermoso-social-media-manager__update_mailchimp_campaign",
      "mcp__hermoso-social-media-manager__mailchimp_report",
      "mcp__hermoso-social-media-manager__sync_leads_to_mailchimp",
      "mcp__hermoso-social-media-manager__upload_klaviyo_image",
      "mcp__hermoso-social-media-manager__create_klaviyo_template",
      "mcp__hermoso-social-media-manager__send_klaviyo_test_email",
      "mcp__hermoso-social-media-manager__create_klaviyo_campaign",
      "mcp__hermoso-social-media-manager__klaviyo_report",
      "mcp__hermoso-social-media-manager__sync_leads_to_klaviyo",
      "mcp__hermoso-social-media-manager__save_contacts",
      "mcp__hermoso-social-media-manager__create_creator_campaign",
      "mcp__hermoso-social-media-manager__update_creator_campaign",
      "mcp__hermoso-social-media-manager__creator_campaign_link",
      "mcp__hermoso-social-media-manager__bulk_invite_creators",
      "mcp__hermoso-social-media-manager__add_campaign_post",
      "mcp__hermoso-social-media-manager__refresh_campaign_views",
      "mcp__hermoso-social-media-manager__creator_campaign_sales",
      "mcp__hermoso-social-media-manager__creator_campaign_report",
      "mcp__hermoso-social-media-manager__share_campaign_report",
      "mcp__hermoso-social-media-manager__creator_directory",
      "mcp__hermoso-social-media-manager__promote_campaign_post",
      "mcp__hermoso-social-media-manager__email_campaign_creator",
      "mcp__hermoso-social-media-manager__campaign_drafts",
      "mcp__hermoso-social-media-manager__intercom_customer_language",
      "mcp__hermoso-social-media-manager__upload_tiktok_comment_image",
      "mcp__hermoso-social-media-manager__extend_tiktok_post_ad_authorization",
      "mcp__hermoso-social-media-manager__list_tiktok_mention_comments",
      "mcp__hermoso-social-media-manager__tiktok_mention_top_terms",
      "mcp__hermoso-social-media-manager__manage_tiktok_brand_hashtags",
      "mcp__hermoso-social-media-manager__tiktok_account_insights",
      "mcp__hermoso-social-media-manager__tiktok_category_benchmark",
      "mcp__hermoso-social-media-manager__tiktok_video_insights",
      "mcp__hermoso-social-media-manager__tiktok_spark_recommendations",
      "mcp__hermoso-social-media-manager__tiktok_hashtag_suggestions",
      "mcp__hermoso-social-media-manager__react_to_linkedin_post",
      "mcp__hermoso-social-media-manager__linkedin_profile_followers",
      "mcp__hermoso-social-media-manager__linkedin_page_analytics",
      "mcp__hermoso-social-media-manager__subscribe_linkedin_leads",
      "mcp__hermoso-social-media-manager__save_to_drive",
      "mcp__hermoso-social-media-manager__import_from_cloud",
      "mcp__hermoso-social-media-manager__create_drive_folder",
      "mcp__hermoso-social-media-manager__create_sheet",
      "mcp__hermoso-social-media-manager__append_to_sheet",
      "mcp__hermoso-social-media-manager__export_swipefile_deck",
      "mcp__hermoso-social-media-manager__save_to_notion",
      "mcp__hermoso-social-media-manager__append_to_notion_page",
      "mcp__hermoso-social-media-manager__export_schedule_to_notion",
      "mcp__hermoso-social-media-manager__create_doc",
      "mcp__hermoso-social-media-manager__append_to_doc",
      "mcp__hermoso-social-media-manager__save_to_onedrive",
      "mcp__hermoso-social-media-manager__convert_onedrive_file",
      "mcp__hermoso-social-media-manager__create_onedrive_folder",
      "mcp__hermoso-social-media-manager__plan_week",
      "mcp__hermoso-social-media-manager__save_skill",
      "mcp__hermoso-social-media-manager__remember",
      "mcp__hermoso-social-media-manager__save_to_swipefile",
      "mcp__hermoso-social-media-manager__save_playbook",
      "mcp__hermoso-social-media-manager__save_creator",
      "mcp__hermoso-social-media-manager__save_location",
      "mcp__hermoso-social-media-manager__store_get",
      "mcp__hermoso-social-media-manager__send_test_alert",
      "mcp__hermoso-social-media-manager__redeliver_webhook",
      "mcp__hermoso-social-media-manager__set_credit_limit",
      "mcp__hermoso-social-media-manager__error_detail",
      "mcp__hermoso-social-media-manager__fetch_asset",
      "mcp__hermoso-social-media-manager__list_product_photos",
      "mcp__hermoso-social-media-manager__post_performance",
      "mcp__hermoso-social-media-manager__diagnose_posts",
      "mcp__hermoso-social-media-manager__collect_post_metrics",
      "mcp__hermoso-social-media-manager__backfill_posts"
    ],
    "deny": [
      "mcp__hermoso-social-media-manager__call_tool",
      "mcp__hermoso-social-media-manager__post_to_bluesky",
      "mcp__hermoso-social-media-manager__delete_bluesky_post",
      "mcp__hermoso-social-media-manager__post_to_telegram",
      "mcp__hermoso-social-media-manager__delete_telegram_message",
      "mcp__hermoso-social-media-manager__post_to_wordpress",
      "mcp__hermoso-social-media-manager__update_wordpress_post",
      "mcp__hermoso-social-media-manager__delete_wordpress_post",
      "mcp__hermoso-social-media-manager__post_to_shopify_blog",
      "mcp__hermoso-social-media-manager__update_shopify_article",
      "mcp__hermoso-social-media-manager__delete_shopify_article",
      "mcp__hermoso-social-media-manager__post_to_webflow",
      "mcp__hermoso-social-media-manager__update_webflow_item",
      "mcp__hermoso-social-media-manager__delete_webflow_item",
      "mcp__hermoso-social-media-manager__post_to_wix",
      "mcp__hermoso-social-media-manager__update_wix_post",
      "mcp__hermoso-social-media-manager__delete_wix_post",
      "mcp__hermoso-social-media-manager__post_to_discord",
      "mcp__hermoso-social-media-manager__edit_discord_message",
      "mcp__hermoso-social-media-manager__delete_discord_message",
      "mcp__hermoso-social-media-manager__post_to_slack",
      "mcp__hermoso-social-media-manager__send_slack_dm",
      "mcp__hermoso-social-media-manager__end_discord_poll",
      "mcp__hermoso-social-media-manager__crosspost_discord_message",
      "mcp__hermoso-social-media-manager__send_discord_dm",
      "mcp__hermoso-social-media-manager__update_discord_role",
      "mcp__hermoso-social-media-manager__delete_discord_role",
      "mcp__hermoso-social-media-manager__assign_discord_role",
      "mcp__hermoso-social-media-manager__remove_discord_role",
      "mcp__hermoso-social-media-manager__unpin_discord_message",
      "mcp__hermoso-social-media-manager__update_discord_event",
      "mcp__hermoso-social-media-manager__delete_discord_event",
      "mcp__hermoso-social-media-manager__edit_slack_message",
      "mcp__hermoso-social-media-manager__delete_slack_message",
      "mcp__hermoso-social-media-manager__cancel_slack_scheduled",
      "mcp__hermoso-social-media-manager__reply_to_inbox_item",
      "mcp__hermoso-social-media-manager__delete_brand",
      "mcp__hermoso-social-media-manager__respond_instagram_collab_invite",
      "mcp__hermoso-social-media-manager__comment_on_meta_post",
      "mcp__hermoso-social-media-manager__reply_to_meta_comment",
      "mcp__hermoso-social-media-manager__moderate_meta_comment",
      "mcp__hermoso-social-media-manager__reply_to_thread",
      "mcp__hermoso-social-media-manager__hide_thread_reply",
      "mcp__hermoso-social-media-manager__delete_thread",
      "mcp__hermoso-social-media-manager__repost_thread",
      "mcp__hermoso-social-media-manager__create_whatsapp_template",
      "mcp__hermoso-social-media-manager__delete_whatsapp_template",
      "mcp__hermoso-social-media-manager__send_whatsapp_message",
      "mcp__hermoso-social-media-manager__send_whatsapp_broadcast",
      "mcp__hermoso-social-media-manager__manage_whatsapp_number",
      "mcp__hermoso-social-media-manager__manage_whatsapp_flow",
      "mcp__hermoso-social-media-manager__send_line_broadcast",
      "mcp__hermoso-social-media-manager__post_to_meta",
      "mcp__hermoso-social-media-manager__schedule_post",
      "mcp__hermoso-social-media-manager__reschedule_post",
      "mcp__hermoso-social-media-manager__cancel_scheduled",
      "mcp__hermoso-social-media-manager__retry_scheduled",
      "mcp__hermoso-social-media-manager__instagram_posting_hold",
      "mcp__hermoso-social-media-manager__duplicate_scheduled",
      "mcp__hermoso-social-media-manager__set_post_refill",
      "mcp__hermoso-social-media-manager__run_post_refill",
      "mcp__hermoso-social-media-manager__approve_post",
      "mcp__hermoso-social-media-manager__reject_post",
      "mcp__hermoso-social-media-manager__set_post_approval",
      "mcp__hermoso-social-media-manager__manage_post_queues",
      "mcp__hermoso-social-media-manager__make_evergreen",
      "mcp__hermoso-social-media-manager__manage_evergreen",
      "mcp__hermoso-social-media-manager__import_posts_csv",
      "mcp__hermoso-social-media-manager__post_to_linkedin",
      "mcp__hermoso-social-media-manager__post_to_x",
      "mcp__hermoso-social-media-manager__post_x_article",
      "mcp__hermoso-social-media-manager__edit_x_post",
      "mcp__hermoso-social-media-manager__delete_x_post",
      "mcp__hermoso-social-media-manager__send_x_dm",
      "mcp__hermoso-social-media-manager__manage_pinterest_catalog_feed",
      "mcp__hermoso-social-media-manager__update_pinterest_catalog_items",
      "mcp__hermoso-social-media-manager__manage_pinterest_product_group",
      "mcp__hermoso-social-media-manager__manage_pinterest_board_section",
      "mcp__hermoso-social-media-manager__post_to_pinterest",
      "mcp__hermoso-social-media-manager__update_pinterest_pin",
      "mcp__hermoso-social-media-manager__delete_pinterest_pin",
      "mcp__hermoso-social-media-manager__update_pinterest_board",
      "mcp__hermoso-social-media-manager__delete_pinterest_board",
      "mcp__hermoso-social-media-manager__post_to_google_business",
      "mcp__hermoso-social-media-manager__update_google_business_post",
      "mcp__hermoso-social-media-manager__delete_google_business_post",
      "mcp__hermoso-social-media-manager__reply_to_google_business_review",
      "mcp__hermoso-social-media-manager__answer_google_business_question",
      "mcp__hermoso-social-media-manager__update_business_location",
      "mcp__hermoso-social-media-manager__post_to_youtube",
      "mcp__hermoso-social-media-manager__delete_youtube_report_job",
      "mcp__hermoso-social-media-manager__update_youtube_video",
      "mcp__hermoso-social-media-manager__delete_youtube_video",
      "mcp__hermoso-social-media-manager__update_youtube_channel",
      "mcp__hermoso-social-media-manager__set_youtube_watermark",
      "mcp__hermoso-social-media-manager__set_youtube_thumbnail",
      "mcp__hermoso-social-media-manager__reply_to_youtube_comment",
      "mcp__hermoso-social-media-manager__manage_youtube_playlist",
      "mcp__hermoso-social-media-manager__manage_youtube_playlist_items",
      "mcp__hermoso-social-media-manager__manage_youtube_channel_section",
      "mcp__hermoso-social-media-manager__manage_youtube_playlist_image",
      "mcp__hermoso-social-media-manager__manage_youtube_caption",
      "mcp__hermoso-social-media-manager__moderate_youtube_comment",
      "mcp__hermoso-social-media-manager__hide_x_reply",
      "mcp__hermoso-social-media-manager__repost_on_x",
      "mcp__hermoso-social-media-manager__follow_x_account",
      "mcp__hermoso-social-media-manager__manage_x_broadcast",
      "mcp__hermoso-social-media-manager__manage_x_stream_source",
      "mcp__hermoso-social-media-manager__send_x_broadcast_chat",
      "mcp__hermoso-social-media-manager__moderate_x_broadcast",
      "mcp__hermoso-social-media-manager__update_x_chat_settings",
      "mcp__hermoso-social-media-manager__manage_x_chat",
      "mcp__hermoso-social-media-manager__edit_telegram_message",
      "mcp__hermoso-social-media-manager__set_telegram_commands",
      "mcp__hermoso-social-media-manager__update_linkedin_event",
      "mcp__hermoso-social-media-manager__send_bluesky_dm",
      "mcp__hermoso-social-media-manager__manage_bluesky_convo",
      "mcp__hermoso-social-media-manager__post_to_tiktok",
      "mcp__hermoso-social-media-manager__reply_to_meta_message",
      "mcp__hermoso-social-media-manager__meta_thread_control",
      "mcp__hermoso-social-media-manager__meta_messenger_profile",
      "mcp__hermoso-social-media-manager__meta_conversation_labels",
      "mcp__hermoso-social-media-manager__unsubscribe_meta_webhooks",
      "mcp__hermoso-social-media-manager__save_instagram_dm_automation",
      "mcp__hermoso-social-media-manager__delete_instagram_dm_automation",
      "mcp__hermoso-social-media-manager__save_dm_automation",
      "mcp__hermoso-social-media-manager__delete_dm_automation",
      "mcp__hermoso-social-media-manager__manage_meta_partnership_creator",
      "mcp__hermoso-social-media-manager__manage_instagram_product_tags",
      "mcp__hermoso-social-media-manager__update_meta_catalog",
      "mcp__hermoso-social-media-manager__delete_meta_catalog",
      "mcp__hermoso-social-media-manager__create_messenger_marketing_campaign",
      "mcp__hermoso-social-media-manager__send_messenger_marketing_message",
      "mcp__hermoso-social-media-manager__request_messenger_optin",
      "mcp__hermoso-social-media-manager__delete_messenger_marketing_campaign",
      "mcp__hermoso-social-media-manager__publish_to_shopify_product",
      "mcp__hermoso-social-media-manager__create_shopify_discount_code",
      "mcp__hermoso-social-media-manager__disable_shopify_discount_code",
      "mcp__hermoso-social-media-manager__update_shopify_order",
      "mcp__hermoso-social-media-manager__edit_shopify_order_items",
      "mcp__hermoso-social-media-manager__fulfill_shopify_order",
      "mcp__hermoso-social-media-manager__cancel_shopify_order",
      "mcp__hermoso-social-media-manager__refund_shopify_order",
      "mcp__hermoso-social-media-manager__set_shopify_inventory",
      "mcp__hermoso-social-media-manager__configure_phone_number",
      "mcp__hermoso-social-media-manager__release_phone_number",
      "mcp__hermoso-social-media-manager__set_sms_settings",
      "mcp__hermoso-social-media-manager__remove_sms_consent",
      "mcp__hermoso-social-media-manager__deactivate_phone_service",
      "mcp__hermoso-social-media-manager__cancel_port_order",
      "mcp__hermoso-social-media-manager__delete_voice_agent",
      "mcp__hermoso-social-media-manager__detach_voice_agent_number",
      "mcp__hermoso-social-media-manager__cancel_voice_agent_batch",
      "mcp__hermoso-social-media-manager__cancel_voice_agent_call",
      "mcp__hermoso-social-media-manager__delete_mailchimp_template",
      "mcp__hermoso-social-media-manager__send_mailchimp_campaign",
      "mcp__hermoso-social-media-manager__cancel_mailchimp_campaign",
      "mcp__hermoso-social-media-manager__delete_mailchimp_campaign",
      "mcp__hermoso-social-media-manager__update_klaviyo_template",
      "mcp__hermoso-social-media-manager__delete_klaviyo_template",
      "mcp__hermoso-social-media-manager__update_klaviyo_campaign",
      "mcp__hermoso-social-media-manager__send_klaviyo_campaign",
      "mcp__hermoso-social-media-manager__cancel_klaviyo_campaign",
      "mcp__hermoso-social-media-manager__delete_klaviyo_campaign",
      "mcp__hermoso-social-media-manager__delete_contacts",
      "mcp__hermoso-social-media-manager__enroll_contacts",
      "mcp__hermoso-social-media-manager__delete_creator_campaign",
      "mcp__hermoso-social-media-manager__review_campaign_creator",
      "mcp__hermoso-social-media-manager__review_campaign_post",
      "mcp__hermoso-social-media-manager__pay_campaign_creators",
      "mcp__hermoso-social-media-manager__creator_campaign_funds",
      "mcp__hermoso-social-media-manager__reply_to_intercom_conversation",
      "mcp__hermoso-social-media-manager__add_intercom_note",
      "mcp__hermoso-social-media-manager__manage_intercom_conversation",
      "mcp__hermoso-social-media-manager__tag_intercom_conversation",
      "mcp__hermoso-social-media-manager__comment_on_tiktok_video",
      "mcp__hermoso-social-media-manager__reply_to_tiktok_comment",
      "mcp__hermoso-social-media-manager__moderate_tiktok_comment",
      "mcp__hermoso-social-media-manager__set_tiktok_post_ad_authorization",
      "mcp__hermoso-social-media-manager__delete_tiktok_post_ad_authorization",
      "mcp__hermoso-social-media-manager__post_to_linkedin_page",
      "mcp__hermoso-social-media-manager__reply_to_linkedin_comment",
      "mcp__hermoso-social-media-manager__delete_linkedin_comment",
      "mcp__hermoso-social-media-manager__edit_linkedin_comment",
      "mcp__hermoso-social-media-manager__manage_linkedin_post",
      "mcp__hermoso-social-media-manager__delete_linkedin_lead_subscription",
      "mcp__hermoso-social-media-manager__manage_meta_post",
      "mcp__hermoso-social-media-manager__update_drive_file",
      "mcp__hermoso-social-media-manager__delete_drive_file",
      "mcp__hermoso-social-media-manager__update_notion_row",
      "mcp__hermoso-social-media-manager__update_sheet",
      "mcp__hermoso-social-media-manager__clear_sheet_range",
      "mcp__hermoso-social-media-manager__manage_sheet_tabs",
      "mcp__hermoso-social-media-manager__format_sheet",
      "mcp__hermoso-social-media-manager__update_doc",
      "mcp__hermoso-social-media-manager__update_onedrive_file",
      "mcp__hermoso-social-media-manager__delete_onedrive_file",
      "mcp__hermoso-social-media-manager__share_onedrive_file",
      "mcp__hermoso-social-media-manager__onedrive_file_permissions",
      "mcp__hermoso-social-media-manager__delete_skill",
      "mcp__hermoso-social-media-manager__forget",
      "mcp__hermoso-social-media-manager__tidy_memory",
      "mcp__hermoso-social-media-manager__update_saved_creator",
      "mcp__hermoso-social-media-manager__delete_playbook",
      "mcp__hermoso-social-media-manager__delete_creator",
      "mcp__hermoso-social-media-manager__delete_location",
      "mcp__hermoso-social-media-manager__update_brand",
      "mcp__hermoso-social-media-manager__update_settings",
      "mcp__hermoso-social-media-manager__set_alert_events",
      "mcp__hermoso-social-media-manager__rotate_webhook_signing_secret",
      "mcp__hermoso-social-media-manager__set_connector_accounts",
      "mcp__hermoso-social-media-manager__disconnect_connector",
      "mcp__hermoso-social-media-manager__connect_connector",
      "mcp__hermoso-social-media-manager__leave_connector",
      "mcp__hermoso-social-media-manager__invite_member",
      "mcp__hermoso-social-media-manager__remove_member",
      "mcp__hermoso-social-media-manager__set_role",
      "mcp__hermoso-social-media-manager__draft_brand",
      "mcp__hermoso-social-media-manager__delete_library_item",
      "mcp__hermoso-social-media-manager__list_products"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as hermoso-social-media-manager. Review it before you use it.

Capability tags behind 549 rules
  • mcp__hermoso-social-media-manager__call_tool untrusted-input
  • mcp__hermoso-social-media-manager__post_to_bluesky untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_bluesky_post untrusted-input
  • mcp__hermoso-social-media-manager__post_to_telegram untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_telegram_chats private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_telegram_dms private-data, untrusted-input
  • mcp__hermoso-social-media-manager__delete_telegram_message untrusted-input
  • mcp__hermoso-social-media-manager__post_to_wordpress untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_wordpress_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_wordpress_post untrusted-input
  • mcp__hermoso-social-media-manager__list_wordpress_posts untrusted-input
  • mcp__hermoso-social-media-manager__get_wordpress_post untrusted-input
  • mcp__hermoso-social-media-manager__list_wordpress_terms untrusted-input
  • mcp__hermoso-social-media-manager__create_wordpress_term untrusted-input
  • mcp__hermoso-social-media-manager__post_to_shopify_blog untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_shopify_article untrusted-input
  • mcp__hermoso-social-media-manager__delete_shopify_article untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_articles untrusted-input
  • mcp__hermoso-social-media-manager__get_shopify_article untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_blogs untrusted-input
  • mcp__hermoso-social-media-manager__post_to_webflow untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_webflow_item untrusted-input
  • mcp__hermoso-social-media-manager__delete_webflow_item untrusted-input
  • mcp__hermoso-social-media-manager__list_webflow_items untrusted-input
  • mcp__hermoso-social-media-manager__get_webflow_item untrusted-input
  • mcp__hermoso-social-media-manager__list_webflow_collections untrusted-input
  • mcp__hermoso-social-media-manager__set_webflow_collection untrusted-input
  • mcp__hermoso-social-media-manager__post_to_wix untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_wix_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_wix_post untrusted-input
  • mcp__hermoso-social-media-manager__list_wix_posts untrusted-input
  • mcp__hermoso-social-media-manager__get_wix_post untrusted-input
  • mcp__hermoso-social-media-manager__get_wix_blog untrusted-input
  • mcp__hermoso-social-media-manager__post_to_discord untrusted-input, outbound
  • mcp__hermoso-social-media-manager__edit_discord_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_discord_message untrusted-input
  • mcp__hermoso-social-media-manager__get_discord_message private-data, untrusted-input
  • mcp__hermoso-social-media-manager__post_to_slack untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_slack_channels untrusted-input
  • mcp__hermoso-social-media-manager__set_slack_channel untrusted-input, outbound
  • mcp__hermoso-social-media-manager__read_slack_channel private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_slack_members untrusted-input
  • mcp__hermoso-social-media-manager__send_slack_dm untrusted-input, outbound
  • mcp__hermoso-social-media-manager__read_slack_dm private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_discord_channels untrusted-input
  • mcp__hermoso-social-media-manager__set_discord_channel untrusted-input, outbound
  • mcp__hermoso-social-media-manager__read_discord_channel private-data, untrusted-input
  • mcp__hermoso-social-media-manager__get_discord_poll untrusted-input
  • mcp__hermoso-social-media-manager__end_discord_poll untrusted-input
  • mcp__hermoso-social-media-manager__crosspost_discord_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__create_discord_thread untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_discord_thread untrusted-input
  • mcp__hermoso-social-media-manager__send_discord_dm untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_discord_roles untrusted-input
  • mcp__hermoso-social-media-manager__create_discord_role untrusted-input
  • mcp__hermoso-social-media-manager__update_discord_role untrusted-input
  • mcp__hermoso-social-media-manager__delete_discord_role untrusted-input
  • mcp__hermoso-social-media-manager__assign_discord_role untrusted-input
  • mcp__hermoso-social-media-manager__remove_discord_role untrusted-input
  • mcp__hermoso-social-media-manager__list_discord_members untrusted-input
  • mcp__hermoso-social-media-manager__search_discord_members untrusted-input
  • mcp__hermoso-social-media-manager__list_discord_pins private-data, untrusted-input
  • mcp__hermoso-social-media-manager__pin_discord_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__unpin_discord_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_discord_events untrusted-input
  • mcp__hermoso-social-media-manager__create_discord_event untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_discord_event untrusted-input
  • mcp__hermoso-social-media-manager__delete_discord_event untrusted-input
  • mcp__hermoso-social-media-manager__check_discord_permissions untrusted-input
  • mcp__hermoso-social-media-manager__edit_slack_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__react_to_slack_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_slack_message untrusted-input
  • mcp__hermoso-social-media-manager__get_slack_message private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_slack_scheduled private-data, untrusted-input
  • mcp__hermoso-social-media-manager__cancel_slack_scheduled untrusted-input
  • mcp__hermoso-social-media-manager__list_inbox private-data, untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_inbox_item untrusted-input, outbound
  • mcp__hermoso-social-media-manager__buy_credits untrusted-input
  • mcp__hermoso-social-media-manager__report_bug untrusted-input
  • mcp__hermoso-social-media-manager__request_feature untrusted-input
  • mcp__hermoso-social-media-manager__contact_support untrusted-input
  • mcp__hermoso-social-media-manager__billing_status private-data
  • mcp__hermoso-social-media-manager__upgrade_plan untrusted-input
  • mcp__hermoso-social-media-manager__delete_brand untrusted-input
  • mcp__hermoso-social-media-manager__meta_page_insights untrusted-input
  • mcp__hermoso-social-media-manager__meta_post_insights untrusted-input, outbound
  • mcp__hermoso-social-media-manager__instagram_insights untrusted-input
  • mcp__hermoso-social-media-manager__list_instagram_media untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_stories untrusted-input
  • mcp__hermoso-social-media-manager__instagram_story_insights untrusted-input
  • mcp__hermoso-social-media-manager__get_meta_story private-data, untrusted-input, outbound
  • mcp__hermoso-social-media-manager__instagram_collaborators untrusted-input
  • mcp__hermoso-social-media-manager__search_instagram_audio untrusted-input
  • mcp__hermoso-social-media-manager__list_instagram_collab_invites untrusted-input
  • mcp__hermoso-social-media-manager__respond_instagram_collab_invite untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_instagram_collab_media untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_comments untrusted-input
  • mcp__hermoso-social-media-manager__comment_on_meta_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__like_instagram untrusted-input
  • mcp__hermoso-social-media-manager__find_instagram_marketplace_creators private-data, untrusted-input
  • mcp__hermoso-social-media-manager__instagram_marketplace_creator untrusted-input
  • mcp__hermoso-social-media-manager__list_instagram_marketplace_audiences untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_meta_comment untrusted-input, outbound
  • mcp__hermoso-social-media-manager__moderate_meta_comment untrusted-input
  • mcp__hermoso-social-media-manager__list_threads_posts private-data, untrusted-input
  • mcp__hermoso-social-media-manager__threads_insights untrusted-input
  • mcp__hermoso-social-media-manager__list_threads_replies private-data, untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_thread untrusted-input, outbound
  • mcp__hermoso-social-media-manager__hide_thread_reply untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_thread untrusted-input
  • mcp__hermoso-social-media-manager__repost_thread untrusted-input
  • mcp__hermoso-social-media-manager__threads_publishing_limit untrusted-input
  • mcp__hermoso-social-media-manager__list_threads_mentions private-data, untrusted-input
  • mcp__hermoso-social-media-manager__threads_trending_topics untrusted-input
  • mcp__hermoso-social-media-manager__embed_threads untrusted-input, outbound
  • mcp__hermoso-social-media-manager__search_threads_keyword private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_pages untrusted-input
  • mcp__hermoso-social-media-manager__upload_file untrusted-input, outbound
  • mcp__hermoso-social-media-manager__search_threads_locations private-data, untrusted-input
  • mcp__hermoso-social-media-manager__threads_profile private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_threads_profile_posts private-data, untrusted-input
  • mcp__hermoso-social-media-manager__search_instagram_hashtag private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_whatsapp_accounts private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_whatsapp_templates private-data, untrusted-input
  • mcp__hermoso-social-media-manager__create_whatsapp_template untrusted-input
  • mcp__hermoso-social-media-manager__delete_whatsapp_template untrusted-input
  • mcp__hermoso-social-media-manager__read_whatsapp_inbox private-data, untrusted-input
  • mcp__hermoso-social-media-manager__send_whatsapp_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__send_whatsapp_broadcast untrusted-input, outbound
  • mcp__hermoso-social-media-manager__manage_whatsapp_number untrusted-input
  • mcp__hermoso-social-media-manager__manage_whatsapp_flow untrusted-input
  • mcp__hermoso-social-media-manager__read_line_inbox private-data, untrusted-input
  • mcp__hermoso-social-media-manager__send_line_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__send_line_broadcast untrusted-input, outbound
  • mcp__hermoso-social-media-manager__line_quota untrusted-input
  • mcp__hermoso-social-media-manager__line_account untrusted-input
  • mcp__hermoso-social-media-manager__line_profile untrusted-input
  • mcp__hermoso-social-media-manager__post_to_meta untrusted-input, outbound
  • mcp__hermoso-social-media-manager__schedule_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_scheduled untrusted-input
  • mcp__hermoso-social-media-manager__reschedule_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__cancel_scheduled untrusted-input
  • mcp__hermoso-social-media-manager__retry_scheduled untrusted-input, outbound
  • mcp__hermoso-social-media-manager__instagram_posting_hold untrusted-input
  • mcp__hermoso-social-media-manager__duplicate_scheduled untrusted-input
  • mcp__hermoso-social-media-manager__get_post_refill private-data, untrusted-input
  • mcp__hermoso-social-media-manager__set_post_refill untrusted-input, outbound
  • mcp__hermoso-social-media-manager__run_post_refill untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_pending_approvals untrusted-input
  • mcp__hermoso-social-media-manager__approve_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__reject_post outbound
  • mcp__hermoso-social-media-manager__set_post_approval outbound
  • mcp__hermoso-social-media-manager__manage_post_queues outbound
  • mcp__hermoso-social-media-manager__make_evergreen untrusted-input, outbound
  • mcp__hermoso-social-media-manager__manage_evergreen untrusted-input
  • mcp__hermoso-social-media-manager__import_posts_csv untrusted-input, outbound
  • mcp__hermoso-social-media-manager__post_to_linkedin untrusted-input, outbound
  • mcp__hermoso-social-media-manager__post_to_x untrusted-input, outbound
  • mcp__hermoso-social-media-manager__post_x_article untrusted-input, outbound
  • mcp__hermoso-social-media-manager__edit_x_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_x_post untrusted-input
  • mcp__hermoso-social-media-manager__x_post_metrics untrusted-input, outbound
  • mcp__hermoso-social-media-manager__x_post_insights untrusted-input, outbound
  • mcp__hermoso-social-media-manager__x_post_insights_historical untrusted-input, outbound
  • mcp__hermoso-social-media-manager__x_mentions untrusted-input
  • mcp__hermoso-social-media-manager__list_x_dms private-data, untrusted-input
  • mcp__hermoso-social-media-manager__send_x_dm untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_pinterest_boards untrusted-input
  • mcp__hermoso-social-media-manager__pinterest_analytics untrusted-input
  • mcp__hermoso-social-media-manager__pinterest_trends untrusted-input
  • mcp__hermoso-social-media-manager__list_pinterest_catalogs untrusted-input
  • mcp__hermoso-social-media-manager__create_pinterest_catalog untrusted-input
  • mcp__hermoso-social-media-manager__manage_pinterest_catalog_feed untrusted-input
  • mcp__hermoso-social-media-manager__update_pinterest_catalog_items untrusted-input
  • mcp__hermoso-social-media-manager__manage_pinterest_product_group untrusted-input
  • mcp__hermoso-social-media-manager__list_pinterest_board_sections untrusted-input
  • mcp__hermoso-social-media-manager__manage_pinterest_board_section untrusted-input
  • mcp__hermoso-social-media-manager__pinterest_account_lists untrusted-input
  • mcp__hermoso-social-media-manager__create_pinterest_board untrusted-input
  • mcp__hermoso-social-media-manager__post_to_pinterest untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_pinterest_pins untrusted-input
  • mcp__hermoso-social-media-manager__update_pinterest_pin untrusted-input
  • mcp__hermoso-social-media-manager__save_pinterest_pin untrusted-input
  • mcp__hermoso-social-media-manager__delete_pinterest_pin untrusted-input
  • mcp__hermoso-social-media-manager__update_pinterest_board untrusted-input
  • mcp__hermoso-social-media-manager__delete_pinterest_board untrusted-input
  • mcp__hermoso-social-media-manager__pinterest_targeting_analytics untrusted-input
  • mcp__hermoso-social-media-manager__pinterest_audience_insights untrusted-input
  • mcp__hermoso-social-media-manager__list_business_locations untrusted-input
  • mcp__hermoso-social-media-manager__post_to_google_business untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_google_business_posts untrusted-input
  • mcp__hermoso-social-media-manager__update_google_business_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_google_business_post untrusted-input
  • mcp__hermoso-social-media-manager__list_google_business_reviews untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_google_business_review untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_google_business_questions untrusted-input
  • mcp__hermoso-social-media-manager__answer_google_business_question untrusted-input, outbound
  • mcp__hermoso-social-media-manager__google_business_insights untrusted-input
  • mcp__hermoso-social-media-manager__get_business_location untrusted-input
  • mcp__hermoso-social-media-manager__update_business_location untrusted-input
  • mcp__hermoso-social-media-manager__google_business_account untrusted-input
  • mcp__hermoso-social-media-manager__post_to_youtube untrusted-input, outbound
  • mcp__hermoso-social-media-manager__youtube_channel untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_videos untrusted-input
  • mcp__hermoso-social-media-manager__youtube_video_insights untrusted-input
  • mcp__hermoso-social-media-manager__youtube_channel_report untrusted-input
  • mcp__hermoso-social-media-manager__youtube_bulk_report untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_report_jobs untrusted-input
  • mcp__hermoso-social-media-manager__delete_youtube_report_job untrusted-input
  • mcp__hermoso-social-media-manager__update_youtube_video untrusted-input
  • mcp__hermoso-social-media-manager__delete_youtube_video untrusted-input
  • mcp__hermoso-social-media-manager__update_youtube_channel untrusted-input
  • mcp__hermoso-social-media-manager__set_youtube_watermark untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_video_stats untrusted-input
  • mcp__hermoso-social-media-manager__set_youtube_thumbnail untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_comments untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_comment_replies untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_youtube_comment untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_youtube_playlists untrusted-input
  • mcp__hermoso-social-media-manager__manage_youtube_playlist untrusted-input
  • mcp__hermoso-social-media-manager__manage_youtube_playlist_items untrusted-input
  • mcp__hermoso-social-media-manager__manage_youtube_channel_section untrusted-input
  • mcp__hermoso-social-media-manager__manage_youtube_playlist_image untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_captions untrusted-input
  • mcp__hermoso-social-media-manager__manage_youtube_caption untrusted-input
  • mcp__hermoso-social-media-manager__moderate_youtube_comment untrusted-input
  • mcp__hermoso-social-media-manager__list_youtube_categories untrusted-input
  • mcp__hermoso-social-media-manager__google_business_search_keywords untrusted-input
  • mcp__hermoso-social-media-manager__list_bluesky_posts untrusted-input
  • mcp__hermoso-social-media-manager__search_x untrusted-input
  • mcp__hermoso-social-media-manager__x_search_counts untrusted-input
  • mcp__hermoso-social-media-manager__x_trends untrusted-input
  • mcp__hermoso-social-media-manager__x_follows untrusted-input
  • mcp__hermoso-social-media-manager__hide_x_reply untrusted-input, outbound
  • mcp__hermoso-social-media-manager__repost_on_x untrusted-input
  • mcp__hermoso-social-media-manager__bookmark_x_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__follow_x_account untrusted-input
  • mcp__hermoso-social-media-manager__list_x_blocks untrusted-input
  • mcp__hermoso-social-media-manager__list_x_broadcasts untrusted-input
  • mcp__hermoso-social-media-manager__manage_x_broadcast untrusted-input, outbound
  • mcp__hermoso-social-media-manager__manage_x_stream_source untrusted-input
  • mcp__hermoso-social-media-manager__read_x_broadcast_chat private-data, untrusted-input
  • mcp__hermoso-social-media-manager__send_x_broadcast_chat untrusted-input, outbound
  • mcp__hermoso-social-media-manager__moderate_x_broadcast untrusted-input, outbound
  • mcp__hermoso-social-media-manager__x_chat_settings untrusted-input
  • mcp__hermoso-social-media-manager__update_x_chat_settings untrusted-input
  • mcp__hermoso-social-media-manager__list_x_chats private-data, untrusted-input
  • mcp__hermoso-social-media-manager__manage_x_chat untrusted-input
  • mcp__hermoso-social-media-manager__x_user untrusted-input
  • mcp__hermoso-social-media-manager__x_account untrusted-input
  • mcp__hermoso-social-media-manager__edit_telegram_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__pin_telegram_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__set_telegram_commands untrusted-input
  • mcp__hermoso-social-media-manager__create_telegram_invite_link untrusted-input, outbound
  • mcp__hermoso-social-media-manager__create_linkedin_event untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_linkedin_event untrusted-input
  • mcp__hermoso-social-media-manager__list_linkedin_events untrusted-input
  • mcp__hermoso-social-media-manager__search_linkedin_ad_library untrusted-input
  • mcp__hermoso-social-media-manager__search_linkedin_brand_partnerships untrusted-input
  • mcp__hermoso-social-media-manager__list_business_categories untrusted-input
  • mcp__hermoso-social-media-manager__list_business_attributes untrusted-input
  • mcp__hermoso-social-media-manager__business_google_updated untrusted-input
  • mcp__hermoso-social-media-manager__telegram_account untrusted-input, outbound
  • mcp__hermoso-social-media-manager__bluesky_account untrusted-input
  • mcp__hermoso-social-media-manager__bluesky_post_metrics untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_bluesky_convos private-data, untrusted-input
  • mcp__hermoso-social-media-manager__read_bluesky_dm private-data, untrusted-input
  • mcp__hermoso-social-media-manager__send_bluesky_dm untrusted-input, outbound
  • mcp__hermoso-social-media-manager__mark_bluesky_convo_read untrusted-input
  • mcp__hermoso-social-media-manager__manage_bluesky_convo untrusted-input
  • mcp__hermoso-social-media-manager__react_to_bluesky_dm untrusted-input, outbound
  • mcp__hermoso-social-media-manager__tiktok_creator_info untrusted-input
  • mcp__hermoso-social-media-manager__post_to_tiktok untrusted-input, outbound
  • mcp__hermoso-social-media-manager__tiktok_post_status untrusted-input, outbound
  • mcp__hermoso-social-media-manager__tiktok_account untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_videos untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_conversations private-data, untrusted-input
  • mcp__hermoso-social-media-manager__read_meta_conversation private-data, untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_meta_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__meta_thread_control untrusted-input
  • mcp__hermoso-social-media-manager__meta_messenger_profile untrusted-input
  • mcp__hermoso-social-media-manager__meta_conversation_labels untrusted-input
  • mcp__hermoso-social-media-manager__meta_page_reviews untrusted-input
  • mcp__hermoso-social-media-manager__instagram_mentions untrusted-input, outbound
  • mcp__hermoso-social-media-manager__subscribe_meta_webhooks untrusted-input
  • mcp__hermoso-social-media-manager__meta_webhook_status untrusted-input
  • mcp__hermoso-social-media-manager__unsubscribe_meta_webhooks untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_webhook_events untrusted-input
  • mcp__hermoso-social-media-manager__list_instagram_dm_automations private-data, untrusted-input
  • mcp__hermoso-social-media-manager__save_instagram_dm_automation untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_dm_automations private-data, untrusted-input
  • mcp__hermoso-social-media-manager__save_dm_automation untrusted-input, outbound
  • mcp__hermoso-social-media-manager__test_dm_automation outbound
  • mcp__hermoso-social-media-manager__list_meta_partnership_creators untrusted-input
  • mcp__hermoso-social-media-manager__manage_meta_partnership_creator untrusted-input
  • mcp__hermoso-social-media-manager__instagram_profile untrusted-input
  • mcp__hermoso-social-media-manager__list_instagram_shopping_catalogs untrusted-input
  • mcp__hermoso-social-media-manager__search_instagram_shopping_products untrusted-input
  • mcp__hermoso-social-media-manager__manage_instagram_product_tags untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_catalogs untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_product_sets untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_catalog_products untrusted-input
  • mcp__hermoso-social-media-manager__create_meta_catalog untrusted-input
  • mcp__hermoso-social-media-manager__update_meta_catalog untrusted-input
  • mcp__hermoso-social-media-manager__meta_catalog_blast_radius untrusted-input
  • mcp__hermoso-social-media-manager__delete_meta_catalog untrusted-input
  • mcp__hermoso-social-media-manager__list_messenger_subscribers private-data, untrusted-input
  • mcp__hermoso-social-media-manager__create_messenger_marketing_campaign untrusted-input
  • mcp__hermoso-social-media-manager__list_messenger_marketing_campaigns private-data, untrusted-input
  • mcp__hermoso-social-media-manager__get_messenger_marketing_message_status private-data, untrusted-input
  • mcp__hermoso-social-media-manager__estimate_messenger_marketing_delivery untrusted-input
  • mcp__hermoso-social-media-manager__send_messenger_marketing_message untrusted-input, outbound
  • mcp__hermoso-social-media-manager__request_messenger_optin untrusted-input
  • mcp__hermoso-social-media-manager__delete_messenger_marketing_campaign untrusted-input
  • mcp__hermoso-social-media-manager__connect_shopify_store untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_products untrusted-input
  • mcp__hermoso-social-media-manager__publish_to_shopify_product untrusted-input, outbound
  • mcp__hermoso-social-media-manager__create_shopify_discount_code untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_discount_codes untrusted-input
  • mcp__hermoso-social-media-manager__disable_shopify_discount_code untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_orders private-data, untrusted-input
  • mcp__hermoso-social-media-manager__shopify_sales_report untrusted-input, outbound
  • mcp__hermoso-social-media-manager__import_shopify_buyers_to_email_leads untrusted-input, outbound
  • mcp__hermoso-social-media-manager__update_shopify_order untrusted-input
  • mcp__hermoso-social-media-manager__edit_shopify_order_items untrusted-input
  • mcp__hermoso-social-media-manager__fulfill_shopify_order untrusted-input
  • mcp__hermoso-social-media-manager__cancel_shopify_order untrusted-input
  • mcp__hermoso-social-media-manager__refund_shopify_order untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_locations untrusted-input
  • mcp__hermoso-social-media-manager__get_shopify_inventory untrusted-input
  • mcp__hermoso-social-media-manager__set_shopify_inventory untrusted-input
  • mcp__hermoso-social-media-manager__list_phone_numbers private-data, untrusted-input
  • mcp__hermoso-social-media-manager__search_phone_numbers untrusted-input
  • mcp__hermoso-social-media-manager__buy_phone_number untrusted-input, outbound
  • mcp__hermoso-social-media-manager__configure_phone_number untrusted-input
  • mcp__hermoso-social-media-manager__release_phone_number untrusted-input
  • mcp__hermoso-social-media-manager__send_sms untrusted-input, outbound
  • mcp__hermoso-social-media-manager__get_sms_status private-data, untrusted-input
  • mcp__hermoso-social-media-manager__sms_conversation untrusted-input
  • mcp__hermoso-social-media-manager__set_sms_settings untrusted-input, outbound
  • mcp__hermoso-social-media-manager__record_sms_consent untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_sms_consents untrusted-input
  • mcp__hermoso-social-media-manager__remove_sms_consent untrusted-input
  • mcp__hermoso-social-media-manager__set_sms_opt_out untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_provider_opt_outs untrusted-input
  • mcp__hermoso-social-media-manager__sms_registration_status untrusted-input
  • mcp__hermoso-social-media-manager__create_sms_registration_bundles untrusted-input, outbound
  • mcp__hermoso-social-media-manager__register_sms_brand untrusted-input, outbound
  • mcp__hermoso-social-media-manager__register_sms_campaign untrusted-input
  • mcp__hermoso-social-media-manager__assign_number_to_campaign untrusted-input
  • mcp__hermoso-social-media-manager__submit_tollfree_verification untrusted-input
  • mcp__hermoso-social-media-manager__list_calls untrusted-input
  • mcp__hermoso-social-media-manager__list_call_recordings untrusted-input
  • mcp__hermoso-social-media-manager__transcribe_call untrusted-input
  • mcp__hermoso-social-media-manager__place_call untrusted-input, outbound
  • mcp__hermoso-social-media-manager__call_tracking_report untrusted-input
  • mcp__hermoso-social-media-manager__list_shopify_sms_buyers untrusted-input
  • mcp__hermoso-social-media-manager__phone_service_status untrusted-input
  • mcp__hermoso-social-media-manager__activate_phone_service untrusted-input
  • mcp__hermoso-social-media-manager__deactivate_phone_service untrusted-input
  • mcp__hermoso-social-media-manager__send_verification_code untrusted-input, outbound
  • mcp__hermoso-social-media-manager__check_verification_code untrusted-input, outbound
  • mcp__hermoso-social-media-manager__check_number_portability untrusted-input
  • mcp__hermoso-social-media-manager__create_port_order untrusted-input
  • mcp__hermoso-social-media-manager__list_port_orders untrusted-input
  • mcp__hermoso-social-media-manager__get_port_order private-data, untrusted-input
  • mcp__hermoso-social-media-manager__cancel_port_order untrusted-input
  • mcp__hermoso-social-media-manager__list_voice_agents untrusted-input
  • mcp__hermoso-social-media-manager__get_voice_agent untrusted-input
  • mcp__hermoso-social-media-manager__draft_voice_agent untrusted-input
  • mcp__hermoso-social-media-manager__create_voice_agent untrusted-input
  • mcp__hermoso-social-media-manager__update_voice_agent untrusted-input
  • mcp__hermoso-social-media-manager__delete_voice_agent untrusted-input
  • mcp__hermoso-social-media-manager__list_voice_agent_voices untrusted-input
  • mcp__hermoso-social-media-manager__list_voice_agent_numbers untrusted-input
  • mcp__hermoso-social-media-manager__attach_voice_agent_number untrusted-input
  • mcp__hermoso-social-media-manager__detach_voice_agent_number untrusted-input
  • mcp__hermoso-social-media-manager__place_voice_agent_call untrusted-input, outbound
  • mcp__hermoso-social-media-manager__batch_voice_agent_calls untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_voice_agent_batches untrusted-input
  • mcp__hermoso-social-media-manager__cancel_voice_agent_batch untrusted-input
  • mcp__hermoso-social-media-manager__cancel_voice_agent_call untrusted-input
  • mcp__hermoso-social-media-manager__list_voice_agent_calls untrusted-input
  • mcp__hermoso-social-media-manager__get_voice_agent_call untrusted-input
  • mcp__hermoso-social-media-manager__list_mailchimp_audiences private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_mailchimp_segments untrusted-input
  • mcp__hermoso-social-media-manager__list_mailchimp_campaigns untrusted-input
  • mcp__hermoso-social-media-manager__list_mailchimp_templates private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_mailchimp_files private-data, untrusted-input
  • mcp__hermoso-social-media-manager__upload_mailchimp_image untrusted-input
  • mcp__hermoso-social-media-manager__create_mailchimp_template untrusted-input
  • mcp__hermoso-social-media-manager__update_mailchimp_template untrusted-input
  • mcp__hermoso-social-media-manager__delete_mailchimp_template untrusted-input
  • mcp__hermoso-social-media-manager__send_mailchimp_test_email untrusted-input, outbound
  • mcp__hermoso-social-media-manager__create_mailchimp_campaign untrusted-input
  • mcp__hermoso-social-media-manager__update_mailchimp_campaign untrusted-input
  • mcp__hermoso-social-media-manager__send_mailchimp_campaign untrusted-input, outbound
  • mcp__hermoso-social-media-manager__cancel_mailchimp_campaign untrusted-input
  • mcp__hermoso-social-media-manager__delete_mailchimp_campaign untrusted-input
  • mcp__hermoso-social-media-manager__mailchimp_report untrusted-input
  • mcp__hermoso-social-media-manager__sync_leads_to_mailchimp untrusted-input
  • mcp__hermoso-social-media-manager__list_klaviyo_lists untrusted-input
  • mcp__hermoso-social-media-manager__list_klaviyo_segments untrusted-input
  • mcp__hermoso-social-media-manager__list_klaviyo_campaigns private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_klaviyo_flows untrusted-input
  • mcp__hermoso-social-media-manager__list_klaviyo_templates private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_klaviyo_images untrusted-input
  • mcp__hermoso-social-media-manager__upload_klaviyo_image untrusted-input
  • mcp__hermoso-social-media-manager__create_klaviyo_template untrusted-input
  • mcp__hermoso-social-media-manager__update_klaviyo_template untrusted-input
  • mcp__hermoso-social-media-manager__delete_klaviyo_template untrusted-input
  • mcp__hermoso-social-media-manager__send_klaviyo_test_email untrusted-input, outbound
  • mcp__hermoso-social-media-manager__create_klaviyo_campaign untrusted-input
  • mcp__hermoso-social-media-manager__update_klaviyo_campaign untrusted-input
  • mcp__hermoso-social-media-manager__send_klaviyo_campaign untrusted-input, outbound
  • mcp__hermoso-social-media-manager__cancel_klaviyo_campaign untrusted-input
  • mcp__hermoso-social-media-manager__delete_klaviyo_campaign untrusted-input
  • mcp__hermoso-social-media-manager__klaviyo_report untrusted-input, outbound
  • mcp__hermoso-social-media-manager__sync_leads_to_klaviyo untrusted-input
  • mcp__hermoso-social-media-manager__list_contacts private-data, untrusted-input
  • mcp__hermoso-social-media-manager__save_contacts untrusted-input
  • mcp__hermoso-social-media-manager__enroll_contacts untrusted-input
  • mcp__hermoso-social-media-manager__read_creator_campaigns untrusted-input
  • mcp__hermoso-social-media-manager__bulk_invite_creators outbound
  • mcp__hermoso-social-media-manager__list_campaign_posts untrusted-input
  • mcp__hermoso-social-media-manager__review_campaign_post outbound
  • mcp__hermoso-social-media-manager__add_campaign_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__refresh_campaign_views untrusted-input
  • mcp__hermoso-social-media-manager__pay_campaign_creators untrusted-input
  • mcp__hermoso-social-media-manager__creator_campaign_funds untrusted-input
  • mcp__hermoso-social-media-manager__creator_campaign_sales untrusted-input
  • mcp__hermoso-social-media-manager__preview_creator_campaign untrusted-input
  • mcp__hermoso-social-media-manager__promote_campaign_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__email_campaign_creator untrusted-input
  • mcp__hermoso-social-media-manager__list_intercom_conversations private-data, untrusted-input
  • mcp__hermoso-social-media-manager__read_intercom_conversation private-data, untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_intercom_conversation untrusted-input, outbound
  • mcp__hermoso-social-media-manager__add_intercom_note untrusted-input
  • mcp__hermoso-social-media-manager__manage_intercom_conversation untrusted-input
  • mcp__hermoso-social-media-manager__list_intercom_tags private-data, untrusted-input
  • mcp__hermoso-social-media-manager__tag_intercom_conversation untrusted-input
  • mcp__hermoso-social-media-manager__search_intercom_contacts private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_intercom_teammates private-data, untrusted-input
  • mcp__hermoso-social-media-manager__intercom_customer_language untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_account_status untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_comments untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_comment_replies untrusted-input
  • mcp__hermoso-social-media-manager__comment_on_tiktok_video untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_tiktok_comment untrusted-input, outbound
  • mcp__hermoso-social-media-manager__moderate_tiktok_comment untrusted-input
  • mcp__hermoso-social-media-manager__upload_tiktok_comment_image untrusted-input, outbound
  • mcp__hermoso-social-media-manager__set_tiktok_post_ad_authorization untrusted-input, outbound
  • mcp__hermoso-social-media-manager__get_tiktok_post_ad_authorization untrusted-input
  • mcp__hermoso-social-media-manager__extend_tiktok_post_ad_authorization untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_tiktok_post_ad_authorization untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_mentions untrusted-input
  • mcp__hermoso-social-media-manager__get_tiktok_mention untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_mention_comments untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_mention_top_terms untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_brand_hashtags untrusted-input
  • mcp__hermoso-social-media-manager__manage_tiktok_brand_hashtags untrusted-input
  • mcp__hermoso-social-media-manager__list_tiktok_brand_hashtag_posts untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_account_insights untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_category_benchmark untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_video_insights untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_spark_recommendations untrusted-input
  • mcp__hermoso-social-media-manager__tiktok_hashtag_suggestions untrusted-input
  • mcp__hermoso-social-media-manager__list_linkedin_pages untrusted-input
  • mcp__hermoso-social-media-manager__post_to_linkedin_page untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_linkedin_comments untrusted-input
  • mcp__hermoso-social-media-manager__reply_to_linkedin_comment untrusted-input, outbound
  • mcp__hermoso-social-media-manager__delete_linkedin_comment untrusted-input
  • mcp__hermoso-social-media-manager__react_to_linkedin_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__edit_linkedin_comment untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_linkedin_page_notifications untrusted-input
  • mcp__hermoso-social-media-manager__manage_linkedin_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__linkedin_profile_followers untrusted-input
  • mcp__hermoso-social-media-manager__linkedin_page_analytics untrusted-input
  • mcp__hermoso-social-media-manager__list_linkedin_lead_forms private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_linkedin_leads private-data, untrusted-input
  • mcp__hermoso-social-media-manager__get_linkedin_lead untrusted-input
  • mcp__hermoso-social-media-manager__subscribe_linkedin_leads untrusted-input
  • mcp__hermoso-social-media-manager__list_linkedin_lead_subscriptions untrusted-input
  • mcp__hermoso-social-media-manager__delete_linkedin_lead_subscription untrusted-input
  • mcp__hermoso-social-media-manager__manage_meta_post untrusted-input, outbound
  • mcp__hermoso-social-media-manager__save_to_drive untrusted-input, outbound
  • mcp__hermoso-social-media-manager__import_from_cloud untrusted-input
  • mcp__hermoso-social-media-manager__list_drive_files private-data, untrusted-input
  • mcp__hermoso-social-media-manager__get_drive_file private-data, untrusted-input
  • mcp__hermoso-social-media-manager__update_drive_file untrusted-input
  • mcp__hermoso-social-media-manager__delete_drive_file untrusted-input
  • mcp__hermoso-social-media-manager__create_drive_folder untrusted-input
  • mcp__hermoso-social-media-manager__create_sheet untrusted-input
  • mcp__hermoso-social-media-manager__append_to_sheet untrusted-input
  • mcp__hermoso-social-media-manager__read_sheet private-data, untrusted-input
  • mcp__hermoso-social-media-manager__export_swipefile_deck untrusted-input
  • mcp__hermoso-social-media-manager__list_notion_pages private-data, untrusted-input
  • mcp__hermoso-social-media-manager__save_to_notion untrusted-input
  • mcp__hermoso-social-media-manager__append_to_notion_page untrusted-input
  • mcp__hermoso-social-media-manager__read_notion_page untrusted-input
  • mcp__hermoso-social-media-manager__export_schedule_to_notion untrusted-input
  • mcp__hermoso-social-media-manager__query_notion_database private-data, untrusted-input
  • mcp__hermoso-social-media-manager__update_notion_row untrusted-input
  • mcp__hermoso-social-media-manager__create_doc untrusted-input
  • mcp__hermoso-social-media-manager__append_to_doc untrusted-input
  • mcp__hermoso-social-media-manager__read_doc private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_sheet_tabs untrusted-input
  • mcp__hermoso-social-media-manager__update_sheet untrusted-input
  • mcp__hermoso-social-media-manager__clear_sheet_range untrusted-input
  • mcp__hermoso-social-media-manager__manage_sheet_tabs untrusted-input
  • mcp__hermoso-social-media-manager__format_sheet untrusted-input
  • mcp__hermoso-social-media-manager__update_doc untrusted-input
  • mcp__hermoso-social-media-manager__save_to_onedrive untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_onedrive_files private-data, untrusted-input
  • mcp__hermoso-social-media-manager__get_onedrive_file private-data, untrusted-input
  • mcp__hermoso-social-media-manager__update_onedrive_file untrusted-input
  • mcp__hermoso-social-media-manager__delete_onedrive_file untrusted-input
  • mcp__hermoso-social-media-manager__share_onedrive_file untrusted-input
  • mcp__hermoso-social-media-manager__onedrive_file_permissions untrusted-input
  • mcp__hermoso-social-media-manager__convert_onedrive_file untrusted-input
  • mcp__hermoso-social-media-manager__create_onedrive_folder untrusted-input
  • mcp__hermoso-social-media-manager__plan_week untrusted-input
  • mcp__hermoso-social-media-manager__list_memory untrusted-input
  • mcp__hermoso-social-media-manager__list_swipefile untrusted-input
  • mcp__hermoso-social-media-manager__save_creator untrusted-input
  • mcp__hermoso-social-media-manager__get_settings private-data, untrusted-input
  • mcp__hermoso-social-media-manager__list_connectors private-data
  • mcp__hermoso-social-media-manager__list_alert_settings untrusted-input
  • mcp__hermoso-social-media-manager__send_test_alert untrusted-input, outbound
  • mcp__hermoso-social-media-manager__redeliver_webhook untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_connector_accounts untrusted-input
  • mcp__hermoso-social-media-manager__set_connector_accounts untrusted-input
  • mcp__hermoso-social-media-manager__disconnect_connector untrusted-input
  • mcp__hermoso-social-media-manager__connect_connector untrusted-input
  • mcp__hermoso-social-media-manager__leave_connector untrusted-input
  • mcp__hermoso-social-media-manager__list_team private-data, untrusted-input
  • mcp__hermoso-social-media-manager__invite_member untrusted-input, outbound
  • mcp__hermoso-social-media-manager__remove_member untrusted-input
  • mcp__hermoso-social-media-manager__get_brand untrusted-input
  • mcp__hermoso-social-media-manager__draft_brand untrusted-input
  • mcp__hermoso-social-media-manager__delete_library_item untrusted-input
  • mcp__hermoso-social-media-manager__fetch_asset untrusted-input, outbound
  • mcp__hermoso-social-media-manager__list_products untrusted-input
  • mcp__hermoso-social-media-manager__list_meta_posts untrusted-input
  • mcp__hermoso-social-media-manager__list_published_posts untrusted-input
  • mcp__hermoso-social-media-manager__post_performance outbound
  • mcp__hermoso-social-media-manager__diagnose_posts outbound
  • mcp__hermoso-social-media-manager__collect_post_metrics untrusted-input, outbound
  • mcp__hermoso-social-media-manager__backfill_posts untrusted-input, outbound

Pin

Keep the decision: fail CI when the tools change, follow every change, or show a badge.

Pin in CI

Fail a build when the tools you reviewed are not the tools the server serves today.

curl -s "https://radar.anlyon.com/api/v1/servers/io.github.hermoso-ai/hermoso-social-media-manager/verify?hash=b7b951de54e24cabf70f9e8607f0561a97e38a101837f22a112e5074fc6d0189" | jq -e '.changed == false'

Pinned hash b7b951de54e2, from Nov 21, 2026, 01:18 UTC.

Watch

Get told when its tools change: a new tool, a new description, a new class.

https://radar.anlyon.com/servers/io.github.hermoso-ai/hermoso-social-media-manager/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

Anlyon Radar badge for io.github.hermoso-ai/hermoso-social-media-manager
[![Anlyon Radar](https://radar.anlyon.com/badge/io.github.hermoso-ai/hermoso-social-media-manager.svg)](https://radar.anlyon.com/servers/io.github.hermoso-ai/hermoso-social-media-manager)

Source: MCP Registry · repository. Synced Nov 6, 2026, 22:17 UTC.

Hermoso: Social Media Manager MCP server: questions and answers

Answered from the scan above, not from the publisher's description.

Is the Hermoso: Social Media Manager MCP server safe?

No scan can promise that. What its definitions show: 605 tools, 404 of which can change, send or delete something, and 41 findings (5 high) from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.

Can the Hermoso: Social Media Manager MCP server delete data?

Yes. 220 tools can delete, cancel or revoke something: call_tool, post_to_bluesky, delete_bluesky_post, post_to_telegram, delete_telegram_message, post_to_wordpress and 214 more.

Can the Hermoso: Social Media Manager MCP server do things that cannot be undone?

Yes. 13 tools can send, pay, publish or merge: send_line_message, shopify_sales_report, send_sms, place_call, send_verification_code, check_verification_code and 7 more.

What tools does the Hermoso: Social Media Manager MCP server have?

605 tools: 220 destructive, 13 irreversible, 171 write, 201 read. call_tool, post_to_bluesky, delete_bluesky_post, post_to_telegram, delete_telegram_message, post_to_wordpress, update_wordpress_post, delete_wordpress_post and 597 more.

Does the Hermoso: Social Media Manager MCP server need sign-in or OAuth?

Its remote endpoint listed its tools to an anonymous client, without sign-in.

Does the Hermoso: Social Media Manager MCP server send data to outside services?

129 tools can carry data out (it sends, posts or publishes, or takes a recipient, channel or URL): post_to_bluesky, post_to_telegram, post_to_wordpress, update_wordpress_post, post_to_shopify_blog, post_to_webflow and 123 more.

Has the Hermoso: Social Media Manager MCP server changed its tools?

Yes, once since Anlyon Radar started tracking it, most recently on Nov 21, 2026. Every change is on this page and in its Atom feed.