Hermoso: AI Ad Generator MCP server
io.github.hermoso-ai/hermoso-ai-ad-generatorhermoso-aistreamable-httpv1.0.0Scanned
AI ad generator: make image and video ads for your brand and research the ads competitors run.
221 tools: 44 can delete or cancel things, 1 do something that can't be undone, 131 change things and 45 only read.
- Reads private data · 17
- Reads text others write · 168
- Can send data out · 24
- 31 findings
Tools listed without sign-in. Remote posture
With Anlyon
44 tools here can delete or cancel things and 1 does 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.
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: AI Ad Generator MCP server can do
The Hermoso: AI Ad Generator MCP server is published by the GitHub account hermoso-ai. It has 221 tools. It can delete or cancel things (44 tools: call_tool, delete_brand, update_drive_file, delete_drive_file and 40 more), do things that cannot be undone, such as sending, paying or publishing (tiktok_ideas) and create or change data (131 tools: enable_tools, hermoso_capabilities, hermoso_other_capabilities, buy_credits and 127 more). 45 tools only read.
17 tools read private data (billing_status, list_drive_files, get_drive_file and 14 more); 168 tools bring in text other people can write (call_tool, buy_credits, report_bug and 165 more); 24 tools can send data out of your system (upload_file, save_to_drive, save_to_onedrive and 21 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 31 findings (tool-shadowing, credentials-mention, long-description and annotation-conflict). 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.
221 tools
Deletes or cancels 44Claude Code: deny
add_productAdd a product to the brand's catalog from its product-page link: reads the page's own data (name, every photo, price and currency, description, its bullet-point selling points), no…Reads text others writeNo findings
Why it is in this group
- The name "add_product" 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 Add a product to the brand's catalog from its product-page link: reads the page's own data (name, every photo, price and currency, description, its bullet-point selling points), no model, 0 credits. Re-adding a link updates the row (the live page wins). Without a url, `title` adds one by hand. `audience` and `sellingPoints` you pass are kept through later re-reads.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: Add a product from a link
advance_story_filmRuns the next stage of a story film run and stops for approval.Reads text others writeNo findings
Why it is in this group
- The description's first verb is "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.
Description, as the server wrote it Runs the next stage of a story film run and stops for approval. Without approve it only reads the run and quotes the next stage (free). approve:true runs it: screenplay (billed at its writing tokens), boards (cast, location and one board per act, each paint billed as an image), clips (every act filmed from the approved boards and joined in order, reserved at the quote), final cut (free). Pass `creative` to replace the screenplay with an edited one (boards are repainted for it), or lengthSeconds to re-outline. A stage still rendering says so; call again to pick it up.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
- title: Run the next stage of a story film
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
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
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,443 characters long, over the 2,000 this check looks for.
What this check looks forMatched text
description ends: "...ceWebhookUrl} · discord {webhookUrl, announceWebhookUrl} · webhook {webhookUrl*}."
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; 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
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_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_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_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_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_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_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_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_video_presetDelete one saved video preset by id.No findings
Why it is in this group
- The name "delete_video_preset" says "delete": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Delete one saved video preset by id. Videos already made from it are kept. Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: false
- title: Delete a video preset
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".
What this check looks forMatched text
description: "...Slack, …). This always drops the stored credentials, so every tool for that provider stops..."
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. Next, for an image ad call generate_image directly (plan_ad is for a video or for concepts to choose from). 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
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
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".
What this check looks forMatched text
description: "...ve YOURS from this profile: your stored credential is dropped and the accounts you shared..."
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.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}; The name "list_products" says "list": a word for reading.
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. Use the ids with make_static_ads.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: List the product catalog
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
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
refresh_productsRe-read product pages now (all products with a page, or `ids`) and update the catalog: the live page wins, a failed read is recorded and said.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 Re-read product pages now (all products with a page, or `ids`) and update the catalog: the live page wins, a failed read is recorded and said. `sync:true` instead imports the whole store catalog (the brand's connected Shopify store, else its website's public catalog), merging into existing rows. Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: Re-check products against their pages
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
remove_productRemove one product from the brand's catalog (its ads already made stay in the Library).No findings
Why it is in this group
- The name "remove_product" says "remove": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Remove one product from the brand's catalog (its ads already made stay in the Library). Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: false
- title: Remove a product
set_competitor_watchSet, change or stop a brand's MARKET RADAR (the standing competitor watch; Ad Spy > Watching in the web app; each brand has its own), run weekly or daily: newAds (what watched bran…Reads text others writeNo findings
Why it is in this group
- The name "set_competitor_watch" 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, change or stop a brand's MARKET RADAR (the standing competitor watch; Ad Spy > Watching in the web app; each brand has its own), run weekly or daily: newAds (what watched brands launched), winners (their ad passing 30 days running), trends + topPosts (formats and most-viewed posts for niche topics), ideas (3 to make). Only what you pass changes. competitors / topics REPLACE their lists (max 8 brands, 5 topics); both empty stops it and clears findings. auto:true picks 3-5 competitors, 2-3 similar brands and 2-3 topics from the saved brand or `seed` (one model call, billed at its token cost). dryRun:true quotes one check, saves nothing. Saving is free; each check holds its quote first and is skipped when the balance is short. runNow is refused while a check runs or just after one finished. Read it with list_watch_findings.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: Set the market radar
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_product_imageLock an image as the ad's real PRODUCT photo and SAVE it as this brand's default product, so every later plan_ad / render_ad / generate_image grounds on the true packaging without …Reads text others writeNo findings
Why it is in this group
- The name "set_product_image" 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 Lock an image as the ad's real PRODUCT photo and SAVE it as this brand's default product, so every later plan_ad / render_ad / generate_image grounds on the true packaging without being told again. Pass `imageUrl` = a product shot's URL — an image from a prior research result (an organic Instagram/TikTok post, a scraped page image), a workspace / list_product_photos url, or any public product photo. The server downloads it and runs a product+safety check: a lifestyle/scene shot with no clear product, or an off-category / unsafe image, is REJECTED and NOTHING is locked or saved (the summary says why). On PASS it persists the photo to a DURABLE url, writes it to the brand's product library as the DEFAULT, and READS THE BRAND BACK to confirm — `savedToBrand` and the summary report what the brand ACTUALLY holds now, never what was asked for, so if it did not become the default you are told instead of finding out from a paid render. Bills one vision check. Reads YOUR saved brand for the category match (pass brandId to target a specific profile — switches this key's active profile like use_brand).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: Set product photo
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
submit_to_galleryPublish ONE image or video this brand made in Hermoso to the public Hermoso gallery, only when the user asks for that item.Reads text others writeNo findings
Why it is in this group
- The name "submit_to_gallery" says "submit": 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.
Description, as the server wrote it Publish ONE image or video this brand made in Hermoso to the public Hermoso gallery, only when the user asks for that item. Nothing to fill in: the title, format and niche come from how it was made, and the brand name is shown. Nothing is public until the Hermoso team approves it; withdraw_from_gallery unpublishes it any time. Uploaded files are refused. preview:true returns what would be public and saves nothing. Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: Publish to the Hermoso gallery
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
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_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_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_productEdit a catalog product's title, description, selling points, audience or page link.No findings
Why it is in this group
- The name "update_product" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Edit a catalog product's title, description, selling points, audience or page link. What you set here is kept through later page re-reads. Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: false
- title: Edit a product
update_saved_creatorSet the OUTREACH STATUS and/or a NOTE on a creator already saved in the swipefile (find_creators -> save_to_swipefile, or the heart on a creator card).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 (find_creators -> save_to_swipefile, or the heart on a creator card). 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_video_presetRename a saved video preset, change its notes, the creator who stars in it, or its captions (true / false / {style}).No findings
Why it is in this group
- The name "update_video_preset" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Rename a saved video preset, change its notes, the creator who stars in it, or its captions (true / false / {style}). What was read off the video stays. Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: false
- title: Update a video preset
withdraw_from_galleryUnpublish: take an item off the public Hermoso gallery at once (its page stops working), whether pending or approved.Reads text others writeNo findings
Why it is in this group
- The name "withdraw_from_gallery" says "withdraw": 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 Unpublish: take an item off the public Hermoso gallery at once (its page stops working), whether pending or approved. Pass the submission id from list_gallery_submissions, or the file link. Free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: true
- openWorldHint: true
- title: Withdraw from the gallery
Can't be undone 1Claude Code: ask
tiktok_ideasWhat to post on TikTok, from posts that are working THIS MONTH in the brand's niche: up to 6 content ideas (hook, format, caption, why, an act-within window of 7d or 30d, a quality…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.
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 What to post on TikTok, from posts that are working THIS MONTH in the brand's niche: up to 6 content ideas (hook, format, caption, why, an act-within window of 7d or 30d, a quality tier), EACH backed by linked TikTok posts with their views, likes and engagement. One bounded pull of the last 30 days: up to 4 keyword searches + up to 5 hashtag pulls, then up to 8 reads of what the strongest posts SAY in their first seconds; only posts past 50,000 views back an idea, and an idea the catalog cannot back is dropped. Works with nothing connected. PAID and priced first: dryRun:true returns the exact credits (lookups + writing) with nothing run; the run charges exactly that (the writing part is not charged if no post clears the bar). THE PICK: call again with pick (one idea object from `ideas`) and to ('render_ad' or 'make_series'), free: it returns the next call's arguments (plan_ad then render_ad, or make_series) with the CLAIMS the ad may make, taken only from the brand's own facts. Nothing renders until you make that call. Omit keywords/hashtags to derive them from product/category or the saved brand.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: TikTok post ideas from what is working now
Changes things 131Claude Code: ask
add_presenterPut a PRESENTER on ANY video, only when the user asks for one: their pick of person (`creator`: a saved or preset creator from list_creators; or `image`: a photo they gave; never i…Reads text others writeNo findings
Why it is in this group
- The name "add_presenter" says "add": a word for a change.
- The input takes a statement or command to run (input.script), 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 Put a PRESENTER on ANY video, only when the user asks for one: their pick of person (`creator`: a saved or preset creator from list_creators; or `image`: a photo they gave; never invent one), filmed on a green screen saying the words, cut out and laid over the video in a bottom corner (default), a round badge, or split screen, lip-synced, block by block across the whole video (about 10 s and about 25 spoken words a block). The words are `script` (verbatim; refused free if it cannot fit) or, without one, written to fit from what the video says and shows (`brief` steers them). The video's own sound stays under the presenter unless baseAudio 'off'; the video without the presenter is kept. A face the video model refuses STOPS it with nothing charged: offer another creator, another photo, or the video as it is. dryRun:true = the exact price, which is what it charges. For a finished make_explainer film, make_explainer with fromFilm.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Add a presenter to any video
add_subtitlesBurn subtitles into ANY video and get the .srt too; nothing is cut or re-rendered.Reads text others writeNo findings
Why it is in this group
- The name "add_subtitles" says "add": a word for a change.
- The input takes a statement or command to run (input.script), 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 Burn subtitles into ANY video and get the .srt too; nothing is cut or re-rendered. Set textStyle only when the user describes a look (default: white sentence case, thin outline, bottom). Timed by the spoken words (up to 5 words a line); auto:'sentences' times per sentence. Only when asked, textStyle 'highlight' (or a highlightColor) lights the word being said, timed word by word. Or pass cues to burn your own lines exactly, untranscribed (reel-style phrases, *stage directions*). burn:false returns only the .srt. Takes a video file or URL, a Vimeo-style page, or a TikTok / Reel / X post link (not YouTube: YouTube does not let us download videos, so upload the file). No speech is refused and refunded. Runs in the background and lands in the Library.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Add subtitles to a video
analyze_videoA video ad's structure: verbatim transcript (voiceover + on-screen text), beat list, duration and sampled frame times; study a reference before remixing it.Reads text others writeCan send data out1 finding
Why it is in this group
- The name "analyze_video" says "analyze": 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 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.
Findings
- Warn
The server marks "analyze_video" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "analyze_video" says "analyze": a word for reading.
Description, as the server wrote it A video ad's structure: verbatim transcript (voiceover + on-screen text), beat list, duration and sampled frame times; study a reference before remixing it. ~A transcription call.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Analyze video
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
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
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".
What this check looks forMatched text
description: "...U ARE AN AGENT HOLDING YOUR OWN PAYMENT CREDENTIAL, there is a third path that needs no hu..."
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
change_voiceSwap the narration of a finished video into a different voice — keeps the performance, lip-sync, and background sound.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 Swap the narration of a finished video into a different voice — keeps the performance, lip-sync, and background sound. Use when the user likes the video but wants a different narrator voice; use dub_video only for language translation. Paid; returns the served URL.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Change narrator voice
check_ad_policyPre-flight ad copy against Meta's REAL, live Advertising Standards before you run it — a flat 1-credit check.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 Pre-flight ad copy against Meta's REAL, live Advertising Standards before you run it — a flat 1-credit check. Pulls Meta's actual policy pages and returns a verdict (pass / fix / block) where every flagged issue QUOTES Meta's own policy text verbatim plus a compliant rewrite that keeps the sell. It's a check, not an edit — it never changes the creative. Especially worth running for regulated-adjacent categories (health/supplements, weight-loss or beauty results claims, finance/crypto/insurance, alcohol, dating, gambling) or ANY strong/absolute/guaranteed claim.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Check ad policy
check_videoCheck a finished video for named, mechanical issues, ONLY when the user asks (never after every render, and it never re-renders): loudness vs a target (default -14 LUFS) and true p…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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it Check a finished video for named, mechanical issues, ONLY when the user asks (never after every render, and it never re-renders): loudness vs a target (default -14 LUFS) and true peak, black and frozen stretches, captions or text outside the platform-safe band, text running off the frame. Optional assertions about named elements: appearsBy {element, bySec}, before {a, b}, staysInFrame {element}, keepsMoving {maxStaticSec}. Each issue comes with a Fix line. The loudness, black and frozen checks are free; the on-screen text and element read is a small paid frame read (frames:false skips it).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Check a video
click_to_adPaste a product page link (Shopify, Amazon or any store page) and get a creator-style video ad planned for that product.Reads text others writeCan send data outNo findings
Why it is in this group
- The name "click_to_ad" says "click": 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 Paste a product page link (Shopify, Amazon or any store page) and get a creator-style video ad planned for that product. Hermoso reads the page (name, photos, what it says about the product, price), saves the product to the brand's catalog, checks the page's real product photo and pins it to this ad (the brand's saved default photo is not changed), then plans the ad. A store that hides its page from servers is read in a real browser; failing that the name comes from the link and the photo from a search, and the reply says so. Nothing renders here: show the user the concept, then call render_ad with the returned creative (dryRun:true first for the exact price). Works with or without a saved brand.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Plan a video ad from a product link
clip_videoCut ONE long video into several RANKED, ready-to-post short clips (podcast, webinar, interview, talk, long ad cut -> Reels/Shorts/TikTok).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 Cut ONE long video into several RANKED, ready-to-post short clips (podcast, webinar, interview, talk, long ad cut -> Reels/Shorts/TikTok). Transcribes with timestamps, picks the strongest SELF-CONTAINED moments, then cuts + reframes each with ffmpeg — no video model renders anything, so it is fast and cheap. NOT supported: TikTok / Instagram / Facebook links, and anything age-restricted, private, members-only, geo-blocked or still LIVE — those fail fast with the real reason and are fully refunded, so ask for a direct file or an upload rather than retrying. SUBTITLES ARE BURNED IN BY DEFAULT (white sentence case timed by the spoken words, thin black outline, bottom safe band, no box) because short-form is watched on mute; captions:false for clean footage. TIMING IS APPROXIMATE (per-sentence, not word-level); never promise frame-accurate sync. Full rules: get_instructions({topic:'clip_video'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Clip a long video
clone_staticUse this when the user wants their own version of a static (image) ad they like, a competitor's or any reference.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 their own version of a static (image) ad they like, a competitor's or any reference. It rebuilds it on-brand: SAME layout, composition and energy, but the user's product, brand colours, logo and voice, with every trace of the source brand removed. Pass `imageUrl` = the static ad image to clone. Uses the saved brand (brandId picks another profile, like use_brand). IMAGES ONLY — for a video ad use clone_video with its link, then render_ad. Bills as one image generation.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Clone a static ad
clone_videoRemake a video you like FOR THIS BRAND from its link — a TikTok, Instagram Reel, Facebook video or reel, X post, or a direct video file URL.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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it Remake a video you like FOR THIS BRAND from its link — a TikTok, Instagram Reel, Facebook video or reel, X post, or a direct video file URL. YouTube does not let us download videos, so a YouTube link is refused up front and nothing is charged; the user downloads it themselves and uploads the file (upload_file). Hermoso WATCHES it first (frames across the whole clip plus a transcript of the voiceover, on-screen text and cut map), then plans a storyboard that keeps its hook device, structure, jump cuts and pacing while swapping in THIS brand's product, cast, setting and words — never the original's words, face or brand. The new ad MATCHES THE ORIGINAL'S LENGTH (capped at 120s) unless durationSeconds is given. Renders nothing: pass the returned creative to render_ad to make the video. Costs the plan plus about 2 credits to read the link. The reply says exactly what was watched, and when a platform will not hand over the footage (YouTube sometimes refuses servers) it says the plan rests on the captions and thumbnail only. For a local file, upload_file it first and pass the URL. For a ready short-form FORMAT instead of a link (a Reel / TikTok structure with its own captions and a Comment-keyword close), use make_short. Reuse a style: save_video_preset.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Clone a video for your brand
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
competitor_teardownUse this when the user asks how a competitor advertises, what its ad strategy is, or where the openings against it are.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 asks how a competitor advertises, what its ad strategy is, or where the openings against it are. It turns the competitor's ads into a playbook: their opening-hook MIX, longest-running campaign THEMES, the WHITE SPACE nobody in their set runs, 2-3 render-ready COUNTER-PLAYS, and the territories they own that you should avoid. Pass `competitor` {name, domain?}. Pass `ads` (raw ad objects from a prior pull_competitor_ads / search_meta_ads call) to tear down exactly those, or omit it and this pulls the competitor's longest-running Meta ads first. Tailored to the saved brand. Spends credits (free when you pass ads).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Competitor teardown
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_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_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_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
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "diagnose_posts" says "post": a word for a change.
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 (change the opening: mine_angles, then list_hooks, then plan_variations). Seen but not held is A RETENTION PROBLEM (plan_variations to rebuild the middle against the same hook). 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
dub_videoLocalize a finished video into another language WITHOUT re-rendering it: each spoken line is said where it was said, in a native voice, lip-synced, background kept.Reads text others writeNo findings
Why it is in this group
- The input takes a statement or command to run (input.script), 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 Localize a finished video into another language WITHOUT re-rendering it: each spoken line is said where it was said, in a native voice, lip-synced, background kept. Pass the video and the language; the script is read off the source (`script` only overrides it). Paid by length; dryRun quotes. Returns the localized video URL.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Dub video
edit_imageEDIT an existing image in place with a plain-language instruction and keep everything else: 'make the headline bigger', 'add our logo bottom right', 'swap the background for a kitc…Reads text others writeNo findings
Why it is in this group
- The name "edit_image" says "edit": 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 an existing image in place with a plain-language instruction and keep everything else: 'make the headline bigger', 'add our logo bottom right', 'swap the background for a kitchen', 'remove the person on the left', 'erase all the text'. Pass `image` (URL, Library item, upload_file URL or local path) and `instruction`. The same edit the web Studio's Edit runs: composition, aspect ratio, people and every untouched line of text stay as they are; the saved brand's real name and website are pinned so an added line never invents one, and the brand's real logo FILE is put on when the instruction asks for the logo (never redrawn by the model): an ask only about the logo ('the logo is wrong', 'make the logo bigger'; or logo:true, any language) runs no image model. Set removal:true when the edit STRIPS text, branding or an object, so nothing branded is put back. When the saved brand has a product photo and the ad shows that product, the photo rides with the edit and the product's label is read and checked against it: re-printed from the photo only when it came out wrong (the check alone is charged when it is right; one small extra charge finds the product first). fixLabel:false turns that off. For a precise region, pass `mask` (see generate_image). One image edit's credits; returns the new image URL. For a new image from a prompt use generate_image; to rebuild a competitor's ad for your brand use clone_static.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Edit an image
edit_timelineCompose ANY edit or transition yourself; there is no preset list.Reads text others writeNo findings
Why it is in this group
- The name "edit_timeline" says "edit": 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 Compose ANY edit or transition yourself; there is no preset list. Segments on an output timeline (later ones drawn on top; overlapping ones ARE the transition), each animated by keyframes (scale, x, y, rotate, opacity, blur, mblur, exposure, speed ramps, holds, reverse), plus your own HTML overlays and masks, compiled server-side into one render. Whip pan, zoom through, push, spin, slow motion, freeze frame, J-cut / L-cut, wipes, split screen, picture in picture: all composed from the fields. Local render at the flat post_edit price (~2 credits, overlays included); a `generate` segment (a paid generated transition shot) only when the user explicitly asks. SOURCES: src is 'this' (videoUrl), a Library / render URL, a direct file or a PUBLIC TikTok / Reel / Facebook / X post link (a YouTube link is refused up front, free: YouTube does not let us download videos, so upload the file). in/out are SOURCE seconds; out:'payoff' cuts just before a hook's payoff. Every seam is matched automatically (grade, level, grain). Present the render as it came back: never review, critique or re-run it on your own. review:true (only when the user asks for a check of the transitions) adds a vision REVIEW of each seam (about 2 credits) plus the seam frames; share it and let the user decide on a re-run. video_frames shows exact frames free: look before you cut. Follow-ups ('cut earlier', 'whip pan instead') re-run with the same sources and the one change. Refusals are free and name the field. READ THE MANUAL FIRST: call get_skill('hermoso-edit-timeline') before composing. It holds the transition recipes with their exact keyframes (whip pan, zoom through, push, spin, speed ramp, freeze, wipes, split screen), how to link two unrelated clips with a match cut, the viral-hook-plus-product method, audio payoff and L/J-cut rules, and the pro-not-iMovie checklist.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Compose an edit (timeline)
edit_videoSWAP AN OBJECT IN A VIDEO ('replace the cup with our can' + the product photo as elements) or EDIT an existing clip from a plain instruction (video-to-video): the motion, timing, f…Reads text others writeNo findings
Why it is in this group
- The name "edit_video" says "edit": 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 SWAP AN OBJECT IN A VIDEO ('replace the cup with our can' + the product photo as elements) or EDIT an existing clip from a plain instruction (video-to-video): the motion, timing, framing and cut stay, the named thing changes. 'change only the mug to red', 'make it nighttime', 'restyle it as claymation'. Your words are wrapped so the model keeps everything else identical, changes only what you named and repeats that lock; lighting is kept unless the change needs new light (set lighting to force either); literal:true sends your words as written. One change per call holds best. previewFirstFrame:true edits ONE still first (one image edit; previewAt picks the second) and quotes the clip; nothing else runs until you call again, ideally with previewStill. The reply scores how well the shot held outside the change (free) and flags an edit that touched more than asked. NOT for cuts/trims/end cards (post_edit), a new video (generate_video / render_ad), translating what is SPOKEN (dub_video) or a saved creator's face (recast_motion). Translating or rewriting the on-screen words of a video laid out from a design (a template ad, a custom design) is textChanges with every line at once: one re-make of the design, about 2 credits. Best on 3-15s clips.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Edit a video clip
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.
What this check looks forMatched text
description: "...few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone —..."
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
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
face_checkBefore any paid render: does a picture or video contain a face, and which video models refuse it (they cannot take a real person's face; a render there fails after it starts) or we…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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it Before any paid render: does a picture or video contain a face, and which video models refuse it (they cannot take a real person's face; a render there fails after it starts) or were measured to take one, plus the model a face-bearing render is routed to. A local detector, no model call, 0 credits. It cannot tell a photo from a drawing, so a drawn face counts. Takes a picture or video URL, a Library item or a public post link. A file or Library item is free; a TikTok / Reel / Facebook / X post link is opened through one paid lookup (1 credit), refused when the account has no credits.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Check a picture or video for a face
fetch_app_screensPull an APP brand's REAL store screenshots (Google Play or App Store) into the workspace brand, so a screen-hungry native format can use them.Reads text others write1 finding
Why it is in this group
- The name "fetch_app_screens" says "fetch": 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.
Findings
- Warn
The server marks "fetch_app_screens" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "fetch_app_screens" says "fetch": a word for reading.
Description, as the server wrote it Pull an APP brand's REAL store screenshots (Google Play or App Store) into the workspace brand, so a screen-hungry native format can use them. Use when the brand has 0–1 app screens on file and you want make_template_ad(template:'app-ui-tour'), or the user asks to 'pull my app's screenshots'. A store link or package id goes in storeUrl and is read exactly; else pass appName (defaults to the saved brand's name). A web app with no store listing gets the screenshots of the product its OWN website shows (pictures the site labels as its interface). Call it before telling the user you have no screenshots of their app. FREE — a keyless store lookup or one read of the brand's homepage. It needs a CONFIDENT match: an ambiguous or unknown app returns 0 screens and saves nothing, which you should relay plainly rather than retrying with guesses. On success the screens are saved to the brand (durable URLs) and are immediately usable.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
- title: Fetch App Store screens
fetch_social_dataGeneric escape hatch for any ALLOWLISTED long-tail social/web endpoint the dedicated search_* tools don't cover — e.g.Reads text others write1 finding
Why it is in this group
- The name "fetch_social_data" says "fetch": 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 "web": it reads web pages, which anyone can write.
Findings
- Warn
The server marks "fetch_social_data" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "fetch_social_data" says "fetch": a word for reading.
Description, as the server wrote it Generic escape hatch for any ALLOWLISTED long-tail social/web endpoint the dedicated search_* tools don't cover — e.g. {path:'/v1/instagram/profile', params:{handle:'nike'}}. Allowlisted platform families: TikTok (+ TikTok Shop), Instagram, YouTube, Facebook (organic profiles/posts/events/marketplace), LinkedIn (organic posts/companies), Twitter/X, Reddit, Threads, Snapchat, Pinterest, Twitch, Bluesky, Truth Social, Rumble, Spotify, SoundCloud, GitHub, Google search, link-in-bio pages (Linktree etc.). Param names vary per endpoint (profiles use `handle`, keyword searches use `query`, Reddit uses `subreddit`). WARNING: returns RAW provider JSON — large and messy; prefer the dedicated search_* tools. Spends credits.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Fetch social data
find_competitorsUse this when the user asks who a brand's competitors are, or for similar brands to learn from, and gives its website.Reads text others write1 finding
Why it is in this group
- The name "find_competitors" says "find": 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 "website": it reads web pages, which anyone can write.
Findings
- Warn
The server marks "find_competitors" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_competitors" says "find": a word for reading.
Description, as the server wrote it Use this when the user asks who a brand's competitors are, or for similar brands to learn from, and gives its website. It finds competitor / similar / adjacent brands from the domain (an AI model grounded by web search). mode=competitors (default, excludes the searched company), inspiration (relevant ads, including the searched company), or company. Bills one model call, no ad-data charge; free during a new account's first brand setup.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Find competitors
find_creatorsScan organic TikTok, Instagram Reels and YouTube for a niche across a few query variants, fold the posts into creators, and rank them on median views, engagement rate and how often…Reads private dataReads text others write1 finding
Why it is in this group
- The name "find_creators" says "find": a word for reading.
- The server marks it as not read-only (readOnlyHint: false).
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 "post": it reads posts, which other people can write.
Findings
- Warn
The server marks "find_creators" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_creators" says "find": a word for reading.
Description, as the server wrote it Scan organic TikTok, Instagram Reels and YouTube for a niche across a few query variants, fold the posts into creators, and rank them on median views, engagement rate and how often they show up for that niche; the top rows get follower counts AND public contact info (an Instagram business email / phone / category, the bio link, an email in a TikTok bio) so outreach can start from the result. Real people, not AI actors — for influencer sourcing, UGC casting and partnership prospecting ("who should we send product to?"). About one credit per search call (platforms × queries, default 3 × 3) plus one per enriched profile; repeats inside 20 minutes are free. Then shortlist (save_to_swipefile), check a profile, draft outreach (generate_text), or approve them for Partnership Ads. Marketplace:true also searches Instagram’s creator marketplace (Meta’s own creator directory: followers, badges, marketplace email) for the same niche and returns those rows beside the ranked list.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Find the creators already winning in a niche
find_leadsLEAD GENERATION FROM BUYING SIGNALS: prospects showing a reason to buy now.Reads text others write1 finding
Why it is in this group
- The name "find_leads" says "find": 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.
Findings
- Warn
The server marks "find_leads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_leads" says "find": a word for reading.
Description, as the server wrote it LEAD GENERATION FROM BUYING SIGNALS: prospects showing a reason to buy now. One on-demand search runs a handful of public lookups and returns COMPANIES, one row per company, each with its OWN WEBSITE (from its job board, the ad, the article, its channel, or its name confirmed by its homepage; a company with none is left out) and the post, ad or page that is the signal (link, date, why it matched). SIGNAL TYPES: new_ads_meta, new_ads_linkedin (companies running new ads), hiring (companies hiring for a role), funding, web (any web search), posts_reddit, posts_threads, posts_tiktok, posts_youtube (people asking, or complaining about a competitor). When the buyer is a business, individual posters come back apart under people. GIVE IT description (who the user sells to), or keywords and competitors, or signals [{ type, query }]; an unknown type is refused with the list. Filters country, size, industry and uses (ad pixels on the site) drop rows the company's own site contradicts; sorted by fit, then recency; a company already in the brand's email leads or do-not-email list is marked. PAID: about 1 credit per lookup (up to 8; planning from a description adds a small writing cost), never more than maxCredits (default 10): it stops at the budget and names what it did not run. Reading the websites is free. DryRun:true prices it. A failed lookup is "could not read", never "no leads". Find_leads({ searchId, id }) returns one row in full, free, for 30 minutes (nothing is stored). SaveAs keeps the search for saved_lead_searches; search_companies finds companies by industry rather than by signal. Works with nothing connected.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Find leads from buying signals
find_proven_formatsPROVEN FORMATS: viral short-form videos that work for a kind of app, product or brand, ranked and grouped into FORMATS you can copy.Reads text others write1 finding
Why it is in this group
- The name "find_proven_formats" says "find": 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.
Findings
- Warn
The server marks "find_proven_formats" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_proven_formats" says "find": a word for reading.
Description, as the server wrote it PROVEN FORMATS: viral short-form videos that work for a kind of app, product or brand, ranked and grouped into FORMATS you can copy. One search runs a few public lookups: TikTok keyword and hashtag searches over the window, the recent posts of any competitor accounts you name (TikTok or Instagram), and optionally the Instagram Reels keyword search. It keeps videos over minViews (default 100,000) posted inside the window (default 90 days) and inside the length range, at most maxPerCreator (default 2) per creator, and groups them into formats: skit / POV, app or product as a character, talking to camera, green screen / reaction, tutorial, quick lesson, review, before and after, list, day in the life, unboxing, comparison, trend. Each format comes with its count, creators, median and top views, median length, length bands, creator types and 2-3 example links; the whole result reports the median beside the top and how concentrated the views are, so one outlier is not read as a format. EVERY EXAMPLE CARRIES next = { tool: "clone_video", args: { url } }: to remake one for the brand, call clone_video with it (price it with get_cost first). Grouping is rule-based from the captions; when they leave many videos unclear, one small labelling call sorts them (about 1 credit, only when it fits maxCredits). PAID: about 1 credit per lookup (5 for a category alone), maxCredits (default 12, max 40) is a HARD stop that returns what it found and names what it did not run; dryRun:true prices the plan with nothing run; repeats inside 20 minutes are free. Works with nothing connected. Instagram keyword reels often carry no view count, and a reel without one is left out and counted (never read as a low number): name Instagram accounts in competitors for Reels with their views. YouTube is not searched (clone_video cannot download a YouTube video; search_youtube finds them). With searchId and format: every video of one format from an earlier search, free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Proven viral video formats for a category
find_soundA sound for an edit by name ('the FAAAA sound'), by the moment ('bad news reaction') or by link (TikTok sound, meme-sound page, post, audio file): a durable mp3 and where it starts…Reads private dataReads text others writeCan send data out1 finding
Why it is in this group
- The name "find_sound" says "find": a word for reading.
- The server marks it as not read-only (readOnlyHint: false).
What it can reach
- 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 "post": it reads posts, 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.
Findings
- Warn
The server marks "find_sound" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_sound" says "find": a word for reading.
Description, as the server wrote it A sound for an edit by name ('the FAAAA sound'), by the moment ('bad news reaction') or by link (TikTok sound, meme-sound page, post, audio file): a durable mp3 and where it starts and lands. Named/described sounds come from what TikTok uses now; pick takes another candidate. A sound that does not exist yet is generate_sfx.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Find a sound
finish_draftFINISH a 480p Seedance 2.5 DRAFT in 1080p: the model regenerates THAT take (same scene, shots, motion, sound) at full resolution.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 FINISH a 480p Seedance 2.5 DRAFT in 1080p: the model regenerates THAT take (same scene, shots, motion, sound) at full resolution. Every 480p Seedance 2.5 render (generate_video / render_ad at resolution 480p) is a draft, finishable for 7 days; its result carries `draft` {id, expiresAt, finishCredits}. Pass that id, or the draft video URL. It is the full-resolution route for a draft (upscale_video is for a video that is not a draft); priced like a 1080p render of its length. Paid: call with dryRun first, state the credits, run only when the user agrees. Captions, end card or music added after the draft are not re-applied. Not a draft or expired: a plain refusal; use upscale_video or a fresh 1080p render.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Finish a draft in 1080p
finish_shortLay a make_short format's layers on its rendered video: its picture layers, the pauses between lines cut out (free), the format's captions (the spoken words, transcribed and burned…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 Lay a make_short format's layers on its rendered video: its picture layers, the pauses between lines cut out (free), the format's captions (the spoken words, transcribed and burned in its look) and its "Comment KEYWORD" card, timed to the moment the presenter says "comment". Nothing else is laid: only what the format (or the keyword you chose) names. Pass the rendered video's url and the creative make_short returned. Runs as ordinary jobs (subtitles about 2-6 credits by length, the card about 2), each landing in the Library. When a step is still rendering the reply says so with its job id: get_job it, then call again with its result as `video` and the given `fromStep`.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Finish a short (lay its format)
finish_videoPost-process an EXISTING rendered video (its served mp4 URL) with the proven direct-response 'reviewer' finish and/or a film-grain pass — no AI model, ~30s, billed for its compute …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 Post-process an EXISTING rendered video (its served mp4 URL) with the proven direct-response 'reviewer' finish and/or a film-grain pass — no AI model, ~30s, billed for its compute only. pills=true composites a header pill (e.g. '10/10 would buy again'), a brand-accent sub-pill, and 3-4 green-check proof pills cascading in on the beat (YOU author the copy: header ≤40 chars, sub ≤34, each point ≤44 — concrete real benefits, never fabricated stats). grain=true applies a subtle camera-grain finish that makes photoreal AI renders look phone-shot ('less AI') — works alone or with pills. Returns a NEW video; the original is untouched.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Finish video
fix_beatSurgically re-render ONE time window (1.5-8s) of an existing rendered video and splice it back on the VIDEO TRACK ONLY — the rest of the video and ALL audio stay byte-identical.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 Surgically re-render ONE time window (1.5-8s) of an existing rendered video and splice it back on the VIDEO TRACK ONLY — the rest of the video and ALL audio stay byte-identical. Use when one beat/shot is broken ('the shot at 8 seconds glitches') and a full re-render would waste the parts that worked; bills only the replacement clip's seconds (~1/3 of a full render). Do NOT pick a window covering spoken dialogue (a video-only splice under speech breaks lip-sync) — pass speechWindows to enforce this. A FINISHED VIDEO-BLOCKS FILM (make_explainer's explainer or faceless channel; get_job says it is editable) is edited ONE BLOCK at a time instead: pass `job` (its job id) and `block` (1-based) or `atSeconds`, with `prompt` for a different shot and/or `line` for new narration words. Only that block is re-rendered and/or re-read; every other block, take, the music and the captions are the film's own and stay aligned. It is priced as that block alone and charged exactly what it quotes (dryRun). The original film is kept; a new film comes back, and it can be edited again. Feedback maps to one named move, never a re-render: quieter/louder (music db, audio_gain), faster/slower (speed; slower = zooms and pans at 0.7x), tighten (trim), retime (to a word anchor), recut (order, in-out points), regrade (timeline exposure/contrast/saturation keys).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Fix a video beat
generate_avatarANIMATE A PHOTO so it talks: the presenter in `image` says `script` word for word, a separate voice lip-synced onto the still.Reads text others writeNo findings
Why it is in this group
- The name "generate_avatar" says "generate": a word for a change.
- The input takes a statement or command to run (input.script), 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 ANIMATE A PHOTO so it talks: the presenter in `image` says `script` word for word, a separate voice lip-synced onto the still. Use it ONLY when the user asks for an animated photo / talking photo / lip-sync look by name; for any other talk-to-camera or spokesperson ask use generate_video with `speak` (the person filmed saying it, which reads as real footage). About 1-3 min, holds the pose steady, 480p/720p. The per-second credit price is in hermoso_capabilities (avatarEngines); dryRun:true returns this exact job's hold without rendering. Blocks until done where the host allows, else returns a job id to poll with get_job. Requires canAvatar. Spends credits; a refusal before rendering costs nothing.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate talking avatar
generate_imageUse this when the user asks for an image ad, ad creative, product photo or social post graphic for their business or product, or an ANIMATED GIF (format gif) or SVG file (format sv…Reads text others writeNo findings
Why it is in this group
- The name "generate_image" says "generate": 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 Use this when the user asks for an image ad, ad creative, product photo or social post graphic for their business or product, or an ANIMATED GIF (format gif) or SVG file (format svg). It renders a finished image on a real image model, on their saved brand (product photos, logo), and returns a URL ready to post. For a video, use render_ad. The saved brand’s product photo is used automatically (see get_brand / list_product_photos), so never ask the user to upload it again. MULTI-BRAND: hydration uses the SAVED brand; for a different brand (a fresh draft_brand) pass its own productImages/logo as refImages with useBrand:false, or the wrong product lands in the shot. model = a catalog id from hermoso_capabilities (omit for the default). Seconds. Spends credits. Full rules: get_instructions({topic:'generate_image'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate ad image
generate_musicRAW music: describe it (genre, mood, instruments, tempo), get an instrumental MP3.Reads text others writeNo findings
Why it is in this group
- The name "generate_music" says "generate": 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 RAW music: describe it (genre, mood, instruments, tempo), get an instrumental MP3. No length: a full track at a flat fee (explainerMusicCredits in hermoso_capabilities). With seconds: by the second up to about 38 s. A named model always runs.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate music
generate_sfxMAKE a sound effect or ambience that does not exist yet, from a description, as an MP3: a whoosh, a door slam, a cash-register ding, rain on a window, a busy cafe.Reads text others writeNo findings
Why it is in this group
- The name "generate_sfx" says "generate": 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 a sound effect or ambience that does not exist yet, from a description, as an MP3: a whoosh, a door slam, a cash-register ding, rain on a window, a busy cafe. (find_sound FINDS an existing sound, a meme or trending TikTok sound; this MAKES one.) seconds = length, 0.5-30 (default 5); loop:true for a loopable bed. engine: omit for Seed Audio 1.0 (length and loop are asked for in words, so the length is approximate), or 'eleven-sfx' (ElevenLabs Sound Effects v3: exact length, a real loop flag, description ≤450 characters). Lay it under a video with post_edit (music.track takes its link). dryRun:true returns the exact credits and makes nothing; the price quoted is the charge. Paid, priced by length (hermoso_capabilities -> sound effects).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate a sound effect
generate_textText generation against the writing-model catalog (Claude, Gemini, GPT, Llama, DeepSeek…) — ad copy, hooks, scripts, rewrites, brainstorms.Reads text others writeNo findings
Why it is in this group
- The name "generate_text" says "generate": 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 Text generation against the writing-model catalog (Claude, Gemini, GPT, Llama, DeepSeek…) — ad copy, hooks, scripts, rewrites, brainstorms. Prompt-only, no ad assembly (for a finished on-brand creative use plan_ad -> render_ad). BY DEFAULT the model answers as a marketing copywriter (a short house system prompt is applied, which is what you want for ad copy); pass raw:true for a plain, unstyled answer from the model itself with NO system prompt at all. model: omit for the default Claude orchestrator. Claude Fable 5.2 runs on paid plans only; on the Free plan it is refused at no charge. Paid (billed at the writing model's token cost, by length).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate text
generate_videoUse this when the user asks for a video clip, b-roll or a shot from a description, or names a video model.Reads text others writeNo findings
Why it is in this group
- The name "generate_video" says "generate": 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 Use this when the user asks for a video clip, b-roll or a shot from a description, or names a video model. For a finished video ad, Reel, TikTok ad or UGC video for their business, use render_ad. A GIF is generate_image format gif. It renders one continuous clip on a real video model and returns its mp4 URL. A clip runs up to the model’s longest listed duration (the longest takes a multi-beat 30s spot in ONE take with native audio), so never assume an 8–10s cap or stitch what fits one clip; durationSeconds must be one of the model’s durations in hermoso_capabilities. NAME A MODEL in `model` to get it: an unnamed render uses a narrower auto-pool. 1–3 min. refImage anchors the first frame; ttsScript adds a voiceover. AUDIO IS NOT FREE BY DEFAULT: a clip with no audio of its own gets a music bed composed and CHARGED on top (see musicMood and audio), which can cost as much as a cheap draft clip. refVideo (a clip URL) EDITS that clip instead, keeping its canvas and length. RAW MODEL ACCESS: by default small guards are added (label safety with no reference image, a negative prompt where the model takes one, reference lines) and hex colours become names; raw:true dispatches your prompt to the model BYTE-IDENTICAL — no rewriting, no appended guidance, no negative prompt, no brand references attached on your behalf. Credits, the durable delivery of the finished asset and the per-model validation are unchanged. Spends credits (blocked on the Starter plan).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate video
generate_voiceRAW speech as an MP3: one voice reading a script (text), or a DIALOGUE of two or more people (lines), each in their own voice.Reads text others writeNo findings
Why it is in this group
- The name "generate_voice" says "generate": 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 RAW speech as an MP3: one voice reading a script (text), or a DIALOGUE of two or more people (lines), each in their own voice. Not for adding audio to a video (render_ad and generate_video voice their own spots; change_voice re-voices a finished clip). ONE VOICE: text + engine (default 'seed-audio'; also 'eleven-v4', 'minimax-speech', 'kokoro'…) + voice, a preset from that engine (hermoso_capabilities -> voice engines); a name the engine does not have is REFUSED for free with its real list, and a few engines make their own voice (the reply says which voice spoke). DIALOGUE: lines [{speaker, voice, text}] in speaking order. Each speaker keeps ONE voice, no two speakers share one, a speaker with no voice gets one nobody has; up to 10 voices and 10,000 characters, refused for free past that. Default engine: the dialogue model (Eleven v3 Dialogue, voices Aria, George, Sarah, Roger, Laura, Charlie, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill, or an ElevenLabs voice id; '[laughs]'-style cues work); or name any voice engine (e.g. 'eleven-v4') to read each line on it and join them in order. dryRun:true returns the exact credits and makes nothing; the price quoted is the charge. Paid, priced by characters (hermoso_capabilities lists credits per 1,000).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Generate voiceover or dialogue
headline_variantsTurn ONE finished static ad into several copies that differ ONLY in the headline, for an A/B test: same picture, product, layout, colours and every other line.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 ONE finished static ad into several copies that differ ONLY in the headline, for an A/B test: same picture, product, layout, colours and every other line. Pass `image`, and either `headlines` (your own, up to 10) or `count` (default 5, max 10) to have distinct angles written for you in the saved brand's voice (never inventing numbers, prices, ratings or claims the ad or brand does not state); `brief` steers what to test. The ad's text is read first (3 credits), then one image edit per headline; each output is proofread and flagged (textCheck) if the rendered words do not match, never silently re-rendered. When the saved brand has a product photo and the ad shows that product, the photo rides with the edit and the product's label is read and checked against it: re-printed from the photo only when it came out wrong (the check alone is charged when it is right; one small extra charge finds the product first). fixLabel:false turns that off. The whole batch is priced before anything runs. Returns each headline, its angle and its image URL.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Headline variants of a static ad
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. It is NOT a prerequisite for rendering: generate_image, generate_video and render_ad all run with `model` omitted and route to the server’s own default. 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
hook_variantsHOOK MULTIPLIER: give ONE finished video ad N NEW OPENING HOOKS, N complete versions to A/B test.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 HOOK MULTIPLIER: give ONE finished video ad N NEW OPENING HOOKS, N complete versions to A/B test. Pass the video's FILE URL (a render, job result, list_library or upload_file). 1-5 versions, default 3. COST: quoteOnly:true returns the exact credits free: state that first. A paid planning read (planCredits) runs next, then each planned version bills like fix_beat for the hook's seconds. dryRun:true pays for that read; pass its `plan` back to render exactly those. Returns ONE JOB PER VERSION; call get_job on each until done, never describe a version before its URL arrives. Full rules: get_instructions({topic:'hook_variants'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: New opening hooks for a video
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
insert_sceneINSERT a newly generated scene into a clip you already have: the video plays up to startTime, the new scene (5 to 13 seconds) plays, then the original picks up again at resumeTime.Reads text others writeNo findings
Why it is in this group
- The name "insert_scene" says "insert": 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 INSERT a newly generated scene into a clip you already have: the video plays up to startTime, the new scene (5 to 13 seconds) plays, then the original picks up again at resumeTime. Use for a product close-up, a reaction, a reveal or a missing beat in the middle of an ad without re-rendering the rest. resumeTime = startTime keeps every second of the original; a later resumeTime also cuts the footage in between. Describe the scene in prompt and/or attach up to 4 reference pictures (refImages) or 1 reference clip (refVideos). Clips up to 60 seconds; both times between 1.625 and 60 seconds. Paid render (billed per second of NEW scene); returns the whole video's URL.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Insert a new scene into a video
layerize_imageSplit ONE finished static ad (or any picture) into a BASE image plus separately editable transparent PNG LAYERS: each text block, the product, the logo, a person, badges, buttons a…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 Split ONE finished static ad (or any picture) into a BASE image plus separately editable transparent PNG LAYERS: each text block, the product, the logo, a person, badges, buttons and shapes come out on their own layer at their original position (each layer's box in base-image pixels), and the base keeps the background with the gaps filled. The words of every ordinary text layer are READ OUT (the text, each line's box, an approximate font, colour, bold, italic), so a designer or an agent can change the copy, translate it or rebuild the ad in a design tool. `layers` = how many layers at most (default 6, up to 20; the base is extra and every picture returned is billed). `prompt` names what to lift (e.g. 'only the headline and the product'). dryRun:true = the price, nothing made. To change the ad itself rather than take it apart, use edit_image.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Split an image into editable layers
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.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "list_product_photos" says "list": a word for reading.
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. Call it before set_product_image to see the existing photos you can reuse. 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
localize_adTranslate the on-image text of ONE finished static ad into other languages and keep everything else: same picture, layout, typeface, colours, logo and product.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 Translate the on-image text of ONE finished static ad into other languages and keep everything else: same picture, layout, typeface, colours, logo and product. Pass `image` and `languages` (up to 5, e.g. ["Spanish", "German", "French (Canada)"]). The ad's text is read (3 credits), translated the way a native copywriter in each market would write it (brand and product names, URLs and prices kept as written), then one image edit per language; each output is proofread and flagged (textCheck) if the words do not match, never silently re-rendered. When the saved brand has a product photo and the ad shows that product, the photo rides with the edit and the product's label is read and checked against it: re-printed from the photo only when it came out wrong (the check alone is charged when it is right; one small extra charge finds the product first). fixLabel:false turns that off. Priced before it runs. For a VIDEO use dub_video.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Localize a static ad into other languages
make_effectONE-CLICK EFFECTS, the same ones as the /tools pages: a photo goes in, a styled picture comes out, and most can then become a 5-second clip.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 ONE-CLICK EFFECTS, the same ones as the /tools pages: a photo goes in, a styled picture comes out, and most can then become a 5-second clip. Plush toy, 3D figure, mascot, comic book, pixel game, billboard ad, giant product, bullet time, packshot, outfit swap, headshot, relight and many more. Name no `effect` for the free list. `effect` alone: what it takes. `effect` + `images`: a free quote; add confirm:true to make the picture. Then `effect` + `still` (that picture's URL): a free quote for the clip; confirm:true makes it. `describe` adds anything of your own. For a look not on the list use generate_image. A real person's photo follows the same likeness rules as every render.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Run a one-click effect on a photo
make_explainerAI HOST EPISODE: format 'host_episode' = one presenter talking to camera, the camera changing every piece (frontal, three-quarter, close), the same host and set throughout, native …Reads text others writeCan send data outNo findings
Why it is in this group
- The input takes a statement or command to run (input.script), 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.channel): what the tool writes goes there.
Description, as the server wrote it AI HOST EPISODE: format 'host_episode' = one presenter talking to camera, the camera changing every piece (frontal, three-quarter, close), the same host and set throughout, native voice, 16:9. It returns a 480p DRAFT; HD (720p) is a SEPARATE call with `fromDraft` (quote it with dryRun, run it only when the user asks). Otherwise: turn a TOPIC into a finished narrated explainer video, in one of TWO LANES (`lane`). BURNED ON-SCREEN TEXT IS OFF BY DEFAULT; the film ships clean unless the user asks; `captions:true` adds held key points and `subtitles:true` adds subtitles timed to the narration. Takes SEVERAL minutes — one image render per frame; NOT for a short product ad: use render_ad, generate_video or make_template_ad. Full rules: get_instructions({topic:'make_explainer'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make an explainer video
make_from_presetPLAN A NEW VIDEO FROM A SAVED PRESET (save_video_preset): it keeps the preset's beat structure, pacing, look, captions, delivery and sound, and makes the topic, every word, the per…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 PLAN A NEW VIDEO FROM A SAVED PRESET (save_video_preset): it keeps the preset's beat structure, pacing, look, captions, delivery and sound, and makes the topic, every word, the person and the product this brand's own. Same length as the preset unless durationSeconds is given. Renders nothing: costs the plan only (no second watch). Then render_ad(creative) makes the video and lays the preset's captions in their look and casts its creator unless you pass your own.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make a video from a preset
make_insertA reaction picture (image, or video from videoStart) with its sound, cut to when the sound lands (or seconds): a 1080x1920 clip for post_edit join.Reads text others writeNo findings
Why it is in this group
- The name "make_insert" says "insert": 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 reaction picture (image, or video from videoStart) with its sound, cut to when the sound lands (or seconds): a 1080x1920 clip for post_edit join.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make an insert clip
make_listing_setMake a marketplace LISTING SET for ONE product in one call (Amazon, Shopify, Etsy, any store page): the MAIN image on pure white (the product alone filling about 85% of the frame, …Reads text others writeNo findings
Why it is in this group
- The name "make_listing_set" 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 Make a marketplace LISTING SET for ONE product in one call (Amazon, Shopify, Etsy, any store page): the MAIN image on pure white (the product alone filling about 85% of the frame, no text, no props, no added logo), then the secondary images a listing carries — a lifestyle shot, a detail close-up with NO infographic, a scale shot that shows its true size, and the product in use — every one rendered from the product's real photo and held to one visual system (the same light, scale and palette). More shots on request: multi_angle, whats_in_box, back_of_pack, or any shot in your own words. The MAIN renders FIRST and every other image is drawn from it (each waits for it in the queue), so the set matches; pass an approved main as mainImage to redo the rest from it. aplus:true adds Amazon's 7 A+ modules (a 21:9 brand hero and brand promise, 3:2 modules 2-6), each also delivered at its Amazon module's exact pixels, with its text fields suggested only from the product's own data. Priced up front: dryRun:true returns the plan and the exact credits; the charge is that number. Each image is its own queued image job (poll with get_job); they land in the Library. For a batch of ADS use make_static_ads; for one product photo in a scene use plan_ad + generate_image.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make a marketplace listing set
make_motion_filmUse this when the user asks for motion graphics or an animated video: kinetic typography (animated text), a logo animation or intro, a product launch film, an animated social cut.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 asks for motion graphics or an animated video: kinetic typography (animated text), a logo animation or intro, a product launch film, an animated social cut. Pick it for 'animated video', 'motion graphics', 'kinetic text', 'text animation', 'logo animation', 'logo intro', 'animated explainer' asks. STEPS: without confirm it is a FREE quote that gives both prices (length, the music's tempo; the spec in structuredContent): say both; preview:true is a 1-credit contact sheet of the still version; confirm:true renders. Only the user's or the brand's words appear: never invent a claim, number or review. Full rules: get_instructions({topic:'make_motion_film'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make a motion graphics video
make_seriesCONTENT FACTORY: turn ONE topic into a SERIES of faceless short videos (narration over pictures, no presenter), optionally in the STYLE of a trending reference video.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.schedule.channels): what the tool writes goes there.
Description, as the server wrote it CONTENT FACTORY: turn ONE topic into a SERIES of faceless short videos (narration over pictures, no presenter), optionally in the STYLE of a trending reference video. Give `topic` ("make a video about…"), `episodes` (1-10, default 1) or your own `episodeTitles`, `durationSeconds` (20-120 per episode, default 30) and optionally `reference` (a TikTok / Reel / Facebook / X link or a video file URL whose look, pacing and opening hook every episode copies, with plain subtitles only if the reference burns its own; never its words or characters). Find a trending reference with search_tiktok / search_instagram / search_youtube when the user wants one. THREE STEPS, ALWAYS IN THIS ORDER: (1) call with no `confirm` for a FREE quote of the whole series (per episode and total); (2) optionally `planOnly:true` to see the episode titles and the style card first (a small planning charge); (3) `confirm:true` (pass the `plan` from step 2 to reuse it) queues every episode and returns their job ids; poll get_job. To make MORE of a series later, pass its returned plan as `moreOf`: same style, no episode repeated, the reference not watched again. Each finished episode can be scheduled with this tool again: pass `jobIds` plus `schedule` {channels, at, everyHours, timezone} and it books one post per finished episode, spaced `everyHours` apart (default 24). Captions follow the reference (on if it burns words on screen) unless `captions` says otherwise.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make a series of faceless short videos (Content Factory)
make_shortPlan a short-form video (Reel / TikTok / Short) in one of Hermoso's ready FORMATS: a written structure (beats, camera, length, aspect) plus the layers it lays on the finished video…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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it Plan a short-form video (Reel / TikTok / Short) in one of Hermoso's ready FORMATS: a written structure (beats, camera, length, aspect) plus the layers it lays on the finished video (its caption look, a closing "Comment KEYWORD" ask, cards). Call with no `preset` to list every format, which are ready and which are coming (free). With a preset: the person in it is this brand's own (pass `creator` to render_ad to star a saved creator), the words are about `topic`, the length is the format's own unless durationSeconds is given, and an optional reference `url` (a TikTok / Reel / Facebook / X post or a direct file) is watched and its length matched up to 120s. Renders nothing: costs the plan only (about 10-20 credits, more with a reference link). Then render_ad(creative) makes the video in the format's aspect, and finish_short(video, creative) lays the format's captions and close. A format whose layers are not built yet is refused before anything is charged.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make a short in a ready format
make_static_adsMake a BATCH of finished static image ads for one or several products in one call: each ad a genuinely different selling angle (offer, material or ingredient story, how it is used,…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 Make a BATCH of finished static image ads for one or several products in one call: each ad a genuinely different selling angle (offer, material or ingredient story, how it is used, a lifestyle moment, an objection, proof the brand really has) AND a different layout (editorial still life, poster headline, packshot on colour, in hand, flat lay, split compare, native phone photo and more; never one look repeated across a batch), with its headline, supporting line and CTA printed on the image and the product's real photo and the brand's real logo composited in. `products` names products from the brand's product catalog by id or name (list_products; add one from its page link with add_product; ['all'] takes every product with a photo; omit for the hero product). A product's price is printed only when it was read from its live page within the last hour: older rows are re-read first, and a page that cannot be read means no price on that ad. `count` is ads PER PRODUCT (1-20). `aspectRatios` any of 1:1, 4:5, 9:16 (each ad is composed natively once per ratio, so the ratios are different pictures with the same words; for one picture in several sizes render one ratio and use resize_ad). `brief` steers (a sale, a season, an audience) and is never turned into a price, discount or claim the brand does not state; `angles` names the angles to spread across; `layouts` (free words) replaces the layout set. ALWAYS PRICED FIRST: dryRun:true returns the plan and the quote; then pass that `plan` (and its `batchId`) back to render exactly it without planning again. Renders are QUEUED jobs, at most 12 per call: the rest comes back as `remaining`, to send again as `plan` once some finish. Read each job with get_job; never describe an ad before its URL arrives. For variants of ONE finished ad use headline_variants / resize_ad; to copy a competitor's static use clone_static.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make static ads at scale
make_template_adUse this when the user asks for a quick, low-cost ad or post built from their words and pictures: a slideshow, carousel, iMessage or ChatGPT chat, Notes, kinetic type, myth vs fact…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 asks for a quick, low-cost ad or post built from their words and pictures: a slideshow, carousel, iMessage or ChatGPT chat, Notes, kinetic type, myth vs fact, an app tour, or their own HTML design. Rendered from HTML, no AI model, ~30s, billed for its compute only, ready to post. Presets are SHORTCUTS; 'custom' is YOUR OWN design as config.html (+ css), so no layout, type, colour or motion is unsupported. custom: { html, css?, size? ('9:16' default | '4:5' | '1:1' | '16:9' | any 'W:H' | {w,h} px), durationSeconds? (1-60 = VIDEO; CSS/SVG animation and <video> are frame-stepped, scripts stripped), slides?:[{html, css?}] (2-35 = carousel) }; {{logo}} {{brandName}} {{domain}} {{accent}} fill from the brand; images and fonts load by public https URL; notes[] lists what failed to load. YOU write preset copy: short, casual, believable, finished phrases within budget. Preset ids and their fields are listed on `config`. config.music on a VIDEO: omit for a free library bed matched to its mood when the library is stocked (hermoso_capabilities hasMusic; else only its own sound effects), 'off' for silence, or words (a mood or description) to compose one for a flat fee.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make template ad
make_thumbnailRender a click-driving YOUTUBE / Shorts / Instagram THUMBNAIL or video cover through the full production pipeline (concept, casting, scene, render, tweaks, text), not a bare image …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 Render a click-driving YOUTUBE / Shorts / Instagram THUMBNAIL or video cover through the full production pipeline (concept, casting, scene, render, tweaks, text), not a bare image prompt. Use this when the user asks for a video thumbnail or a video cover. Default: 4 variants at 1K (YouTube shows 1280x720 at most), each billed; 2K or 4K only when the user asks. dryRun:true prices it free. The headline overlay is free. WHO IS IN FRAME — never assume or silently substitute a stranger. A framework with a person and no face photo is refused (nothing charged): ask the user once — themselves (a face photo, identity-locked), a generated person (`castGenericPerson:true`), or a people-free framework. TEXT — default is a CLEAN render with the headline TYPESET over it (free, legible, correctly spelled): pass `headline`. `bakeText:true` only on an explicit ask for words painted INTO the image. ALWAYS check the returned postRenderCheck against the image before presenting it. Full rules: get_instructions({topic:'make_thumbnail'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Make video thumbnail
mine_anglesMine ad ANGLES from real customer language: gathers the customer's own words (Reddit, TikTok, the brand's review page + review-site results) and returns a RANKED angle bank — each …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 Mine ad ANGLES from real customer language: gathers the customer's own words (Reddit, TikTok, the brand's review page + review-site results) and returns a RANKED angle bank — each angle tagged (pain / outcome / identity / fear / competitive-displacement / social-proof / contrast), 2-5 VERBATIM proof quotes, a 0-100 score with breakdown, and a ready-to-run hook in the customer's own voice. Reads YOUR saved brand (pass brandId to target a specific profile — that switches this key's active profile like use_brand). To tear down a COMPETITOR use competitor_teardown instead. YOUR OWN REVIEWS: pass `reviews` (a list of review texts, or one pasted block: one per line, numbered, blank-line separated, or a CSV with a review column) and/or `reviewsUrl` (a CSV, TXT or JSON file from upload_file, or a review page; on a local CLI a file path works too). They are first-class evidence: every quote from them is checked word for word against what you sent and labelled 'your reviews', and a quote that is not verbatim is dropped and counted. useOwnReviewsOnly:true mines only your reviews and gathers nothing public. Limits: 300 reviews, 2,000 characters each, 40,000 in total; over that it is refused at no cost, so send fewer or split into batches. Each angle comes back with `next`: the exact plan_variations and generate_image arguments that turn it into finished statics (one generate_image per angle = statics with distinct angles). Spends credits on the reads and the model's token cost.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Mine customer angles
multiply_adMULTIPLY a winning video ad into N variants: each gets a NEW character, outfit, location and/or objects while the cut, the camera motion, the pacing and the ORIGINAL AUDIO stay exa…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 MULTIPLY a winning video ad into N variants: each gets a NEW character, outfit, location and/or objects while the cut, the camera motion, the pacing and the ORIGINAL AUDIO stay exactly as they were, and the source's own captions and on-screen text stay exactly as they are. ONE JOB PER VARIANT: get_job each until done; never describe a variant before its URL arrives. COST: quoteOnly:true returns the exact credits free: state that first. A paid planning read (planCredits) runs next, then each variant bills perVariantCredits. dryRun:true pays for that read; pass its `plan` back to render without paying again. No ad: list_winning_ads. New words: rewrite_ad_line. Full rules: get_instructions({topic:'multiply_ad'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Multiply an ad
plan_adPlan an ad: turns a brand and a product or brief into an ad concept, with copy variants (headline, primary text, call to action) and either an image prompt or a timed video storybo…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 Plan an ad: turns a brand and a product or brief into an ad concept, with copy variants (headline, primary text, call to action) and either an image prompt or a timed video storyboard, plus the recipe and the model ids to render with. It renders nothing; pass its output to render_ad, generate_image or generate_video. For a single image ad it is optional: generate_image alone makes one from the saved brand, so skip this step unless the user wants concepts or copy options first. A named length ("a 30 second ad") goes in durationSeconds and the storyboard is written to it; a video with none is not planned: a free question comes back to ask the user (15s is one clip, or 30s, or any 4-180). The user’s own screenshots or pictures to show inside the video go in `inserts`. The brand’s SAVED product photo (get_brand / list_product_photos) is used automatically; never ask the user to upload it again. Uses credits for the planning step.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Plan an ad concept
plan_variationsFan a brief into N DISTINCT ad angles (different hooks/mechanics/audiences), each with its own headline + visual brief — then render each with generate_image and rank with score_ad…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 Fan a brief into N DISTINCT ad angles (different hooks/mechanics/audiences), each with its own headline + visual brief — then render each with generate_image and rank with score_ad. LLM planning only; renders nothing itself. To plan AND render a batch of finished static ads for one or several products in one call (up to 20 per product), use make_static_ads.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Plan ad variations
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. 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_editMECHANICAL post-production on an EXISTING video (URL): ordered ffmpeg primitives, ~2 credits flat, NO AI model, outputs a NEW video.Reads text others writeCan send data out1 finding
Why it is in this group
- The name "post_edit" 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 "post_edit" says "post": it sends or publishes something to other people.
Findings
- Info
The description is 2,029 characters long, over the 2,000 this check looks for.
What this check looks forMatched text
description ends: "...im), retime (word anchor), recut (order, in/out), regrade (timeline colour keys)."
Description, as the server wrote it MECHANICAL post-production on an EXISTING video (URL): ordered ffmpeg primitives, ~2 credits flat, NO AI model, outputs a NEW video. Ops: a branded end card, trim, speed (0.5-2x), mute (whole or a window), audio_gain (-20..+6 dB), fade_out, music (a ducked bed: omit track = a free library track picked by mood, no attribution; or track = an audio link (upload_file, find_sound or generate_sfx URL, or a post's sound); track 'generate' composes it, paid, ONLY when the user asks; start/end, db, replace), voiceover (text spoken OVER it, its sound ducked; ~2.5 words/s; voice female|male; +~1 credit), watermark (brand logo), grain (anti-AI), text (timed words in a native look: style 'tiktok-classic' default / 'clean-minimal' / 'note-style' or a textStyle; start/end, or at:{word} and until:{word} to time them to speech), join (this video FOLLOWED BY clips[]: Library URLs, files or public post links, one 1080x1920 video), layout (ONLY when asked: split screen, cut-out or green-screen presenter, letterbox, fisheye; whole or a start/end window). Presets are shortcuts: x/y, grain amount, join transition and bridge sound are free. 'A viral hook, then our clip' = videoUrl: the hook's post link + [{op:'join', clips:[{url: ours}], bridge}], and it ALWAYS gets a bridge unless the user asks for a bare cut: {kind:'impact'} cuts the hook just before its payoff (cutAt overrides) and lands our clip on a punch-in and flash, with the payoff sound FROM THE HOOK ITSELF (else one generated from its frames, up to 8 credits, else a neutral impact). {kind:'text', text, then?} only when words over the cut are asked for. No voiceover bridge. ANY OTHER EDIT, op or bridge (whip, zoom, freeze, wipe, generated shot) is edit_timeline: free keyframes, any size. NEVER generate_video/render_ad for these. Feedback is one named move, never a re-render: quieter/louder (music db, audio_gain), faster/slower (speed; slower = zooms and pans at 0.7x), tighten (trim), retime (word anchor), recut (order, in/out), regrade (timeline colour keys).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Post-production edit
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "post_performance" says "post": a word for a change.
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
product_moveA 6-SECOND SILENT 1080p PRODUCT CLIP from ONE product photo: the product is first set on a clean seamless background in a colour taken from the product itself (centred, about two t…Reads text others writeNo findings
Why it is in this group
- The name "product_move" says "move": 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 6-SECOND SILENT 1080p PRODUCT CLIP from ONE product photo: the product is first set on a clean seamless background in a colour taken from the product itself (centred, about two thirds of the frame, one soft shadow), then one MOVE is filmed from that frame. Moves by name: label-trace, crane-reveal, floating-roll, detail-scan, half-turn, impact, light-sweep, liquid-wrap, macro-glide, paint-wave, product-spin, pull-back, push-in, shadow-motion, sunrise-pass, texture-track, topdown-dive, whip-pan. Or describe your own move in `describe` (with no `move`); with a named move, `describe` adds to it. Default 3:4; square 1:1, landscape 16:9, Reel/Story 9:16. No people, hands, words or music are added. Two paid steps (the start frame, then the clip); dryRun:true = the price of both, nothing made. For a longer cut-together product film use product_sizzle.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Six-second product move
product_sizzleRender an 18-30s PRODUCT SIZZLE: ONE 15s Seedance 2.5 hero clip of the product, diced into fast cuts and intercut with typeset spec/CTA cards on a brand-coloured grain background.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 Render an 18-30s PRODUCT SIZZLE: ONE 15s Seedance 2.5 hero clip of the product, diced into fast cuts and intercut with typeset spec/CTA cards on a brand-coloured grain background. No music unless asked (music / musicMood); its own sound carries the cut. Faceless by design — no people, no voiceover, no spoken lines; the cards carry every word, so nothing is left to a video model's spelling. Pass a real packshot as refImage or the label will not be yours. EXPENSIVE — the hero clip is the only paid leg and it is a full 15s Seedance 2.5 render: ≈870 credits at the DEFAULT 1080p, ≈360 at 720p, ≈170 at 480p; a 4k ask renders on Seedance 2.0, the only Seedance tier with 4k, ≈2,360 (call hermoso_capabilities for the live seedance-2.5 per-duration numbers; the dicing and the cards are free; an asked-for bed adds a few). Confirm the spend with the user before calling. For a talking/UGC ad use render_ad or generate_avatar; for a cheap deterministic format use make_template_ad.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Product sizzle
pull_competitor_adsUse this when the user names a brand and asks what ads it is running ("show me the ads <brand> is running").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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it Use this when the user names a brand and asks what ads it is running ("show me the ads <brand> is running"). It pulls that brand’s live ads from the Meta (Facebook and Instagram) Ad Library, deduplicated and sorted, in a few seconds. Covers the Meta Ad Library only; for a broader search across brands or platforms use research_ads. Spends credits.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Pull competitor ads
recast_hookRECAST A VIRAL HOOK with the brand's own subject (the egg rolling off the table becomes your product; your host does the viral move), then join it into your clip.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 is 2,038 characters long, over the 2,000 this check looks for.
What this check looks forMatched text
description ends: "...e result and ops [{op:'join', clips:[{url: your clip}], bridge:{kind:'impact'}}]."
Description, as the server wrote it RECAST A VIRAL HOOK with the brand's own subject (the egg rolling off the table becomes your product; your host does the viral move), then join it into your clip. voice/language: a new voice, or language lip-synced, for one person swapped in. hook: a public post link (TikTok, Reel, Facebook, X; one lookup; not YouTube, which cannot be downloaded) or a video file. Subject: creator (saved name or id), image (a product or person; a real person's photo records consent), or neither for the brand's first product photo. A DUO OR GROUP (2-4 people): subjects [{creator or image, position: 'left'|'right'|'center' or your own words, refs?, outfit?}], each bound to its place in the frame, keeping that performer's movement and timing on the original sound. LOCATION AND OUTFITS, same pass: location (a place photo or words) moves the scene; outfit (a photo or words) re-dresses the subject, subjects[].outfit each person; with no subject named nobody is swapped and only those change (useBrand:true also swaps in the brand product). Pictures are references (4 max; more in words). Person for person: Seedance 2.5 (720p) if the hook is our render or faceRoute is set, else Wan 3.0 (≤15s; Kling 4.0 Edit past). FULL LENGTH: past its one pass (30 s) the window is recast in passes, each continuing from the previous one's frame and crossfaded across the cut, under the original sound: one video up to 60 s, quoted as passes plus join. mode 'auto' is always 'swap' (a region edit: camera, set, light, timing, text and sound kept; a multi-shot hook goes shot by shot); 'motion' only if asked (your person moves in their photo's setting). swap: your own words for what changes. start/end pick the window (3 s minimum; default: a group or a location/outfit change takes the whole clip, one subject the first 10 s). PAID, QUOTED FIRST: no confirm returns the plan and credits; confirm:true once the user okays. Then get_job until done, and post_edit with videoUrl = the result and ops [{op:'join', clips:[{url: your clip}], bridge:{kind:'impact'}}].
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Recast a viral hook with your subject
recast_motionCopy the motion of any video (motion transfer): re-perform a clip's motion, camera and timing with YOUR character, product, clothes or place; sound kept.Reads text others writeNo findings
Why it is in this group
- The description's first verb is "copy": 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 Copy the motion of any video (motion transfer): re-perform a clip's motion, camera and timing with YOUR character, product, clothes or place; sound kept. image (+ images, @Image1, @Image2… in prompt) = who and what. engine auto (default): a person clip + ONE photo of a person (saved, real or AI), 4-30s -> seedance (Seedance 2.5 through our face library, 720p: the clip's scene, beats and sound kept, the WHOLE person swapped) when the clip is one of our renders or faceRoute is set; otherwise wan (Wan 3.0, scene kept, 3-15s, 720p), past 15s kling-edit (Kling 4.0 Edit, 3-30s, 1080p by asking); several photos (one per person) -> h3 (H3 Max Recast, ≤4 photos, 5-30s); no person in the clip -> seedance. By name: kling-edit; wan = Wan 3.0 (≤15s, keeps the set); wan-prime; h3; kling = Kling Motion Control (ONE picture, its background becomes the set). voice/language: the new performer gets a new voice (same timing) or speaks another language (lip-synced), in the same job and price. Billed per output second, ~5 min per 5s; dryRun quotes.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Recast motion
reframe_videoReframe a video to a different aspect ratio (e.g.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 Reframe a video to a different aspect ratio (e.g. 16:9 master -> 9:16 vertical): the whole original frame is kept and the new canvas around it is generated, with the sound and timing unchanged. Clips up to 300 seconds. Paid render; returns the served URL of the reframed video. Every placement at once (a free blur-pad by default): repurpose_video. A presenter on any video: add_presenter.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Reframe video
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
remix_staticThe OLD NAME of clone_static, kept so agents that already call it keep working.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 OLD NAME of clone_static, kept so agents that already call it keep working. It is the same tool with the same inputs, result and cost; prefer clone_static.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Clone a static ad (old name)
render_adUse this when the user asks for a video ad, Reel, TikTok ad, UGC video or commercial for their business or product It renders a finished ad on a real video model, on their brand (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.
What it 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 asks for a video ad, Reel, TikTok ad, UGC video or commercial for their business or product It renders a finished ad on a real video model, on their brand (real product photos, brand voice), as an mp4 ready to post: timed shots, clean speech, text set in post, no music, captions or end card unless asked. Pass plan_ad’s full output as `creative` (plan_ad turns a one-line ask into the concept). Most models cap a clip at 15s and the longest at 30s: dryRun:true shows the act split free, before spending. The brand’s saved product photo (get_brand / list_product_photos) is the real product in the shots, with no upload needed. CAST A SAVED CREATOR with `creator` (list_creators) so the same person stars in every ad; otherwise each render casts a new face. The user’s own pictures (creative.inserts, or `inserts`) are laid in full screen at their seconds. An app shown on a device screen with no real screens to lay there returns needsAppScreens, nothing charged: ask, then pass screenChoice or screens. 1–3 min; poll get_job while it renders. Spends credits. Full rules: get_instructions({topic:'render_ad'}).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Render ad video
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
repurpose_imageONE finished static ad in, VARIANTS × FORMATS out, in one job, as a named file list (<name>_<variant>_<format>_<WxH>.png) with a manifest.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 ONE finished static ad in, VARIANTS × FORMATS out, in one job, as a named file list (<name>_<variant>_<format>_<WxH>.png) with a manifest. The ad's text is read ONCE as the source of truth; each variant's change is made ONCE on the master; every format is derived from that master; every output is text-checked line by line and any line it lost is named (never re-rendered). Variants: {headline}, {language}, {swap:[{from,to}]} (exact words: a price, an offer, a CTA) or {edit} (any change in words), each with an optional {name}; the original is always included. Formats: default 1:1, 4:5, 9:16, 16:9, or 'everywhere', any canvas or a platform word (snapped to the nearest canvas an image model makes). At most 24 renders. dryRun:true = the exact price, which is what it charges. One resize alone is resize_ad.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Repurpose a static ad into variants × formats
repurpose_transcriptTurn a VIDEO into WRITTEN pieces: a summary, YouTube chapters (first at 0:00, at least 3, each 10s+), chapter summaries, an X thread (every post under 280 characters), a blog post,…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 VIDEO into WRITTEN pieces: a summary, YouTube chapters (first at 0:00, at least 3, each 10s+), chapter summaries, an X thread (every post under 280 characters), a blog post, timestamped verbatim quotes, or any piece in your own words (pass the words as a format). The video: a YouTube link (read from its captions), a video file URL, a Library id, an upload_file URL or a social post link (read by watching it); or the text itself, when you already have it from analyze_video (which is the tool that just reads a video back). Several formats share ONE read. Priced by the video's length before anything is spent: without confirm it returns the exact credits and spends nothing; confirm:true writes and charges exactly that. Only the paid minutes are read. Every piece is written only from what the video says. Built-in skills youtube_script and retention_skeleton (get_skill) write long-form scripts.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Repurpose a video transcript
repurpose_videoONE video in, EVERY placement out, in one job, as a named file list (<name>_<placement>_<WxH>[_<lang>].mp4) with a manifest.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 ONE video in, EVERY placement out, in one job, as a named file list (<name>_<placement>_<WxH>[_<lang>].mp4) with a manifest. Placements: 'everywhere' (default: 9:16, 4:5, 1:1, 16:9), any W:H, a pixel size (1200x628) or a platform word (tiktok, reels, stories, feed, square, youtube, linkedin, pinterest). Each is reframed by a BLUR-PAD by default (the whole frame over a blurred copy of itself; free, no AI), reframe 'crop' (fill, edges cut; free) or 'ai' (the new canvas generated around the frame; paid, for a canvas the engine makes, else padded and said). A placement may be {placement, reframe} to mix. Optional captions (word-timed, ~4 words a cue, placed for each canvas) and languages (a lip-synced dub per language; every placement of each). A pack of pads and crops only is billed 0. dryRun:true = the exact price (the sum of every leg's own price), which is what it charges. For ONE canvas use post_edit op pad.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Repurpose a video for every placement
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
research_adsUse this when the user asks an open-ended ad question across several brands or platforms, such as comparisons, which angles are working in a market, or ad examples for a category.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 asks an open-ended ad question across several brands or platforms, such as comparisons, which angles are working in a market, or ad examples for a category. Do not use for one named brand’s current ads: pull_competitor_ads covers that. Open-ended ad research that needs JUDGMENT across platforms — comparisons, "what angle is working", "who else is doing this", anything where the right sources are not known up front. It is an agentic loop (several rounds of library pulls plus a written synthesis) and typically takes 30-60 seconds, so it is the WRONG tool for a question that names its own answer. For one named brand’s live ads use pull_competitor_ads; for one keyword or one advertiser on Meta use search_meta_ads — both are a single call and return in a few seconds. Spends credits — an agentic loop, so a handful rather than the one-call cost of a targeted search.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Research ads
resize_adRe-lay out ONE finished static ad for other placements: the same ad, product, copy (word for word), logo and style, recomposed natively for each canvas rather than cropped.Reads text others writeNo findings
Why it is in this group
- The name "resize_ad" says "resize": 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 Re-lay out ONE finished static ad for other placements: the same ad, product, copy (word for word), logo and style, recomposed natively for each canvas rather than cropped. Pass `image` and optionally `aspectRatios` from 1:1, 4:5, 9:16, 16:9, 3:4, 4:3 (default 1:1, 4:5 and 9:16; the ad's own ratio is skipped). Reads the ad's text first (3 credits) so every line survives, then one image edit per canvas. When the saved brand has a product photo and the ad shows that product, the photo rides with the edit and the product's label is read and checked against it: re-printed from the photo only when it came out wrong (the check alone is charged when it is right; one small extra charge finds the product first). fixLabel:false turns that off. Priced before it runs. Several sizes AND versions (headlines, languages, offers) at once: repurpose_image. For VIDEO use reframe_video.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Resize a static ad for other placements
restyle_videoRESTYLE a clip into a new LOOK: every frame redrawn, shots, motion, camera, framing, timing and sound kept.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 RESTYLE a clip into a new LOOK: every frame redrawn, shots, motion, camera, framing, timing and sound kept. Looks: `Restyle looks` in hermoso_capabilities (claymation, knitted yarn, cel-shaded CG anime…), your own words, or a look BUILT FROM YOUR IMAGES (styleImages); characters draws your own characters in. engine auto (default) picks by what is in the clip: a real-looking person -> kling (Kling 4.0 Edit, 3-15s); none -> wan (Wan 3.0, recommended, ≤15s) else seedance (Seedance 2.5, 4-30s); wan-prime = Wan 3.0 Prime by name (costs more). Paid; dryRun quotes it. One change only: edit_video.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Restyle a video
resume_jobFinish a video-blocks explainer or faceless-channel film (make_explainer) that STOPPED partway: a block the video model would not render, or a server restart.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 Finish a video-blocks explainer or faceless-channel film (make_explainer) that STOPPED partway: a block the video model would not render, or a server restart. What it already made is kept (the script, the style key, the narration and every block that rendered), so this renders ONLY the missing blocks and re-assembles the same film, with the same topic, look, voice, length and options. It reserves credits only for what is missing and never charges again for what was kept. get_job and list_jobs show which jobs can be resumed and which blocks are kept. Quote it with dryRun first and tell the user the number. A finished film is not resumed: to redo one block of a finished film, use fix_beat with its job id.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Resume a stopped film
rewrite_ad_lineCHANGE THE HOOK OR CALL TO ACTION of a finished video ad in the user's own words.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 HOOK OR CALL TO ACTION of a finished video ad in the user's own words. The new words are said where the old ones were, in the speaker's own voice (a paid plan; a matching voice on Free), and the mouth is re-synced to them in that moment alone; every other frame, line, the music and the length stay the source's. hook = the opening sentence, cta = the closing sentence, line = any other spoken line at {atSeconds, text}; hook and cta can go in one call. A new line must fit the moment it replaces at a natural pace: a longer one is refused before anything renders, with the word count that fits. A video nobody speaks in is refused (new words on screen are post_edit text). quoteOnly:true = the price, free. Returns ONE video; the original is kept.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Change the hook or call to action
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 (a generate_image render of an AI person, or a photo of a real person you have permission to use, or of yourself; never a photo just because it is public) plus a name to call them by; from then on list_creators returns them and their url can be re-passed to generate_avatar / generate_video / recast_motion. 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_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. Use it to keep what a competitor_teardown or mine_angles just found, or to bank a creative you want to repeat. 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. Use it whenever research turns up something worth keeping: a competitor ad from search_meta_ads / pull_competitor_ads, an organic post, or one of your own renders. 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
save_video_presetSAVE A FINISHED VIDEO AS A REUSABLE PRESET: its beat structure, pacing, look, captions, how the words are delivered and its sound are read off it once and kept with the video, so n…Reads text others writeNo findings
Why it is in this group
- The name "save_video_preset" 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 A FINISHED VIDEO AS A REUSABLE PRESET: its beat structure, pacing, look, captions, how the words are delivered and its sound are read off it once and kept with the video, so new videos can be made in the same style (make_from_preset). Takes a render, a Library video, a file link, or a TikTok / Reel / Facebook / X post link. About 2 credits (one watch). Optional: name, the saved creator who stars in videos made from it, notes, captions (false = make them without captions; or {style} in words).
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Save a video as a preset
saved_lead_searchesSAVED SEARCHES for find_leads and search_companies, per brand.Reads text others write1 finding
Why it is in this group
- The name "saved_lead_searches" says "search": 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.
Findings
- Warn
The server marks "saved_lead_searches" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "saved_lead_searches" says "search": a word for reading.
Description, as the server wrote it SAVED SEARCHES for find_leads and search_companies, per brand. action "list" (free), "save" (name, kind "leads" or "companies", search: the call's arguments; free), "run" (name or id: re-runs it NOW and returns ONLY companies it has not returned before and that are not already in the brand's email leads or do-not-email list; billed like the search, under the saved maxCredits or the one you pass; dryRun prices it), "delete" (free). A saved search keeps its arguments and a fingerprint of each company it returned, never the rows, and NEVER runs on a schedule: it runs when asked.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Saved lead and company searches
score_adVirality/performance prediction for a finished ad (image or video URL): overall score, per-dimension breakdown (scroll-stop, hook, clarity, brand/product, CTA, retention, goal fit,…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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it Virality/performance prediction for a finished ad (image or video URL): overall score, per-dimension breakdown (scroll-stop, hook, clarity, brand/product, CTA, retention, goal fit, own: could another brand run it unchanged), strengths, and the single biggest fix. Use BEFORE spending on distribution, or to rank variants.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Score ad
search_companiesREAL COMPANIES FOR A PROSPECT LIST, each with its own website, country, a size hint, what its site says it does, the ad pixels and platforms its homepage carries (Meta Pixel, Googl…Reads text others write1 finding
Why it is in this group
- The name "search_companies" says "search": 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 "website": it reads web pages, which anyone can write.
Findings
- Warn
The server marks "search_companies" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_companies" says "search": a word for reading.
Description, as the server wrote it REAL COMPANIES FOR A PROSPECT LIST, each with its own website, country, a size hint, what its site says it does, the ad pixels and platforms its homepage carries (Meta Pixel, Google Ads, TikTok Pixel, Shopify …) and its signals (hiring, new ads on Meta or LinkedIn, funding). Give it description (the kind of company, in plain words) and/or industry, country, size, uses (tags its site must carry) and keywords, or signals [{ type, query }] of the company types: hiring, new_ads_meta, new_ads_linkedin, funding, web. It runs on demand over public lookups (ad libraries, job boards, news, web search) and reads each company's own site; only companies whose website was found come back, sorted by fit, marked when already in the brand's email leads or do-not-email list. Nothing is stored. Paid: about 1 credit per lookup under a hard maxCredits (default 10); reading the websites is free; dryRun:true prices it. Works with nothing connected.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search companies by industry, country, size and signals
search_google_adsStructured Google Ads Transparency pull for ONE advertiser (by domain or advertiserId) — use when you know the brand; use research_ads for open-ended research.Reads text others write1 finding
Why it is in this group
- The name "search_google_ads" says "search": 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.
Findings
- Warn
The server marks "search_google_ads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_google_ads" says "search": a word for reading.
Description, as the server wrote it Structured Google Ads Transparency pull for ONE advertiser (by domain or advertiserId) — use when you know the brand; use research_ads for open-ended research. Deliberately fetches the cheap BASIC listing (get_ad_details=false, ~1 credit — the detailed variant with per-ad headlines costs 25 credits/call and is not exposed here). Returns compact JSON {advertiser, format, adUrl, image, firstShown, lastShown} per ad.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search Google ads
search_instagramOrganic Instagram REELS keyword search (/v2/instagram/reels/search — our only IG keyword surface; profile/hashtag pulls go through fetch_social_data with a handle).Reads text others write1 finding
Why it is in this group
- The name "search_instagram" says "search": 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.
Findings
- Warn
The server marks "search_instagram" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_instagram" says "search": a word for reading.
Description, as the server wrote it Organic Instagram REELS keyword search (/v2/instagram/reels/search — our only IG keyword surface; profile/hashtag pulls go through fetch_social_data with a handle). Returns compact JSON {desc, handle, plays, likes, comments, seconds, postedAt, link, cover} per reel, ranked by plays. It matches captions worldwide and cannot be limited to a country or language: for one market, search in the words people there use, or read named local accounts' Reels through fetch_social_data's Instagram profile endpoint, which is the better first step for a local market. Spends about a credit.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search Instagram
search_linkedin_adsStructured LinkedIn Ad Library search by company name, keyword, or companyId — use for a targeted B2B pull; use research_ads for open-ended research.Reads text others write1 finding
Why it is in this group
- The name "search_linkedin_ads" says "search": 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.
Findings
- Warn
The server marks "search_linkedin_ads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_linkedin_ads" says "search": a word for reading.
Description, as the server wrote it Structured LinkedIn Ad Library search by company name, keyword, or companyId — use for a targeted B2B pull; use research_ads for open-ended research. Returns compact JSON {advertiser, headline, description, cta, link, media, dates, impressions} per ad — LinkedIn's library includes impression counts. Spends about a credit.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search LinkedIn ads
search_meta_adsStructured Meta (Facebook/Instagram) Ad Library pull — use when you know exactly WHAT to fetch: a keyword (query) OR one advertiser (companyName / pageId).Reads text others write1 finding
Why it is in this group
- The name "search_meta_ads" says "search": 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.
Findings
- Warn
The server marks "search_meta_ads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_meta_ads" says "search": a word for reading.
Description, as the server wrote it Structured Meta (Facebook/Instagram) Ad Library pull — use when you know exactly WHAT to fetch: a keyword (query) OR one advertiser (companyName / pageId). Returns compact JSON {page_name, body, cta, link, dates, media} per ad. For open-ended research across platforms, use research_ads instead. Spends credits on each ad-library read it makes: one for a keyword; for a brand name, the page lookup and its ads. An advertiser search returns only that advertiser's ads, or none plus similarly named pages to retry by pageId.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search Meta ads
search_meta_placesFind a PLACE to tag on an Instagram or Facebook post: a shop, cafe, restaurant, venue or landmark.Reads text others write1 finding
Why it is in this group
- The name "search_meta_places" says "search": 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 "find" and "post": it reads posts, which other people can write.
Findings
- Warn
The server marks "search_meta_places" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_meta_places" says "search": a word for reading.
Description, as the server wrote it Find a PLACE to tag on an Instagram or Facebook post: a shop, cafe, restaurant, venue or landmark. Give its name with the city ("Blue Bottle Coffee Oakland"), or paste its Facebook Page link, an Instagram place link (instagram.com/explore/locations/...) or its numeric id. A pasted link or id is read and comes back as that Page's taggable pageId with its name and address, or a plain reason it cannot be tagged. Returns a handful of matching Facebook Pages that have an address: pageId, name, address, category, link. These are matches to CONFIRM with the user (check the name and address; a place tag is public), and Instagram checks the place when the post is made. Needs no connected account. Spends about 1 credit per Page it checks (a name search checks up to 5 Pages, so about 5 to 7 credits); a pasted Facebook Page link or numeric id is about 1 credit; an Instagram place link costs nothing.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Find a place to tag on Instagram or Facebook
search_postsThe POSTS people make ABOUT a subject — a brand ("liquid death"), a product, a hobby ("coffee"), a hashtag ("#homecafe") — from whoever posted them, across organic TikTok, Instagra…Reads text others writeNo findings
Why it is in this group
- The name "search_posts" says "search": a word for reading.
- 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.
- untrusted-inputThe name "search_posts" says "search" and "post": it reads posts, which other people can write.
Description, as the server wrote it The POSTS people make ABOUT a subject — a brand ("liquid death"), a product, a hobby ("coffee"), a hashtag ("#homecafe") — from whoever posted them, across organic TikTok, Instagram Reels and YouTube in ONE call, ranked by views. Not the brand's own ads (search_meta_ads / research_ads) and not the people (find_creators folds these same posts into creators): use it to see what is actually being posted and watched about a subject, to find clips worth cloning (clone_video), and to read the hooks and angles an audience already responds to. About one credit per platform searched (one query each by default; `queries` adds "best X" / "X review" / #tag variants, each a paid call); repeats inside 20 minutes are free.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Top posts about any topic, brand or product
search_redditReddit keyword search (top-ranked posts), to find the customer's own words (pain points, objections, language) to mine into ad hooks and copy.Reads text others write1 finding
Why it is in this group
- The name "search_reddit" says "search": 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 "post": it reads posts, which other people can write.
Findings
- Warn
The server marks "search_reddit" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_reddit" says "search": a word for reading.
Description, as the server wrote it Reddit keyword search (top-ranked posts), to find the customer's own words (pain points, objections, language) to mine into ad hooks and copy. Returns compact JSON {desc (title+selftext), subreddit, upvotes, comments, link} per post. Spends about a credit.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search Reddit
search_threadsOrganic Threads keyword search (/v1/threads/search) — short-form text/social posts for trend + voice research.Reads private dataReads text others write1 finding
Why it is in this group
- The name "search_threads" says "search": a word for reading.
- The server marks it as not read-only (readOnlyHint: false).
What it can reach
- private-dataThe name "search_threads" says "search" 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 "search_threads" says "search" and "thread": it reads messages, which other people can write.
- untrusted-inputThe description's first sentence says "thread": it reads messages, which other people can write.
Findings
- Warn
The server marks "search_threads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_threads" says "search": a word for reading.
Description, as the server wrote it Organic Threads keyword search (/v1/threads/search) — short-form text/social posts for trend + voice research. Returns compact JSON {desc, author, handle, likes, link, cover} per post. Spends about a credit.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search Threads
search_tiktokOrganic TikTok keyword search — top-performing videos to mine for hooks/trends/remixable creative.Reads text others write1 finding
Why it is in this group
- The name "search_tiktok" says "search": 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.
Findings
- Warn
The server marks "search_tiktok" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_tiktok" says "search": a word for reading.
Description, as the server wrote it Organic TikTok keyword search — top-performing videos to mine for hooks/trends/remixable creative. Returns compact JSON {desc, handle, followers, plays, likes, comments, shares, seconds, postedAt, link, cover} per video, ranked by plays. region sets where TikTok is read from, not where posts come from. Use research_ads for open-ended research; for what to POST, tiktok_ideas; for formats across a category, find_proven_formats. Spends about a credit.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search TikTok
search_youtubeOrganic YouTube keyword search (/v1/youtube/search) — videos to mine for hooks/angles/long-form structure.Reads text others write1 finding
Why it is in this group
- The name "search_youtube" says "search": 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.
Findings
- Warn
The server marks "search_youtube" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_youtube" says "search": a word for reading.
Description, as the server wrote it Organic YouTube keyword search (/v1/youtube/search) — videos to mine for hooks/angles/long-form structure. Returns compact JSON {desc (title), author, handle, plays, seconds, postedAt, link, cover} per video, ranked by views. Spends about a credit.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- idempotentHint: false
- title: Search YouTube
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
split_imageCUT ONE PICTURE INTO 2-9 TILES, exactly (no AI, nothing re-drawn): an Instagram grid or panorama carousel ("三宫格" = 3 side by side, "九宫格" = 3x3), or any equal split.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 CUT ONE PICTURE INTO 2-9 TILES, exactly (no AI, nothing re-drawn): an Instagram grid or panorama carousel ("三宫格" = 3 side by side, "九宫格" = 3x3), or any equal split. layout 'row' (default), 'column' or 'grid' with count, or cols and rows; aspect makes each tile that shape (e.g. '1:1', '4:5'; centre-cropped first), 'auto' keeps the picture as it is. Returns the tiles in order (left to right, top to bottom), saved to the Library. A small flat price, like post_edit. For changing what is IN the picture use edit_image.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Cut a picture into tiles
start_story_filmFree.Reads text others writeNo findings
Why it is in this group
- The name "start_story_film" says "start": 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 Free. Starts a staged story film run from a card (cardId from list_story_cards, or your own `card` object with the same fields as get_story_card returns) for the brand's product: it writes the outline, nothing is billed. Then call advance_story_film to run each stage: screenplay, boards (cast, location and a board per act), clips, final cut. autoRun:true runs every stage after the screenplay straight through once its price is shown; the default asks before each paid stage.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Start a story film
stitch_videoRender a multi-scene STITCHED video (≥2 scenes) — ONLY for spots LONGER than ONE clip of the chosen model.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 Render a multi-scene STITCHED video (≥2 scenes) — ONLY for spots LONGER than ONE clip of the chosen model. Do not use it for a spot that fits in one clip of the chosen model: generate_video or render_ad make that in a single generation. What fits is the model’s own maximum from hermoso_capabilities, not a fixed number: 15s on most models, 30s on the longest-clip one, so a 30s spot need not be stitched at all if you name that model. Blocks until done. Spends credits.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Stitch multi-scene video
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "store_get" says "store": a word for a change.
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
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
upscale_videoUpscale a video to higher resolution (2x) for final delivery.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 Upscale a video to higher resolution (2x) for final delivery. Paid render; returns the served URL. A 480p Seedance 2.5 draft: finish_draft (same take, native 1080p). Three engines: the default ('standard') is the safe precision upscaler; engine:'flux' is the FLUX 3 video upscaler (1080p/2K/4K) with an optional mode:'creative' detail-enhancement pass; engine:'detail' rebuilds fine detail such as hair, skin and fabric, the sharpest result for a hero shot and the most expensive. Pick 'flux' or 'detail' when the user asks for added detail rather than a faithful enlargement.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
- title: Upscale video
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
video_framesLOOK at a video's exact frames, free: one contact-sheet image of the frames from start to end at fps (e.g.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 URL (input.url): a request to a URL can carry data to whoever runs it.
Description, as the server wrote it LOOK at a video's exact frames, free: one contact-sheet image of the frames from start to end at fps (e.g. a seam, 3.0-3.8 s at 10 fps) or at the listed times, tiles in reading order with each tile's second listed. Use it to find a moment before an edit and to check a render's seam after it. Takes a Library / render URL, a direct file or a public post link (a TikTok / Reel / Facebook / X post link is opened through one paid lookup, 1 credit; a file is free). SAVE STILLS: save:true returns full-size still images (frame grabs, up to 8) as URLs instead of a contact sheet, picked by times or by clips (numbered at the video's hard cuts, -1 = the last): a before / after from someone's own footage, a cover, a product shot. Compose with those URLs (make_template_ad template 'custom', a post) with no AI.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: true
- title: Look at video frames
- idempotentHint: false
Only reads 45Show 45 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_company_contactsTHE PUBLIC BUSINESS CONTACT FOR A COMPANY, read from its own website: the homepage and its contact / about pages, and the email addresses the company publishes there for contact (m…Reads private dataReads text others writeNo findings
Why it is in this group
- The name "find_company_contacts" says "find": a word for reading.
What it can reach
- private-dataThe name "find_company_contacts" says "find" and "contact": it reads contacts.
- 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 "website": it reads web pages, which anyone can write.
Description, as the server wrote it THE PUBLIC BUSINESS CONTACT FOR A COMPANY, read from its own website: the homepage and its contact / about pages, and the email addresses the company publishes there for contact (mailto links, and role addresses such as hello@, sales@, press@). Each address comes with its role, the page it was found on and the date. A page that says "no solicitation" is flagged and that company is left out of the rows to enrol. It NEVER guesses or builds an address from a name, never tests a mail server, and never looks people up on LinkedIn; an address the site hides from automated readers is left alone, and a domain that cannot receive mail is marked. Pass companies [{ domain, company }] (up to 5 a call), one domain, or searchId and ids from find_leads. ListConfirmed: true is still required on both, and the rule stands: only email an address that is openly published as a business contact, on a page with no "no solicitation" note, with a message relevant to that role. This tool adds and enrols nothing. A site that could not be read is reported as "could not read", never as "no address". Free: 0 credits.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: true
- idempotentHint: true
- title: Find a company's public business contact
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_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_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_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_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_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_story_cardFree.No findings
Why it is in this group
- The name "get_story_card" says "get": a word for reading.
Description, as the server wrote it Free. One story card's full recipe: its style and look, beats (role, share of the film, what each must show), cast slots (product, presenter, rival, location), the location rule, and the outline at a length (each beat in seconds and the acts it is filmed as).
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Read a story card recipe
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_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_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_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. TO PUT ONE IN A FINISHED AD, pass their id or name as render_ad’s `creator` — that casts them for the whole spot. THE PORTRAIT URL IS THE REUSE HANDLE for the raw lanes — pass it as generate_avatar’s `image` (a talking clip of them), generate_video’s `refImage` (they star in the scene), recast_motion’s `image` (they perform a reference clip’s motion), or generate_image’s `refImages`. 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 — say so and offer generate_avatar / save_creator, never invent a roster.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
- title: List saved creators
- idempotentHint: true
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_gallery_submissionsThis brand's submissions to the public Hermoso gallery: each one's id, status (pending review, approved with its public page, rejected) and file.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "list_gallery_submissions" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "file": it reads files.
- untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
Description, as the server wrote it This brand's submissions to the public Hermoso gallery: each one's id, status (pending review, approved with its public page, rejected) and file. Free.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: List gallery submissions
list_hooksThe curated menu of VISUAL scroll-stop HOOKS (how an ad opens) and SETTINGS (where it is staged) that plan_ad and render_ad accept, PLUS this brand's measured traction per hook.No findings
Why it is in this group
- The name "list_hooks" says "list": a word for reading.
Description, as the server wrote it The curated menu of VISUAL scroll-stop HOOKS (how an ad opens) and SETTINGS (where it is staged) that plan_ad and render_ad accept, PLUS this brand's measured traction per hook. Call it before planning an ad to pick a hook deliberately instead of letting the model improvise one, and call it after publishing to see which ones are actually landing. Three things it will not do: it never recommends a hook from thin data — a verdict is SUPPRESSED below 5 measured posts and the reason is stated; it never compares across channels; and it reports hooks you have NEVER TRIED as a fact, not as advice, because 'you haven't tried this' is an observation and 'you should' would be a verdict drawn from zero data. A hook marked unusable in this brief says WHY (an on-screen-text hook cannot ride an authentic/UGC render, which carries zero on-screen text). Read-only, 0 credits.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
- title: The hook + setting libraries, and which hooks are working
- 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_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 (L0, L1…, which plan_ad and render_ad `inserts` take), 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`. To SEE what an image shows, view_images. Free, read-only.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: List library
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_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. 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_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_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_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_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_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_story_cardsFree.No findings
Why it is in this group
- The name "list_story_cards" says "list": a word for reading.
Description, as the server wrote it Free. The story film catalog: 8 styles (micro drama, talking object, cinematic story, cartoon, claymation, inside the body, doll, crochet) and 44 story cards, each a short film with a fixed beat structure where the brand's product turns the story, 40-240 seconds, 9:16. Filter by style or by a length that must fit. Pick one, read it with get_story_card, start it with start_story_film.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: List story film cards
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_templatesReady-to-run ad BRIEFS by industry: dropshipping, ecommerce, mobile apps, restaurants, real estate and local services (12 trades: plumbers, electricians, hvac, roofers, landscapers…No findings
Why it is in this group
- The name "list_templates" says "list": a word for reading.
Description, as the server wrote it Ready-to-run ad BRIEFS by industry: dropshipping, ecommerce, mobile apps, restaurants, real estate and local services (12 trades: plumbers, electricians, hvac, roofers, landscapers, house-cleaners, pest-control, auto-repair, salons, med-spas, dentists, gyms). Compact list by default; pass `id` for one template in full: its brief (filled with the active profile's name, and the trade's specifics when `trade` is given), what the user must supply, the recommended format/aspect/length, and its web deep link. To run one, fill the [square-bracket] slots from what the user gave you, then pass the brief to plan_ad as `product` (with its format and durationSeconds) and render the plan (render_ad for video, generate_image for images). Every part is editable: a template is a shortcut, not a lane, so change or ignore anything that does not fit. These are NOT the native HTML formats of make_template_ad. Read-only, 0 credits.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Industry ad templates
list_video_presetsThe brand's saved video presets (save_video_preset): each one's id, name, format, length, shots and captions.No findings
Why it is in this group
- The name "list_video_presets" says "list": a word for reading.
Description, as the server wrote it The brand's saved video presets (save_video_preset): each one's id, name, format, length, shots and captions. Free.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: List video presets
list_watch_findingsRead what a brand's MARKET RADAR (set_competitor_watch) has found: each watched brand's new ads, the winners (ads past 30 days running, with a ready brief to make your own version)…Reads text others writeNo findings
Why it is in this group
- The name "list_watch_findings" says "list": a word for reading.
What it can reach
- 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 what a brand's MARKET RADAR (set_competitor_watch) has found: each watched brand's new ads, the winners (ads past 30 days running, with a ready brief to make your own version), the trending formats and top posts for its topics, and the ideas to make, plus its state (lastRun, nextRunAt, lastRunOk, paused) and the quote for its next check. Findings marked `seed:true` are what a brand was already running at its first check, not new launches. Read-only and free; it never runs a check.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
- title: Read the market radar
- idempotentHint: true
list_winning_adsThe shelf the Ad Multiplier starts from (multiply_ad start: <id>): this brand's best measured video posts (with the number that ranked them), its saved video presets, and Hermoso's…Reads text others writeNo findings
Why it is in this group
- The name "list_winning_ads" 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 The shelf the Ad Multiplier starts from (multiply_ad start: <id>): this brand's best measured video posts (with the number that ranked them), its saved video presets, and Hermoso's own ad styles (person-led clips, each with its sound said: a version keeps its source's sound). Free.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Winning ads to start from
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_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_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
view_imagesLOOK at pictures already in this brand's Library: returns each image itself (a JPEG, at most 1024 px on its long edge unless maxPx says otherwise) so you can see its headline, on-s…No findings
Why it is in this group
- The name "view_images" says "view": a word for reading.
Description, as the server wrote it LOOK at pictures already in this brand's Library: returns each image itself (a JPEG, at most 1024 px on its long edge unless maxPx says otherwise) so you can see its headline, on-screen text, people, product and layout. Pass up to 6 Library ids (L0… from list_library) or Hermoso file links. Use it to tell which image is which, to write copy for one, or to check its text before quoting it; never describe an image you have not looked at. Only this brand's Library and Hermoso's own files are read. A video is named as one (video_frames shows its frames). Free, read-only.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Look at Library images
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.
68544 paths in this server alone from private data, through text someone else wrote, to a way out. Denying 17 private-data tools breaks every one.
- Reads private data17
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write168
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out24
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
{
"permissions": {
"deny": [
"mcp__hermoso-ai-ad-generator__billing_status",
"mcp__hermoso-ai-ad-generator__find_company_contacts",
"mcp__hermoso-ai-ad-generator__find_creators",
"mcp__hermoso-ai-ad-generator__find_sound",
"mcp__hermoso-ai-ad-generator__get_drive_file",
"mcp__hermoso-ai-ad-generator__get_onedrive_file",
"mcp__hermoso-ai-ad-generator__get_settings",
"mcp__hermoso-ai-ad-generator__list_connectors",
"mcp__hermoso-ai-ad-generator__list_drive_files",
"mcp__hermoso-ai-ad-generator__list_gallery_submissions",
"mcp__hermoso-ai-ad-generator__list_notion_pages",
"mcp__hermoso-ai-ad-generator__list_onedrive_files",
"mcp__hermoso-ai-ad-generator__list_team",
"mcp__hermoso-ai-ad-generator__query_notion_database",
"mcp__hermoso-ai-ad-generator__read_doc",
"mcp__hermoso-ai-ad-generator__read_sheet",
"mcp__hermoso-ai-ad-generator__search_threads"
]
}
}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.
Looked at Nov 14, 2026, 12:21 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
- 168
- 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 168 tools that change things (42 destructive, 2 irreversible, 124 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://app.hermoso.ai/mcp?tools=app-create&src=registry: tools/list returned 210 tools to an anonymous client, including call_tool (destructive), delete_brand (destructive), update_drive_file (destructive), delete_drive_file (destructive), update_notion_row (destructive) and 163 more
Posture changes
- Nov 14, 2026
- Tools that change things, listed without credentials: 153 to 168
Findings
Matches of fixed checks, with the text they matched.
- Warnenable_tools
The description contains "Every other tool", wording about other tools or servers.
What this check looks forMatched text
description: "...few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone —..."
- Warnstore_get
The server marks "store_get" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "store_get" says "store": a word for a change.
- Warnfind_competitors
The server marks "find_competitors" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_competitors" says "find": a word for reading.
- Warnsearch_meta_ads
The server marks "search_meta_ads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_meta_ads" says "search": a word for reading.
The server marks "search_google_ads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_google_ads" says "search": a word for reading.
The server marks "search_linkedin_ads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_linkedin_ads" says "search": a word for reading.
Show 25 more findingsShow fewer
- Warnfind_creators
The server marks "find_creators" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_creators" says "find": a word for reading.
- Warnfind_leads
The server marks "find_leads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_leads" says "find": a word for reading.
- Warnsearch_companies
The server marks "search_companies" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_companies" says "search": a word for reading.
The server marks "saved_lead_searches" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "saved_lead_searches" says "search": a word for reading.
The server marks "find_proven_formats" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_proven_formats" says "find": a word for reading.
- Warnsearch_tiktok
The server marks "search_tiktok" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_tiktok" says "search": a word for reading.
- Warnsearch_instagram
The server marks "search_instagram" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_instagram" says "search": a word for reading.
- Warnsearch_youtube
The server marks "search_youtube" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_youtube" says "search": a word for reading.
- Warnsearch_reddit
The server marks "search_reddit" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_reddit" says "search": a word for reading.
- Warnsearch_threads
The server marks "search_threads" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_threads" says "search": a word for reading.
The server marks "search_meta_places" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "search_meta_places" says "search": a word for reading.
The server marks "fetch_social_data" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "fetch_social_data" says "fetch": a word for reading.
- Warnanalyze_video
The server marks "analyze_video" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "analyze_video" says "analyze": a word for reading.
- Warnfind_sound
The server marks "find_sound" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "find_sound" says "find": a word for reading.
- Warnlist_products
The server marks "list_products" destructive (destructiveHint: true), and its name says "list", a word for reading.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}; The name "list_products" says "list": a word for reading.
The server marks "list_product_photos" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "list_product_photos" says "list": a word for reading.
The server marks "fetch_app_screens" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "fetch_app_screens" says "fetch": a word for reading.
- Warnpost_performance
The server marks "post_performance" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "post_performance" says "post": a word for a change.
- Warndiagnose_posts
The server marks "diagnose_posts" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "diagnose_posts" says "post": a word for a change.
- Infobuy_credits
The description mentions "CREDENTIAL".
What this check looks forMatched text
description: "...U ARE AN AGENT HOLDING YOUR OWN PAYMENT CREDENTIAL, there is a third path that needs no hu..."
- Infopost_edit
The description is 2,029 characters long, over the 2,000 this check looks for.
What this check looks forMatched text
description ends: "...im), retime (word anchor), recut (order, in/out), regrade (timeline colour keys)."
The description mentions "credentials".
What this check looks forMatched text
description: "...Slack, …). This always drops the stored credentials, so every tool for that provider stops..."
The description is 2,443 characters long, over the 2,000 this check looks for.
What this check looks forMatched text
description ends: "...ceWebhookUrl} · discord {webhookUrl, announceWebhookUrl} · webhook {webhookUrl*}."
- Infoleave_connector
The description mentions "credential".
What this check looks forMatched text
description: "...ve YOURS from this profile: your stored credential is dropped and the accounts you shared..."
- Inforecast_hook
The description is 2,038 characters long, over the 2,000 this check looks for.
What this check looks forMatched text
description ends: "...e result and ops [{op:'join', clips:[{url: your clip}], bridge:{kind:'impact'}}]."
History
Changes to its tool definitions and to its remote endpoint, newest first.
Tools33 added, 114 changed.+33 added~114 changedView diff
- Added:advance_story_filmDeletes or cancels
- Added:contact_supportChanges things
- Added:delete_locationDeletes or cancels
- Added:delete_video_presetDeletes or cancels
- Added:find_company_contactsOnly reads
- Added:find_leadsChanges things
- Added:find_proven_formatsChanges things
- Added:finish_shortChanges things
- Added:get_credit_limitsOnly reads
- Added:get_instructionsOnly reads
- Added:get_story_cardOnly reads
- Added:hermoso_other_capabilitiesChanges things
- Added:layerize_imageChanges things
- Added:list_elementsOnly reads
- Added:list_gallery_submissionsOnly reads
- Added:list_story_cardsOnly reads
- Added:list_video_presetsOnly reads
- Added:list_winning_adsOnly reads
- Added:make_from_presetChanges things
- Added:make_shortChanges things
- Added:product_moveChanges things
- Added:rewrite_ad_lineChanges things
- Added:save_locationChanges things
- Added:save_video_presetChanges things
- Added:saved_lead_searchesChanges things
- Added:search_companiesChanges things
- Added:set_credit_limitChanges things
- Added:split_imageChanges things
- Added:start_story_filmChanges things
- Added:submit_to_galleryDeletes or cancels
- Added:update_video_presetDeletes or cancels
- Added:view_imagesOnly reads
- Added:withdraw_from_galleryDeletes or cancels
- Changed:add_presenterChanges thingsinputSchema
- Changed:add_subtitlesChanges thingsdescriptioninputSchema
- Changed:analyze_videoChanges thingsinputSchema
- Changed:billing_statusOnly readsdescription
- Changed:call_toolDeletes or cancelsinputSchema
- Changed:change_voiceChanges thingsinputSchema
- Changed:check_ad_policyChanges thingsinputSchema
- Changed:check_videoChanges thingsinputSchema
- Changed:click_to_adChanges thingsinputSchema
- Changed:clip_videoChanges thingsdescriptioninputSchema
- Changed:clone_staticChanges thingsdescriptioninputSchema
- Changed:clone_videoChanges thingsdescriptioninputSchema
- Changed:collect_post_metricsChanges thingsinputSchema
- Changed:competitor_teardownChanges thingsdescriptioninputSchema
- Changed:connect_connectorDeletes or cancelsdescriptioninputSchema
- Changed:create_docChanges thingsdescription
- Changed:create_sheetChanges thingsdescription
- Changed:diagnose_postsChanges thingsdescription
- Changed:disconnect_connectorDeletes or cancelsdescriptioninputSchema
- Changed:draft_brandDeletes or cancelsdescription
- Changed:dub_videoChanges thingsinputSchema
- Changed:edit_imageChanges thingsinputSchema
- Changed:edit_timelineChanges thingsdescriptioninputSchema
- Changed:edit_videoChanges thingsinputSchema
- Changed:export_swipefile_deckChanges thingsdescription
- Changed:face_checkChanges thingsannotations
- Changed:fetch_social_dataChanges thingsinputSchema
- Changed:find_competitorsChanges thingsdescription
- Changed:find_creatorsChanges thingsinputSchema
- Changed:find_soundChanges thingsinputSchema
- Changed:find_toolsOnly readsdescription
- Changed:finish_draftChanges thingsinputSchema
- Changed:finish_videoChanges thingsinputSchema
- Changed:fix_beatChanges thingsdescriptioninputSchema
- Changed:generate_avatarChanges thingsinputSchema
- Changed:generate_imageChanges thingsdescriptioninputSchema
- Changed:generate_musicChanges thingsinputSchema
- Changed:generate_sfxChanges thingsinputSchema
- Changed:generate_textChanges thingsdescriptioninputSchema
- Changed:generate_videoChanges thingsdescriptioninputSchema
- Changed:generate_voiceChanges thingsinputSchema
- Changed:get_brandOnly readsdescription
- Changed:get_settingsOnly readsdescription
- Changed:headline_variantsChanges thingsinputSchema
- Changed:hermoso_creditsOnly readsdescription
- Changed:hook_variantsChanges thingsdescriptioninputSchema
- Changed:insert_sceneChanges thingsinputSchema
- Changed:leave_connectorDeletes or cancelsdescription
- Changed:list_connector_accountsOnly readsdescriptioninputSchema
- Changed:list_connectorsOnly readsdescription
- Changed:list_creatorsOnly readsdescription
- Changed:list_libraryOnly readsdescriptioninputSchema
- Changed:list_meta_postsOnly readsinputSchema
- Changed:list_notion_pagesOnly readsdescription
- Changed:list_productsDeletes or cancelsannotations
- Changed:list_published_postsOnly readsinputSchema
- Changed:localize_adChanges thingsinputSchema
- Changed:make_effectChanges thingsinputSchema
- Changed:make_explainerChanges thingsdescriptioninputSchema
- Changed:make_insertChanges thingsinputSchema
- Changed:make_listing_setChanges thingsinputSchema
- Changed:make_motion_filmChanges thingsdescriptioninputSchema
- Changed:make_seriesChanges thingsdescriptioninputSchema
- Changed:make_static_adsChanges thingsinputSchema
- Changed:make_template_adChanges thingsinputSchema
- Changed:make_thumbnailChanges thingsdescriptioninputSchema
- Changed:mine_anglesChanges thingsinputSchema
- Changed:multiply_adChanges thingsdescriptioninputSchema
- Changed:plan_adChanges thingsdescriptioninputSchema
- Changed:plan_variationsChanges thingsinputSchema
- Changed:plan_weekChanges thingsinputSchema
- Changed:post_editChanges thingsdescriptioninputSchema
- Changed:post_performanceChanges thingsdescriptioninputSchema
- Changed:product_sizzleChanges thingstitledescriptioninputSchemaannotations
- Changed:pull_competitor_adsChanges thingsdescriptioninputSchema
- Changed:query_notion_databaseOnly readsdescription
- Changed:recast_hookChanges thingsdescriptioninputSchema
- Changed:recast_motionChanges thingsinputSchema
- Changed:reframe_videoChanges thingsinputSchema
- Changed:remix_staticChanges thingsinputSchema
- Changed:render_adChanges thingsdescriptioninputSchema
- Changed:repurpose_imageChanges thingsinputSchema
- Changed:repurpose_transcriptChanges thingsinputSchema
- Changed:repurpose_videoChanges thingsinputSchema
- Changed:research_adsChanges thingsinputSchema
- Changed:resize_adChanges thingsinputSchema
- Changed:restyle_videoChanges thingsinputSchema
- Changed:resume_jobChanges thingsinputSchema
- Changed:save_creatorChanges thingsdescriptioninputSchemaannotations
- Changed:save_to_driveChanges thingsdescription
- Changed:save_to_onedriveChanges thingsdescription
- Changed:save_to_swipefileChanges thingsdescription
- Changed:score_adChanges thingsinputSchema
- Changed:search_google_adsChanges thingsinputSchema
- Changed:search_instagramChanges thingsdescriptioninputSchema
- Changed:search_linkedin_adsChanges thingsinputSchema
- Changed:search_meta_adsChanges thingsdescriptioninputSchema
- Changed:search_meta_placesChanges thingsinputSchema
- Changed:search_postsChanges thingsinputSchema
- Changed:search_redditChanges thingsdescriptioninputSchema
- Changed:search_threadsChanges thingsinputSchema
- Changed:search_tiktokChanges thingsdescriptioninputSchema
- Changed:search_youtubeChanges thingsdescriptioninputSchema
- Changed:set_connector_accountsDeletes or cancelsdescriptioninputSchema
- Changed:set_roleDeletes or cancelsannotations
- Changed:stitch_videoChanges thingsdescriptioninputSchema
- Changed:tiktok_ideasCan't be undoneinputSchema
- Changed:update_brandDeletes or cancelsdescriptioninputSchema
- Changed:update_settingsDeletes or cancelsdescriptioninputSchema
- Changed:upgrade_planChanges thingsdescription
- Changed:upload_fileChanges thingsinputSchema
- Changed:upscale_videoChanges thingsinputSchema
- Changed:use_brandChanges thingsdescription
- Changed:video_framesChanges thingsinputSchema
PostureRemote posture changed. Tools that change things, listed without credentials: 153 -> 168.View diff
- Tools that change things, listed without credentials: 153 to 168
Install
Pinned to version 1.0.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http hermoso-ai-ad-generator https://app.hermoso.ai/mcp?tools=app-create&src=registryclaude mcp add --transport http hermoso-ai-ad-generator https://app.hermoso.ai/mcp?tools=app-create&src=registryRun 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.
{
"permissions": {
"allow": [
"mcp__hermoso-ai-ad-generator__get_instructions",
"mcp__hermoso-ai-ad-generator__find_tools",
"mcp__hermoso-ai-ad-generator__hermoso_credits",
"mcp__hermoso-ai-ad-generator__billing_status",
"mcp__hermoso-ai-ad-generator__list_brands",
"mcp__hermoso-ai-ad-generator__list_drive_files",
"mcp__hermoso-ai-ad-generator__get_drive_file",
"mcp__hermoso-ai-ad-generator__read_sheet",
"mcp__hermoso-ai-ad-generator__list_notion_pages",
"mcp__hermoso-ai-ad-generator__read_notion_page",
"mcp__hermoso-ai-ad-generator__query_notion_database",
"mcp__hermoso-ai-ad-generator__read_doc",
"mcp__hermoso-ai-ad-generator__list_sheet_tabs",
"mcp__hermoso-ai-ad-generator__list_onedrive_files",
"mcp__hermoso-ai-ad-generator__get_onedrive_file",
"mcp__hermoso-ai-ad-generator__list_video_presets",
"mcp__hermoso-ai-ad-generator__list_story_cards",
"mcp__hermoso-ai-ad-generator__get_story_card",
"mcp__hermoso-ai-ad-generator__get_job",
"mcp__hermoso-ai-ad-generator__list_skills",
"mcp__hermoso-ai-ad-generator__get_skill",
"mcp__hermoso-ai-ad-generator__list_memory",
"mcp__hermoso-ai-ad-generator__list_swipefile",
"mcp__hermoso-ai-ad-generator__list_playbooks",
"mcp__hermoso-ai-ad-generator__list_creators",
"mcp__hermoso-ai-ad-generator__list_elements",
"mcp__hermoso-ai-ad-generator__get_settings",
"mcp__hermoso-ai-ad-generator__list_connectors",
"mcp__hermoso-ai-ad-generator__list_connector_accounts",
"mcp__hermoso-ai-ad-generator__list_team",
"mcp__hermoso-ai-ad-generator__get_credit_limits",
"mcp__hermoso-ai-ad-generator__list_jobs",
"mcp__hermoso-ai-ad-generator__list_errors",
"mcp__hermoso-ai-ad-generator__list_watch_findings",
"mcp__hermoso-ai-ad-generator__find_company_contacts",
"mcp__hermoso-ai-ad-generator__get_brand",
"mcp__hermoso-ai-ad-generator__list_library",
"mcp__hermoso-ai-ad-generator__view_images",
"mcp__hermoso-ai-ad-generator__list_gallery_submissions",
"mcp__hermoso-ai-ad-generator__list_winning_ads",
"mcp__hermoso-ai-ad-generator__list_meta_posts",
"mcp__hermoso-ai-ad-generator__list_published_posts",
"mcp__hermoso-ai-ad-generator__list_hooks",
"mcp__hermoso-ai-ad-generator__list_templates"
],
"ask": [
"mcp__hermoso-ai-ad-generator__enable_tools",
"mcp__hermoso-ai-ad-generator__hermoso_capabilities",
"mcp__hermoso-ai-ad-generator__hermoso_other_capabilities",
"mcp__hermoso-ai-ad-generator__buy_credits",
"mcp__hermoso-ai-ad-generator__report_bug",
"mcp__hermoso-ai-ad-generator__request_feature",
"mcp__hermoso-ai-ad-generator__contact_support",
"mcp__hermoso-ai-ad-generator__upgrade_plan",
"mcp__hermoso-ai-ad-generator__set_auto_reload",
"mcp__hermoso-ai-ad-generator__use_brand",
"mcp__hermoso-ai-ad-generator__create_brand",
"mcp__hermoso-ai-ad-generator__upload_file",
"mcp__hermoso-ai-ad-generator__save_to_drive",
"mcp__hermoso-ai-ad-generator__import_from_cloud",
"mcp__hermoso-ai-ad-generator__create_drive_folder",
"mcp__hermoso-ai-ad-generator__create_sheet",
"mcp__hermoso-ai-ad-generator__append_to_sheet",
"mcp__hermoso-ai-ad-generator__export_swipefile_deck",
"mcp__hermoso-ai-ad-generator__save_to_notion",
"mcp__hermoso-ai-ad-generator__append_to_notion_page",
"mcp__hermoso-ai-ad-generator__export_schedule_to_notion",
"mcp__hermoso-ai-ad-generator__create_doc",
"mcp__hermoso-ai-ad-generator__append_to_doc",
"mcp__hermoso-ai-ad-generator__save_to_onedrive",
"mcp__hermoso-ai-ad-generator__convert_onedrive_file",
"mcp__hermoso-ai-ad-generator__create_onedrive_folder",
"mcp__hermoso-ai-ad-generator__plan_ad",
"mcp__hermoso-ai-ad-generator__clone_video",
"mcp__hermoso-ai-ad-generator__save_video_preset",
"mcp__hermoso-ai-ad-generator__make_from_preset",
"mcp__hermoso-ai-ad-generator__make_short",
"mcp__hermoso-ai-ad-generator__finish_short",
"mcp__hermoso-ai-ad-generator__click_to_ad",
"mcp__hermoso-ai-ad-generator__generate_image",
"mcp__hermoso-ai-ad-generator__edit_image",
"mcp__hermoso-ai-ad-generator__headline_variants",
"mcp__hermoso-ai-ad-generator__resize_ad",
"mcp__hermoso-ai-ad-generator__localize_ad",
"mcp__hermoso-ai-ad-generator__make_thumbnail",
"mcp__hermoso-ai-ad-generator__generate_voice",
"mcp__hermoso-ai-ad-generator__generate_sfx",
"mcp__hermoso-ai-ad-generator__generate_music",
"mcp__hermoso-ai-ad-generator__generate_text",
"mcp__hermoso-ai-ad-generator__render_ad",
"mcp__hermoso-ai-ad-generator__make_template_ad",
"mcp__hermoso-ai-ad-generator__make_motion_film",
"mcp__hermoso-ai-ad-generator__finish_video",
"mcp__hermoso-ai-ad-generator__post_edit",
"mcp__hermoso-ai-ad-generator__edit_timeline",
"mcp__hermoso-ai-ad-generator__video_frames",
"mcp__hermoso-ai-ad-generator__fix_beat",
"mcp__hermoso-ai-ad-generator__clip_video",
"mcp__hermoso-ai-ad-generator__add_subtitles",
"mcp__hermoso-ai-ad-generator__make_explainer",
"mcp__hermoso-ai-ad-generator__resume_job",
"mcp__hermoso-ai-ad-generator__make_series",
"mcp__hermoso-ai-ad-generator__start_story_film",
"mcp__hermoso-ai-ad-generator__make_effect",
"mcp__hermoso-ai-ad-generator__product_sizzle",
"mcp__hermoso-ai-ad-generator__generate_video",
"mcp__hermoso-ai-ad-generator__generate_avatar",
"mcp__hermoso-ai-ad-generator__stitch_video",
"mcp__hermoso-ai-ad-generator__plan_week",
"mcp__hermoso-ai-ad-generator__save_skill",
"mcp__hermoso-ai-ad-generator__remember",
"mcp__hermoso-ai-ad-generator__save_to_swipefile",
"mcp__hermoso-ai-ad-generator__save_playbook",
"mcp__hermoso-ai-ad-generator__save_creator",
"mcp__hermoso-ai-ad-generator__save_location",
"mcp__hermoso-ai-ad-generator__store_get",
"mcp__hermoso-ai-ad-generator__set_credit_limit",
"mcp__hermoso-ai-ad-generator__error_detail",
"mcp__hermoso-ai-ad-generator__find_competitors",
"mcp__hermoso-ai-ad-generator__pull_competitor_ads",
"mcp__hermoso-ai-ad-generator__research_ads",
"mcp__hermoso-ai-ad-generator__search_meta_ads",
"mcp__hermoso-ai-ad-generator__search_google_ads",
"mcp__hermoso-ai-ad-generator__search_linkedin_ads",
"mcp__hermoso-ai-ad-generator__find_creators",
"mcp__hermoso-ai-ad-generator__search_posts",
"mcp__hermoso-ai-ad-generator__find_leads",
"mcp__hermoso-ai-ad-generator__search_companies",
"mcp__hermoso-ai-ad-generator__saved_lead_searches",
"mcp__hermoso-ai-ad-generator__tiktok_ideas",
"mcp__hermoso-ai-ad-generator__find_proven_formats",
"mcp__hermoso-ai-ad-generator__search_tiktok",
"mcp__hermoso-ai-ad-generator__search_instagram",
"mcp__hermoso-ai-ad-generator__search_youtube",
"mcp__hermoso-ai-ad-generator__search_reddit",
"mcp__hermoso-ai-ad-generator__search_threads",
"mcp__hermoso-ai-ad-generator__search_meta_places",
"mcp__hermoso-ai-ad-generator__fetch_social_data",
"mcp__hermoso-ai-ad-generator__fetch_asset",
"mcp__hermoso-ai-ad-generator__analyze_video",
"mcp__hermoso-ai-ad-generator__repurpose_transcript",
"mcp__hermoso-ai-ad-generator__find_sound",
"mcp__hermoso-ai-ad-generator__make_insert",
"mcp__hermoso-ai-ad-generator__score_ad",
"mcp__hermoso-ai-ad-generator__check_video",
"mcp__hermoso-ai-ad-generator__reframe_video",
"mcp__hermoso-ai-ad-generator__repurpose_video",
"mcp__hermoso-ai-ad-generator__repurpose_image",
"mcp__hermoso-ai-ad-generator__layerize_image",
"mcp__hermoso-ai-ad-generator__split_image",
"mcp__hermoso-ai-ad-generator__product_move",
"mcp__hermoso-ai-ad-generator__add_presenter",
"mcp__hermoso-ai-ad-generator__insert_scene",
"mcp__hermoso-ai-ad-generator__upscale_video",
"mcp__hermoso-ai-ad-generator__finish_draft",
"mcp__hermoso-ai-ad-generator__restyle_video",
"mcp__hermoso-ai-ad-generator__edit_video",
"mcp__hermoso-ai-ad-generator__multiply_ad",
"mcp__hermoso-ai-ad-generator__hook_variants",
"mcp__hermoso-ai-ad-generator__rewrite_ad_line",
"mcp__hermoso-ai-ad-generator__dub_video",
"mcp__hermoso-ai-ad-generator__change_voice",
"mcp__hermoso-ai-ad-generator__recast_motion",
"mcp__hermoso-ai-ad-generator__recast_hook",
"mcp__hermoso-ai-ad-generator__face_check",
"mcp__hermoso-ai-ad-generator__plan_variations",
"mcp__hermoso-ai-ad-generator__make_static_ads",
"mcp__hermoso-ai-ad-generator__make_listing_set",
"mcp__hermoso-ai-ad-generator__competitor_teardown",
"mcp__hermoso-ai-ad-generator__check_ad_policy",
"mcp__hermoso-ai-ad-generator__clone_static",
"mcp__hermoso-ai-ad-generator__remix_static",
"mcp__hermoso-ai-ad-generator__mine_angles",
"mcp__hermoso-ai-ad-generator__list_product_photos",
"mcp__hermoso-ai-ad-generator__fetch_app_screens",
"mcp__hermoso-ai-ad-generator__post_performance",
"mcp__hermoso-ai-ad-generator__diagnose_posts",
"mcp__hermoso-ai-ad-generator__collect_post_metrics",
"mcp__hermoso-ai-ad-generator__backfill_posts"
],
"deny": [
"mcp__hermoso-ai-ad-generator__call_tool",
"mcp__hermoso-ai-ad-generator__delete_brand",
"mcp__hermoso-ai-ad-generator__update_drive_file",
"mcp__hermoso-ai-ad-generator__delete_drive_file",
"mcp__hermoso-ai-ad-generator__update_notion_row",
"mcp__hermoso-ai-ad-generator__update_sheet",
"mcp__hermoso-ai-ad-generator__clear_sheet_range",
"mcp__hermoso-ai-ad-generator__manage_sheet_tabs",
"mcp__hermoso-ai-ad-generator__format_sheet",
"mcp__hermoso-ai-ad-generator__update_doc",
"mcp__hermoso-ai-ad-generator__update_onedrive_file",
"mcp__hermoso-ai-ad-generator__delete_onedrive_file",
"mcp__hermoso-ai-ad-generator__share_onedrive_file",
"mcp__hermoso-ai-ad-generator__onedrive_file_permissions",
"mcp__hermoso-ai-ad-generator__update_video_preset",
"mcp__hermoso-ai-ad-generator__delete_video_preset",
"mcp__hermoso-ai-ad-generator__advance_story_film",
"mcp__hermoso-ai-ad-generator__delete_skill",
"mcp__hermoso-ai-ad-generator__forget",
"mcp__hermoso-ai-ad-generator__tidy_memory",
"mcp__hermoso-ai-ad-generator__update_saved_creator",
"mcp__hermoso-ai-ad-generator__delete_playbook",
"mcp__hermoso-ai-ad-generator__delete_creator",
"mcp__hermoso-ai-ad-generator__delete_location",
"mcp__hermoso-ai-ad-generator__update_brand",
"mcp__hermoso-ai-ad-generator__update_settings",
"mcp__hermoso-ai-ad-generator__set_connector_accounts",
"mcp__hermoso-ai-ad-generator__disconnect_connector",
"mcp__hermoso-ai-ad-generator__connect_connector",
"mcp__hermoso-ai-ad-generator__leave_connector",
"mcp__hermoso-ai-ad-generator__invite_member",
"mcp__hermoso-ai-ad-generator__remove_member",
"mcp__hermoso-ai-ad-generator__set_role",
"mcp__hermoso-ai-ad-generator__set_competitor_watch",
"mcp__hermoso-ai-ad-generator__draft_brand",
"mcp__hermoso-ai-ad-generator__delete_library_item",
"mcp__hermoso-ai-ad-generator__submit_to_gallery",
"mcp__hermoso-ai-ad-generator__withdraw_from_gallery",
"mcp__hermoso-ai-ad-generator__list_products",
"mcp__hermoso-ai-ad-generator__add_product",
"mcp__hermoso-ai-ad-generator__refresh_products",
"mcp__hermoso-ai-ad-generator__update_product",
"mcp__hermoso-ai-ad-generator__remove_product",
"mcp__hermoso-ai-ad-generator__set_product_image"
]
}
}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-ai-ad-generator. Review it before you use it.
Capability tags behind 172 rules
- mcp__hermoso-ai-ad-generator__call_tool untrusted-input
- mcp__hermoso-ai-ad-generator__buy_credits untrusted-input
- mcp__hermoso-ai-ad-generator__report_bug untrusted-input
- mcp__hermoso-ai-ad-generator__request_feature untrusted-input
- mcp__hermoso-ai-ad-generator__contact_support untrusted-input
- mcp__hermoso-ai-ad-generator__billing_status private-data
- mcp__hermoso-ai-ad-generator__upgrade_plan untrusted-input
- mcp__hermoso-ai-ad-generator__delete_brand untrusted-input
- mcp__hermoso-ai-ad-generator__upload_file untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__save_to_drive untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__import_from_cloud untrusted-input
- mcp__hermoso-ai-ad-generator__list_drive_files private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__get_drive_file private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__update_drive_file untrusted-input
- mcp__hermoso-ai-ad-generator__delete_drive_file untrusted-input
- mcp__hermoso-ai-ad-generator__create_drive_folder untrusted-input
- mcp__hermoso-ai-ad-generator__create_sheet untrusted-input
- mcp__hermoso-ai-ad-generator__append_to_sheet untrusted-input
- mcp__hermoso-ai-ad-generator__read_sheet private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__export_swipefile_deck untrusted-input
- mcp__hermoso-ai-ad-generator__list_notion_pages private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__save_to_notion untrusted-input
- mcp__hermoso-ai-ad-generator__append_to_notion_page untrusted-input
- mcp__hermoso-ai-ad-generator__read_notion_page untrusted-input
- mcp__hermoso-ai-ad-generator__export_schedule_to_notion untrusted-input
- mcp__hermoso-ai-ad-generator__query_notion_database private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__update_notion_row untrusted-input
- mcp__hermoso-ai-ad-generator__create_doc untrusted-input
- mcp__hermoso-ai-ad-generator__append_to_doc untrusted-input
- mcp__hermoso-ai-ad-generator__read_doc private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__list_sheet_tabs untrusted-input
- mcp__hermoso-ai-ad-generator__update_sheet untrusted-input
- mcp__hermoso-ai-ad-generator__clear_sheet_range untrusted-input
- mcp__hermoso-ai-ad-generator__manage_sheet_tabs untrusted-input
- mcp__hermoso-ai-ad-generator__format_sheet untrusted-input
- mcp__hermoso-ai-ad-generator__update_doc untrusted-input
- mcp__hermoso-ai-ad-generator__save_to_onedrive untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__list_onedrive_files private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__get_onedrive_file private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__update_onedrive_file untrusted-input
- mcp__hermoso-ai-ad-generator__delete_onedrive_file untrusted-input
- mcp__hermoso-ai-ad-generator__share_onedrive_file untrusted-input
- mcp__hermoso-ai-ad-generator__onedrive_file_permissions untrusted-input
- mcp__hermoso-ai-ad-generator__convert_onedrive_file untrusted-input
- mcp__hermoso-ai-ad-generator__create_onedrive_folder untrusted-input
- mcp__hermoso-ai-ad-generator__plan_ad untrusted-input
- mcp__hermoso-ai-ad-generator__clone_video untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__save_video_preset untrusted-input
- mcp__hermoso-ai-ad-generator__make_from_preset untrusted-input
- mcp__hermoso-ai-ad-generator__make_short untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__finish_short untrusted-input
- mcp__hermoso-ai-ad-generator__click_to_ad untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__generate_image untrusted-input
- mcp__hermoso-ai-ad-generator__edit_image untrusted-input
- mcp__hermoso-ai-ad-generator__headline_variants untrusted-input
- mcp__hermoso-ai-ad-generator__resize_ad untrusted-input
- mcp__hermoso-ai-ad-generator__localize_ad untrusted-input
- mcp__hermoso-ai-ad-generator__make_thumbnail untrusted-input
- mcp__hermoso-ai-ad-generator__generate_voice untrusted-input
- mcp__hermoso-ai-ad-generator__generate_sfx untrusted-input
- mcp__hermoso-ai-ad-generator__generate_music untrusted-input
- mcp__hermoso-ai-ad-generator__generate_text untrusted-input
- mcp__hermoso-ai-ad-generator__render_ad untrusted-input
- mcp__hermoso-ai-ad-generator__make_template_ad untrusted-input
- mcp__hermoso-ai-ad-generator__make_motion_film untrusted-input
- mcp__hermoso-ai-ad-generator__finish_video untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__post_edit untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__edit_timeline untrusted-input
- mcp__hermoso-ai-ad-generator__video_frames untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__fix_beat untrusted-input
- mcp__hermoso-ai-ad-generator__clip_video untrusted-input
- mcp__hermoso-ai-ad-generator__add_subtitles untrusted-input
- mcp__hermoso-ai-ad-generator__make_explainer untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__resume_job untrusted-input
- mcp__hermoso-ai-ad-generator__make_series untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__start_story_film untrusted-input
- mcp__hermoso-ai-ad-generator__advance_story_film untrusted-input
- mcp__hermoso-ai-ad-generator__make_effect untrusted-input
- mcp__hermoso-ai-ad-generator__product_sizzle untrusted-input
- mcp__hermoso-ai-ad-generator__generate_video untrusted-input
- mcp__hermoso-ai-ad-generator__generate_avatar untrusted-input
- mcp__hermoso-ai-ad-generator__stitch_video untrusted-input
- mcp__hermoso-ai-ad-generator__plan_week untrusted-input
- mcp__hermoso-ai-ad-generator__list_memory untrusted-input
- mcp__hermoso-ai-ad-generator__list_swipefile untrusted-input
- mcp__hermoso-ai-ad-generator__save_creator untrusted-input
- mcp__hermoso-ai-ad-generator__get_settings private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__list_connectors private-data
- mcp__hermoso-ai-ad-generator__list_connector_accounts untrusted-input
- mcp__hermoso-ai-ad-generator__set_connector_accounts untrusted-input
- mcp__hermoso-ai-ad-generator__disconnect_connector untrusted-input
- mcp__hermoso-ai-ad-generator__connect_connector untrusted-input
- mcp__hermoso-ai-ad-generator__leave_connector untrusted-input
- mcp__hermoso-ai-ad-generator__list_team private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__invite_member untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__remove_member untrusted-input
- mcp__hermoso-ai-ad-generator__find_competitors untrusted-input
- mcp__hermoso-ai-ad-generator__pull_competitor_ads untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__set_competitor_watch untrusted-input
- mcp__hermoso-ai-ad-generator__list_watch_findings untrusted-input
- mcp__hermoso-ai-ad-generator__research_ads untrusted-input
- mcp__hermoso-ai-ad-generator__search_meta_ads untrusted-input
- mcp__hermoso-ai-ad-generator__search_google_ads untrusted-input
- mcp__hermoso-ai-ad-generator__search_linkedin_ads untrusted-input
- mcp__hermoso-ai-ad-generator__find_creators private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__search_posts untrusted-input
- mcp__hermoso-ai-ad-generator__find_leads untrusted-input
- mcp__hermoso-ai-ad-generator__search_companies untrusted-input
- mcp__hermoso-ai-ad-generator__saved_lead_searches untrusted-input
- mcp__hermoso-ai-ad-generator__find_company_contacts private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__tiktok_ideas untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__find_proven_formats untrusted-input
- mcp__hermoso-ai-ad-generator__search_tiktok untrusted-input
- mcp__hermoso-ai-ad-generator__search_instagram untrusted-input
- mcp__hermoso-ai-ad-generator__search_youtube untrusted-input
- mcp__hermoso-ai-ad-generator__search_reddit untrusted-input
- mcp__hermoso-ai-ad-generator__search_threads private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__search_meta_places untrusted-input
- mcp__hermoso-ai-ad-generator__fetch_social_data untrusted-input
- mcp__hermoso-ai-ad-generator__get_brand untrusted-input
- mcp__hermoso-ai-ad-generator__draft_brand untrusted-input
- mcp__hermoso-ai-ad-generator__delete_library_item untrusted-input
- mcp__hermoso-ai-ad-generator__submit_to_gallery untrusted-input
- mcp__hermoso-ai-ad-generator__list_gallery_submissions private-data, untrusted-input
- mcp__hermoso-ai-ad-generator__withdraw_from_gallery untrusted-input
- mcp__hermoso-ai-ad-generator__fetch_asset untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__analyze_video untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__repurpose_transcript untrusted-input
- mcp__hermoso-ai-ad-generator__find_sound private-data, untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__make_insert untrusted-input
- mcp__hermoso-ai-ad-generator__score_ad untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__check_video untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__reframe_video untrusted-input
- mcp__hermoso-ai-ad-generator__repurpose_video untrusted-input
- mcp__hermoso-ai-ad-generator__repurpose_image untrusted-input
- mcp__hermoso-ai-ad-generator__layerize_image untrusted-input
- mcp__hermoso-ai-ad-generator__split_image untrusted-input
- mcp__hermoso-ai-ad-generator__product_move untrusted-input
- mcp__hermoso-ai-ad-generator__add_presenter untrusted-input
- mcp__hermoso-ai-ad-generator__insert_scene untrusted-input
- mcp__hermoso-ai-ad-generator__upscale_video untrusted-input
- mcp__hermoso-ai-ad-generator__finish_draft untrusted-input
- mcp__hermoso-ai-ad-generator__restyle_video untrusted-input
- mcp__hermoso-ai-ad-generator__edit_video untrusted-input
- mcp__hermoso-ai-ad-generator__multiply_ad untrusted-input
- mcp__hermoso-ai-ad-generator__list_winning_ads untrusted-input
- mcp__hermoso-ai-ad-generator__hook_variants untrusted-input
- mcp__hermoso-ai-ad-generator__rewrite_ad_line untrusted-input
- mcp__hermoso-ai-ad-generator__dub_video untrusted-input
- mcp__hermoso-ai-ad-generator__change_voice untrusted-input
- mcp__hermoso-ai-ad-generator__recast_motion untrusted-input
- mcp__hermoso-ai-ad-generator__recast_hook untrusted-input
- mcp__hermoso-ai-ad-generator__face_check untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__plan_variations untrusted-input
- mcp__hermoso-ai-ad-generator__make_static_ads untrusted-input
- mcp__hermoso-ai-ad-generator__make_listing_set untrusted-input
- mcp__hermoso-ai-ad-generator__list_products untrusted-input
- mcp__hermoso-ai-ad-generator__add_product untrusted-input
- mcp__hermoso-ai-ad-generator__refresh_products untrusted-input
- mcp__hermoso-ai-ad-generator__competitor_teardown untrusted-input
- mcp__hermoso-ai-ad-generator__check_ad_policy untrusted-input
- mcp__hermoso-ai-ad-generator__clone_static untrusted-input
- mcp__hermoso-ai-ad-generator__remix_static untrusted-input
- mcp__hermoso-ai-ad-generator__mine_angles untrusted-input
- mcp__hermoso-ai-ad-generator__set_product_image untrusted-input
- mcp__hermoso-ai-ad-generator__fetch_app_screens untrusted-input
- mcp__hermoso-ai-ad-generator__list_meta_posts untrusted-input
- mcp__hermoso-ai-ad-generator__list_published_posts untrusted-input
- mcp__hermoso-ai-ad-generator__post_performance outbound
- mcp__hermoso-ai-ad-generator__diagnose_posts outbound
- mcp__hermoso-ai-ad-generator__collect_post_metrics untrusted-input, outbound
- mcp__hermoso-ai-ad-generator__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-ai-ad-generator/verify?hash=91ed7ec91cea8657dec0ba24f96ccc2d7f06bb2dce2b6a909c48641d37a560e4" | jq -e '.changed == false'Pinned hash 91ed7ec91cea, 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-ai-ad-generator/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.github.hermoso-ai/hermoso-ai-ad-generator)Source: MCP Registry · repository. Synced Nov 6, 2026, 22:17 UTC.
Hermoso: AI Ad Generator MCP server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the Hermoso: AI Ad Generator MCP server safe?
- No scan can promise that. What its definitions show: 221 tools, 176 of which can change, send or delete something, and 31 findings 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: AI Ad Generator MCP server delete data?
- Yes. 44 tools can delete, cancel or revoke something: call_tool, delete_brand, update_drive_file, delete_drive_file, update_notion_row, update_sheet and 38 more.
Can the Hermoso: AI Ad Generator MCP server do things that cannot be undone?
- Yes. 1 tool can send, pay, publish or merge: tiktok_ideas.
What tools does the Hermoso: AI Ad Generator MCP server have?
- 221 tools: 44 destructive, 1 irreversible, 131 write, 45 read. call_tool, delete_brand, update_drive_file, delete_drive_file, update_notion_row, update_sheet, clear_sheet_range, manage_sheet_tabs and 213 more.
Does the Hermoso: AI Ad Generator MCP server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the Hermoso: AI Ad Generator MCP server send data to outside services?
- 24 tools can carry data out (it sends, posts or publishes, or takes a recipient, channel or URL): upload_file, save_to_drive, save_to_onedrive, clone_video, make_short, click_to_ad and 18 more.
Has the Hermoso: AI Ad Generator 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.