Skip to content

Hermoso: Ads Manager MCP server

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

AI marketing agent for paid ads: run campaigns on 11 ad networks and read your web analytics.

831 tools: 311 can delete or cancel things, 10 do something that can't be undone, 245 change things and 265 only read.

Tools: 311 delete, 10 irreversible, 245 write, 265 read.
  • Reads private data · 55
  • Reads text others write · 779
  • Can send data out · 59
  • 49 findings, 2 high

Tools listed without sign-in. Remote posture

With Anlyon

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

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

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

What the Hermoso: Ads Manager MCP server can do

The Hermoso: Ads Manager MCP server is published by the GitHub account hermoso-ai. It has 831 tools. It can delete or cancel things (311 tools: call_tool, delete_brand, create_meta_campaign, set_meta_campaign_status and 307 more), do things that cannot be undone, such as sending, paying or publishing (record_shopify_marketing_activity, list_stripe_refunds, create_stripe_product, create_stripe_price and 6 more) and create or change data (245 tools: enable_tools, hermoso_capabilities, hermoso_other_capabilities, buy_credits and 241 more). 265 tools only read.

55 tools read private data (billing_status, find_meta_audiences, list_google_ads_lead_submissions and 52 more); 779 tools bring in text other people can write (call_tool, buy_credits, report_bug and 776 more); 59 tools can send data out of your system (upload_file, upload_meta_asset, upload_meta_playable and 56 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 49 findings, 2 of them high severity (tool-shadowing, credentials-mention, long-description, annotation-conflict and 1 more). Each one comes with the text it matched.

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

Last scanned Nov 21, 2026, version 1.0.0.

Tools

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

831 tools

Deletes or cancels 311Claude Code: deny
  • analytics_data_retentionHOW LONG GA4 KEEPS EVENT- AND USER-LEVEL DATA.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    HOW LONG GA4 KEEPS EVENT- AND USER-LEVEL DATA. The default is 2 months, which silently caps every exploration and funnel at the last two months; standard reports are unaffected. action:'get' reads it; 'set' changes eventDataRetention / userDataRetention (2 or 14 months on a standard property; 26, 38, 50 for event data on Analytics 360 only) and resetUserDataOnNewActivity. RAISING applies to data already collected. LOWERING DELETES the older data at Google's next monthly run and cannot be undone, so it answers needsConfirm first — show the user, get a yes, then confirm:true. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: GA4 data retention
  • apply_apple_ads_recommendationTHIS CHANGES WHAT A LIVE CAMPAIGN MAY SPEND, and it is the only tool in the Apple Ads suggestion/recommendation family that touches money.Reads text others writeNo findings

    Why it is in this group

    • The name "apply_apple_ads_recommendation" says "apply": a word for a change.
    • The input carries an amount (input.amount) and a currency, so it moves money.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THIS CHANGES WHAT A LIVE CAMPAIGN MAY SPEND, and it is the only tool in the Apple Ads suggestion/recommendation family that touches money. Applying a daily-budget recommendation raises that campaign’s daily budget to Apple’s suggested amount; applying a target-CPA recommendation moves the CPA its auto-bidder chases. REQUIRES confirm:true, and the refusal you get without it is built from the recommendation READ BACK FROM APPLE — it names the campaign, states the daily budget current -> recommended (Apple keeps no current target CPA anywhere readable, so a target-CPA refusal states the recommended target against the campaign’s average CPA so far), and quotes Apple’s own projected spend over the next seven days — so you are confirming a specific change to a specific campaign rather than confirming that you pressed a button. Apple publishes no dry-run for this call; that refusal IS the preview, and it dispatches nothing. An id Hermoso cannot read back from Apple right now (unknown, expired, another app, or Apple not answering) is refused even WITH confirm:true. Pass amount to apply a DIFFERENT number than Apple suggested; omit it to take Apple’s. The campaign’s STATUS IS NOT TOUCHED: this moves a ceiling, it never enables or pauses anything, and it does not make a paused campaign start spending. Only an AVAILABLE recommendation can be applied and applying is TERMINAL. APPLIED is reported only from READ-BACKS, never from Apple’s acknowledgement: a daily budget only when the re-read CAMPAIGN carries the new budget; a target CPA (which Apple stores on no campaign) only when the re-read campaign exists and the recommendation re-queries as APPLIED. Anything less comes back NOT CONFIRMED and says which read failed. Free to call; the spending it enables is real.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Apply an Apple Ads recommendation
    • idempotentHint: false
  • apply_microsoft_ads_customer_listUpload customer emails into a Microsoft Advertising Customer Match list so campaigns can target or exclude them.Reads text others writeNo findings

    Why it is in this group

    • The name "apply_microsoft_ads_customer_list" says "apply": 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
    Upload customer emails into a Microsoft Advertising Customer Match list so campaigns can target or exclude them. YOU PASS PLAIN EMAIL ADDRESSES — Hermoso normalizes and SHA-256 hashes them locally and sends ONLY the digests, so no plaintext ever leaves the server; values that arrive already hashed (64 hex characters) are passed through untouched. Microsoft's own normalization is applied exactly as published: trim, remove all dots from the user portion, remove any +alias, lowercase, then SHA-256. YOU MUST GET THE USER'S AGREEMENT FIRST: show them https://about.ads.microsoft.com/en-us/legal/customer-match-terms and only then call with acceptTerms:true, which Microsoft says 'eliminates the need to accept terms through the Microsoft Advertising UI' — without it nothing is uploaded and nothing is hashed. action is Add (additive, the default), Remove or Replace. Maximum 1000 items per call; page larger lists. Email is the only supported identifier — Microsoft publishes Phone and CRM as 'Not currently supported' and both are refused by name. DO NOT read a size of 0 afterwards as a failure: Microsoft leaves it empty for up to 48 hours while the audience builds. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Upload customer emails into a Microsoft Customer Match list
  • apply_microsoft_ads_recommendationsApply Microsoft Advertising recommendations by id.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Apply Microsoft Advertising recommendations by id. THIS SPENDS REAL MONEY AND HAS NO UNDO. It raises daily budgets, adds keywords, widens keywords to broad match, DELETES negative keywords so the account buys more searches, and publishes Microsoft-written ads under the brand’s name, all live at the next auction. THE GATE IS UNLIKE THE OTHER MICROSOFT SPEND SWITCHES, AND confirm:true ALONE IS REFUSED: it proves you meant to apply something, not that you know what THESE ones do, and it reads identically for one keyword suggestion and forty budget raises. So call it ONCE with no confirmation. Nothing is applied, and you get every recommendation named with its campaign, exactly what it changes, the current -> recommended budget where there is one, and Microsoft’s own cost estimate. SHOW THAT LIST TO THE USER, get an explicit yes, then call again with confirm:true, confirmCount:<n> and confirmCostIncrease:<n>. BOTH NUMBERS ARE RECOMPUTED FROM A FRESH READ at that moment, so a recommendation Microsoft has withdrawn, already applied or re-priced since you looked fails the check instead of being applied unseen. If ANY id you name is no longer on offer, NOTHING is applied, not even the ones that still are, because applying part of a set you inspected whole is not what you asked for. Microsoft can reject individual items and apply the rest, so the result reports per item: never call a partial apply a failure, and never call it a success. 0 credits to us; the spend lands on the ad account.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Apply Microsoft recommendations (spend-gated)
    • idempotentHint: false
  • apply_tiktok_ads_audienceAttach a TikTok custom audience to ad groups as an INCLUDE or an EXCLUDE — the call that changes WHO SEES THE ADS, and the reason building audiences is worth doing at all.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Attach a TikTok custom audience to ad groups as an INCLUDE or an EXCLUDE — the call that changes WHO SEES THE ADS, and the reason building audiences is worth doing at all. actionMode is exactly "Apply" or "Disconnect" (TikTok’s enum is case-sensitive), and Apply also needs usageMode "Include" or "Exclude": GETTING usageMode WRONG INVERTS THE ENTIRE AUDIENCE, showing the ads to precisely the people you meant to keep out, and nothing in TikTok’s reply would say so. One audience per call, and the audience and ad groups must be on the same advertiser. A Lookalike cannot be applied to a Reach & Frequency ad group. It spends nothing by itself — every ad group Hermoso builds is born paused — but on an ALREADY-LIVE ad group it changes delivery on the next auction, so name the ad groups to the user first. The ad groups are read back from TikTok.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Include or exclude a TikTok audience on ad groups
    • idempotentHint: false
  • archive_analytics_audienceARCHIVE a GA4 audience, and it is ONE-WAY: GA4 publishes no delete and no un-archive anywhere in its API.Reads text others writeNo findings

    Why it is in this group

    • The name "archive_analytics_audience" says "archive": a word for removing or ending something.
    • The description says "cannot be recovered".
    • 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
    ARCHIVE a GA4 audience, and it is ONE-WAY: GA4 publishes no delete and no un-archive anywhere in its API. Any Google Ads remarketing list sourced from it stops refreshing, and because the definition is IMMUTABLE the audience cannot be recovered by editing — rebuilding means a NEW audience that starts collecting members from scratch, so months of accumulated membership are gone. WITHOUT `confirm` IT ARCHIVES NOTHING and describes the audience read back from Google; check that against what the user asked for, because naming the right audience is the one thing confirm cannot prove. An ambiguous displayName is REFUSED rather than first-matched — GA4 does not enforce unique names and there is no way back. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Archive a GA4 audience (one-way)
  • archive_analytics_custom_dimensionTHE ONLY WAY TO RETIRE A CUSTOM DIMENSION, and it is ONE-WAY.Reads text others writeNo findings

    Why it is in this group

    • The name "archive_analytics_custom_dimension" says "archive": 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
    THE ONLY WAY TO RETIRE A CUSTOM DIMENSION, and it is ONE-WAY. GA4 publishes no delete and no un-archive for custom dimensions anywhere in its API — archiving is permanent through every programmatic surface — so this is how a typo'd or duplicate dimension is cleared, and it also frees the slot it was holding against the 50-event-scoped cap. Reports lose the ability to break down by it. CALLED WITHOUT `confirm` IT ARCHIVES NOTHING and instead reports what the dimension actually is, read back from Google — check that against what the user asked for before confirming, because naming the right dimension is the only thing `confirm` cannot prove. Identify it by its parameterName (the event parameter), which list_analytics_definitions lists. Needs edit access on the property.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Archive a GA4 custom dimension
  • archive_analytics_custom_metricTHE ONLY WAY TO RETIRE A GA4 CUSTOM METRIC, and it is ONE-WAY: GA4 publishes no delete and no un-archive for custom metrics anywhere in its API, exactly as for dimensions, so archi…Reads text others writeNo findings

    Why it is in this group

    • The name "archive_analytics_custom_metric" says "archive": 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
    THE ONLY WAY TO RETIRE A GA4 CUSTOM METRIC, and it is ONE-WAY: GA4 publishes no delete and no un-archive for custom metrics anywhere in its API, exactly as for dimensions, so archiving is permanent through every programmatic surface. It frees the slot against the 50-per-property cap, and reports lose the ability to sum or average it. WITHOUT `confirm` IT ARCHIVES NOTHING and instead describes the metric read back from Google — check that against what the user asked for before confirming, because naming the RIGHT metric is the one thing confirm cannot prove. Identify it by parameterName (from list_analytics_definitions), not the report label. A custom DIMENSION of the same name is a DIFFERENT resource and needs archive_analytics_custom_dimension. Needs edit access. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Archive a GA4 custom metric (one-way)
  • archive_meta_lead_formRetire an INSTANT LEAD FORM so it stops collecting — the only way to tidy a Page’s Instant Forms list, because META DOES NOT SUPPORT DELETING A LEAD FORM AT ALL, only archiving it.Reads text others writeNo findings

    Why it is in this group

    • The name "archive_meta_lead_form" says "archive": 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
    Retire an INSTANT LEAD FORM so it stops collecting — the only way to tidy a Page’s Instant Forms list, because META DOES NOT SUPPORT DELETING A LEAD FORM AT ALL, only archiving it. This is REVERSIBLE: pass status:"ACTIVE" to switch an archived form back on. Archiving publishes nothing, spends nothing and DELETES NO LEADS — everything the form already collected stays readable with read_meta_leads. CALL IT WITHOUT confirm FIRST: nothing changes and you get the form’s real name, current status and lead count READ BACK FROM META, so you can show the user exactly which form they are about to retire rather than echoing back an id they may have mistyped; then call again with confirm:true. WARNING WORTH RELAYING BEFORE ARCHIVING: if a live ad still points at this form, its button will open nothing — check the ad first. The new status is READ BACK from Meta after the change, so the summary reports what Meta actually stored and says plainly when the change did NOT take; print it verbatim rather than assuming a successful call means a changed form.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Archive (or restore) a Meta instant form
    • idempotentHint: false
  • archive_openai_ads_audienceRetire a ChatGPT Ads custom audience.Reads text others writeNo findings

    Why it is in this group

    • The name "archive_openai_ads_audience" says "archive": 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
    Retire a ChatGPT Ads custom audience. ARCHIVING IS PERMANENT AND THERE IS NO DELETE TO UNDO IT: an archived audience can never be restored, targeted or bid on again, and any campaign that includes or excludes it loses that audience. Without confirm:true this archives NOTHING and instead reports the audience’s real name, status and matched size read back from ChatGPT Ads, so the cost is visible before it is paid. Pass confirm:true only once that is what the user wants.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Archive a ChatGPT Ads custom audience (permanent)
  • archive_openai_ads_feedArchive a product feed — its products leave every campaign using it.Reads text others writeNo findings

    Why it is in this group

    • The name "archive_openai_ads_feed" says "archive": 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
    Archive a product feed — its products leave every campaign using it. confirm:true required.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Archive a ChatGPT Ads product feed
    • idempotentHint: false
  • archive_openai_ads_lead_formArchive a ChatGPT Ads lead form.Reads text others writeNo findings

    Why it is in this group

    • The name "archive_openai_ads_lead_form" says "archive": 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
    Archive a ChatGPT Ads lead form. Not reversible through the API, and refused by ChatGPT Ads while a PUBLISHED Business Agent references it. confirm:true is required; without it nothing changes and the reply says what would.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Archive a ChatGPT Ads lead form
    • idempotentHint: false
  • associate_linkedin_conversion_campaignsAssociate LinkedIn campaigns with a conversion rule — or detach them with remove:true.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Associate LinkedIn campaigns with a conversion rule — or detach them with remove:true. THIS IS WHAT MAKES A CONVERSION COUNT: LinkedIn only attributes a conversion to campaigns associated with its rule, so an unassociated rule reports zero however many events you stream to it. Associate every campaign the conversion could plausibly have come from. It spends nothing, but on a LIVE campaign it changes what the campaign optimises toward and what its report counts. The result is the PER-CAMPAIGN status LinkedIn returned, not a blanket success — repeat any that failed. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Attach campaigns to a LinkedIn conversion rule
  • boost_linkedin_postBOOST an existing LinkedIn post — the user’s own personal post, or a Company Page post they administer (pass organization) — into an ad, through LinkedIn’s native boost flow.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "boost_linkedin_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    BOOST an existing LinkedIn post — the user’s own personal post, or a Company Page post they administer (pass organization) — into an ad, through LinkedIn’s native boost flow. WITHOUT confirm it is a free PREVIEW: the sponsored account LinkedIn would bill and whether it has a payment method, the objectives LinkedIn offers for the post, LinkedIn’s suggested audience, suggested total budgets, the maximum budget and (with budget) a forecast. Nothing is created. WITH confirm:true and a total budget it CREATES the boost, which LAUNCHES PAID DELIVERY — LinkedIn has no paused or draft state for a boost — so show the user the preview (budget, schedule, goal) and get an explicit yes first. Goals: ENGAGEMENT, BRAND_AWARENESS, WEBSITE_VISIT, VIDEO_VIEW, LEAD_GENERATION (LinkedIn decides which are available per post). Audience: LinkedIn’s suggested one, or your own — locations (urn:li:geo:…), targeting {includeAll, excludeAny} with a location (the preview lists targetingOptions), or a saved audienceId. LinkedIn tools may not be used to discriminate based on personal characteristics like gender, age, race, or ethnicity. Unless the preview says LinkedIn confirmed no political declaration is needed, creating needs notPolitical:true after the user confirms “I confirm this is not political advertising.” A personal-post boost starts today; a Company Page boost may start later. A schedule covers at least 2 UTC days. A button (ctaLabel + ctaUrl) exists only on LEAD_GENERATION. If the boost account has no payment method the reply gives LinkedIn’s billing link and nothing is created. The result is read back from LinkedIn; end_linkedin_boost stops a boost.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Boost a LinkedIn post (preview, or create with confirm)
  • bulk_apple_ads_keywordsCreate or update up to 1,000 Apple Ads keywords or negative keywords in ONE call — how you seed a whole campaign structure from apple_ads_keyword_suggestions, or re-bid a list afte…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create or update up to 1,000 Apple Ads keywords or negative keywords in ONE call — how you seed a whole campaign structure from apple_ads_keyword_suggestions, or re-bid a list after a performance review, instead of one call per keyword. A single request can span DIFFERENT AD GROUPS. op:"create" takes full keyword rows; op:"update" takes ids and can change ONLY bid and status, because a keyword’s text and matchType are immutable after creation — changing either means deleting it and creating a new one. ALLOW-PARTIAL-SUCCESS MATTERS AND APPLE’S DEFAULT IS ALL-OR-NOTHING: with it unset, one bad item (a duplicate text/matchType, say) rejects the ENTIRE batch and nothing is written; pass allowPartialSuccess:true to let the good ones land and read the per-item errors. The reply is the per-item read-back Apple returns — each row carries the stored id, text, matchType and status, so you can see exactly which items landed rather than trusting a 200. Adding keywords into an ENABLED ad group can serve on the next auction and therefore takes confirm:true, the same guard add_apple_ads_keywords uses. Apple caps 1,000 per call and 5,000 per ad group in total. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Bulk create or update Apple Ads keywords
    • idempotentHint: false
  • call_toolRun ANY Hermoso tool by name — including the paid-campaign, analytics and channel-admin tools that are not in this session's starting list — with the same permissions, the same acc…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Run ANY Hermoso tool by name — including the paid-campaign, analytics and channel-admin tools that are not in this session's starting list — with the same permissions, the same account and the same result as calling it directly. Get the exact `name` and its `args` from find_tools first. This is the route on hosts that cannot reload their tool list mid-conversation (claude.ai, ChatGPT): enable_tools switches a group on server-side, but such a host keeps the list it fetched at connect time. Arguments are validated against the tool's own schema and a mistake is answered with the expected parameters, not a silent default. Refused by name, with the way out, when the tool needs a connector this workspace has not made or is withheld by the host's own policy.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Run any Hermoso tool by name
  • cancel_openai_ads_audience_operationCancel an accepted ADD or REMOVE on a ChatGPT Ads custom audience BEFORE its membership changes begin.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Cancel an accepted ADD or REMOVE on a ChatGPT Ads custom audience BEFORE its membership changes begin. ChatGPT Ads refuses once the operation is already applying changes, and that refusal is reported as it came. Free. The reply is the status read back after the cancel, never the request alone.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Cancel a ChatGPT Ads audience membership operation
    • idempotentHint: false
  • cancel_stripe_subscriptionCancel a Stripe subscription: at the end of the current period by default (the customer keeps access until then), or immediately:true to end it now.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Cancel a Stripe subscription: at the end of the current period by default (the customer keeps access until then), or immediately:true to end it now. ALWAYS needs confirm:true, test keys included. The read-back distinguishes the two — a period-end cancel reports the date it will end and the status it keeps until then, an immediate one reports status canceled. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: cancel stripe subscription
    • idempotentHint: false
  • 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
  • clone_applovin_ads_creative_setCopy an AppLovin creative set into another campaign, born PAUSED and read back.Reads text others writeNo findings

    Why it is in this group

    • The name "clone_applovin_ads_creative_set" 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
    Copy an AppLovin creative set into another campaign, born PAUSED and read back. AppLovin only clones a set that already belongs to a campaign. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Copy an AppLovin creative set into another campaign (paused)
  • 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.

      Matched text

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

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Connect a paste-a-key account
  • create_analytics_custom_dimensionRegister an event parameter the site ALREADY SENDS as a custom dimension, so reports can break down by it (plan tier, content category, logged-in state…).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Register an event parameter the site ALREADY SENDS as a custom dimension, so reports can break down by it (plan tier, content category, logged-in state…). TWO THINGS TO TELL THE USER BEFORE CALLING: a GA4 custom dimension CANNOT BE DELETED — only archived — and a property is capped at 50 EVENT-scoped dimensions, so a duplicate or a typo permanently burns one of them. Call list_analytics_definitions first to see what already exists. GET THE TWO NAMES THE RIGHT WAY ROUND: parameterName is the event parameter GA4 is already collecting (e.g. "customer_tier") and displayName is only the label shown in reports — swapping them silently produces a dimension that always reads "(not set)". Registering a dimension is NOT retroactive: it only collects from the moment it is created. The property is the NUMERIC id from list_analytics_properties. Needs the Google Analytics connection to have edit access on the property.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a GA4 custom dimension
  • create_apple_ads_adCreate an Apple Ads ad — the object that shows one creative in one ad group.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an Apple Ads ad — the object that shows one creative in one ad group. REQUIRED: adGroupId, creativeId (from create_apple_ads_creative) and name. CREATED PAUSED ALWAYS, with no override, so it cannot spend until set_apple_ads_status(level:"ad", status:"ENABLED", confirm:true) and its parents are enabled too. THE PLACEMENT RULE, which Apple documents nowhere and which is checked FOR FREE before anything is written: an ad attaches only to a campaign whose placement is APPSTORE_SEARCH_TAB. Apple refuses ads on APPSTORE_SEARCH_RESULTS, APPSTORE_TODAY_TAB and APPSTORE_PRODUCT_PAGES campaigns with AD_CAMPAIGN_SUPPLY_SOURCES_NOT_SUPPORTED — and a SEARCH RESULTS campaign needs no ad and no creative at all, because Apple renders your App Store product page itself, so such a campaign is already complete. The creative must be VALID; a PENDING one is a wait, not a failure. Only ONE ad per ad group can be ENABLED at a time, so enabling this one means pausing whichever ad serves there now. Its creative and ad group are locked at creation: to serve a different creative, create a NEW ad and delete this one, which is Apple’s own instruction so delivery history stays traceable. NO CONFIRMATION IS NEEDED even inside a live ad group, and that is deliberate rather than an oversight: a paused ad cannot serve and does not displace whichever ad is serving there, so gating it would be friction with no safety behind it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create an Apple Ads ad
    • idempotentHint: false
  • create_apple_ads_ad_groupCreate an ad group inside an Apple Ads campaign — this is where the bid and the keywords live.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an ad group inside an Apple Ads campaign — this is where the bid and the keywords live. CREATED PAUSED ALWAYS. REQUIRED: campaignId, name. defaultBid is the most you will pay per tap (decimal string, e.g. "1.50") and applies to every keyword with no bid of its own. startTime is optional here and defaults to now: Apple documents it as optional and then REJECTS the create without it, so Hermoso always supplies one. searchMatch:true opts into Apple’s automated keyword matching, which targets relevant search terms beyond your keyword list. pricingModel defaults to CPT and must match the campaign’s billing event. Keywords cannot be created inline — make the ad group, then call add_apple_ads_keywords. targeting is who and where it reaches: FOR AN APPLE MAPS AD GROUP, targeting.locationGroupIds is the only field that says WHICH of the brand’s shops this ad group promotes, and an ad group with none stops serving rather than reaching everywhere — build the group first with create_apple_ads_location_group. Radius and geo targeting cannot be combined in one ad group and that is refused here rather than delivered on terms nobody chose. Like the campaign it lives in, it stays PAUSED until set_apple_ads_status(status:"ENABLED", confirm:true) arms it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create an Apple Ads ad group
    • idempotentHint: false
  • create_apple_ads_budget_orderA BUDGET ORDER NEEDS A LINE OF CREDIT ORGANIZATION.Reads text others writeNo findings

    Why it is in this group

    • The name "create_apple_ads_budget_order" says "create": a word for a change.
    • The input carries an amount (input.amount) and a currency, so it moves money.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    A BUDGET ORDER NEEDS A LINE OF CREDIT ORGANIZATION. Measured on prod 2026-08-17 against org 19534840 (PAYG): Apple answers 403 “The organization does not have a Line of Credit(LOC). Creating Budget Order is permissible only for LOC Organizations. [FORBIDDEN]” — so on a pay-as-you-go account this whole family is unusable and no request shape fixes it. That is Apple’s account tier, not a Hermoso limit and not something to reconnect over. Create a shared spending ceiling that campaigns can draw from. A BUDGET ORDER SPENDS NOTHING AND CANNOT MAKE ANYTHING SERVE — it is a cap, so creating one can only ever reduce what campaigns may spend, never raise it, which is why it takes no confirmation. Nothing draws from it until you set a campaign’s budgetOrderId. TWO APPLE RULES ARE ENFORCED FOR FREE BEFORE ANYTHING IS SENT, because Apple’s own 400s name the field rather than the rule: startTime must be TOMORROW OR LATER at midnight UTC (today is rejected outright), and exactly ONE ad account may be attached — which is why adAccountId is a single value and defaults to the account this connection is pinned to. Omit endTime for an open-ended budget. Apple requires invoice contact details, so primaryBuyerEmail and billingEmail are required and are never invented. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create an Apple Ads budget order
    • idempotentHint: false
  • create_apple_ads_campaignCreate an Apple Ads (Apple Search Ads) campaign promoting an iOS app on the App Store.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an Apple Ads (Apple Search Ads) campaign promoting an iOS app on the App Store. CREATED PAUSED ALWAYS — there is no override, so nothing can spend until you separately call set_apple_ads_status(status:"ENABLED", confirm:true). REQUIRED: name (unique across the whole Apple Ads ORGANIZATION, not just this ad account — Apple 400s DUPLICATE_CAMPAIGN_NAME, and the org can contain campaigns you cannot see), appAdamId (the App Store id, e.g. "6752439949" — read it off any existing campaign’s promotedObjectId), dailyBudget (decimal string, e.g. "25.00"), countries (ISO 3166-1 alpha-2). placements defaults to APPSTORE_SEARCH_RESULTS, the classic Search Ads placement, which needs NO creative — Apple renders your App Store product page. bidStrategyType defaults to MANUAL_CPT (a fixed price per tap); MAX_CONVERSIONS optimizes for installs and is the only strategy that takes a campaign-level bid, where it means the target CPA. A MANUAL_CPT per-tap bid does NOT belong here: Apple refuses it at campaign level with an error naming a field you never sent — pass defaultBid to create_apple_ads_ad_group instead. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create an Apple Ads campaign
    • idempotentHint: false
  • create_apple_ads_creativeCreate an Apple Ads creative — what a person sees before and after tapping the ad.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an Apple Ads creative — what a person sees before and after tapping the ad. Pick creativeType: DEFAULT_PRODUCT_PAGE renders the app’s standard App Store listing and needs only adamId; CUSTOM_PRODUCT_PAGE renders a custom page built in App Store Connect and needs adamId AND productPageId (from list_apple_ads_product_pages); LOCAL_ADS_SEARCH_CREATIVE is Apple Maps and needs mapsBrandId (from list_apple_ads_brands) plus assetIds you uploaded with upload_apple_ads_asset — that is the one creative type where YOUR OWN IMAGE is the ad. YOU CANNOT SUPPLY YOUR OWN IMAGERY FOR AN APP STORE AD — Apple renders the pre-tap ad from the product page itself, so the way to change how an App Store ad LOOKS is to edit that page (or build a Custom Product Page) in App Store Connect; say that plainly rather than looking for a parameter that does not exist. The destination type is derived from the creative type and never asked for. A creative SPENDS NOTHING and has no status of its own: it serves only once an ad references it and that ad, its ad group and its campaign are all ENABLED. Apple validates asynchronously, so a fresh creative is usually PENDING for a moment and an ad may only reference a VALID one — that is a wait, not a failure. Type and destination are immutable afterwards. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create an Apple Ads creative
    • idempotentHint: false
  • create_applovin_ads_campaignCreate an AppLovin Ads campaign, read back PAUSED: AppLovin ignores status on create, so Hermoso pauses it straight after.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an AppLovin Ads campaign, read back PAUSED: AppLovin ignores status on create, so Hermoso pauses it straight after. A WEB campaign needs name, websiteUrl, countries, dailyBudget, goalType and goalValue (CPE also eventTarget; CHK_ROAS also roasDayTarget). APP campaigns add platform, packageName, trackingMethod, clickUrl, impressionUrl (iOS: itunesId). Every field is checked before AppLovin is called. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create an AppLovin Ads campaign (paused)
  • create_applovin_ads_creative_setCreate an AppLovin creative set from uploaded asset ids, born PAUSED, optionally inside a campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an AppLovin creative set from uploaded asset ids, born PAUSED, optionally inside a campaign. It must hold EITHER an HTML playable OR a portrait image (IMG_INTER_P) plus a video; Hermoso checks that against AppLovin’s own asset types before creating it. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create an AppLovin creative set (paused)
  • create_google_ads_adCreate the actual AD inside a Google Ads ad group — this is the object that carries the creative; a campaign or ad group alone shows nothing.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the actual AD inside a Google Ads ad group — this is the object that carries the creative; a campaign or ad group alone shows nothing. On a SEARCH campaign it builds a RESPONSIVE SEARCH AD: 3–15 headlines (≤30 chars), 2–4 descriptions (≤90 chars), at least one finalUrl, optional path1/path2. On a DISPLAY campaign it builds a RESPONSIVE DISPLAY AD: headlines, longHeadline, descriptions, businessName plus BOTH a landscape (1.91:1) and a square (1:1) image asset from upload_google_ads_asset. The right format is chosen from the campaign's channel. Created PAUSED and read back from Google. If the parent campaign is already LIVE (ENABLED), creating this ENABLED starts REAL AD SPEND immediately — show the user what would begin serving, get an explicit yes, then pass confirm:true. Leaving it PAUSED never needs confirmation.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Ads ad
  • create_google_ads_ad_groupAdd an ad group to an EXISTING Google Ads campaign — the level between a campaign and its ads.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add an ad group to an EXISTING Google Ads campaign — the level between a campaign and its ads. Google requires it: a campaign with no ad group cannot serve. Optionally build its ad and keywords in the same ATOMIC call. The ad-group type is taken from the campaign's channel automatically. Created PAUSED and read back from Google before you are told it exists. If the parent campaign is already LIVE (ENABLED), creating this ENABLED starts REAL AD SPEND immediately — show the user what would begin serving, get an explicit yes, then pass confirm:true. Leaving it PAUSED never needs confirmation.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add an ad group to a Google Ads campaign
  • create_google_ads_campaignBuild a campaign on a connected Google Ads account.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Build a campaign on a connected Google Ads account. ALWAYS created PAUSED — it spends NOTHING until you enable it with set_google_ads_status(confirm:true). Google's object graph is campaign -> ad group -> ad, so a campaign ON ITS OWN CANNOT SERVE AN IMPRESSION: pass adGroup{name, ad{headlines,descriptions,finalUrls}, keywords[]} and this builds budget + campaign + location/language targeting + ad group + ad + keywords in ONE ATOMIC operation (if any part is rejected, nothing at all is created — no half-built campaign to clean up). Also here: bidding strategy, locations by NAME ("United States", "Toronto" — resolved for you), languages, and start/end dates. Google requires 3–15 headlines (≤30 chars) and 2–4 descriptions (≤90 chars) on a search ad. Everything is READ BACK from Google before you are told it exists; print the returned note verbatim, and if it says the campaign cannot serve yet, say that rather than calling it a finished ad.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Build a Google Ads campaign (paused)
  • create_google_ads_demand_gen_campaignBuild a Google DEMAND GEN campaign — video ads on YouTube Shorts, in-feed and in-stream (plus Discover, Gmail, Display, Maps if you pick them) — as ONE atomic, PAUSED build: budget…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Build a Google DEMAND GEN campaign — video ads on YouTube Shorts, in-feed and in-stream (plus Discover, Gmail, Display, Maps if you pick them) — as ONE atomic, PAUSED build: budget, campaign, ad group with channel controls, locations/languages, optional audiences, and a video ad. ad needs videoAssets (from upload_google_ads_video) or youtubeVideoIds, a square logo (logoImage or logoAssets), finalUrl, businessName ≤25, 1–5 headlines, longHeadlines, descriptions. Google sets a minimum daily budget (it names it if you go under). Read back; turn it on with set_google_ads_status(confirm:true) only after the user approves.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Demand Gen video campaign (YouTube Shorts, in-feed, in-stream)
  • create_google_ads_performance_max_campaignBuild a PERFORMANCE MAX campaign — Google’s cross-surface campaign type (Search, YouTube, Display, Discover, Gmail, Maps).Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

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

      Matched text

      description ends: "...efused by name, so a caller can never believe they narrowed it when they did not."

      What this check looks for
    Description, as the server wrote it
    Build a PERFORMANCE MAX campaign — Google’s cross-surface campaign type (Search, YouTube, Display, Discover, Gmail, Maps). ALWAYS created PAUSED; it spends NOTHING until you enable it with set_google_ads_status(confirm:true). PMax has NO manual bidding and NO keywords: it bids only on conversions, so the account MUST already have a conversion action — check with list_google_ads_conversion_actions, because this REFUSES rather than build a campaign that cannot optimise. Creative lives in an ASSET GROUP, and Google’s minimums are enforced before anything is sent: 3–15 headlines (≤30 chars), 1–5 longHeadlines (≤90), 2–5 descriptions (≤90), one businessName (≤25), at least one LOGO (1:1), one MARKETING_IMAGE (1.91:1) and one SQUARE_MARKETING_IMAGE (1:1) — upload the images with upload_google_ads_asset first and pass their asset resource names. A YouTube video is optional (Google generates one from the asset group if you omit it). Brand guidelines: since Google Ads API v21 they are ON by default for new PMax campaigns, which means the businessName and LOGO assets are linked to the CAMPAIGN (CampaignAsset), not to the asset group — Hermoso does that for you. Leave brandGuidelinesEnabled alone unless the user wants the older asset-group layout, and pass false for that. Budget, campaign, location/language targeting, the asset group and every asset link go up in ONE ATOMIC operation — if any part is rejected, nothing at all is created — and the whole tree is READ BACK from Google before you are told it exists. Print the returned note verbatim; if it says the campaign cannot serve, say that instead of calling it finished. RETAIL/SHOPPING: pass merchantCenterId (from list_merchant_accounts) to make it a Shopping-feed Performance Max — it then advertises the WHOLE feed (one root listing group); feedLabel narrows it to a single feed. Partitioning the feed by brand/category/custom label is NOT built and is refused by name, so a caller can never believe they narrowed it when they did not.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Ads Performance Max campaign
  • create_hubspot_contactCreate a contact in the brand's HubSpot by email, or UPDATE the contact that already has that email — HubSpot's duplicate answer carries the existing id, so this is an UPSERT and n…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a contact in the brand's HubSpot by email, or UPDATE the contact that already has that email — HubSpot's duplicate answer carries the existing id, so this is an UPSERT and never makes a twin. Optional firstname, lastname, phone, company, website, lifecyclestage, hs_lead_status, hubspotOwnerId (the sales rep to assign it to — an owner id from list_hubspot_owners), plus any other writable contact property in `properties` (by internal name). The contact is READ BACK after the write; the reply says created or updated. Free. Needs HubSpot connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create or update a HubSpot contact
    • idempotentHint: false
  • create_linkedin_ads_campaignCreate a LinkedIn campaign inside an existing campaign group.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a LinkedIn campaign inside an existing campaign group. Created DRAFT — it spends NOTHING until activated with set_linkedin_ads_status(confirm:true) — and a campaign on its own carries no creative, so it cannot serve an impression. Budget amounts are in the ad account’s currency; tell the user that LinkedIn may spend UP TO 150% of a daily budget on a high-opportunity day before they pick a number. Two LinkedIn behaviours to repeat rather than hide: on manual, target-cost or cost-cap bidding a unitCost of 0 means the campaign never delivers, and LinkedIn DEFERS some validation on DRAFT objects, so a clean create can still fail at activation — never promise it will run. TARGETING IS MANDATORY on LinkedIn — a campaign with no audience is refused outright — so pass locations (and optionally include/exclude facets like titles, industries, seniorities or staffCountRanges), or a raw targetingCriteria. Resolve every targeting value with search_linkedin_ads_targeting first: they are opaque URNs and MUST NOT be invented. LinkedIn’s own enums for type, objectiveType and costType are passed straight through, and LinkedIn’s refusal is surfaced verbatim if one is wrong. Read back before you are told it exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a LinkedIn campaign (draft)
  • create_linkedin_ads_creativeCreate the AD ITSELF on LinkedIn — a CREATIVE inside an existing campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the AD ITSELF on LinkedIn — a CREATIVE inside an existing campaign. A LinkedIn campaign holds no copy and no visual, so until this runs the campaign CANNOT show an impression no matter what its status says; say that rather than calling a campaign "live". Two ways in: pass postUrn to sponsor a post that already exists (LinkedIn’s "boost this post"), or pass text and/or imageUrl / videoUrl / documentUrl (a PDF/PPTX/DOCX document ad) to author a DIRECT SPONSORED CONTENT post — a real post by a company Page the user administers that is NEVER shown on the Page’s feed and exists only as an ad. Created DRAFT: it spends nothing until you activate it with set_linkedin_ads_status(level:"creative", status:"ACTIVE", confirm:true). Creating it ACTIVE under an already-live campaign starts REAL AD SPEND on the very next auction and therefore requires confirm:true. LEAD GEN ADS: under a LEAD_GENERATION campaign pass leadFormId (create_linkedin_lead_form makes one) — LinkedIn requires it there. The whole tree — group, campaign and every creative — is read back from LinkedIn before you are told anything exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a LinkedIn ad (creative, draft)
  • create_meta_adBuild a complete, ready-to-run Meta ad: campaign -> ad set (FULL targeting + budget + schedule + bidding) -> creative -> ad(s), ALL created PAUSED — it spends NOTHING until you act…Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

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

      Matched text

      description ends: "...(Meta refuses to boost a post carrying licensed music or an interactive element)."

      What this check looks for
    Description, as the server wrote it
    Build a complete, ready-to-run Meta ad: campaign -> ad set (FULL targeting + budget + schedule + bidding) -> creative -> ad(s), ALL created PAUSED — it spends NOTHING until you activate the campaign with set_meta_campaign_status(confirm:true). This is the "create a campaign and put the ads on it" path. IMAGE, VIDEO (uploaded, transcoded and thumbnailed for you) and CAROUSEL (format:"carousel", 2–10 cards each with its own headline/description/link) all work. Targeting is the `targeting` object: geo down to cities with a radius, age, gender, interests, behaviours, custom audiences and lookalikes, languages, placements, devices and OS. For a conversion objective pass pixelId + conversionEvent and the ad set optimizes for that conversion. Schedule with startTime/endTime + dayparting; bid with bidStrategy + bidAmountUsd/minRoas; use lifetimeBudgetUsd (with endTime) for a fixed flight. Attach to an existing campaign with campaignId or an existing ad set with adSetId. Everything is READ BACK from Meta before you are told it exists — print the returned summary verbatim (it carries 24-hour Meta PREVIEW LINKS for the first ad — hand them to the user; preview_meta_ad renders any ad in any placement). Needs ads-management on the connected account. BOOST AN EXISTING POST: pass boostPostId — a post you have ALREADY published (numeric id, the <pageId>_<postId> form, or a permalink) — INSTEAD of any creative, and the ad promotes that post exactly as published, comments and all. The post keeps its own caption and media, so message/headline/description do NOT apply. AN INSTAGRAM BOOST TAKES A BUTTON: pass cta (e.g. SHOP_NOW, SIGN_UP) and link and the boosted post carries that button to that link; a FACEBOOK post boost takes no button and keeps the post as published. Anything not applied is named in the reply, and the reply reads back from Meta which post the ad promotes. Targeting, budget, schedule, bidding and PAUSED-by-default all work identically. AN INSTAGRAM POST NEEDS boostTarget:"instagram" — IG media ids and Facebook post ids are both bare digits, so Hermoso never guesses, and a Facebook boost given an IG media id is refused. Instagram eligibility is checked for free before anything is created (Meta refuses to boost a post carrying licensed music or an interactive element).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Build a full Meta ad (campaign -> ad set -> ad, paused)
  • create_meta_adsetCreate an AD SET on an EXISTING Meta campaign — the level that holds the audience, budget, schedule and bidding.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an AD SET on an EXISTING Meta campaign — the level that holds the audience, budget, schedule and bidding. Use it to hang SEVERAL ad sets off ONE campaign, which is how you actually test audiences on Meta (one ad set per audience, same campaign, same creative). Takes the same full `targeting`, pixelId/conversionEvent, bidStrategy, schedule and budget fields as create_meta_ad. Created PAUSED and read back from Meta. It has NO ads until you call create_meta_ad(adSetId:…). For CATALOG / ADVANTAGE+ CATALOG ads (DPA), pass productSetId here — the campaign carries productCatalogId and the ad set narrows it to a product set.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Meta ad set (audience + budget + schedule)
  • create_meta_campaignUse this when the user asks to create a new Facebook or Instagram ad campaign on their own ad account.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Use this when the user asks to create a new Facebook or Instagram ad campaign on their own ad account. Create a campaign on a connected Meta ad account. Always created PAUSED — it spends NOTHING until you activate it with set_meta_campaign_status(confirm:true). Optionally set a dailyBudgetUsd (an amount in the AD ACCOUNT’s currency, e.g. CAD on a CAD account — the name is historical, it is not USD). Pass adAccountId + an objective. Needs ads-management permission on the connected account. CATALOG / ADVANTAGE+ CATALOG ADS (also called DPA or dynamic product ads) ARE SUPPORTED: pass productCatalogId here and productSetId on the ad set, and the campaign is catalog-backed. Say YES when a user asks for catalog, Advantage+ catalog, DPA or feed-driven ads.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Meta ad campaign (paused)
  • create_meta_pixelCreate a META PIXEL on one of the brand’s ad accounts, so their ads can optimise for real website conversions instead of link clicks and so website retargeting audiences become pos…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a META PIXEL on one of the brand’s ad accounts, so their ads can optimise for real website conversions instead of link clicks and so website retargeting audiences become possible. A pixel is a DEFINITION: it cannot serve, cannot spend, and RECORDS NOTHING until its snippet is installed on the site — the reply hands back that snippet and says so. TWO THINGS TO SAY OUT LOUD BEFORE CALLING IT: Meta allows exactly ONE pixel per ad account (a second attempt is refused and Hermoso will name the one that already exists — so call list_meta_pixels first), and Meta publishes NO WAY TO DELETE a pixel, so this is permanent. Creating it spends nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Meta Pixel
    • idempotentHint: false
  • create_microsoft_ads_adCreate the actual AD inside a Microsoft Advertising ad group — this is the object that carries the creative; a campaign or ad group alone shows nothing.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the actual AD inside a Microsoft Advertising ad group — this is the object that carries the creative; a campaign or ad group alone shows nothing. It builds a RESPONSIVE SEARCH AD: 3–15 headlines (≤30 chars), 2–4 descriptions (≤90 chars), at least one finalUrl, optional path1/path2. Expanded text ads CANNOT be created any more — Microsoft rejects them outright. Created Paused; if the parent ad group and campaign are both Active, creating this Active starts REAL AD SPEND immediately — get an explicit yes and pass confirm:true. Read back from Microsoft, including its editorial status, before you are told it exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Microsoft responsive search ad
  • create_microsoft_ads_ad_groupAdd an ad group to an existing Microsoft Advertising campaign — optionally with its responsive search ad and keywords in the same call.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add an ad group to an existing Microsoft Advertising campaign — optionally with its responsive search ad and keywords in the same call. Created Paused by default. If the parent campaign is already LIVE (Active), creating this ad group Active starts REAL AD SPEND on the next auction, exactly like activating it — show the user what would begin serving, get an explicit yes, then pass confirm:true. Leaving it Paused never needs confirmation. Read back from Microsoft before you are told it exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add a Microsoft Advertising ad group
  • create_microsoft_ads_campaignBuild a campaign on a connected Microsoft Advertising (Bing Ads) account.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • High

      The description contains "without telling the user", an instruction to keep something from the user.

      Matched text

      description: "...nds nothing; it is NOT safe to activate without telling the user, so relay the warning. Nothing is creat..."

      What this check looks for
    Description, as the server wrote it
    Build a campaign on a connected Microsoft Advertising (Bing Ads) account. ALWAYS created Paused — it spends NOTHING until you activate it with set_microsoft_ads_status(confirm:true). Microsoft’s object graph is campaign -> ad group -> responsive search ad -> keywords, so a campaign ON ITS OWN CANNOT SERVE AN IMPRESSION: pass adGroup{name, ad{headlines,descriptions,finalUrls}, keywords[]} and this builds the whole tree. Microsoft has NO atomic multi-object write, so the levels are created in sequence and the campaign is DELETED again if anything below it is rejected — you never inherit a half-built campaign. Microsoft requires 3–15 headlines (≤30 chars) and 2–4 descriptions (≤90 chars); expanded text ads can no longer be created at all. dailyBudget is in the ACCOUNT’S currency, not necessarily USD. LOCATION TARGETING: pass locations[] (country / region / city names, ISO country codes, or numeric Microsoft location ids). A Microsoft campaign has NO geo targeting unless it is set, and Microsoft does not require any — so if you pass none, the campaign IS CREATED and serves WORLDWIDE (Microsoft’s own default), and the returned note says so loudly. That is safe at this stage because the campaign is Paused and spends nothing; it is NOT safe to activate without telling the user, so relay the warning. Nothing is created when a location you DID name cannot be resolved (call microsoft_ads_geo_search to disambiguate, then pass the id). Pass worldwide:true to record that everywhere was deliberate and suppress the nudge. The locations are written and READ BACK inside the same rollback as the rest of the tree, so a campaign is either targeted as asked or does not exist. Everything is READ BACK from Microsoft before you are told it exists; print the returned note verbatim, and if it says the campaign cannot serve yet, say that rather than calling it a finished ad.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Build a Microsoft Advertising campaign (paused)
  • create_microsoft_ads_image_adTurn a Hermoso render, or the user’s own picture (any https URL, or a file via upload_file), into a Microsoft Advertising IMAGE ad: a responsive ad on the Microsoft Audience Networ…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Turn a Hermoso render, or the user’s own picture (any https URL, or a file via upload_file), into a Microsoft Advertising IMAGE ad: a responsive ad on the Microsoft Audience Network (an Audience campaign) or a multimedia ad on Search. One imageUrl is centre-cropped to the 1.91:1 and 1:1 pictures Microsoft requires (or pass images{landscape, square, logo}), uploaded, and the ad is built PAUSED and read back with its pictures. businessName ≤25, 1–15 headlines ≤30, 1–5 longHeadlines ≤90, 1–5 descriptions ≤90. Search multimedia ads get a callToAction button (default LearnMore); Audience ads have none. videoIds attach videos from upload_microsoft_ads_video. Creating it Active in a live ad group needs confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Microsoft image ad from a render (paused)
  • create_openai_ads_adCreate the actual AD inside a ChatGPT Ads ad group — the object that carries the creative; a campaign or ad group alone shows nothing at all.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the actual AD inside a ChatGPT Ads ad group — the object that carries the creative; a campaign or ad group alone shows nothing at all. The creative is a TEXT + IMAGE CARD: a title of 3–50 characters, body copy of 100 characters maximum, one landing page URL and one still image. THERE IS NO VIDEO FORMAT ON THIS PLATFORM — a video URL is refused outright, so never offer one. Created paused; creating it active inside a live ad group starts REAL AD SPEND, so that needs confirm:true. OpenAI REVIEWS every ad (usually a few minutes) and the ad is read back with its review status: until that says approved the ad CANNOT show, so report the review status rather than calling it live. The landing page is also checked against robots.txt for OAI-AdsBot / OAI-SearchBot blocks — a page that blocks those agents cannot run ChatGPT ads at all, and the note says so. OpenAI creative enhancements (on by default for self-serve campaigns since 2026-10-30) may serve this copy rewritten, translated or on another page of the same site; the switch is in ChatGPT Ads Manager (account and campaign) and the API does not expose it, so never promise the exact words will run.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a ChatGPT Ads ad
  • create_openai_ads_ad_groupAdd an ad group to an existing ChatGPT Ads campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add an ad group to an existing ChatGPT Ads campaign. Created PAUSED by default. Bidding: leave it out and the ad group gets INTELLIGENT BIDDING (OpenAI’s renamed “Maximize results”: maximize_clicks / maximize_conversions, no amount; needs a daily campaign budget). From 2026-11-09: bidStrategy target_cpa + targetCpa (conversions campaigns) or target_cpc + targetCpc (clicks campaigns). A fixed maxBid is Max Bid / Max CPC, deprecated and retired by ChatGPT Ads on 2027-01-01. The reply says if ChatGPT Ads stored a different bid than was sent. Its context hints ARE the targeting on this platform: up to 2,000 natural-language descriptions of the conversations, topics or questions where this offering is relevant — not exact-match keywords, and no guarantee of delivery. Write many distinct ones rather than variations of the same phrase. If the parent campaign is already LIVE (active), creating this ad group active starts REAL AD SPEND on the next auction, exactly like activating it — show the user what would begin serving, get an explicit yes, then pass confirm:true. Leaving it paused never needs confirmation. The whole tree is READ BACK from OpenAI before you are told it exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add a ChatGPT Ads ad group
  • create_openai_ads_business_agentDraft a ChatGPT Ads BUSINESS AGENT: name, instructions (the system prompt real users will experience — write it as the brand), optional description, privacy policy URL, conversatio…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Draft a ChatGPT Ads BUSINESS AGENT: name, instructions (the system prompt real users will experience — write it as the brand), optional description, privacy policy URL, conversation starters, product feed ids, connector ids, tool ids (list_openai_ads_business_agent_tools) and a published lead form id. Pass businessAgentId to REPLACE an existing agent’s configuration (it becomes a pending change). Nothing is served until publish_openai_ads_business_agent. Needs ChatGPT Ads connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create or replace a ChatGPT Ads Business Agent
    • idempotentHint: false
  • create_openai_ads_campaignBuild a campaign on the connected ChatGPT Ads account — the ads that appear below ChatGPT answers.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Build a campaign on the connected ChatGPT Ads account — the ads that appear below ChatGPT answers. ALWAYS created PAUSED at every level, with no override: it spends NOTHING until you activate it with set_openai_ads_status(confirm:true). The object graph is campaign -> ad group -> ad, and a campaign ON ITS OWN CANNOT SERVE AN IMPRESSION, so pass adGroup{name, contextHints, ad{creative}} and this builds the whole tree. BIDDING: leave the ad group’s bid out and it gets INTELLIGENT BIDDING (maximize_clicks / maximize_conversions, OpenAI’s renamed “Maximize results”), or a cost target (target_cpa + targetCpa, target_cpc + targetCpc); a fixed maxBid (Max Bid / Max CPC) is deprecated and ChatGPT Ads retires it on 2027-01-01. PRODUCT-FEED CAMPAIGNS: pass productFeedId, and adGroup.productSet to choose which products. THE CREATIVE IS A TEXT + IMAGE CARD AND NOTHING ELSE — title 3–50 characters, body 100 maximum, one landing page, one still image. THERE IS NO VIDEO ON THIS CHANNEL: never offer a video ad here, and if the brand only has video, pull a frame from it first. TARGETING IS SEMANTIC: context hints are natural-language descriptions of the conversations where this ad belongs (up to 2,000 per ad group). Geo (countries / locationIds) and PLATFORMS (which of the iOS app, Android app and web the ad runs on) are the only other dimensions — leave platforms out to run on all three. They guide matching, they are NOT exact-match keywords, and they do not guarantee delivery. OpenAI’s own guidance is BREADTH — many genuinely distinct hints and many distinct title/body angles beat one message repeated. The whole tree is VALIDATED before the first write; if a level below the campaign is still rejected, the campaign is left PAUSED (spending nothing) and the note says exactly what exists. Everything is READ BACK from OpenAI before you are told it exists: print the returned note verbatim, and if it says the campaign cannot serve yet, say that rather than calling it a finished ad.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Build a ChatGPT Ads campaign (paused)
  • create_pinterest_ads_adCreate the actual AD inside a Pinterest ad group — this is the object that carries the creative; a campaign or ad group alone shows nothing.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the actual AD inside a Pinterest ad group — this is the object that carries the creative; a campaign or ad group alone shows nothing. A Pinterest ad PROMOTES AN EXISTING PIN, so pass pinId. Created PAUSED; if the parent ad group and campaign are both ACTIVE, creating this ACTIVE starts REAL AD SPEND immediately — get an explicit yes and pass confirm:true. Pinterest reviews ads: the read-back reports the review status and any rejection reason, and a REJECTED ad never serves until it is fixed.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Pinterest ad
  • create_pinterest_ads_ad_groupAdd an ad group to an existing Pinterest campaign — optionally with its ad in the same call.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add an ad group to an existing Pinterest campaign — optionally with its ad in the same call. Created PAUSED by default. Pinterest REQUIRES every ad group to target at least one place, so targetingSpec must carry a GEO array or a LOCATION object. If the parent campaign is already LIVE (ACTIVE), creating this ad group ACTIVE starts REAL AD SPEND on the next auction, exactly like activating it — show the user what would begin serving, get an explicit yes, then pass confirm:true. Leaving it paused never needs confirmation. Read back from Pinterest before you are told it exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add a Pinterest ad group
  • create_pinterest_ads_campaignBuild a campaign on a connected Pinterest ad account.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Build a campaign on a connected Pinterest ad account. ALWAYS created PAUSED — worth knowing that Pinterest’s own API defaults new campaigns to ACTIVE, so this deliberately overrides that; it spends NOTHING until you activate it with set_pinterest_ads_status(confirm:true). Pinterest’s object graph is campaign -> ad group -> ad, and an ad PROMOTES AN EXISTING PIN, so a campaign ON ITS OWN CANNOT SERVE AN IMPRESSION: pass adGroup{name, targetingSpec, ad{pinId}} and this builds the whole tree. Pinterest has NO atomic multi-object write, so the levels are created in sequence and the campaign is ARCHIVED again if anything below it is rejected (Pinterest has no delete) — you never inherit a half-built campaign. Budgets are ordinary amounts in the ad account’s currency; the micro-currency conversion Pinterest requires is handled for you. Every ad group must target at least one place. Everything is READ BACK from Pinterest before you are told it exists; print the returned note verbatim, and if it says the campaign cannot serve yet, say that rather than calling it a finished ad.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Build a Pinterest ad campaign (paused)
  • create_pinterest_ads_product_group_promotionAttach catalog PRODUCT GROUPS to a Pinterest Shopping (CATALOG_SALES) ad group — this is what makes a Shopping ad group serve products.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Attach catalog PRODUCT GROUPS to a Pinterest Shopping (CATALOG_SALES) ad group — this is what makes a Shopping ad group serve products. Created PAUSED by default; creating them ACTIVE under a LIVE campaign and ad group starts real spend, so that needs an explicit yes and confirm:true. Optional bid (ad account currency), included:false to exclude a group, creativeType, cta, trackingUrl. Read back from Pinterest. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Promote catalog product groups in a Pinterest ad group
  • create_reddit_ads_adCreate the ad itself — the object that binds a POST (the creative) to an AD GROUP (the targeting and budget).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the ad itself — the object that binds a POST (the creative) to an AD GROUP (the targeting and budget). Create the post first with create_reddit_ads_post and pass its id as postId; without a post there is nothing to show. A CATALOG ad (an ad group with a productSetId under a SALES useCatalog campaign) has no post: pass shoppingCreative (headline, callToAction, optional destinationUrl, secondLineCta PRICE/DESCRIPTION, dpaCarouselMode, heroCard for a collection ad) plus redditProfileId, and optionally up to 6 productIds to feature. ALWAYS created PAUSED, and Reddit additionally has to APPROVE it, so a fresh ad reports effective status PENDING_APPROVAL — report that rather than calling it live. UTMs: clickUrlQueryParameters ({"utm_source":"reddit","utm_campaign":"{{CAMPAIGN_ID}}"} — Reddit macros allowed, ≤14) are appended to the click URL by Reddit — Reddit allows that list only on some campaigns and otherwise refuses “URL Parameters cannot be added to this campaign”; then write the parameters into clickUrl itself. PREVIEW: previewDays (1-30) asks Reddit for a preview link, read back as previewUrl (the very first time, Reddit wants the test URL generated once in Ads Manager — the reply says so). GOTCHA: a TEXT ("free form") post’s ad may not carry clickUrl at all — Reddit refuses it. The click destination for image and link ads lives on the POST’s media destinationUrl, not here.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Reddit ad
    • idempotentHint: false
  • create_reddit_ads_ad_groupCreate an ad group under an existing Reddit campaign — this is the tier that holds the budget, the bid and ALL the targeting.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an ad group under an existing Reddit campaign — this is the tier that holds the budget, the bid and ALL the targeting. ALWAYS created PAUSED; it spends nothing until set_reddit_ads_status(confirm:true). Reddit refuses the create unless it has: a bidType, a bidStrategy, a startTime, a budget with its goalType, a bidAmount whenever the bid type is a paid rate, and a conversion pixel (resolved automatically when the ad account has exactly one). THE BID TYPE MUST FIT THE CAMPAIGN’S OBJECTIVE — a CLICKS campaign takes CPC and refuses CPM, a SALES campaign (Reddit’s new name for conversions) asked for CPM; Reddit’s error says which. Money is ordinary amounts in the ad account’s currency (micro-currency is handled for you). Resolve community names and interest ids with search_reddit_ads_targeting first, and consider reddit_ads_forecast + reddit_ads_bid_suggestion before committing. Everything is READ BACK from Reddit before you are told it exists — print the returned note verbatim.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Reddit ad group (targeting, budget, bidding, schedule)
    • idempotentHint: false
  • create_reddit_ads_campaignCreate the top tier of a Reddit ad — the campaign, which sets the OBJECTIVE everything under it optimises toward and (optionally) a lifetime spend cap.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the top tier of a Reddit ad — the campaign, which sets the OBJECTIVE everything under it optimises toward and (optionally) a lifetime spend cap. ALWAYS created PAUSED, with no override; it spends nothing until set_reddit_ads_status(confirm:true). Pick the objective deliberately, because the ad group’s bid type has to match it and it cannot be changed afterwards: CLICKS is Reddit’s name for traffic to a website (there is no TRAFFIC), CONVERSIONS optimises toward pixel events and needs a working pixel, LEAD_GENERATION optimises toward LEAD / SIGN_UP pixel events (Reddit retired onsite lead forms), IMPRESSIONS and VIDEO_VIEWABLE_IMPRESSIONS buy reach, APP_INSTALLS and CATALOG_SALES are for apps and product feeds. Reddit’s NEW names (since 2026-09-21) are accepted too: BRAND_AWARENESS (= IMPRESSIONS / VIDEO_VIEWABLE_IMPRESSIONS) and SALES (= CONVERSIONS, or CATALOG_SALES when useCatalog is true); Reddit rolls them out per account, so an account without them yet answers with Reddit’s own refusal — use the legacy name then. A campaign on its own can never serve: create an ad group under it, then an ad pointing at a post. The result is read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Reddit campaign
    • idempotentHint: false
  • create_reddit_ads_max_campaignBuild a Reddit MAX campaign in one call: an automated campaign (campaign budget optimization, automatic bidding), its one automated ad group (seed targeting) and its one template a…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Build a Reddit MAX campaign in one call: an automated campaign (campaign budget optimization, automatic bidding), its one automated ad group (seed targeting) and its one template ad, from which Reddit GENERATES the ads out of your creative-library assets. ALL CREATED PAUSED: nothing spends until the user approves and set_reddit_ads_status(confirm:true) runs on the campaign, the ad group and the template ad. Before calling, upload at least 3 HEADLINE and 2 IMAGE or VIDEO assets with upload_reddit_ads_assets (5 to 45 in total, all ACTIVE) and pass their ids, and take redditProfileId from list_reddit_ads_profiles. Every asset is read and counted by type before anything is created. Objectives: CLICKS, SALES, LEAD_GENERATION, APP_INSTALLS (and the legacy CONVERSIONS, Reddit’s old name for SALES). spendCap puts a lifetime ceiling on a DAILY_SPEND campaign. Bid strategies: BIDLESS (default, Lowest Cost), TARGET_CPX (Target Cost, needs bidAmount), MAXIMIZE_VOLUME (Cost Cap — Reddit retires it for every Max objective except CLICKS on 2027-02-10). MAXIMIZE_VALUE and TARGET_ROAS cannot be set: Reddit exposes them only as read-only values. If a later step fails, what this call created is ARCHIVED and the reply says so. The reply says whether Reddit finished generating the ads (materialization); poll with get_reddit_ads_max_template.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Build a Reddit Max campaign (paused)
    • idempotentHint: false
  • create_reddit_ads_product_feedHave Reddit FETCH your product file (CSV/TSV/XML at a public https:// or FTP/SFTP address — a Shopify, Google Merchant or WooCommerce product feed works) into a catalog, once or on…Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...d they must be of different types. Feed credentials (username/password) go to Reddit and ar..."

      What this check looks for
    Description, as the server wrote it
    Have Reddit FETCH your product file (CSV/TSV/XML at a public https:// or FTP/SFTP address — a Shopify, Google Merchant or WooCommerce product feed works) into a catalog, once or on a schedule. mode REPLACE (default) treats the file as the whole catalog, so products missing from it are removed; UPDATE only adds and changes. A catalog takes at most TWO feeds and they must be of different types. Feed credentials (username/password) go to Reddit and are never echoed back. Spends nothing. Check how the import went with list_reddit_ads_catalogs(catalogId) then get_reddit_ads_catalog_import. Read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Link a product feed to a Reddit catalog
    • idempotentHint: false
  • create_snapchat_ads_adCreate the Snapchat ad itself, inside an ad squad.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the Snapchat ad itself, inside an ad squad. CREATED PAUSED with no override. THE CREATIVE COMES FROM upload_snapchat_ads_creative: pass the creativeId it returns. AN AD POINTS AT A CREATIVE, NEVER AT A MEDIA ID — passing a mediaId is refused by name rather than failing at Snapchat with a field-path error. SNAPCHAT REVIEWS EVERY AD before it can show: the returned reviewStatus says whether that has happened, and an ad Snapchat has REJECTED cannot serve even once it is activated, so relay a rejection instead of reporting a successful build. The status is READ BACK from Snapchat’s own row — if the note carries a Warning: saying it was stored as anything other than PAUSED, relay that and pause it before anything above it is activated.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Snapchat ad (forced paused)
    • idempotentHint: false
  • create_snapchat_ads_ad_squadCreate an ad squad under an existing Snapchat campaign — the tier that holds the budget, the bid, the targeting, the placements and the schedule.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an ad squad under an existing Snapchat campaign — the tier that holds the budget, the bid, the targeting, the placements and the schedule. CREATED PAUSED with no override. TWO THINGS ARE MANDATORY AND NEITHER IS GUESSABLE: countries (at least one two-letter code — Snapchat refuses an ad squad with no geo, and search_snapchat_ads_targeting(kind:"country") resolves them), and a budget. **MONEY ON SNAPCHAT IS MICRO-CURRENCY**: state a plain amount in dailyBudget (50 means fifty dollars) and Hermoso multiplies by 1,000,000 for you. Only use dailyBudgetMicro if you have ALREADY converted, and NEVER pass both — that is refused rather than resolved by precedence, because applying the conversion twice to an already-converted amount asks for a budget a million times too large, and under-converting merely fails loudly while over-converting does not. Snapchat’s documented minimum daily budget is 5 units. A bid is required unless bidStrategy is AUTO_BID, which lets Snapchat choose it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Snapchat ad squad (targeting, budget, bidding, schedule)
    • idempotentHint: false
  • create_snapchat_ads_campaignCreate the top tier of a Snapchat ad — the campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the top tier of a Snapchat ad — the campaign. CREATED PAUSED AND THERE IS NO OVERRIDE; it spends nothing until set_snapchat_ads_status(confirm:true). A CAMPAIGN ALONE CAN NEVER SERVE: it needs an ad squad and then an ad under it, and every tier must be ACTIVE before one impression is shown. Objectives are Snapchat’s CURRENT objective_v2 set — AWARENESS_AND_ENGAGEMENT, SALES, TRAFFIC, APP_PROMOTION, LEADS. A LEGACY objective name (BRAND_AWARENESS, WEB_CONVERSION and the rest) is REFUSED BY NAME rather than silently mapped onto a v2 value, because mapping one onto the other would optimise the campaign for something the user did not ask for. The result is READ BACK from Snapchat and the note says so when the read-back could not be run.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a Snapchat campaign (forced paused)
    • idempotentHint: false
  • create_stripe_subscriptionSubscribe a Stripe customer (cus_…) to a price (price_…), optional quantity and trialDays.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Subscribe a Stripe customer (cus_…) to a price (price_…), optional quantity and trialDays. THIS CHARGES THE CUSTOMER'S SAVED PAYMENT METHOD when there is no trial, so it ALWAYS needs confirm:true (test keys included) after you show the user exactly what will be created. Read back; an INCOMPLETE status means no chargeable card is on file. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: create stripe subscription
    • idempotentHint: false
  • create_tiktok_ads_adCreate the ad itself — the creative that runs under an existing TikTok ad group.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

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

      Matched text

      description ends: "...is enabled — print that verbatim and act on it before touching anything above it."

      What this check looks for
    Description, as the server wrote it
    Create the ad itself — the creative that runs under an existing TikTok ad group. CREATED PAUSED with no override (TikTok’s own default is ENABLED); it spends nothing until set_tiktok_ads_status(confirm:true), and TikTok additionally reviews it before it can ever show. WHERE THE CREATIVE COMES FROM: run upload_tiktok_ads_creative on a finished Hermoso render (or any public https video) and pass back the videoId AND the coverImageId it returns as imageIds — a TikTok video ad needs BOTH, and TikTok rejects any cover whose dimensions differ from the video, so the video’s own cover is the only one that reliably fits. A videoId with no imageIds is refused here, for free. AN IDENTITY IS MANDATORY AND HAS NO DEFAULT: identityId AND identityType both come from list_tiktok_ads_identities and the ad appears publicly as that TikTok account, so let the USER pick and never guess — the call is refused outright without either. SPARK ADS — RUN A REAL ORGANIC POST INSTEAD: pass tiktokItemId (from list_tiktok_ads_identity_posts or list_tiktok_ads_spark_posts) INSTEAD OF videoId, and the ad IS that TikTok post, keeping its own comments, likes and shares under the account that made it. Spark needs an identityType of TT_USER, BC_AUTH_TT or AUTH_CODE — never CUSTOMIZED_USER, which is a Custom Identity and cannot carry one. THIS MATTERS BEYOND STYLE: TikTok is phasing Custom Identity out — ad accounts created on or after January 15, 2026 cannot create non-Spark ads at all, and existing accounts can no longer create them either, for any ad group delivering to Automatic or Select Placement with TikTok included (only Pangle / Global App Bundle campaigns are unaffected). Defaults: adFormat SINGLE_VIDEO, callToAction LEARN_MORE. THE STATUS IS READ BACK FROM TIKTOK’S OWN STORED ROW, never assumed: if it comes back anything other than DISABLE the note is a Warning: warning that the ad would serve the moment its campaign is enabled — print that verbatim and act on it before touching anything above it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a TikTok ad
    • idempotentHint: false
  • create_tiktok_ads_ad_groupCreate an ad group under an existing TikTok campaign — the tier that holds the budget, the bid, the placements, the schedule and ALL the targeting.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an ad group under an existing TikTok campaign — the tier that holds the budget, the bid, the placements, the schedule and ALL the targeting. CREATED PAUSED with no override (TikTok would otherwise create it ENABLED, and a live ad group under a paused campaign is exactly how spend escapes a one-level pause); it spends nothing until set_tiktok_ads_status(confirm:true). TIKTOK REQUIRES THIRTEEN FIELDS TOGETHER and its error names only the FIRST missing one per round trip, so the server checks the whole set locally and refuses with EVERY absentee at once — which matters here because QPS is 1 and each round trip costs a second. Sensible defaults are supplied for placement, pacing, promotion type, schedule type, optimization goal, billing event, bid type and budget mode, so the ONE thing you must resolve yourself is LOCATION: locationIds is effectively mandatory (TikTok: "‘location_ids’ or ‘zipcode_ids’ must be specified") and comes from search_tiktok_ads_targeting(kind:"location"). Resolve interest and language ids the same way — a guessed id either fails the create or targets the wrong people, silently. CONVERSION CAMPAIGNS (WEB_CONVERSIONS / CONVERSIONS / PRODUCT_SALES / LEAD_GENERATION) NEED A PIXEL: set optimizationGoal CONVERT, pass pixelId AND optimizationEvent, and billingEvent OCPM — TikTok pairs a billing event with every goal MANUALLY and derives nothing, so the server supplies the right one if you leave it out. Without a pixel TikTok refuses with "Please select a pixel." The result is READ BACK from TikTok, and the pixel and event it reports are the STORED ones.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a TikTok ad group (targeting, budget, bidding, schedule)
    • idempotentHint: false
  • create_tiktok_ads_campaignCreate the top tier of a TikTok ad — the campaign, which fixes the OBJECTIVE everything under it optimises toward.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the top tier of a TikTok ad — the campaign, which fixes the OBJECTIVE everything under it optimises toward. It is created paused (operation_status DISABLE), also when the caller asks for ENABLE. It spends nothing until set_tiktok_ads_status(confirm:true). OBJECTIVES that create cleanly, each proven with a real create: TRAFFIC (the default), REACH, VIDEO_VIEWS, ENGAGEMENT, WEB_CONVERSIONS, LEAD_GENERATION, APP_INSTALL, PRODUCT_SALES, CONVERSIONS. RF_REACH (Reach & Frequency) also works but ONLY with budgetMode BUDGET_MODE_INFINITE — TikTok’s own words are "The budget type for Reach & Frequency must be unlimited". Five further values sit in TikTok’s schema enum and are REFUSED BY NAME with the reason (CATALOG_SALES is retired, SHOP_PURCHASES needs TikTok Shop on the advertiser, and APP_PROMOTION / RF_ENGAGEMENT / RF_APP_INSTALL are withheld) — the server owns that list, so a refusal names its cause and is TikTok's restriction. budgetMode is BUDGET_MODE_DAY (the default), BUDGET_MODE_TOTAL, BUDGET_MODE_DYNAMIC_DAILY_BUDGET or BUDGET_MODE_INFINITE. A campaign alone can never serve: build an ad group under it, then an ad. The result is READ BACK from TikTok and says so when the read-back could not be run.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a TikTok campaign (forced paused)
    • idempotentHint: false
  • create_tiktok_ads_rf_ad_groupCreate the ad group of a REACH & FREQUENCY campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the ad group of a REACH & FREQUENCY campaign. THIS IS THE ONE OBJECT HERMOSO CREATES THAT CANNOT BE BORN PAUSED, and that is TikTok’s doing, not ours: /adgroup/rf/create/ publishes no operation_status anywhere in its parameter table, so there is no field to force — and an R&F ad group is a RESERVATION whose budget locks 5 minutes before delivery. So it needs confirm:true, and WITHOUT confirm NOTHING IS CREATED: you get the sentence describing exactly what would be booked, which you must show the user before asking for a yes. The three reservation numbers must come from tiktok_ads_rf_inventory_estimate — TikTok silently books its own maximum rather than refusing a number outside the estimated range. REACH & FREQUENCY IS ALLOWLIST-ONLY PER AD ACCOUNT: TikTok requires the advertiser to be allowlisted by a TikTok representative and to have signed a Commercial Contract for Branding, no API reports that status, and if TikTok refuses this the remedy is a conversation with the rep rather than a different field.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Book a TikTok Reach & Frequency ad group (confirm-gated)
    • idempotentHint: false
  • create_tiktok_smart_adAdd the creative to a Smart+ ad group.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add the creative to a Smart+ ad group. Smart+ combines the materials you give it rather than running one fixed cut, so this is where the videos and copy go. Created PAUSED. If TikTok accepts the request but returns no ad id, the reply says nothing is confirmed to exist rather than claiming success — check Ads Manager before retrying, or a second call can create a twin.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a TikTok Smart+ ad (forced paused)
  • create_tiktok_smart_ad_groupAdd an ad group to a Smart+ campaign — the level holding the targeting, budget, schedule and bidding.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add an ad group to a Smart+ campaign — the level holding the targeting, budget, schedule and bidding. TikTok requires NINE fields together here and reports only the FIRST one it hits per request, so every absentee is named at once rather than one per round trip. Created PAUSED; it has no ads until you add one.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a TikTok Smart+ ad group (forced paused)
  • create_tiktok_smart_campaignCreate an UPGRADED SMART+ campaign — TikTok’s automated campaign type, where TikTok picks the audience, placements and creative combinations for you.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an UPGRADED SMART+ campaign — TikTok’s automated campaign type, where TikTok picks the audience, placements and creative combinations for you. It is what a customer means by "smart campaign", "automated campaign", "performance max" or "Smart+" on TikTok. CREATED PAUSED WITH NO OVERRIDE, exactly like the classic lane and for the same reason: TikTok creates ENABLED by default, so an omitted status would ship something that serves on the next auction. It spends nothing until set_tiktok_smart_status(confirm:true). SMART+ TAKES A SHORTER OBJECTIVE LIST THAN A CLASSIC CAMPAIGN — APP_PROMOTION, WEB_CONVERSIONS, LEAD_GENERATION and nothing else — and a value TikTok accepts on the classic endpoint can still be refused here, at the ad group, after the campaign exists; that is refused up front instead. CATALOG ADS: set catalogEnabled and catalogType (ECOMMERCE for a commerce catalog; GENERIC for itemized NON-commerce inventories; TRAVEL_ENTERTAINMENT for hotels, flights and destinations, on WEB_CONVERSIONS or, since TikTok added App Travel Catalog Ads on 2026-11-06, on APP_PROMOTION). There is no PRODUCT catalog type.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a TikTok Smart+ campaign (forced paused)
  • create_tiktok_tto_campaignCreate a TikTok One creator campaign and get the invite link creators tag their videos with.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a TikTok One creator campaign and get the invite link creators tag their videos with. TWO SHAPES, AND THEY NEED DIFFERENT FIELDS: campaignType "CAMPAIGN" invites named creators by handle and produces a campaign-level link; campaignType "BRAND_LINK" requires a brandProfileId, takes no handles at all, and produces one open link anyone can tag a video with. THE FIELD WITH LASTING CONSEQUENCES IS advertiserIds: naming ad accounts means every video a creator links to this campaign AUTOMATICALLY grants those accounts Spark Ads rights for sparkAdsAuthorizationDays and is synced into their creative library; that is standing permission rather than a one-off, and TikTok requires the days whenever advertiserIds is given. sendNotification puts an invitation in a real creator’s TikTok inbox and is OFF unless you ask for it; without it the creators see the invitation only if you share the link yourself. Handles TikTok rejects come back in a failed list rather than as an error, so the reply reports which ones were ACTUALLY invited rather than which ones were asked for. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create a TikTok One creator campaign
    • idempotentHint: false
  • create_x_ads_campaignCreate a campaign on X (Twitter).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a campaign on X (Twitter). ALWAYS CREATED PAUSED with no override — it spends NOTHING until set_x_ads_status(confirm:true). A CAMPAIGN ALONE CANNOT SERVE ON X: it needs a line item and a promoted post underneath it, and the read-back says so rather than letting you call it a finished ad. Requires a funding instrument (a payment method on the X ad account) — omit fundingInstrumentId to be shown the usable ones, and if there are none this refuses with that reason instead of failing at X. Budgets are in the ad account’s own currency. Everything is READ BACK from X before you are told it exists; print the returned note verbatim.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Build an X ads campaign (paused)
    • idempotentHint: false
  • create_x_ads_line_itemCreate a line item — X's ad group — under a campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a line item — X's ad group — under a campaign. ALWAYS CREATED PAUSED with no override. THE TREE ON X IS campaign -> line item -> promoted post, and a campaign ALONE CANNOT SERVE: this is the middle level, and it still cannot serve until you attach a post with create_x_ads_promoted_tweet. Targeting attaches HERE (add_x_ads_targeting), never to the campaign. `objective` is validated before dispatch because X answers an invalid one with a 500 that reads like an outage; note that WEBSITE_CONVERSIONS and SITE_VISITS are `goal` values and are NOT objectives. `bidStrategy` MAX/TARGET require a bidAmount; AUTO lets X set it. Omitting startTime records now, and the read-back says so. Everything is READ BACK from X before you are told it exists; print the returned note verbatim.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Build an X ads line item (paused)
    • idempotentHint: false
  • create_x_ads_promoted_accountTHE CREATIVE OF AN X FOLLOWER CAMPAIGN.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE CREATIVE OF AN X FOLLOWER CAMPAIGN. A line item with objective FOLLOWERS (productType PROMOTED_ACCOUNT, which create_x_ads_line_item now defaults to for FOLLOWERS) promotes an X ACCOUNT, and until one is attached here it has nothing to show and never serves. Omit userId and the ad account’s own promotable account is used; if it may promote several, the choice is refused rather than guessed (list_x_ads_promotable_users shows them). A line item of any other product type is refused for free, naming X’s INCOMPATIBLE_LINE_ITEM rule. You may ALSO attach a post with create_x_ads_promoted_tweet, which X adds as a mobile timeline placement. The attachment is READ BACK from the line item before it is reported. Nothing spends: the campaign and line item stay PAUSED until set_x_ads_status(confirm:true). X cannot edit a promoted account, only remove it (delete_x_ads_object type:"promoted_account"). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Attach an X account to a follower line item (paused)
    • idempotentHint: false
  • create_x_ads_promoted_tweetAttach an existing X post to a line item so the line item has a creative — the LAST piece of the tree, and without it nothing can ever serve however the statuses are set.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "create_x_ads_promoted_tweet" says "create" and "tweet": it writes something other people read.
    Description, as the server wrote it
    Attach an existing X post to a line item so the line item has a creative — the LAST piece of the tree, and without it nothing can ever serve however the statuses are set. The tweet id is the number at the end of the post URL (x.com/<handle>/status/<id>), not the URL. Several ids may be attached at once; X creates one promoted-tweet row per post. ATTACHMENT IS VERIFIED by re-reading the line item's own promoted posts rather than by trusting X's echo, and if that read cannot run the note says UNCONFIRMED instead of claiming success. Everything Hermoso built above this is PAUSED, so attaching a post starts no spend. Print the returned note verbatim.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Attach a post to an X line item (paused)
    • idempotentHint: false
  • delete_analytics_key_eventREMOVE A KEY EVENT — the reverse of create_analytics_key_event, and note the ASYMMETRY with custom dimensions: a key event really can be DELETED, where a custom dimension can only …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    REMOVE A KEY EVENT — the reverse of create_analytics_key_event, and note the ASYMMETRY with custom dimensions: a key event really can be DELETED, where a custom dimension can only be archived. Nothing is destroyed — GA4 keeps collecting the underlying event and keeps all of its history, this only stops it counting as a conversion, and it can be marked again at any time. Use it for an event marked as a conversion by mistake, or one that should no longer be optimised toward. BE AWARE IT REACHES FURTHER THAN GA4: anything importing this conversion — Google Ads smart bidding in particular — stops receiving it, which changes how campaigns bid. Called without `confirm` it deletes nothing and describes the key event back to you. Needs edit access on the property.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Stop counting a GA4 event as a conversion
  • delete_apple_ads_objectDelete an Apple Ads campaign, ad group, keyword, negative keyword, ad, creative, asset, location group or budget order.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete an Apple Ads campaign, ad group, keyword, negative keyword, ad, creative, asset, location group or budget order. Requires confirm:true, and optionally confirmName echoed back to prove you aimed at the right object. THIS CASCADES AND CANNOT BE UNDONE: Apple soft-deletes with no undelete, and deleting a campaign takes every ad group, keyword and ad underneath it. THE BLAST RADIUS DIFFERS BY LEVEL and the refusal states the right one for the object you named: deleting a CREATIVE does not delete the ads that use it — it makes every one of them stop serving, permanently, with no way back but a new creative; deleting an ASSET makes any Apple Maps creative using it INVALID; deleting an AD leaves its creative untouched and available; deleting a LOCATION GROUP is permanent with no restore, and every ad group targeting it loses that constraint immediately — an ad group left targeting no location group STOPS serving rather than reaching everywhere. In almost every case set_apple_ads_status(status:"PAUSED") is what you actually want — it stops all spend and is reversible — but a creative, an asset, a location group and a budget order have NO status, so for those the reversible move is pausing whatever references them. DELETING A BUDGET ORDER CASCADES TO NOTHING — it is a spend ceiling, not a parent — but every campaign assigned to it loses that ceiling, and Apple REFUSES the delete outright while any campaign is still assigned, or once the order has started, or if it is cancelled, completed or exhausted; the refusal names whichever applies before anything is sent. The reply is confirmed by RE-READING the object: for a delete, an absent or deleted-flagged row is the proof, never the HTTP 200. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete an Apple Ads object
    • idempotentHint: false
  • 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_google_ads_objectPERMANENTLY remove a Google Ads object.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_google_ads_object" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY remove".
    • 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 remove a Google Ads object. Google has no HTTP delete — removal is a `remove` operation that puts the object in the terminal REMOVED state, which cannot be undone or re-enabled, so treat it as a delete. Levels: "campaign" + campaignId · "adGroup" + adGroupId · "ad" + adGroupId AND adId · "keyword" + adGroupId AND keywordId · "conversionAction" + conversionActionId · "campaignAsset"/"adGroupAsset" + the LINK’s full resourceName (get it from google_ads_report over campaign_asset / ad_group_asset — an asset id alone does not identify a link). THERE IS DELIBERATELY NO "asset" LEVEL: Google publishes no operation that deletes an Asset, only its links, so removing a link unlinks the asset and leaves it in the library. CALL IT WITHOUT confirm FIRST — nothing is removed and you get the object’s real name, status, LIFETIME SPEND and child counts read live from Google; show the user exactly that. A target with children, live delivery or real spend additionally needs confirmName (its exact name) and confirmChildren (the child count from that read-back). Removing a CAMPAIGN also removes its campaign-owned budget, and the note says whether it did. Removing the last ENABLED conversion action makes every smart-bidding campaign on the account undeliverable — the refusal says so. To stop delivery without removing, use set_google_ads_status(status:"PAUSED").

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove a Google Ads campaign / ad group / ad / keyword / asset link / conversion action
  • delete_google_ads_ruleDelete a rule (its run history stays readable).No findings

    Why it is in this group

    • The name "delete_google_ads_rule" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete a rule (its run history stays readable). Needs confirm:true. Does not put back anything it changed. Free.

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete from Library
  • delete_linkedin_ads_objectDelete a LinkedIn campaign group, campaign or creative (level:"creative" + creativeId).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_linkedin_ads_object" 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 LinkedIn campaign group, campaign or creative (level:"creative" + creativeId). LinkedIn HARD-deletes only DRAFT objects; anything that has ever run is moved to PENDING_DELETION instead — it stops serving and its reporting history is retained. The returned note says which of the two actually happened, and you must repeat that rather than claiming a clean delete. Irreversible either way, so it requires confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a LinkedIn campaign group / campaign / ad
  • 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_merchant_data_sourceDelete a data source (feed) from a Merchant Center account.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_merchant_data_source" 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 data source (feed) from a Merchant Center account. CONFIRM-GATED and the heavier of the two deletes: without confirm:true nothing is deleted and it reports the feed plus HOW MANY PRODUCTS would be destroyed with it, counted live from Google. This is NOT recoverable the way a product delete is — the products would have to be re-inserted into a new feed, and feedLabel/contentLanguage are immutable so a replacement may not be identical. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Merchant Center product feed
  • delete_merchant_productDelete a product from a Merchant Center feed.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_merchant_product" 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 product from a Merchant Center feed. CONFIRM-GATED: without confirm:true nothing is deleted and it reports the real product it WOULD delete — title, price and availability read back from Google — because the id you were given proves nothing about what is actually there. It is recoverable: re-inserting the same offerId re-creates the product. Needs the same offerId + contentLanguage + feedLabel that identify the product (contentLanguage and feedLabel come from the feed when it declares them). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Merchant Center product
  • delete_meta_ad_rulePermanently delete a rule (Meta publishes no restore; switching it off is the reversible choice).Reads text others writeNo findings

    Why it is in this group

    • The name "delete_meta_ad_rule" 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 rule (Meta publishes no restore; switching it off is the reversible choice). Needs confirm:true. Read back from Meta to prove it is gone. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Meta automated rule
  • delete_meta_audiencePERMANENTLY delete a Meta custom audience or lookalike.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_meta_audience" 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 Meta custom audience or lookalike. Meta’s own warning: "When you delete a custom audience, it will be permanently removed from your account and your ads using it will stop running." An audience is the one ad object whose value is its CONTENTS — a big retargeting list cannot be rebuilt, it has to re-accumulate — so CALL IT WITHOUT confirm FIRST: nothing is deleted, and you get its real name, how many people are in it and which lookalikes were built from it, read live from Meta. Show the user exactly that. A populated audience, or one with lookalikes, then needs confirmName set to its exact name (and confirmChildren set to the lookalike count when there are any). META REFUSES to delete an audience that has lookalikes derived from it (error 2656) — delete those first; the unconfirmed call names them. Pass adAccountId + audienceId (from list_meta_audiences). The result is READ BACK from Meta: it says deleted only when the id no longer resolves.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Meta custom audience
  • delete_meta_objectPERMANENTLY delete a campaign, ad set, or ad.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_meta_object" 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 campaign, ad set, or ad. Pass objectId (from list_meta_ads) + adAccountId. DELETING A CAMPAIGN ALSO DELETES EVERY AD SET AND AD UNDER IT, and deleting an ad set deletes its ads: Meta itself leaves them behind, so Hermoso deletes each ad, then each ad set, then the object, and reads every one back (deletedAds / deletedAdSets / verified say exactly what went). An ad creative that ads still use cannot be deleted until those ads are; the refusal names them (usedBy). Call it WITHOUT confirm first: it reports what the object is, its name, and how many children go with it. Show the user that, get an unambiguous yes, then call again with confirm:true plus confirmChildren set to the number it reported (only needed when there is at least one child). To stop delivery without deleting anything, use update_meta_object(status:"PAUSED") instead — that is reversible and this is not.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Meta campaign / ad set / ad
  • delete_microsoft_ads_objectPERMANENTLY delete a Microsoft Advertising campaign, ad group, ad or keyword.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_microsoft_ads_object" 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 Microsoft Advertising campaign, ad group, ad or keyword. This is a real delete — Microsoft removes the object and it stops being returned by every read, with no undelete and no documented recovery window. Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, level:"ad" + adGroupId AND adId, or level:"keyword" + adGroupId AND keywordId. CALL IT WITHOUT confirm FIRST: nothing is deleted, and you get back the object’s real name, its status and how many ad groups / ads / keywords go with it, read live from Microsoft — show the user exactly that. If the object has children, is Active, or has spent, confirming alone is NOT enough: you must also pass confirmName set to its exact name and confirmChildren set to the child count from that read-back, which is what proves you are deleting the object you think you are. A campaign that is paused, empty and never ran deletes on plain confirm:true. To stop delivery WITHOUT deleting, use set_microsoft_ads_status(status:"Paused") instead. The result is READ BACK from Microsoft: it says "deleted" only when the object no longer resolves, "not confirmed" if it does, and "could not tell" if the check itself failed — repeat that verbatim rather than claiming success.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Microsoft Advertising campaign / ad group / ad / keyword
  • delete_microsoft_merchant_productDelete one product offer from a Microsoft Merchant Center store.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_microsoft_merchant_product" 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 one product offer from a Microsoft Merchant Center store. Pass productId as the FULLY QUALIFIED id (channel:contentLanguage:targetCountry:offerId), not the offerId. Call without confirm first — nothing is deleted and you get Microsoft's own better advice back: deleted products can take UP TO 12 HOURS to stop delivering, so if the goal is to stop showing it today, upsert it with availability 'out of stock' instead. The outcome is READ BACK by re-fetching the offer, and says 'deleted', 'not confirmed' or 'could not tell' — repeat that verbatim rather than claiming success from the delete's own empty response. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Microsoft Merchant Center product offer
  • delete_mixpanel_annotationPermanently delete a Mixpanel annotation from every chart in the project.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_mixpanel_annotation" 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 Mixpanel annotation from every chart in the project. WITHOUT confirm:true nothing is deleted and you get the exact annotation that would go, to show the user; call again with confirm:true only after they say yes. The delete is verified by reading it back. Needs the ANALYST role on the service account. 0 credits. Needs Mixpanel connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Mixpanel annotation
  • 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_openai_ads_lead_syncDelete the lead-sync subscription: every lead form on the account stops delivering leads.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delete the lead-sync subscription: every lead form on the account stops delivering leads. confirm:true required.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a ChatGPT Ads lead-sync subscription
    • idempotentHint: false
  • delete_openai_ads_objectRetire a ChatGPT Ads campaign, ad group or ad.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_openai_ads_object" 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
    Retire a ChatGPT Ads campaign, ad group or ad. THE OPENAI ADVERTISER API HAS NO DELETE — archiving is its only teardown, and OpenAI’s own guidance is "only archive objects you have no further use for, as archiving isn’t reversible": there is no un-archive, not even through support. So say ARCHIVED, never "deleted". Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, or level:"ad" + adId. CALL IT WITHOUT confirm FIRST — nothing is archived and you get the object’s real name, status and child count read live from OpenAI; show the user exactly that. A target with children or live delivery additionally needs confirmName (its exact name) and confirmChildren (the count from that read-back). PAUSING stops all spend and keeps the object editable — offer that first whenever the user only wants delivery to stop. Archiving a campaign is not documented to cascade, so archive the children yourself if they should stop too. The result is READ BACK: it says archived only when OpenAI reports the archived status.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Archive (ChatGPT Ads’ delete) a campaign / ad group / ad
  • delete_openai_ads_spend_windowDelete an active or scheduled spend-limit window before it ends — this REMOVES a spending ceiling.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_openai_ads_spend_window" 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 an active or scheduled spend-limit window before it ends — this REMOVES a spending ceiling. confirm:true required.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a ChatGPT Ads spend-limit window
    • idempotentHint: false
  • delete_pinterest_ads_objectRetire a Pinterest campaign, ad group or ad.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_pinterest_ads_object" 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
    Retire a Pinterest campaign, ad group or ad. PINTEREST API v5 HAS NO DELETE for any of the three — ARCHIVED is its terminal state, and Pinterest’s own campaign docs call an archived campaign "deleted" and say reversing it means filing a ticket with their customer ops team, so there is no un-archive you or the user can call. Say ARCHIVED, not "deleted": the object stays on the account with its reporting history and simply drops out of the default list view. Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, or level:"ad" + adId. CALL IT WITHOUT confirm FIRST — nothing is archived and you get the object’s real name, status and child count read live from Pinterest; show the user exactly that. A target with children or live delivery additionally needs confirmName (its exact name) and confirmChildren (the count from that read-back). PAUSING is fully reversible — offer it first whenever the user only wants delivery to stop. Pinterest documents no cascade, so archive the children yourself if they should stop too.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Archive (Pinterest’s delete) a campaign / ad group / ad
  • 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_reddit_ads_assetPermanently delete a creative asset from the Reddit asset library.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_reddit_ads_asset" 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 creative asset from the Reddit asset library. Without confirm:true it deletes nothing and reports what the asset is; with it, the reply is the read-back (the asset reads as DELETED or gone), never Reddit’s 200. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Reddit creative asset
  • delete_reddit_ads_audiencePermanently delete a Reddit custom audience.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_reddit_ads_audience" 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 Reddit custom audience. This is one of the very few things Reddit really deletes — campaigns, ad groups and ads are only ever archived — and it cannot be undone: the uploaded list is gone and any ad group targeting it loses that audience. Confirm-gated: show the user the audience name and its size, get an explicit yes, then call again with confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Reddit custom audience
  • delete_reddit_ads_catalog_objectPERMANENTLY delete a Reddit catalog (with all its products, feeds and product sets), a product feed, or a product set.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_reddit_ads_catalog_object" 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 Reddit catalog (with all its products, feeds and product sets), a product feed, or a product set. Unlike campaigns these really are deleted, and it cannot be undone. Call WITHOUT confirm first: nothing is deleted, and the answer lists what would go with it — including any ad group on the shared ad account still advertising an affected product set. Show that to the user, get an explicit yes, then call again with confirm:true. The result is checked by reading the object back (Reddit then answers 404).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a Reddit catalog, feed or product set
    • idempotentHint: false
  • delete_reddit_ads_objectRemove a Reddit campaign, ad group or ad.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a Reddit campaign, ad group or ad. REDDIT HAS NO DELETE VERB for any of the three — its whole Ads API has exactly four HTTP DELETE endpoints and none of them is a campaign, ad group or ad — so removal is the `configured_status` field: DELETED (permanent) or ARCHIVED (out of service, and can be set back to PAUSED). DELETED is additionally TIME-GATED: Reddit refuses to delete anything modified in the last 3 hours, and the refusal names ARCHIVED as the immediate alternative. CALL IT WITHOUT confirm FIRST — nothing changes, and you get the object’s real name, status and how many ad groups / ads sit under it, read live from Reddit. A target with children or live delivery then needs confirmName (its exact name) and confirmChildren (the count from that read-back). Reddit does NOT document whether removing a campaign cascades to its ad groups and ads — each carries its own status — so remove the children yourself if they should go too. To stop delivery without removing, use set_reddit_ads_status(status:"PAUSED").

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete or archive a Reddit campaign / ad group / ad
  • delete_reddit_ads_productsPERMANENTLY remove products (by id) from a Reddit catalog — Reddit: "This action can't be undone".Reads text others writeNo findings

    Why it is in this group

    • The name "delete_reddit_ads_products" says "delete": a word for removing or ending something.
    • The description says "PERMANENTLY remove".
    • 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 remove products (by id) from a Reddit catalog — Reddit: "This action can't be undone". Up to 1,000 ids per call. Call WITHOUT confirm first: nothing is deleted and the answer says how many would go; get the user's yes, then call again with confirm:true. Reddit answers DELETED or NOT_FOUND per id, and that is what is reported. A catalog fed by a REPLACE feed re-imports whatever the file still contains, so remove the product from the file too.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Remove products from a Reddit catalog
    • idempotentHint: false
  • delete_reddit_ads_saved_audienceDelete a Reddit saved audience — the named, reusable targeting block ad groups point at.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_reddit_ads_saved_audience" 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 Reddit saved audience — the named, reusable targeting block ad groups point at. Reddit publishes NO delete verb for one (its whole Ads API has four, and this is not among them), so removal is its `status` field set to DELETED. THE BLAST RADIUS IS THE AD GROUPS USING IT: every live ad group pointing at this audience loses that targeting definition the moment it goes, and Reddit’s own `active_ad_groups_count` is what says how many. CALL IT WITHOUT confirm FIRST — nothing is deleted and you get its real name and that count; show the user exactly that, and if any ad group uses it you must then pass confirmName (its exact name) and confirmChildren (the count). The result is READ BACK from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Reddit saved audience
  • delete_salesforce_recordDelete one Salesforce record; it goes to the org's Recycle Bin for 15 days.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_salesforce_record" 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 one Salesforce record; it goes to the org's Recycle Bin for 15 days. Without confirm:true nothing is deleted and you get the record it would delete; call again with confirm:true only after the user says yes. Free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a Salesforce record
    • idempotentHint: false
  • delete_search_console_siteRemove a property from the connected Google account.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a property from the connected Google account. THIS LOSES HISTORY: the account loses access to that property's stored Search Console performance data, and re-adding it later means verifying ownership from scratch — Google does NOT restore the 16-month window on re-add. Nothing about the site itself, its pages or its ranking changes. CONFIRM-GATED: the unconfirmed call removes nothing and describes what would be lost, including how many sitemaps this account can currently see on it. The property is also dropped from this brand's shared list, so it cannot linger as a tick pointing at something unreachable. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Remove a property from Search Console
    • idempotentHint: false
  • delete_search_console_sitemapRemove a sitemap from a property.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a sitemap from a property. THIS DOES NOT REMOVE THOSE PAGES FROM GOOGLE'S INDEX — it stops Google using that file to discover new ones, and it can be submitted again at any time, so it is reversible. CONFIRM-GATED: called without confirm it removes nothing and reports what the sitemap actually IS, read back from Google (its error and warning counts and how many URLs it covers), so you can check you are aiming at the right one. Re-run with confirm:true to proceed. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Remove a sitemap from a Search Console property
    • idempotentHint: false
  • delete_shopify_marketing_activityRemove a marketing activity Hermoso recorded from the merchant's Shopify > Marketing, by remoteId or id.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove a marketing activity Hermoso recorded from the merchant's Shopify > Marketing, by remoteId or id. Shopify stops attributing visits and sales to it and it cannot be undone, so without confirm:true NOTHING is deleted and the reply names exactly what would go: show the user, get a yes, then call again with confirm:true. Read back afterwards. Works for the Shopify store connected to this brand or the store this account was installed on. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a Shopify marketing activity
  • 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_snapchat_ads_audiencePermanently delete a Snapchat audience — Snapchat: deleted audiences "cannot be retrieved".Reads text others writeNo findings

    Why it is in this group

    • The name "delete_snapchat_ads_audience" 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 Snapchat audience — Snapchat: deleted audiences "cannot be retrieved". confirm:true required; without it nothing is deleted and you get the audience's name, type and size to show the user. Ad squads targeting it lose that targeting. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a Snapchat audience
    • idempotentHint: false
  • delete_snapchat_ads_objectPERMANENTLY DELETE a Snapchat campaign, ad squad or ad.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_snapchat_ads_object" 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 Snapchat campaign, ad squad or ad. Snapchat deletes at every tier, so this is irreversible and there is no undelete. Needs confirm:true, and the unconfirmed call changes nothing and names the objects READ FROM SNAPCHAT plus what deleting a parent takes with it (a campaign takes its ad squads and ads). TO STOP DELIVERY REVERSIBLY, use set_snapchat_ads_status with PAUSED instead — the refusal says so, because most people asking to "remove" an ad mean "stop it". The read-back is INVERTED for a delete: an id that still resolves afterwards is reported as NOT CONFIRMED, never as a success.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete a Snapchat campaign, ad squad or ad
    • idempotentHint: false
  • delete_tiktok_ads_audienceDelete one or more TikTok custom audiences.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_tiktok_ads_audience" 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 one or more TikTok custom audiences. IRREVERSIBLE: TikTok publishes no undelete, any Lookalike seeded from one loses its seed, every ad group targeting it stops using it, and re-creating one means rebuilding the rule and waiting up to 48 hours for it to process again. WITHOUT confirm NOTHING IS DELETED — you get each audience’s real name, type and matched-user count READ BACK FROM TIKTOK, which is what you show the user before asking for a yes, because a confirm flag proves you meant to delete something and cannot tell an empty scratch audience from the one every campaign targets. Deleting MORE THAN ONE additionally needs confirmCount set to the exact number. If the audiences cannot be READ, the delete is refused outright rather than performed blind — an unknown blast radius on an irreversible action is not the same as an empty one.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete TikTok custom audiences
    • idempotentHint: false
  • delete_tiktok_ads_commentWarning: READ THIS BEFORE REACHING FOR IT: TikTok’s comment delete removes a comment YOUR OWN advertiser identity posted — your own reply.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_tiktok_ads_comment" 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
    Warning: READ THIS BEFORE REACHING FOR IT: TikTok’s comment delete removes a comment YOUR OWN advertiser identity posted — your own reply. It CANNOT remove a comment left by a member of the public, and TikTok reports that per comment as canDelete on every row from list_tiktok_ads_comments. To take somebody else’s comment out of public view, use moderate_tiktok_ads_comment with operation HIDDEN, which is the moderation tool and is reversible. IRREVERSIBLE: TikTok publishes no undelete, the replies under it go with it, and re-posting means a new comment with a new id at the bottom of the thread rather than the one people answered. WITHOUT confirm NOTHING IS DELETED — you get the comment’s real text, author and date READ BACK FROM TIKTOK, which is what you show the user before asking for a yes. Deleting then additionally needs confirmText set to that exact text, because a confirm flag proves you meant to delete something and cannot prove you aimed at the right comment. If the comment cannot be READ, the delete is refused outright rather than performed blind.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete your OWN comment on a TikTok ad
    • idempotentHint: false
  • delete_tiktok_ads_objectRemove TikTok campaigns, ad groups or ads.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Remove TikTok campaigns, ad groups or ads. TIKTOK HAS NO DELETE VERB: removal is a status, so this posts to the same route as set_tiktok_ads_status with status:"DELETE" rather than being a second implementation with its own rules. It is permanent, TikTok publishes no undelete, and it needs confirm:true; calling it WITHOUT confirm changes nothing and returns the sentence naming how many objects go, which is what you show the user first. TikTok does NOT document whether removing a campaign takes its ad groups and ads with it — each carries its own status — so remove the children yourself if they should go too, and VERIFY with list_tiktok_ads_campaigns afterwards rather than assuming a cascade either way. TO STOP DELIVERY WITHOUT DESTROYING ANYTHING, use set_tiktok_ads_status(status:"DISABLE"): that is reversible and this is not.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete TikTok campaigns / ad groups / ads
  • delete_tiktok_ads_playableDelete a SAVED playable from a TikTok advertiser's Creative Library.Reads text others writeNo findings

    Why it is in this group

    • The name "delete_tiktok_ads_playable" 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 SAVED playable from a TikTok advertiser's Creative Library. Permanent. Without confirm:true it changes nothing and returns what would be deleted, which you show the user first. TikTok does not report which ads use it.

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Delete a post’s Spark-Ads authorization code
  • delete_vercel_deploymentPERMANENTLY delete one Vercel deployment: its URL stops working and Vercel has no undo.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PERMANENTLY delete one Vercel deployment: its URL stops working and Vercel has no undo. Without confirm:true nothing is deleted and you get the deployment it would delete (URL, target, state) to show the user; a production deployment the domains still serve takes the site down. Call again with confirm:true only after the user says yes to that exact deployment. Free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Delete a Vercel deployment
  • delete_x_ads_objectPERMANENTLY delete an X campaign, line item, promoted post, promoted account or targeting criterion — or ARCHIVE a lead form (it stops collecting and its leads can no longer be exp…Reads text others writeNo findings

    Why it is in this group

    • The name "delete_x_ads_object" 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 an X campaign, line item, promoted post, promoted account or targeting criterion — or ARCHIVE a lead form (it stops collecting and its leads can no longer be exported, so run get_x_ads_leads first), or remove a card, a Media Library item (type media: id is the media_key) or a custom audience (custom_audience). X CASCADES AND PUBLISHES NO UNDO: deleting a campaign destroys its line items and their promoted posts too — verified live, the children answer 404 the moment the parent is deleted. RUN IT WITHOUT confirm FIRST: that deletes nothing and reports the REAL blast radius read back off X (what is underneath it, whether it is live, whether it has spent). Show the user exactly that, get an unambiguous yes, then call again with confirm:true — and, for anything with children / live delivery / real spend, also confirmName set to its exact name and confirmChildren set to the real count, because confirm:true alone proves you meant to delete SOMETHING and cannot prove you aimed at the right object. TO STOP DELIVERY WITHOUT DESTROYING ANYTHING use set_x_ads_status PAUSED, which is reversible — except for a promoted post, which cannot be paused on X at all, so pause its LINE ITEM instead. Removing a targeting criterion WIDENS the audience rather than narrowing it. The result is confirmed by re-reading the object, never by X's 200.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Delete an X ads object (permanent, cascades)
    • idempotentHint: false
  • deploy_vercel_pagePublish a STATIC landing page to the brand's Vercel account from HTML (it becomes index.html) or a few files [{file, data, encoding:'utf-8'|'base64'}], up to 50 files and 4 MB.Reads text others writeNo findings

    Why it is in this group

    • The name "deploy_vercel_page" says "deploy": 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 a STATIC landing page to the brand's Vercel account from HTML (it becomes index.html) or a few files [{file, data, encoding:'utf-8'|'base64'}], up to 50 files and 4 MB. project names the Vercel project (created if it does not exist; it becomes part of the URL). target 'preview' (default) makes a new preview URL and leaves the live site alone; 'production' REPLACES what the project's domains serve. WITHOUT confirm:true nothing is sent and you get the exact preview to show the user; call again with confirm:true only after they say yes. The answer is Vercel's own deployment row (URL and state); a new deployment is QUEUED or BUILDING for a moment, so read it back with list_vercel_deployments deploymentId until READY. Free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

      The description mentions "credentials".

      Matched text

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

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

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Draft profile
  • end_linkedin_boostEND a LinkedIn boost: LinkedIn DELETES the boost campaign (it is not a pause; delivery stops).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • 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
    END a LinkedIn boost: LinkedIn DELETES the boost campaign (it is not a pause; delivery stops). Name the boosted post (its campaign is looked up from LinkedIn) or pass campaign + account URNs from linkedin_boost_status. Without confirm it says what would be deleted; confirm:true does it and reads the post’s status back.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: End a LinkedIn boost
  • 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
  • install_tracking_tagPUT A PIXEL ON THE BRAND'S WEBSITE: a Meta Pixel, TikTok Pixel, Google tag, LinkedIn Insight Tag, Reddit Pixel, Pinterest Tag, X Pixel or Snap Pixel.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PUT A PIXEL ON THE BRAND'S WEBSITE: a Meta Pixel, TikTok Pixel, Google tag, LinkedIn Insight Tag, Reddit Pixel, Pinterest Tag, X Pixel or Snap Pixel. It goes through the site connection the brand has. GOOGLE TAG MANAGER (any pixel): a Custom HTML tag with the platform's base code on every page, staged as a draft, and live only with publish:true, through the same confirmation publish_tag_manager_container asks for (a container already live needs confirmPublicId). WIX (Meta, TikTok, Google Ads AW-, Google Analytics G-): a Wix marketing tag, live at once; Wix keeps one per type, so replacing a different pixel needs replaceExisting set to the one being replaced. WEBFLOW, WORDPRESS, SHOPIFY or no site connection: those give an app no way to add code, so the reply is the base code and exactly where to paste it. THE PIXEL ID IS NEVER INVENTED: leave pixelId out and the brand's only pixel on its connected ad account is used (several are listed for you to pick); a given id is checked against that account when it is connected, and refused if it is not the brand's. The code is the platform's own: Meta and Pinterest from the connected account or their published base code, the Google tag from Google's published snippet; for TikTok, LinkedIn, Reddit, X and Snap pass snippet, the base code copied from the platform's events manager (it must contain the id). WITHOUT confirm:true NOTHING IS WRITTEN: the reply says exactly what would change; show the user, get a yes, call again with confirm:true. After a change reaches the site, Hermoso reads the live page (url, default the brand's website) and verify.found says whether the pixel is there: true, false, or null when the page could not be read (never report null as missing). A Tag Manager publish can take a few minutes to reach visitors. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Install a pixel on the website
  • invite_memberInvite someone to this profile by email (role: member = read-only on billing, admin = full).Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

      The description mentions "credential".

      Matched text

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

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

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: List the product catalog
  • manage_analytics_annotationsMARK WHAT YOU DID ON THE CUSTOMER'S OWN GA4 CHARTS — "ad launched", "post went out", "price change" — so the traffic it moved is visible where they already look.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    MARK WHAT YOU DID ON THE CUSTOMER'S OWN GA4 CHARTS — "ad launched", "post went out", "price change" — so the traffic it moved is visible where they already look. action:'list' reads them (Google's own system annotations included, which cannot be edited or deleted), 'create' adds one on a single date or a startDate–endDate range, 'update' changes one, 'delete' removes one (confirm-gated). color: PURPLE BROWN BLUE GREEN RED CYAN ORANGE (default BLUE). Every write is read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: GA4 chart annotations
  • manage_analytics_calculated_metricTHE DERIVED NUMBER A MARKETER ACTUALLY REPORTS — cost per purchase, revenue per session, a margin — built from metrics GA4 already collects and then available to analytics_report l…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE DERIVED NUMBER A MARKETER ACTUALLY REPORTS — cost per purchase, revenue per session, a margin — built from metrics GA4 already collects and then available to analytics_report like any other metric. action:'list' reads them, 'create' adds one, 'update' changes the formula, name, unit or description, 'delete' removes one (confirm-gated). THE ID IS CHOSEN ONCE AND IS PERMANENT: calculatedMetricId becomes the API name reports ask for (calcMetric:your_id), Google marks it output-only afterwards, and renaming is refused by name rather than silently ignored — so pick it deliberately. The formula takes + - * / and parentheses over metric names and plain numbers, referencing at most 5 unique custom metrics; Google answers a syntax error with the exact position. WATCH invalidMetricReference ON THE WAY BACK: a formula naming a metric this property does not collect is created happily and flagged invalid, and any report using it may fail or return unexpected numbers — report that rather than a clean success. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: GA4 calculated metrics
  • manage_analytics_channel_groupHOW GA4 DECIDES WHICH BUCKET A CLICK LANDS IN, which is the number an ad studio is judged on and the answer to "why is my campaign showing as Unassigned".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
    HOW GA4 DECIDES WHICH BUCKET A CLICK LANDS IN, which is the number an ad studio is judged on and the answer to "why is my campaign showing as Unassigned". action:'list' reads every group with its channels in the order GA4 tests them, including Google's own Default channel group — read that first, because a campaign landing in the wrong channel is a rule that does not match rather than missing data. 'create' authors your own group, 'update' changes one, 'delete' removes one (confirm-gated). AUTHORING: `channels` is an ordered list, each with a name and its conditions, and GA4 STOPS AT THE FIRST RULE THAT MATCHES — so a broad rule above a narrow one silently swallows it. A condition is {fieldName, matchType, value} or {fieldName, values:[…]} for a list, plus not:true to invert; an entry that is itself an ARRAY of conditions is OR'ed, and separate entries are AND'ed. THE FIELD NAMES ARE NOT THE REPORT DIMENSIONS: use eachScopeSource, eachScopeMedium, eachScopeCampaignName, eachScopeCampaignId, eachScopeSourcePlatform or eachScopeDefaultChannelGroup — sessionSource, medium and the rest are real GA4 dimensions that Google REFUSES here, and its refusal does not say what to use instead. `primary:true` makes the group the one every report is bucketed by AND unsets whichever group was primary before. Google's own Default channel group cannot be edited and is refused by name. An update REPLACES the whole rule set. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: GA4 channel groups
  • manage_analytics_measurement_protocol_secretTHE SERVER-SIDE EVENT CHANNEL FOR GA4, the Google twin of the conversions APIs Hermoso already ships for Reddit, Snapchat and OpenAI Ads.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE SERVER-SIDE EVENT CHANNEL FOR GA4, the Google twin of the conversions APIs Hermoso already ships for Reddit, Snapchat and OpenAI Ads. A Measurement Protocol secret is the api_secret half of https://www.google-analytics.com/mp/collect; the other half is the stream's measurementId for a web stream or its firebaseAppId for an app stream, and this tool reports whichever applies. action:"list" shows every secret with its value, action:"create" mints one (displayName is required, and it is the ONLY label a secret ever gets because the values are opaque), action:"delete" revokes one and NEEDS confirm:true. TELL THE USER THIS BEFORE THEY DELETE: there is no rotation anywhere in the API, because the value is output-only and patch reaches only the display name. A delete takes effect at once, and anything still sending with the old value stops being recorded SILENTLY, since the Measurement Protocol answers a bad api_secret with a 2xx and drops the hit. Rotating safely means create the new one, move every sender across, then delete the old one. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: GA4 Measurement Protocol secrets
  • manage_google_ads_asset_groupsPerformance Max ASSET GROUPS after launch.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
    Performance Max ASSET GROUPS after launch. action: list (campaignId) | create (campaignId, name, finalUrls, assets; a non-retail group needs Google's minimum set in the same call: 3+ headlines, 1+ longHeadlines, 2+ descriptions, businessName + logos unless brand guidelines are on, 1+ marketingImages and squareMarketingImages as asset resource names from upload_google_ads_asset; born PAUSED) | update (assetGroupId; name, finalUrls, path1, path2) | pause | enable | remove (permanent: confirm:true + confirmName; never the last group) | link (assets to add) | unlink (unlink:[{asset, fieldType}], never below the minimum) | listing_groups (which feed products a RETAIL group advertises) | set_listing_groups (all:true, or dimension + values + mode include|exclude). A change to a live group needs confirm:true. Everything is read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Manage Performance Max asset groups
  • manage_google_ads_assetsThe assets on a Google Ads campaign, ad group or the whole account (level:"customer"): action "list" (every attached asset with its review status and any policy problem), "update" …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The assets on a Google Ads campaign, ad group or the whole account (level:"customer"): action "list" (every attached asset with its review status and any policy problem), "update" (edit a sitelink/callout/snippet/call/promotion/price/lead-form asset — pass assetId, assetType and asset{} in add_google_ads_assets' shape), "pause", "enable" or "unlink" (pass assetId + fieldType from list). Google never deletes an asset; unlink stops it showing. Editing or re-enabling on a LIVE campaign needs confirm:true after the user agrees.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: List, edit, pause or detach Google Ads assets
  • manage_google_ads_audienceAudiences for Google Ads.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
    Audiences for Google Ads. action "search" finds affinity + in-market interests, remarketing lists, custom segments and saved audiences (query by name). "create_remarketing_list": people who visited pages matching urlRules [{operator CONTAINS|EQUALS|STARTS_WITH|ENDS_WITH, value}] in the last membershipDays (needs the Google tag on the site). "create_custom_segment": people searching keywords[] or into sites like urls[] (type AUTO or SEARCH). "create_audience": a reusable audience (userLists, interests, customSegments ids + ages like "25-34", genders) — what Performance Max signals and Demand Gen targeting take. "remove" (userList or customSegment, confirm:true). Attach with set_google_ads_audiences.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Find or build Google Ads audiences
  • manage_google_ads_bid_strategyPORTFOLIO bid strategies: one shared Google Ads strategy and target driving several campaigns.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
    PORTFOLIO bid strategies: one shared Google Ads strategy and target driving several campaigns. action: list | create (name, strategy, its targets, optional campaignIds to attach) | update (targets or name; the type cannot change) | attach (campaignIds) | delete (only once no campaign uses it; confirm:true). Amounts are in the account currency. Changing targets of, or attaching, a LIVE campaign changes how it bids now: confirm:true after the user approves. Performance Max cannot use a portfolio. To move a campaign OFF a portfolio, call set_google_ads_bidding on it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Google Ads portfolio bid strategies
  • manage_google_ads_budget_networksGoogle Ads WATERFALL AND NETWORK CAPS: which network a budget spends on first and how much the others may take.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
    Google Ads WATERFALL AND NETWORK CAPS: which network a budget spends on first and how much the others may take. action 'read' (default), 'set' (settings) or 'clear', on the ACCOUNT DEFAULT or, with budgetId, on one campaign budget, which then wins. Every channel a campaign type supports must be in a tier and caps only go on tier2; Google says which if not. A budget's read says whether it can use these and why not. 'set' and 'clear' move real spend on the next auction: show the user, get a yes, then confirm:true; dryRun:true validates without changing anything.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Google Ads waterfall priorities and network spend caps
  • manage_google_ads_labelsGoogle Ads LABELS for organising campaigns, ad groups and ads ("Made by Hermoso", "Q4 test").Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Google Ads LABELS for organising campaigns, ad groups and ads ("Made by Hermoso", "Q4 test"). action: list | create (name, color #RRGGBB, description, and targets to label at once) | update (name, color, description) | apply / remove (campaignIds, adGroupIds, ads:[{adGroupId, adId}]) | delete (confirm:true). Labels never change delivery or spend. Report by label with google_ads_report over campaign_label / ad_group_label / ad_group_ad_label.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Google Ads labels on campaigns, ad groups and ads
  • manage_google_ads_negative_listShared NEGATIVE KEYWORD LISTS: one list of blocked searches reused across Google Ads campaigns, or applied to the whole account.Reads text others write1 finding

    Why it is in this group

    • The name "manage_google_ads_negative_list" 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 "manage_google_ads_negative_list" destructive (destructiveHint: true), and its name says "list", a word for reading.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Shared NEGATIVE KEYWORD LISTS: one list of blocked searches reused across Google Ads campaigns, or applied to the whole account. action: list (with sharedSetId shows its keywords) | create (name, keywords, campaignIds or accountLevel:true) | add (keywords) | remove_keywords (keywords or criterionIds) | attach / detach (campaignIds) | delete. keywords are "text" or {text, matchType: BROAD|PHRASE|EXACT}. Creating, adding and attaching only block ads, so they never need confirm. Removing keywords, detaching or deleting lets blocked searches show ads again: confirm:true on a live campaign, and always for delete. One ad group's own negatives: add_google_ads_keywords with negative:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Google Ads shared negative keyword lists
  • manage_google_ads_recommendationsAct on Google Ads recommendations by id.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
    Act on Google Ads recommendations by id. action:"apply" makes the change live immediately with no undo. Any spend-type recommendation (budget, bidding, keywords, network or audience expansion, new campaigns) or one touching a LIVE campaign is refused until the user says yes: call once without confirm, show the returned list, then call again with confirm:true and the confirmCount it named. The count is re-checked against a fresh read, and if any id is no longer on offer NOTHING is applied. action:"dismiss" only takes advice off the list and needs no confirm. action:"auto_apply" with autoApply:{TYPE:true|false} lets Google apply that type by itself; turning one ON needs confirm:true, OFF never does. dryRun validates and changes nothing. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Apply / dismiss Google Ads recommendations, or set auto-apply
  • manage_google_ads_seasonalitySeasonality adjustments tell Google’s Smart Bidding that conversion rate will move for a short event (a sale, a launch, a holiday weekend), so it bids for the event instead of lear…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
    Seasonality adjustments tell Google’s Smart Bidding that conversion rate will move for a short event (a sale, a launch, a holiday weekend), so it bids for the event instead of learning it late. action "list" shows them; "create" needs name, start and end ("YYYY-MM-DD HH:mm:ss", the end is exclusive, at most 14 days apart, and Google expects a future event), conversionRateModifier (0.1 to 10: 1.5 means 50% more conversions per click than usual, 0.8 means 20% fewer) and what it covers: campaignIds (up to 2,000 campaigns) OR channels (SEARCH, DISPLAY, SHOPPING, DEMAND_GEN), never both; optional devices. "update" changes the named fields of one (id); "remove" deletes one (id). It moves real bids on every campaign it covers, so create, update and remove need confirm:true after the user agrees; dryRun:true has Google validate it and changes nothing. Google’s API cannot create an account-wide adjustment and does not allow them on manager accounts. The reply is read back from Google. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Google Ads seasonality adjustments (tell Smart Bidding about a sale or launch)
  • manage_linkedin_boost_audienceCreate (name + locations/targeting, must include a location), update (id + name, description or the whole audience) or delete (id; confirm:true deletes, without it says what would …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create (name + locations/targeting, must include a location), update (id + name, description or the whole audience) or delete (id; confirm:true deletes, without it says what would be) a SAVED LinkedIn boost audience. Read back from LinkedIn.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create, edit or delete a saved LinkedIn boost audience
  • manage_merchant_conversion_sourceWHERE MERCHANT CENTER GETS ITS CONVERSION DATA FROM, which is what free-listing and Shopping performance reporting is built on — a merchant with no conversion source sees clicks an…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
    WHERE MERCHANT CENTER GETS ITS CONVERSION DATA FROM, which is what free-listing and Shopping performance reporting is built on — a merchant with no conversion source sees clicks and no outcomes, and nothing in Merchant Center says why. Two kinds, and they are different jobs: a MERCHANT CENTER DESTINATION is a Google tag target, and creating one returns a destination id (MC-…) that is the only place that id exists, so it must be read back to the user because it is what the Google tag has to send conversions to. A GOOGLE ANALYTICS LINK pulls conversions from a GA4 property instead, needs the connected Google account to be an ADMIN on that property, and Google marks it IMMUTABLE — the property cannot be changed afterwards, only deleted and re-created. action:'list' shows every source including archived ones, 'create' adds one, 'update' changes a destination's name, currency or attribution, 'delete' ARCHIVES one (confirm-gated) and 'undelete' restores it until the expiry Google reports on the archived row. Attribution lookback is 7, 30 or 40 days and nothing else. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Merchant Center conversion sources
  • manage_merchant_notificationsPUSH INSTEAD OF POLLING for Merchant Center product status.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "push": 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
    PUSH INSTEAD OF POLLING for Merchant Center product status. Google POSTs to a URL the moment a product's status changes — a disapproval is otherwise found whenever someone happens to run list_merchant_issues, which for a feed of thousands means money burning unnoticed. action:'list' shows the subscriptions, 'create' adds one, 'delete' removes one. BE HONEST ABOUT WHERE IT GOES: callBackUri must be an HTTPS endpoint THE MERCHANT runs and can decode — Hermoso does not receive these notifications, so this only helps someone with a server on the other end. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Merchant Center push notifications
  • manage_merchant_settingsFIX THE MERCHANT CENTER SETTINGS that stop an account serving (merchant_account_status names them).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it 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
    FIX THE MERCHANT CENTER SETTINGS that stop an account serving (merchant_account_status names them). Pick section + action. shipping: get · upsert (add or update services by name; services you do not mention are KEPT) · remove (serviceNames) · replace (exactly this list). A service is {name, countries, currency, rate, freeOver?, handlingDays:[min,max], transitDays:[min,max], active?} or Google's own Service shape; delivery days are required, never guessed. returns: list · create (policy {countries, returnPolicyUri, days or policyType, itemConditions, returnMethods, processRefundDays, returnLabelSource, label?}) · delete (returnPolicyId). Google has no edit for a return policy. business_info: get · update (address, customerService {uri,email,phone}, koreanBusinessRegistrationNumber; merged field by field, null clears). homepage: get · claim (re-checks verification; overwrite:true takes it from another account) · unclaim · set_uri (removes the claim). programs: list · enable · disable (program e.g. free-listings, shopping-ads). Overwriting or removing a shipping service, replacing existing business info, deleting a return policy, unclaiming, changing a claimed homepage, overwrite:true and disabling an enabled program each answer with what would change and need confirm:true. Every write is read back from Google. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Change Merchant Center settings
  • manage_microsoft_ads_negative_keyword_listA SHARED negative keyword list on Microsoft Advertising — one set of exclusions reused across up to 20 campaigns.Reads text others write1 finding

    Why it is in this group

    • The name "manage_microsoft_ads_negative_keyword_list" 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 "manage_microsoft_ads_negative_keyword_list" destructive (destructiveHint: true), and its name says "list", a word for reading.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    A SHARED negative keyword list on Microsoft Advertising — one set of exclusions reused across up to 20 campaigns. action: create (name + keywords; campaignIds attaches it straight away), add (keywords), remove (negativeKeywordIds), attach / detach (campaignIds), delete (permanent, confirm:true). Removing, detaching or deleting on a LIVE campaign lets those searches trigger paid ads again, so it needs confirm:true. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Manage a shared Microsoft negative keyword list
  • manage_microsoft_merchant_catalogCreate, update or delete a catalog in a Microsoft Merchant Center store.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create, update or delete a catalog in a Microsoft Merchant Center store. Creating needs name + market + isPublishingEnabled; updating needs catalogId + name + isPublishingEnabled (market is not settable after creation). isPublishingEnabled is NEVER defaulted on — products serve only when it is true, so publishing a catalogue is always an explicit choice. Names must be unique within the store and are capped at 70 characters. Pass deleteIt:true with catalogId and confirm:true to remove one. Every outcome is READ BACK from Microsoft. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Create, update or delete a Microsoft Merchant Center catalog
  • manage_pinterest_ads_keywordsAdd keywords to a Pinterest ad group, or archive them.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 keywords to a Pinterest ad group, or archive them. action:"add" needs parentId (an ad group; a campaign takes only the _NEGATIVE match types) and keywords; Pinterest’s per-keyword refusals are reported. action:"archive" needs keywordIds; archiving is how Pinterest deletes a keyword. Read back from Pinterest. pinterest_ads_keyword_ideas finds candidates. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add or archive Pinterest ad keywords
  • manage_pinterest_ads_promotionCreate, change or delete a Pinterest PROMOTION, the discount an ad group can show.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create, change or delete a Pinterest PROMOTION, the discount an ad group can show. action:"create" needs title and type (the kind of offer, which sets the text shown) and takes code, startTime, endTime (Unix seconds), templateValues (what fills the text), discountStatus, and any other Pinterest field in fields; "update" needs promotionId; "delete" needs promotionId and confirm:true. Read back from Pinterest. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Manage Pinterest promotions
  • manage_pinterest_ads_targeting_templateSave a Pinterest targeting set to reuse across ad groups, or remove one.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Save a Pinterest targeting set to reuse across ad groups, or remove one. action:"create" needs name and targetingSpec; "remove" needs templateId. Pinterest does not let an ordinary account edit a saved one, so a changed set is a new template. Read back from Pinterest. 0 credits.

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add, rename or delete a sheet tab
  • manage_snapchat_ads_lead_webhookHave Snapchat PUSH every new lead from a lead form to Hermoso the moment it is submitted — the ONLY way Snapchat hands leads to an API (it has no endpoint that lists leads), so lea…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
    Have Snapchat PUSH every new lead from a lead form to Hermoso the moment it is submitted — the ONLY way Snapchat hands leads to an API (it has no endpoint that lists leads), so leads submitted before this was on are never delivered. action 'subscribe' (default) turns it on, read back from Snapchat; forwardTo (public https) also relays each lead to a CRM, Zapier or Make. 'list' shows the form's webhooks; 'test' makes Snapchat send its sample lead and waits for it to ARRIVE at Hermoso, which proves delivery end to end; 'delete' removes a webhook (confirm:true; one Hermoso did not make may feed the advertiser's own CRM, and the refusal says so). Snapchat allows ONE webhook per form and requires Organization Admin on the Snapchat organization. Every delivery is verified against Snapchat's HMAC signature before it is stored. Read leads with list_snapchat_ads_leads. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn on real-time Snapchat lead delivery
  • manage_tiktok_ads_blocked_wordsChange the ad account’s blocked-word list — the standing filter that auto-hides any comment containing one of these words across every ad on the account.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
    Change the ad account’s blocked-word list — the standing filter that auto-hides any comment containing one of these words across every ad on the account. operation "add" (up to TikTok’s 500-word account limit, refused here for free if the list would overflow rather than failing at TikTok), "remove", or "replace" one word with another. Warning: REMOVING A WORD REPUBLISHES HISTORY: TikTok’s own words are that comments already hidden by it "will become public instead of being visible only to the commentor" — a bulk unhide across every ad on the account, for which TikTok reports no count. So a remove without confirm changes nothing and tells you which of the words are actually on the list first. EVERY WRITE HERE IS READ BACK: TikTok answers all three operations with an empty response and its delete explicitly does not error on a word that was never on the list, so reporting off the response would report a no-op as a change — the reply is the diff of the list before and after.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Add, remove or replace TikTok comment blocked words
    • idempotentHint: false
  • manage_tiktok_ads_catalog_feedThe scheduled import that fills a TikTok catalog from the product feed a store already publishes — Shopify, WooCommerce and BigCommerce all expose one, so this is usually the whole…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The scheduled import that fills a TikTok catalog from the product feed a store already publishes — Shopify, WooCommerce and BigCommerce all expose one, so this is usually the whole job of getting a merchant’s products into TikTok. THE ONE THING TO GET RIGHT IS updateMode, and it has NO DEFAULT ON PURPOSE: INCREMENTAL creates new products and updates existing ones, while OVERWRITE IS A FULL REPLACEMENT THAT REMOVES EVERY PRODUCT THE FEED OMITS — pointing a partial feed at a populated catalog in OVERWRITE mode deletes the rest of it. uri, intervalType and timezone are ALL-OR-NOTHING; TikTok requires each of the three whenever either of the others is given, so a URL with no schedule is a rejected call rather than a one-off fetch. If any additional-image URL inside the feed contains a comma it must be URL-encoded as %2C, or TikTok splits it into two URLs (Shopify-style transform parameters are the common case). Products do not appear instantly: the feed runs on its schedule and then TikTok reviews the products, so check list_tiktok_ads_catalog_products and tiktok_ads_catalog_diagnostics rather than expecting them immediately. action:"delete" is confirm-gated and stops FUTURE imports — the products already imported stay in the catalog.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: List, create or delete a TikTok catalog product feed
    • idempotentHint: false
  • manage_tiktok_ads_negative_keywordsSearch terms a TikTok ad must NOT show for.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "search": 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.
    Description, as the server wrote it
    Search terms a TikTok ad must NOT show for. level "advertiser" (default) is the whole ad account, or "campaign" / "adgroup" with objectId. action "list" reads them; "add" takes keywords (words, or {text, match} with match exact, phrase or broad; broad by default; up to 1,000, 80 characters each); "update" changes one (keywordId + keyword, fromMatch when the word has several match types); "remove" deletes keywordIds (match narrows it to one match type). A negative is a word plus a match type, and the keyword id names the word, so one id can carry several match types. Adding only narrows who sees the ads and runs on the ask; update, remove and add with replace:true let ads show on searches they were kept off, so they need confirm:true after the user agrees. Every change is read back from TikTok. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: TikTok negative keywords (ad account, campaign or ad group)
  • manage_tiktok_ads_offline_event_setCreate, rename or delete an Offline Event set — the container in-store and other real-world conversions are reported into.Reads text others writeNo findings

    Why it is in this group

    • The name "manage_tiktok_ads_offline_event_set" 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
    Create, rename or delete an Offline Event set — the container in-store and other real-world conversions are reported into. AUTOTRACKING IS A STANDING SETTING RATHER THAN A PROPERTY OF THIS SET: with it on, EVERY campaign created under this advertiser afterwards attributes to it automatically, including campaigns nobody has thought of yet. TikTok caps an advertiser at ten auto-tracking sets, and once that is reached a non-auto-tracking set cannot be switched over until one is deleted — so leave it off unless the user means it. DELETING is confirm-gated, and not because of the container: every conversion already reported into it stops being available to reporting and optimisation, campaigns tracking it lose their attribution, and TikTok publishes no undelete. A create is READ BACK from TikTok, because the create response is only an id and never the stored row. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Create, rename or delete a TikTok Offline Event set
  • manage_tiktok_ads_test_leadTikTok’s own test-lead mechanism — the way to prove a lead pipeline works end to end WITHOUT waiting for a real person to fill in a form, and the exact twin of testEventCode on sen…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
    TikTok’s own test-lead mechanism — the way to prove a lead pipeline works end to end WITHOUT waiting for a real person to fill in a form, and the exact twin of testEventCode on send_tiktok_ads_events. action "create" makes one, "get" reads the existing one, "delete" removes it. A test lead flows through the SAME download path as a real one (so download_tiktok_ads_leads is provably wired), carries obviously-dummy campaign and ad-group names so it can never be mistaken for a customer, spends nothing and reaches nobody. TikTok allows EXACTLY ONE test lead per Instant Form, so delete the existing one before creating another. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create, read or delete a TikTok TEST lead
    • idempotentHint: false
  • manage_tiktok_tto_anchorWebpage anchors: the link that appears above a creator’s video description and in its comment section, sending viewers to a product or service page.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
    Webpage anchors: the link that appears above a creator’s video description and in its comment section, sending viewers to a product or service page. action "list", "create" or "delete". AN ANCHOR CREATED HERE CAN NEVER BE DELETED: TikTok removes only DRAFT anchors, an anchor created through the API is born IN_REVIEW, and no API path produces a draft; so treat creating one as permanent, exactly like a TikTok pixel. An anchor is visible ONLY to viewers in its own country, and TikTok measures its performance only when the creator’s country matches too; the video still reaches everyone, the anchor does not. The landing page must be a product or service DETAIL page or TikTok rejects it during review. The thumbnail is passed as a public URL: TikTok also accepts a file upload, and that transport is deliberately not built because the URL form is documented as equivalent. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: List, create or delete TikTok webpage anchors
    • idempotentHint: false
  • microsoft_ads_bulk_uploadApply a Microsoft Advertising BULK FILE — edit hundreds of campaigns, ad groups, ads, keywords, extensions or labels in one request.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Warn

      The description contains "EVERY OTHER TOOL", wording about other tools or servers.

      Matched text

      description: "...field. THE SPEND GATE, AND IT IS UNLIKE EVERY OTHER TOOL HERE. A bulk file carries a Status colu..."

      What this check looks for
    Description, as the server wrote it
    Apply a Microsoft Advertising BULK FILE — edit hundreds of campaigns, ad groups, ads, keywords, extensions or labels in one request. Pass `file` as the CSV/TSV string; microsoft_ads_bulk_download returns exactly that shape in its `file` field. THE SPEND GATE, AND IT IS UNLIKE EVERY OTHER TOOL HERE. A bulk file carries a Status column, so one upload can turn campaigns ON — and confirm:true ALONE IS NOT ENOUGH for a file: it proves you meant to upload something, not that you know what THIS file does, and it reads identically for a file that changes two bids and one that activates fifty campaigns. So: call it ONCE with no confirmation. Nothing is uploaded, and you are told exactly how many objects the file would ACTIVATE (they can then spend real money) and DELETE (which Microsoft never undoes — a deleted object is never returned by any read again), each named with its row number, type, id and name. SHOW THAT LIST TO THE USER, get an explicit yes, then call again with confirm:true, confirmActivations:<n> and confirmDeletions:<n>. If the activations are incidental — a file you round-tripped out of a download and only meant to edit bids in — pass pauseInstead:true instead and those rows are written as Paused, so everything else lands with nothing armed; it is refused when the file also deletes, because pausing is a safe substitute for activating and there is none for deleting. Partial success is normal on this API: rows Microsoft rejects come back listed individually and the correct ones ARE applied, so never describe a CompletedWithErrors upload as a failure. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Apply a Microsoft Advertising bulk file (spend-gated)
    • idempotentHint: false
  • moderate_tiktok_ads_commentHiding takes a comment out of public view — everyone stops seeing it except the person who wrote it, who is never told — and it works on ANYONE’s comment, which is what distinguish…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Hiding takes a comment out of public view — everyone stops seeing it except the person who wrote it, who is never told — and it works on ANYONE’s comment, which is what distinguishes it from delete_tiktok_ads_comment (that one only ever removes your own reply). IT IS FULLY REVERSIBLE: the same tool with operation PUBLIC puts a comment back, which is why it needs no confirmation. Takes a list, so a whole batch of spam goes in one call. TikTok answers this endpoint with no data at all, so the reply reports what was ACCEPTED and tells you to re-run list_tiktok_ads_comments to see commentStatus change — it is not a read-back and does not pretend to be. To hide a whole class of comment automatically and permanently, add the word to the account’s blocked-word list instead (manage_tiktok_ads_blocked_words).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Hide or unhide comments on a TikTok ad
    • idempotentHint: false
  • 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
  • openai_ads_bulkCreate or update up to 1,000 ChatGPT Ads campaigns, ad groups and ads in ONE asynchronous job.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create or update up to 1,000 ChatGPT Ads campaigns, ad groups and ads in ONE asynchronous job. It builds CHAT-CARD campaigns only: its campaign.create has no product-feed mode, and OpenAI’s spreadsheet bulk creation of product-feed campaigns and ad groups with auto-generated ad templates is an Ads Manager feature with no API. Build a product-feed campaign with create_openai_ads_campaign (mode product_feed), create_openai_ads_ad_group and an ad whose creative type is the product-ad template instead. Each operation is {operation_id, type, idempotency_key|target_resource_id, input}. Types: campaign.create, campaign.update, ad_group.create, ad_group.update, ad.create, ad.update. FORWARD REFERENCES are the point: set input.campaign_idempotency_key / input.ad_group_idempotency_key to another CREATE operation’s idempotency_key and the child attaches to the parent made in the same job (a key no operation mints is refused here, for free, rather than failing the whole job at OpenAI). EVERYTHING CREATED IS PAUSED and spends nothing — status:"active" on a create is overridden, and an UPDATE that would set "active" is REFUSED BY NAME, because one job could otherwise arm a thousand objects in a single call that no confirmation ever saw; turn things on one at a time with set_openai_ads_status. Use validateOnly:true for a FREE dry run (not update-target existence, image fetching or entity limits, so a validated job can still fail). Returns a jobId — poll it with openai_ads_bulk_job; an operation’s result is only final once the job is completed, partially_failed or failed. LIMITS (OpenAI’s): 1–1000 operations, 16 MiB body, 512 KiB per operation, 10 job creates per 10 s per ad account, budget ≥ 1000000 micros, titles 3–50, bodies ≤100. THE BULK API IS IN LIMITED PREVIEW AND ENABLED PER AD ACCOUNT: a 404 means this account has not been granted it (not a wrong path), and the refusal says so and names the per-object tools that do the same work.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: ChatGPT Ads bulk create/update job
  • pinterest_ads_bulkPinterest’s BULK lane: many campaigns, ad groups, ads, keywords or product groups in one request.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
    Pinterest’s BULK lane: many campaigns, ad groups, ads, keywords or product groups in one request. action:"download" exports them; action:"upsert" creates or updates them from create and update, in Pinterest’s own object shapes; action:"status" reads a request by requestId and gives the result file link. Download and upsert run in the background, so read status next. A created object with no status goes in PAUSED; anything that starts delivery or changes a budget or bid is refused until the user agrees and confirm:true is passed. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Pinterest bulk export and upsert
  • publish_openai_ads_business_agentPublish a Business Agent’s draft so every campaign referencing it serves this version to real users.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "publish_openai_ads_business_agent" says "publish": it sends or publishes something to other people.
    Description, as the server wrote it
    Publish a Business Agent’s draft so every campaign referencing it serves this version to real users. confirm:true required; show the user the instructions first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Publish a ChatGPT Ads Business Agent
    • idempotentHint: false
  • publish_openai_ads_lead_formPublish the current draft of a ChatGPT Ads lead form so Business Agents can use it.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "publish_openai_ads_lead_form" says "publish": it sends or publishes something to other people.
    Description, as the server wrote it
    Publish the current draft of a ChatGPT Ads lead form so Business Agents can use it. expectedDraftRevisionId is the draftRevisionId you last read. Show the user the fields before publishing: the form is what real people will see.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Publish a ChatGPT Ads lead form
    • idempotentHint: false
  • publish_tag_manager_containerPUBLISH THE CONTAINER — the ONE call in Hermoso that changes what runs on the customer's live website for every visitor, immediately.Reads text others writeCan send data out1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

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

      Matched text

      description ends: "...rmission, not a broken connection. 0 credits. Needs Google Tag Manager connected."

      What this check looks for
    Description, as the server wrote it
    PUBLISH THE CONTAINER — the ONE call in Hermoso that changes what runs on the customer's live website for every visitor, immediately. Tag Manager publishes a VERSION, so the draft workspace becomes a version, then that is published. CALLING IT WITHOUT confirm PUBLISHES NOTHING and is the correct first move: it returns what is live right now, its tag/trigger/variable counts, and exactly what would change, read back from Google. Show the user, get a yes, then call again. THE GATE SCALES WITH THE DAMAGE. A NEVER-published container needs only confirm:true. A container that ALREADY has a live version is replacing something that works, so it additionally needs confirmPublicId set to that container's GTM-XXXXXXX public id. It cannot be guessed; read it from list_tag_manager_containers or from the preview. IT REFUSES, FOR FREE AND WITHOUT PUBLISHING, in four cases you should relay rather than retry: merge conflicts in the workspace (somebody changed the same thing in the container — resolve in Tag Manager first), a workspace with no changes at all, a version Google reports a COMPILER ERROR in, and a container whose public id could not be read. TO UNDO: publish the previous version again (versionPath from list_tag_manager_versions, no workspace involved); rolledBackTo names it. READ verified BEFORE YOU TELL ANYONE IT IS LIVE. It is three-valued: true means the container's live version was re-read and IS the one just published; false means Google accepted it but something else is live, which can be Tag Manager's own read lag and must be reported as unconfirmed; null means the read-back could not run, so it is not known — never report false or null as published. Creating the version DELETES the draft workspace and opens a fresh empty one (id in the reply), so any workspace id you hold is stale. Publishing needs the PUBLISH right on the container (Admin, User Management), separate from Edit; a refusal there is a permission, not a broken connection. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Publish the container to the live site
    • idempotentHint: false
  • reddit_ads_data_deletionHonour a person’s data-deletion request on Reddit Ads: asks Reddit to PERMANENTLY delete the ads data it holds for their identifiers — EMAIL, PHONE_NUMBER, IDFA, AAID or EXTERNAL_I…Reads text others writeNo findings

    Why it is in this group

    • 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
    Honour a person’s data-deletion request on Reddit Ads: asks Reddit to PERMANENTLY delete the ads data it holds for their identifiers — EMAIL, PHONE_NUMBER, IDFA, AAID or EXTERNAL_ID, 1–200 per job — across the shared ad account, or only under one pixel (pixelId; Reddit requires business-admin access for that). Emails and phone numbers are canonicalised and SHA-256 hashed here exactly as the audience upload and Conversions API hash them, so the deletion matches what was sent; a 64-hex hash you made yourself passes through. It removes ads data (custom-audience matches, conversion records) and never anyone’s Reddit account. Call WITHOUT confirm first — nothing is sent and the answer states the scope — then again with confirm:true. Reddit processes jobs DAILY and finishes within 30 days: pass jobId alone to check one (QUEUED, COMPLETED or FAILED), at most once a day.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Request (or check) deletion of a person’s Reddit ads data
    • idempotentHint: false
  • refund_stripe_chargeRefund a Stripe charge (ch_… or a pi_… payment intent): the full refundable amount, or a partial `amount` in major units; optional reason duplicate / fraudulent / requested_by_cust…Reads text others writeNo findings

    Why it is in this group

    • The name "refund_stripe_charge" says "refund": 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
    Refund a Stripe charge (ch_… or a pi_… payment intent): the full refundable amount, or a partial `amount` in major units; optional reason duplicate / fraudulent / requested_by_customer. ALWAYS needs confirm:true, test keys included. Read back. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: refund stripe charge
    • idempotentHint: false
  • remove_applovin_ads_creative_setTake an AppLovin creative set out of its campaigns (all of them, or campaignIds).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Take an AppLovin creative set out of its campaigns (all of them, or campaignIds). AppLovin’s API has no delete or archive, so this is its only removal: the set and its assets stay on the account and can be added back. Call it WITHOUT confirm FIRST: nothing changes and you get the campaigns it is in; show the user, then call with confirm:true, plus confirmName (its exact name) and confirmChildren when the reply asks for them. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove an AppLovin creative set from its campaigns
  • remove_bing_webmaster_siteRemove a site from the connected Bing Webmaster account — the heaviest thing in this connector.Reads text others writeNo findings

    Why it is in this group

    • The name "remove_bing_webmaster_site" 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 site from the connected Bing Webmaster account — the heaviest thing in this connector. GATED ON BLAST RADIUS: called WITHOUT `confirm` it removes nothing and reports whether Bing holds the site as VERIFIED and how many sitemaps are registered on it; a site that is verified or has any sitemaps then ALSO needs `confirmSiteUrl` set to that exact site string, which is a fact you only have after inspecting it. A site that was never verified and has no sitemaps is the empty radius and stays a one-call removal — friction that does not scale with the loss just gets routed around. RE-ADDING A VERIFIED SITE LATER MEANS PROVING OWNERSHIP FROM SCRATCH; no API restores it. Nothing about the site itself or its Bing ranking changes. The site is also dropped from this brand's shared list, and if the read-back that confirms the removal cannot run the answer says "could not tell", never "removed". 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Remove a site from the Bing Webmaster account
    • idempotentHint: false
  • remove_bing_webmaster_sitemapRemove a sitemap from Bing.Reads text others writeNo findings

    Why it is in this group

    • The name "remove_bing_webmaster_sitemap" 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 sitemap from Bing. GATED ON BLAST RADIUS, not just on intent: called WITHOUT `confirm` it removes nothing and reports what Bing says that sitemap actually carries — its URL count, status and type — and a sitemap carrying any URLs then ALSO needs `confirmUrlCount` set to that number. confirm:true proves you meant to remove something; the echoed count proves you aimed at the sitemap you inspected rather than one that merely shares a name. A sitemap Bing reports as empty stays a one-call removal. Removing it does NOT remove those pages from Bing's index — Bing simply stops using it to find new ones — and it can be submitted again at any time. If the read-back that confirms the removal cannot run, the answer says "could not tell", never "removed". 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Remove a sitemap from Bing
    • idempotentHint: false
  • 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_microsoft_ads_negative_keywordsRemove negative keywords (by id, from list_microsoft_ads_negative_keywords) from a Microsoft Advertising campaign or ad group.Reads text others writeNo findings

    Why it is in this group

    • The name "remove_microsoft_ads_negative_keywords" 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 negative keywords (by id, from list_microsoft_ads_negative_keywords) from a Microsoft Advertising campaign or ad group. On a LIVE campaign that lets those searches trigger paid ads again, so it needs confirm:true after the user agrees. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove Microsoft Advertising negative keywords
  • remove_openai_ads_daily_spend_limitRemove the account-wide DAILY spending limit on ChatGPT Ads.Reads text others writeNo findings

    Why it is in this group

    • The name "remove_openai_ads_daily_spend_limit" 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 the account-wide DAILY spending limit on ChatGPT Ads. This takes a spending CEILING off the whole account, so campaigns may then spend up to their own budgets every day; date-range spend-limit windows are not touched. Like every account spending-limit request it needs postpaid INVOICE billing and billing-management permission; a card-billed account is refused whatever key is used. Without confirm:true AND expectedRevision (the revision list_openai_ads_spend_windows returns) nothing changes and the reply names the limit that would be removed. With several daily rules, pass windowId to name the one to remove (OpenAI requires it then). The result is read back from ChatGPT Ads.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Remove the ChatGPT Ads account daily spending limit
    • idempotentHint: false
  • remove_tracking_tagTAKE A PIXEL OFF THE BRAND'S WEBSITE.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    TAKE A PIXEL OFF THE BRAND'S WEBSITE. Tag Manager: deletes the tag Hermoso installed for that pixel (only Hermoso's own, never somebody else's), as a draft, live only with publish:true through the usual publish confirmation. Wix: removes the site's marketing tag of that type only when it IS this pixel. Other sites: says where to delete the code by hand. The site stops sending that platform data once it is gone, so WITHOUT confirm:true NOTHING CHANGES and the reply names exactly what would be removed: show the user, get a yes, then call again with confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove a pixel from the website
  • reply_to_tiktok_ads_commentPost a public reply, as the brand, under a comment on one of your TikTok ads.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "reply_to_tiktok_ads_comment" says "reply": it sends or publishes something to other people.
    Description, as the server wrote it
    Post a public reply, as the brand, under a comment on one of your TikTok ads. THE REPLY IS LIVE IMMEDIATELY AND IS PUBLIC, posted as the TikTok identity you name, so let the user approve the wording. TikTok requires FIVE ids and every one of them is on the comment row itself — pass back commentId, adId, tiktokItemId, identityId and identityType exactly as list_tiktok_ads_comments reported them rather than assembling them by hand; a mismatched identity is a public mistake. IdentityType on the comment endpoints is narrower than on the ad builder: only TT_USER or CUSTOMIZED_USER. The reply comes back as TikTok’s own stored row with its new comment id, so the answer is TikTok’s record and not an echo — and because it is your own comment, delete_tiktok_ads_comment can remove it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Reply publicly to a comment on a TikTok ad
    • idempotentHint: false
  • request_tiktok_tto_spark_authorizationAsk the creator of a campaign video for Spark Ads authorization, so the brand can run their organic post as an ad.Reads text others writeNo findings

    Why it is in this group

    • The name "request_tiktok_tto_spark_authorization" says "request": 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
    Ask the creator of a campaign video for Spark Ads authorization, so the brand can run their organic post as an ad. THIS IS THE ONLY WAY TO OBTAIN A SPARK ADS CODE WITHOUT THE CREATOR PASTING ONE OUT OF THE TIKTOK APP BY HAND: once they accept, get_tiktok_tto_spark_authorization hands back the code that authorize_tiktok_ads_spark_post takes, which then makes the post usable by create_tiktok_ads_ad. THE NUMBER OF DAYS IS A REQUEST, NOT A SETTING: TikTok says the creator picks the actual window when approving, so read the granted dates back rather than assuming what was asked for. action "EXTEND" lengthens an authorization the creator has already approved. TikTok returns no confirmation body for this call, so the state in the reply was read back separately rather than echoed. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Ask a TikTok One creator for Spark Ads authorization
    • idempotentHint: false
  • resume_openai_ads_audience_operationResume an existing ADD or REMOVE on a ChatGPT Ads custom audience from its own checkpoints with its original inputs, so nothing is uploaded again.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
    Resume an existing ADD or REMOVE on a ChatGPT Ads custom audience from its own checkpoints with its original inputs, so nothing is uploaded again. Free. The reply is the status read back after the resume, never the request alone.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Resume a ChatGPT Ads audience membership operation
    • idempotentHint: false
  • run_google_ads_ruleDRY RUN BY DEFAULT: reads the live metrics and returns, object by object, the values it measured and exactly what it WOULD change, with every cap applied — nothing is written.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    DRY RUN BY DEFAULT: reads the live metrics and returns, object by object, the values it measured and exactly what it WOULD change, with every cap applied — nothing is written. It is the same plan a live run applies, so it cannot describe something a run would not do. dryRun:false applies it now (same gate as switching on), reads the result back and logs it; undo_google_ads_rule_action reverses it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Dry-run (or run now) a Google Ads automated rule
  • run_meta_ad_ruleDRY RUN BY DEFAULT: Meta's own preview of which campaigns / ad sets / ads pass the rule right now, with names and budgets — nothing changes.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    DRY RUN BY DEFAULT: Meta's own preview of which campaigns / ad sets / ads pass the rule right now, with names and budgets — nothing changes. Use it before switching a rule on, and to sanity-check money units. dryRun:false asks Meta to RUN it now (Meta runs a switched-off rule by hand too), so it takes the same gate as switching on; the run is asynchronous, read it with meta_ad_rule_history. Schedule rules only. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Dry-run (or run now) a Meta automated rule
  • send_applovin_ads_eventsSend website conversion events to AppLovin from the server (its Conversion API): purchase, generate_lead, add_to_cart and the rest, up to 100 per batch, each with the visitor’s pub…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_applovin_ads_events" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send website conversion events to AppLovin from the server (its Conversion API): purchase, generate_lead, add_to_cart and the rest, up to 100 per batch, each with the visitor’s public IP, user agent and one identifier. Email and phone are hashed with AppLovin’s own normalisation before sending; a purchase dedupes on its transaction id. Needs the Conversion API key, which AppLovin enables per account on request; without it the answer says how to get it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send conversion events to AppLovin
  • send_linkedin_conversionsStream conversion events to LinkedIn (Conversions API) — server-side conversion tracking for things that happen where the Insight Tag cannot see them: a CRM deal closing, an offlin…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_linkedin_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Stream conversion events to LinkedIn (Conversions API) — server-side conversion tracking for things that happen where the Insight Tag cannot see them: a CRM deal closing, an offline sale, a phone order, a qualified lead. Needs a rule from create_linkedin_conversion_rule, and that rule needs campaigns associated or nothing is attributed. PASS THE PERSON’S PLAIN EMAIL ADDRESS as `email` — Hermoso applies LinkedIn’s own normalization and SHA-256 hashes it on the server, and the plaintext is never stored or logged. NEVER COMPUTE THE HASH YOURSELF: an invented digest is a well-formed 64-character string that matches nobody, and LinkedIn accepts it with a 201, so the failure is completely silent (`emailSha256` exists only for a source system that already holds real digests). SEND EVERY IDENTIFIER YOU HAVE — email, liFatId (the li_fat_id click id LinkedIn appends to ad click URLs), ipAddress, firstName WITH lastName, an externalId, a lead URN — the match rate is what decides whether the conversion counts at all. Events must have happened in the past 90 DAYS. ACCEPTED IS NOT MATCHED: success means LinkedIn took the events, not that any matched a member, and no API reports the match rate — check attribution in linkedin_ads_report over the following days and never present acceptance as conversions. Up to 5000 events per call. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send conversions to LinkedIn (Conversions API)
  • send_meta_conversionsSend SERVER events to the brand’s OWN Meta pixel (the Conversions API): Purchase, Lead, CompleteRegistration, AddToCart, InitiateCheckout, ViewContent, Contact, Subscribe or a cust…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_meta_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send SERVER events to the brand’s OWN Meta pixel (the Conversions API): Purchase, Lead, CompleteRegistration, AddToCart, InitiateCheckout, ViewContent, Contact, Subscribe or a custom name, for sales and sign-ups the browser pixel misses (a CRM deal, a phone order, a checkout the browser blocked). The pixel must be on one of the brand’s ticked ad accounts (list_meta_pixels); any other id is refused. PASS PLAIN VALUES (email, phone with country code, firstName, lastName, city, state, zip, country, dateOfBirth, externalId): Hermoso normalizes and SHA-256 hashes them per Meta’s rules, so never hash them yourself. clientIpAddress, clientUserAgent, fbc or fbclid, fbp and a Meta leadId go as given. A website event needs eventSourceUrl and clientUserAgent. Give every event an eventId (the same one the browser pixel sends) so Meta deduplicates it. Events up to 7 days old (62 for physical_store), up to 1,000 per call. testEventCode sends to Events Manager’s Test Events, and those events still count. The brand is responsible for its customers’ consent to share this data with Meta. RECEIVED IS NOT MATCHED: the reply reads back Meta’s events_received. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send conversions to a Meta pixel (Conversions API)
  • send_microsoft_ads_offline_conversionsTell Microsoft Advertising about conversions that happened OFF the website — a phone sale, an in-store purchase, a lead that closed weeks after the click — so smart bidding on that…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_microsoft_ads_offline_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Tell Microsoft Advertising about conversions that happened OFF the website — a phone sale, an in-store purchase, a lead that closed weeks after the click — so smart bidding on that account stops optimising against only what converted online. Each row needs conversionName (an existing OFFLINE conversion goal, matched by name — list_microsoft_ads_conversion_goals shows them), conversionTime (within the last 90 days AND after the click), and an identifier: either microsoftClickId (the msclkid Microsoft appends to the landing-page URL) or, for ENHANCED conversions, a plain email and/or phone. YOU PASS PLAIN VALUES AND THE HASHING HAPPENS SERVER-SIDE: emails are normalized and SHA-256’d to Microsoft’s own published five-step spec, which is verified against Microsoft’s own worked digests. A PHONE MUST ALREADY CARRY ITS COUNTRY CODE (+14255551234) and is refused otherwise — Microsoft’s spec says "normalize to E.164 format with country code" and stops there, and guessing which country a bare 4255551234 belongs to is not a mistake you would ever see: the upload succeeds and matches nobody. SAY THIS WHEN REPORTING: accepted is not the same as visible. Microsoft takes up to 6 hours to show offline conversion data and applies nothing at all in the first 2 hours after a goal is created, and a conversion only counts inside the goal’s own conversion window. Duplicates are silently ignored (the first wins), so re-sending a batch is safe and changes nothing. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send offline + enhanced conversions to Microsoft
    • idempotentHint: false
  • send_openai_ads_conversionsSend conversion events to ChatGPT Ads from a SERVER (the Conversions API).Reads text others writeCan send data out2 findings

    Why it is in this group

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

    What it can reach

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

    Findings

    • High

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

      Matched text

      description: "...run that VALIDATES AND SAVES NOTHING — never tell a user a validate-only run was measured. If th..."

      What this check looks for
    • Info

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

      Matched text

      description ends: "...ersion, give them the SAME id so OpenAI deduplicates it. Free — costs no credits."

      What this check looks for
    Description, as the server wrote it
    Send conversion events to ChatGPT Ads from a SERVER (the Conversions API). USER MATCHING: pass plaintext email / phone (with country code) / externalId / firstName / lastName and Hermoso hashes them locally, plus raw country / city / region / zip_code and gaid (Android advertising id); each becomes the API’s plural list (emails_sha256, phone_numbers_sha256, …), the first three unique values per list count, and more fields = better matching. This is the only way a conversion that did not happen in the browser — an offline sale, a webhook, a mobile backend, a CRM — is ever counted, and it is the half of the measurement loop that create_openai_ads_pixel and create_openai_ads_conversion_event exist to set up. TWO IDS LOOK ALIKE AND ONLY ONE WORKS: pass `pixelSnippetId`, which is OpenAI’s `pixel_id` and is what create_openai_ads_pixel returns under that name — NOT the `pixelId` (their `clidsrc_…` value), which is the conversion SOURCE id that an event setting takes as sourceIds. THE KEY IS ALSO NOT THE ONE YOU THINK: `apiKey` is the CONVERSIONS API key from create_openai_ads_conversion_api_key, not the Advertiser API key this workspace is connected with — OpenAI return it exactly once so Hermoso holds no copy and it must be passed in. Each event needs an `id` and a `type`, plus `source_url` for a web event; the data SHAPE is fixed by the event type and Hermoso fills it in, and MONEY IS AN INTEGER IN THE CURRENCY’S MINOR UNIT (4250 means $42.50 — sending 42.50 is refused, not rounded). Timestamps must be inside the last 7 days and no more than 10 minutes ahead. ONE BAD EVENT FAILS THE WHOLE BATCH of up to 1,000, so Hermoso validates locally first and names the offending event and field instead of letting OpenAI discard all of them. Use validateOnly:true for a free dry run that VALIDATES AND SAVES NOTHING — never tell a user a validate-only run was measured. If the browser pixel and the server both send the same conversion, give them the SAME id so OpenAI deduplicates it. Free — costs no credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Send server-side conversion events to ChatGPT Ads
  • send_pinterest_ads_conversionsSend conversions to Pinterest server-side — purchases, sign-ups, leads, add-to-carts or any of Pinterest’s 22 events — so Pinterest attributes them to the ads that caused them and …Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_pinterest_ads_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Send conversions to Pinterest server-side — purchases, sign-ups, leads, add-to-carts or any of Pinterest’s 22 events — so Pinterest attributes them to the ads that caused them and conversion campaigns can optimise. Pass ordinary emails, phones and names: they are normalised Pinterest’s way and SHA-256 hashed on our server before they reach Pinterest. Every event needs something to match on: an email, a mobile ad id (maid), or BOTH ipAddress and userAgent — refused here otherwise. Pass eventId (your order or event id) if the site also runs the Pinterest tag, or the same conversion is counted twice. test:true makes Pinterest validate the events and record NOTHING — use it first. The reply counts what Pinterest PROCESSED, not what was sent, and names every failed event. Spends nothing, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Send conversions to Pinterest (Conversions API)
  • send_reddit_ads_conversionsReport conversions to Reddit server-side — purchases, leads, sign-ups, or your own custom events — so Reddit can attribute them to the ads that caused them and optimise delivery to…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_reddit_ads_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Report conversions to Reddit server-side — purchases, leads, sign-ups, or your own custom events — so Reddit can attribute them to the ads that caused them and optimise delivery toward them. This is what makes a CONVERSIONS campaign work; without it Reddit optimises blind. Send events as close to real time as you can: Reddit REFUSES anything older than seven days, and deduplication against the browser pixel only works inside two days. Pass ordinary email addresses and phone numbers — they are canonicalised and SHA-256 hashed on our server before they reach Reddit, and a value you already hashed is passed through untouched. The more match keys per event (email, phone, clickId, uuid, externalId, IP + user agent) the better the attribution. Set conversionId on every event if you ALSO run the browser pixel, or the same purchase is counted twice. Costs no credits and spends no ad money — this is measurement. Needs the "adsconversions" permission: if Reddit answers 403, the connection predates it and the user must reconnect Reddit Ads.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send conversions to Reddit (Conversions API)
    • idempotentHint: false
  • send_snapchat_ads_conversionsReport conversions to Snapchat server-side (Conversions API v3) so it can attribute them to ads and optimise delivery toward them — purchases, sign-ups, leads, page views and the r…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_snapchat_ads_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Report conversions to Snapchat server-side (Conversions API v3) so it can attribute them to ads and optimise delivery toward them — purchases, sign-ups, leads, page views and the rest. pixelId for website and offline events (list_snapchat_ads_pixels), or snapAppId for app events. Pass plain emails and phone numbers: Hermoso normalises and SHA-256 hashes them before they leave. Snapchat's rules, refused for free: each event needs something to match on (email, phone, madid, ipAddress + userAgent, clickId from the ScCid URL parameter, or leadId); WEB events need eventSourceUrl; PURCHASE needs customData.currency and value; nothing older than 7 days; at most 2,000 events per call. validateOnly:true has Snapchat CHECK the events and records nothing — use it first. eventId deduplicates against the browser pixel. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send conversions to Snapchat (Conversions API)
    • idempotentHint: false
  • send_tiktok_ads_eventsSERVER-SIDE CONVERSION TRACKING — report a purchase, signup, form submission or lead to TikTok straight from a server, so TikTok can attribute it and optimise delivery toward it.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_tiktok_ads_events" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    SERVER-SIDE CONVERSION TRACKING — report a purchase, signup, form submission or lead to TikTok straight from a server, so TikTok can attribute it and optimise delivery toward it. This is what makes a pixel useful: a pixel with no events is inert, and a conversion campaign optimising toward an event nobody sends has nothing to learn from. ALWAYS OFFER testEventCode FIRST: an event carrying it lands in the Test Events tab of Events Manager and is EXCLUDED from reporting, attribution and optimisation, whereas an event sent WITHOUT it is a real, permanent conversion that TikTok will optimise against and that NO endpoint deletes. The code is copied out of Events Manager in a browser (open the pixel or event set > Test Events > the code button under "Test Server Events") and no API mints one, exactly like a Spark Ads authorization code. eventTime is a Unix timestamp in SECONDS — milliseconds are refused here for free, because TikTok accepts them and reads them as a date tens of thousands of years away, so the event is silently attributed to nothing. Emails, phones and external ids are trimmed, lower-cased, E.164-normalized and SHA-256 hashed by Hermoso exactly as TikTok specifies before anything leaves the process; a value that is already a 64-character hash is passed through untouched, so nothing is ever double-hashed. A phone with no "+" country code is refused rather than guessed. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send server-side conversion events to TikTok (Events API 2.0)
    • idempotentHint: false
  • send_tiktok_ads_offline_eventsREPORT REAL-WORLD CONVERSIONS — an in-store purchase, a phone booking, a signed contract — so TikTok can attribute them to the ads that caused them and optimise delivery toward the…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_tiktok_ads_offline_events" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    REPORT REAL-WORLD CONVERSIONS — an in-store purchase, a phone booking, a signed contract — so TikTok can attribute them to the ads that caused them and optimise delivery toward them. This is what makes a TikTok campaign measurable for a business whose sale does not happen on a website. Emails and phone numbers are normalized and SHA-256 hashed by Hermoso exactly as TikTok specifies before anything leaves the process, using the SAME implementation as send_tiktok_ads_events; a value that is already a 64-character hash is passed through untouched, and a phone with no "+" country code is refused rather than guessed. EITHER emails OR phone_numbers is REQUIRED on every event — an offline conversion identifying nobody is attributed to nothing. Warning: THE TIMESTAMP IS AN ISO-8601 STRING HERE ("2026-08-19T19:11:01Z"), NOT the Unix-seconds NUMBER that send_tiktok_ads_events takes: TikTok accepts a wrong-shaped one, reads it as some other date and attributes the conversion to nothing, so it is refused here for free. Warning: THERE IS NO TEST MODE: TikTok documents test_event_code on Events API 2.0 and on NEITHER offline endpoint, so everything sent here is a real, permanent conversion that no endpoint deletes. To rehearse the pipeline first, send the same events through send_tiktok_ads_events with eventSource "offline", the same event set id and a testEventCode from Events Manager — those land in the Test Events tab and are excluded from reporting, attribution and optimisation. Warning: REPORTING NEEDS A ROLE, NOT JUST A CONNECTION: TikTok requires the connected user to be an ADMIN or OPERATOR of that advertiser account, measured live — the same token can create and delete Offline Event SETS and still be refused on the events themselves. If that happens Hermoso says so plainly rather than telling anyone to reconnect, because reconnecting cannot grant a role; it has to change in TikTok Business Center. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Report in-store and other real-world conversions to TikTok
    • idempotentHint: false
  • send_x_ads_conversionsReport conversions to X server-side (the X Conversion API) — purchases, sign-ups, leads — so X attributes them to the ads that caused them and conversion bidding (goal WEBSITE_CONV…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_x_ads_conversions" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Report conversions to X server-side (the X Conversion API) — purchases, sign-ups, leads — so X attributes them to the ads that caused them and conversion bidding (goal WEBSITE_CONVERSIONS_V2) has something to optimise toward. Leave pixelId out and name each event by eventType (PURCHASE, SIGN_UP…) or eventId: Hermoso reads the ids from the ad account's conversion events (manage_x_ads_conversion_events). Each event needs a click id (twclid from the landing URL), an email or an E.164 phone — emails and phones are SHA-256 hashed on Hermoso's server; IP + user agent only count together or beside one of those. Send conversionId to deduplicate against the X Pixel. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Send conversions to X (Conversion API)
    • idempotentHint: false
  • set_apple_ads_statusPause or enable an Apple Ads campaign, ad group, keyword or ad.Reads text others writeNo findings

    Why it is in this group

    • The name "set_apple_ads_status" 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
    Pause or enable an Apple Ads campaign, ad group, keyword or ad. PAUSING is immediate and needs no confirmation. ENABLING IS THE ONE SWITCH THAT ARMS REAL MONEY: it requires confirm:true, and without it nothing changes and the refusal names the object Apple actually holds under that id — read back from Apple, never echoed from your input, because aiming at the wrong campaign is invisible until money moves. An object serves only when it AND every parent above it are ENABLED, so enabling a keyword inside a paused campaign spends nothing. Prefer pausing to deleting: pausing is reversible and Apple’s delete is not. A CREATIVE, AN ASSET AND A LOCATION GROUP ARE DELIBERATELY ABSENT from the levels here and that is not an oversight: none of them has an advertiser status — a creative and a location group carry only a read-only systemStatus Apple computes — so to stop a creative serving, pause the ADS that reference it, and to stop promoting a set of shops, pause the AD GROUP that targets the location group. The reply reports the status Apple STORED, which is a different claim from the one it accepted. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Pause or enable an Apple Ads object
    • idempotentHint: false
  • set_applovin_ads_statusLIVE or PAUSED for an AppLovin campaign (campaignId) or creative set (creativeSetId), read back.Reads text others writeNo findings

    Why it is in this group

    • The name "set_applovin_ads_status" 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
    LIVE or PAUSED for an AppLovin campaign (campaignId) or creative set (creativeSetId), read back. LIVE starts real ad spend: show the user the budget, get an explicit yes, then call with confirm:true. Pausing is always safe. AppLovin’s API has no delete; pause instead. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn an AppLovin campaign or creative set live or paused
  • 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_google_ads_asset_automationWhat Google Ads is allowed to generate from the user’s own creative: text laid over videos (OVERLAY_TEXT_ON_VIDEOS), vertical and shorter video cuts, generated videos and animated …Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_asset_automation" 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
    What Google Ads is allowed to generate from the user’s own creative: text laid over videos (OVERLAY_TEXT_ON_VIDEOS), vertical and shorter video cuts, generated videos and animated images, image crops and enhancements, written headlines and landing-page text. Pass campaignId for campaign-level automation (Performance Max, Search), or adGroupId + adId for one ad: a Demand Gen video ad keeps OVERLAY_TEXT_ON_VIDEOS, GENERATE_VERTICAL_YOUTUBE_VIDEOS and GENERATE_SHORTER_YOUTUBE_VIDEOS there, and Google turns them ON by default. With no settings it READS what is set. settings is {TYPE: true|false}; a type you do not name keeps its current value, and one that was never set follows Google’s default. Turning a type OFF needs nothing more; turning one ON for something live needs confirm:true, because Google then serves versions it generated. The reply is what Google stored, read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Read or change what Google may make from the creative (text on videos, video cuts, written text)
  • set_google_ads_audiencesWho a Google Ads campaign reaches.Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_audiences" 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
    Who a Google Ads campaign reaches. adGroupId (Search/Display): userLists, interests (affinity/in-market ids), customSegments (Display only), mode "observation" (report, do not narrow — default on Search) or "targeting" (narrow to them); Demand Gen ad groups take audiences[] ids. assetGroupId (Performance Max): audiences[] as signals and searchThemes[]. campaignId: exclusions only. exclude{userLists, interests, customSegments}, excludeAges ["18-24"…"65+","unknown"], excludeGenders, excludeIncomes (household income bands; with campaignId this is how a Performance Max campaign excludes them). remove[] takes criterion resource names from a call with no changes (which lists what is set). Narrowing a LIVE ad group needs confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Target or exclude audiences on Google Ads
  • set_google_ads_biddingChange how an existing Google Ads campaign bids: MANUAL_CPC (optionally enhanced), MAXIMIZE_CLICKS (needs maxCpcUsd on an existing campaign — Google requires the CPC ceiling on tha…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change how an existing Google Ads campaign bids: MANUAL_CPC (optionally enhanced), MAXIMIZE_CLICKS (needs maxCpcUsd on an existing campaign — Google requires the CPC ceiling on that change), MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_CPA (needs targetCpaUsd) or TARGET_ROAS (needs targetRoas, e.g. 4 = $4 revenue per $1 spent). TARGET_CPA and TARGET_ROAS are applied as Google's own v25 equivalents — maximize-conversions with a target CPA, and maximize-conversion-value with a target ROAS — so the read-back reports them as MAXIMIZE_CONVERSIONS / MAXIMIZE_CONVERSION_VALUE; report what the read-back says. The conversion-based strategies only deliver once conversion tracking is configured on the account. Changing a LIVE campaign's bidding changes what it pays immediately, so that needs confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Set a Google Ads bidding strategy
  • set_google_ads_budgetCreate a new daily budget, or change an existing budget’s daily amount (pass budgetResourceName).Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_budget" 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
    Create a new daily budget, or change an existing budget’s daily amount (pass budgetResourceName). Raising the budget on a LIVE (ENABLED) campaign increases real spend immediately — you MUST show the user the new daily amount, get an explicit yes, then call with confirm:true. Creating a budget or lowering one on a paused campaign is safe.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Set a Google Ads campaign budget
  • set_google_ads_conversion_goalsWhich conversion goals Google Ads smart bidding optimises toward, the usual cause of "it optimises for the wrong thing".Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_conversion_goals" 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
    Which conversion goals Google Ads smart bidding optimises toward, the usual cause of "it optimises for the wrong thing". With no goals it reads: the account goals, or with campaignId that campaign's goals and whether it follows the account. goals:[{category (PURCHASE, SIGNUP, SUBMIT_LEAD_FORM, PAGE_VIEW...), origin (default WEBSITE), biddable}] sets them account-wide, or for one campaign with campaignId (it then stops following account changes). useAccountGoals:true puts a campaign back on the account goals. A goal exists only where a conversion action of that category exists. Changing goals of LIVE campaigns needs confirm:true after the user approves. Read back from Google.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Google Ads conversion goals (what smart bidding optimises for)
  • set_google_ads_networksChange WHERE an existing Google Ads campaign serves: Google Search, Search partners (target_search_network) and the Display Network (target_content_network), each true/false.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change WHERE an existing Google Ads campaign serves: Google Search, Search partners (target_search_network) and the Display Network (target_content_network), each true/false. The classic use is turning Search partners OFF on a Search campaign, or Display off. Current settings are read first and a no-op says so. On a LIVE (ENABLED) campaign this moves real spend on the next auction — show the user the before -> after, get an explicit yes, then call again with confirm:true. dryRun:true validates with Google and writes nothing. The result is READ BACK from Google before you are told it took; Google’s own rules (a Display campaign cannot take Google Search on, a Search campaign keeps Google Search on) are relayed by name.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change where a Google Ads campaign serves (Search partners / Display)
  • set_google_ads_rule_limitsThe account's caps on automated rules, enforced at EVERY run: the most one budget/bid may rise in a day (default 100%), the most rules may add to budgets in a day, the highest budg…No findings

    Why it is in this group

    • The name "set_google_ads_rule_limits" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    The account's caps on automated rules, enforced at EVERY run: the most one budget/bid may rise in a day (default 100%), the most rules may add to budgets in a day, the highest budget a rule may set. Tightening needs nothing; loosening needs confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Caps on what Google Ads rules may raise
  • set_google_ads_rule_statusENABLED means Hermoso runs it on its schedule with nobody watching.No findings

    Why it is in this group

    • The name "set_google_ads_rule_status" says "set": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    ENABLED means Hermoso runs it on its schedule with nobody watching. A rule that can only pause, lower or notify needs confirm:true; one that can enable or RAISE needs confirm:true AND confirmScope (from list_google_ads_rules). Calling without them changes nothing and says what it would do. DISABLED stops it at once and is never gated (it does not put back what it changed: undo_google_ads_rule_action does). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Switch a Google Ads automated rule on or off
  • set_google_ads_schedule_and_bidsWHEN a Google Ads campaign runs and how much more or less it bids by device, location and hour.Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_schedule_and_bids" 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
    WHEN a Google Ads campaign runs and how much more or less it bids by device, location and hour. Pass only campaignId to read the current schedule and adjustments. schedule:[{day: MONDAY…SUNDAY | WEEKDAYS | WEEKENDS | EVERYDAY, start:"09:00", end:"17:00", bidModifier?}] REPLACES the schedule (scheduleMode:"add" appends; clearSchedule:true runs it all day again); account time zone, quarter hours, end may be 24:00. devices {mobile, desktop, tablet, connectedTv} and adGroupDevices (with adGroupId) take MULTIPLIERS: 1.2 = +20%, 0.8 = -20%, 0 = never show on that device. locations:[{geoTargetId, bidModifier}] adjusts locations the campaign already targets. On a LIVE campaign a change that can raise spend (more hours, a higher multiplier) needs confirm:true after the user approves; lowering never does. dryRun:true validates only. Read back from Google.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Google Ads ad schedule + device / location / hour bid adjustments
  • set_google_ads_statusTurn a campaign, AD GROUP, AD or one KEYWORD ON (ENABLED), OFF (PAUSED) or REMOVED.Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_status" 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
    Turn a campaign, AD GROUP, AD or one KEYWORD ON (ENABLED), OFF (PAUSED) or REMOVED. Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, level:"ad" + BOTH adGroupId and adId (Google keys an ad by adGroupId~adId), or level:"keyword" + BOTH adGroupId and keywordId. ENABLING STARTS REAL AD SPEND — you MUST first show the user the campaign name + its daily budget, get an explicit yes, then call with status:"ENABLED" and confirm:true. Pausing is always safe. REMOVED is PERMANENT in Google Ads and is handled by the same gate as delete_google_ads_object — call it once WITHOUT confirm to see what goes with it, and expect to echo back the object’s name and child count when it has children, is live, or has spent. The resulting status is READ BACK from Google before you are told it took.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Enable, pause or remove a Google Ads campaign / ad group / ad
  • set_google_ads_targetingADD locations and languages to an existing Google Ads campaign.Reads text others writeNo findings

    Why it is in this group

    • The name "set_google_ads_targeting" 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
    ADD locations and languages to an existing Google Ads campaign. THIS ADDS; IT DOES NOT REPLACE — Google campaign criteria are a list, this call only ever creates entries, and there is no remove operation here. So a campaign already targeting the United States that you "change to Canada" ends up targeting BOTH and still spending in the US; the read-back names every pre-existing location and language it kept, and you MUST relay that rather than reporting the new total as the answer. Removing targeting is done in Google Ads (Campaign > Settings > Locations). Pass locations by NAME ("United States", "California", "Toronto") — they are resolved to Google's geo target ids for you; excludedLocations adds a NEGATIVE criterion (the reliable way to stop serving somewhere from here); languages takes ISO codes ("en","fr"). A campaign with NO location targeting runs WORLDWIDE, which is the most expensive default in Google Ads. Changing a LIVE campaign's targeting moves real spend immediately, so that needs confirm:true.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add Google Ads location & language targeting
  • set_google_ads_trackingSet the FINAL URL SUFFIX (the UTMs added to every click), tracking template and custom parameters on a Google Ads campaign, ad group or ad; a lower level overrides a higher one.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Set the FINAL URL SUFFIX (the UTMs added to every click), tracking template and custom parameters on a Google Ads campaign, ad group or ad; a lower level overrides a higher one. "" clears a field; utmDefault:true applies our standard UTMs (utm_source=google, utm_medium, utm_campaign=<name>, utm_id={campaignid}, utm_content={creative}). New campaigns already get those unless you say otherwise. Read back from Google.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set UTMs / tracking on a Google Ads campaign, ad group or ad
  • set_linkedin_ads_budgetChange a LinkedIn campaign’s daily and/or total budget.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a LinkedIn campaign’s daily and/or total budget. On a LIVE (ACTIVE) campaign this changes real spend immediately — and LinkedIn can spend up to 150% of a daily budget on a high-opportunity day — so show the user the new amount, get an explicit yes, then call with confirm:true. The currency must match the ad account’s. Read back after the change.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set a LinkedIn campaign budget
  • set_linkedin_ads_statusTurn a LinkedIn campaign group, campaign or CREATIVE (the ad itself) on (ACTIVE) or off (PAUSED).Reads text others writeNo findings

    Why it is in this group

    • The name "set_linkedin_ads_status" 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
    Turn a LinkedIn campaign group, campaign or CREATIVE (the ad itself) on (ACTIVE) or off (PAUSED). Pass level:"campaign" + campaignId, level:"campaignGroup" + campaignGroupId, or level:"creative" + creativeId. All three tiers must be ACTIVE for an ad to serve — activating only the campaign leaves a DRAFT creative sitting there showing nothing. ACTIVATING STARTS REAL AD SPEND — you MUST first show the user the campaign and its budget, get an explicit yes, then call with status:"ACTIVE" and confirm:true. Pausing is always safe. The resulting status is READ BACK from LinkedIn along with its servingStatuses before you are told it took: LinkedIn defers validation on drafts, so activation is exactly where a hidden problem surfaces, and the note reports what LinkedIn actually says rather than what was requested.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate or pause a LinkedIn campaign group / campaign / ad
  • set_linkedin_ads_trackingDynamic UTM tracking for LinkedIn ads: parameters LinkedIn appends to every ad’s landing page on a campaign (or, level:"account", across the whole ad account), filled in per click.Reads text others writeNo findings

    Why it is in this group

    • The name "set_linkedin_ads_tracking" 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
    Dynamic UTM tracking for LinkedIn ads: parameters LinkedIn appends to every ad’s landing page on a campaign (or, level:"account", across the whole ad account), filled in per click. standard:true sets utm_source=linkedin, utm_medium=paid_social, utm_campaign={campaign name}, utm_content={creative id}. Or pass dynamic {key: ACCOUNT_ID | ACCOUNT_NAME | CAMPAIGN_GROUP_ID | CAMPAIGN_GROUP_NAME | CAMPAIGN_ID | CAMPAIGN_NAME | CREATIVE_ID | CREATIVE_NAME} and/or custom {key: fixed value}. A new set REPLACES the previous one; clear:true removes it; call with no parameters to read what is set. Ads do not go back through review. Read back from LinkedIn. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: LinkedIn ads dynamic UTM tracking
  • set_merchant_inventorySET the price, availability or stock level of one Shopping product at ONE physical store (kind:"local", keyed by storeCode) or in ONE region (kind:"regional", keyed by region).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    SET the price, availability or stock level of one Shopping product at ONE physical store (kind:"local", keyed by storeCode) or in ONE region (kind:"regional", keyed by region). This is what stops a Shopping ad advertising something the nearest store has sold out of. Google's insert REPLACES the whole entry, so this tool reads what is already stored, merges your fields over it, and reports which stored fields it preserved; pass an explicit null to CLEAR one. The API publishes no enum for availability, so it accepts anything and only Google's local inventory data specification says which values actually serve: In stock, Limited availability, On display to order, Out of stock, submitted in English. An unrecognised value is warned about here rather than refused, because refusing would mean inventing an enum Google does not publish. Google states it can take up to 30 minutes before the product itself reflects the change, so a product read straight afterwards can still show the old value and be correct. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set store or region price and stock
  • set_meta_ad_rule_limitsThe ad account's caps on automated rules: the most a rule may raise one budget/bid in a day (default 100%), the most rules may add to budgets in a day, and the highest budget a rul…Reads text others writeNo findings

    Why it is in this group

    • The name "set_meta_ad_rule_limits" 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
    The ad account's caps on automated rules: the most a rule may raise one budget/bid in a day (default 100%), the most rules may add to budgets in a day, and the highest budget a rule may set. A rule whose worst case breaks them cannot be switched on. Tightening needs nothing; LOOSENING needs confirm:true. The reply names any rule already ON that now exceeds them (Meta keeps running it until switched off). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Caps on what Meta rules may raise
  • set_meta_ad_rule_statusENABLED hands the rule to Meta to run unattended.Reads text others writeNo findings

    Why it is in this group

    • The name "set_meta_ad_rule_status" 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
    ENABLED hands the rule to Meta to run unattended. A rule that can only pause, lower or notify needs confirm:true. A rule that can switch something ON or RAISE a budget/bid needs confirm:true AND confirmScope (the scopeToken from list_meta_ad_rules, computed from the rule as Meta stores it), and is refused if its worst case breaks the ad account's caps (set_meta_ad_rule_limits). Calling without them changes nothing and returns exactly what the rule would do — show the user, get a yes, then confirm. DISABLED is the brake: never gated. The answer is the status read back from Meta. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Switch a Meta automated rule on or off
  • set_meta_campaign_statusTurn a campaign ON (ACTIVE) or OFF (PAUSED).Reads text others writeNo findings

    Why it is in this group

    • The name "set_meta_campaign_status" 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
    Turn a campaign ON (ACTIVE) or OFF (PAUSED). ACTIVATING STARTS REAL AD SPEND — you MUST first show the user the campaign name + its daily budget, get an explicit yes, then call with status:"ACTIVE" and confirm:true. Pausing is always safe. Needs ads-management permission.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate or pause a Meta campaign
  • set_meta_conversions_autoRead or change AUTOMATIC sending to the brand’s Meta pixel.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read or change AUTOMATIC sending to the brand’s Meta pixel. Sources, each OFF by default: shopify (paid Shopify orders as Purchase, keyed by order id; waits on Shopify approving access to order details), metaLeads (Meta instant-form leads sent back as Lead), emailReplies (an email lead who replies, as Lead). Call with no arguments to read the setting and the last run. Turning a source ON needs confirm:true AND consent:true, after showing the user what is sent and that they are responsible for their customers’ consent. limitedDataUse sets Meta’s Limited Data Use for US state privacy laws. runNow:true sends now. An event is never sent twice, and a failed send is retried. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Automatic sending to a Meta pixel
  • set_microsoft_ads_audience_targetingPut an audience to work on a Microsoft Advertising campaign or ad group — e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "set_microsoft_ads_audience_targeting" 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
    Put an audience to work on a Microsoft Advertising campaign or ad group — e.g. the customer list from create_microsoft_ads_customer_list, to retarget it or EXCLUDE existing customers. action add (audienceId, exclude, bidAdjustment -90..900 %) or remove (criterionIds from list_microsoft_ads_audience_targeting). Microsoft allows biddable audiences at the campaign OR the ad-group level of one campaign, not both; exclusions at both; Performance Max can only exclude. Targeting or removing on a LIVE campaign needs confirm:true. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Target or exclude a Microsoft audience
  • set_microsoft_ads_auto_applySwitch Microsoft’s auto-apply on or off, per recommendation type.Reads text others writeNo findings

    Why it is in this group

    • The name "set_microsoft_ads_auto_apply" 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
    Switch Microsoft’s auto-apply on or off, per recommendation type. SWITCHING ONE ON IS UNLIKE EVERY OTHER WRITE IN HERMOSO: it is STANDING PERMISSION FOR MICROSOFT TO CHANGE THIS AD ACCOUNT ON ITS OWN, indefinitely, with nobody watching, publishing search and multimedia ads it wrote under the brand’s name, DELETING negative keywords so the account starts buying searches it currently blocks, or creating and changing conversion goals so every smart-bidding strategy on the account re-aims. It has no expiry and no schedule you can inspect, and nothing in Hermoso will ever turn it off for the user. AND THERE IS NOTHING TO PREVIEW: Microsoft decides later, on evidence that does not exist yet, so no count, no dry run and no list can tell you what it will do, which is exactly why a blast-radius echo would be meaningless here and each type has to be named instead. To turn any type ON: confirm:true AND confirmTypes listing every type being turned on, individually. There is no "all" and no default; naming four of five leaves the fifth refused BY NAME. TURNING IT OFF IS NEVER GATED, set those types to false and it goes straight through, because that only ever reduces what Microsoft does unattended. A type already in the state you asked for is not sent at all. THE ANSWER IS THE READ-BACK: the result re-reads Microsoft and says done / not done / could not tell PER TYPE, and you report that, never the fact that the call returned. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Let Microsoft change the account by itself, or stop it (per type)
    • idempotentHint: false
  • set_microsoft_ads_biddingChange a Microsoft Advertising campaign’s BID STRATEGY, read back: EnhancedCpc, MaxClicks (maxCpc cap), MaxConversions (optional targetCpa), MaxConversionValue (optional targetRoas…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Microsoft Advertising campaign’s BID STRATEGY, read back: EnhancedCpc, MaxClicks (maxCpc cap), MaxConversions (optional targetCpa), MaxConversionValue (optional targetRoas), TargetImpressionShare (targetImpressionShare + targetAdPosition). Search takes any; Audience EnhancedCpc / MaxConversions; Shopping EnhancedCpc; Performance Max MaxConversions / MaxConversionValue. TargetCpa and TargetRoas are sent as MaxConversions / MaxConversionValue with the target, which is what Microsoft converts them to since 2025-08-04. Conversion strategies need a UET tag and a conversion goal recording conversions. On a LIVE campaign it needs confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a Microsoft Advertising bid strategy
  • set_microsoft_ads_budgetChange a Microsoft Advertising campaign’s DAILY BUDGET (in the account’s currency).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Microsoft Advertising campaign’s DAILY BUDGET (in the account’s currency). Raising it on a LIVE (Active) campaign increases real spend immediately — you MUST show the user the new daily amount, get an explicit yes, then call with confirm:true. If the campaign is on a SHARED budget its amount is read-only here and this refuses with an explanation rather than pretending to change it. Read back after the change.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set a Microsoft Advertising daily budget
  • set_microsoft_ads_profile_targetingTarget LinkedIn profiles on a Microsoft Advertising Search, Shopping or Dynamic Search Ads campaign: add companies, industries, job functions, seniorities or job titles, each with …Reads text others writeNo findings

    Why it is in this group

    • The name "set_microsoft_ads_profile_targeting" 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
    Target LinkedIn profiles on a Microsoft Advertising Search, Shopping or Dynamic Search Ads campaign: add companies, industries, job functions, seniorities or job titles, each with an optional bid adjustment (whole percent, -90 to 900), or change an existing adjustment by criterion id (list_microsoft_ads_profile_targeting shows it). Find profile ids with search_microsoft_ads_profiles. On an ACTIVE campaign this changes bids on the very next auction, so show the user the changes, get an explicit yes, then call with confirm:true. The reply is what Microsoft reads back, and a change that does not read back is named. Removing a profile criterion is not available here; an adjustment of 0 has no effect on bids.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Set LinkedIn profile targeting on a Microsoft Advertising campaign
    • idempotentHint: false
  • set_microsoft_ads_statusTurn a Microsoft Advertising campaign, AD GROUP or AD on (Active) or off (Paused).Reads text others writeNo findings

    Why it is in this group

    • The name "set_microsoft_ads_status" 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
    Turn a Microsoft Advertising campaign, AD GROUP or AD on (Active) or off (Paused). Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, or level:"ad" + BOTH adGroupId and adId. ACTIVATING STARTS REAL AD SPEND — you MUST first show the user the campaign name + its daily budget, get an explicit yes, then call with status:"Active" and confirm:true. Pausing is always safe. Microsoft has only these two statuses — its Deleted state is internal-only and cannot be SET — so to remove something use delete_microsoft_ads_object, which is a real delete operation, not a status. The resulting status is READ BACK from Microsoft before you are told it took — and Microsoft may report BudgetPaused / BudgetAndManualPaused / Suspended instead, which the note names explicitly.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate or pause a Microsoft Advertising campaign / ad group / ad
  • set_openai_ads_budgetChange a ChatGPT Ads campaign’s budget — a daily cap, a lifetime cap, or both, in the ad account’s currency.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a ChatGPT Ads campaign’s budget — a daily cap, a lifetime cap, or both, in the ad account’s currency. A LIFETIME (total) budget is PACED by ChatGPT Ads to spread spend evenly across the campaign’s dates (actual daily spend still varies with available delivery), so a total budget is not a first-come-first-served pool. ChatGPT Ads’ own minimum for a DAILY budget is 25.00 (measured live 2026-08-05; a LIFETIME budget has no such floor, so use one to spend less than that in total). Raising it on a LIVE (active) campaign increases real spend immediately, so you MUST show the user the old and new amounts, get an explicit yes, then call with confirm:true. Lowering it or changing a paused campaign is safe. The campaign is READ BACK after the change and the note is built from that.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set a ChatGPT Ads campaign budget
  • set_openai_ads_daily_spend_limitCreate or change the ACCOUNT-WIDE DAILY SPENDING LIMIT on ChatGPT Ads: the most all campaigns together may spend each day, renewing at midnight in the account timezone, until it is…Reads text others writeNo findings

    Why it is in this group

    • The name "set_openai_ads_daily_spend_limit" 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
    Create or change the ACCOUNT-WIDE DAILY SPENDING LIMIT on ChatGPT Ads: the most all campaigns together may spend each day, renewing at midnight in the account timezone, until it is removed or reaches its optional end date. OpenAI offers it only on ad accounts with postpaid INVOICE billing and it needs billing-management permission; a card-billed account is refused whatever key is used. amount is per day in the account currency and is required even when only the end date changes (0 stops account spend). A NEW limit starts tomorrow or later: list_openai_ads_spend_windows names the earliest start date. On an existing limit leave startDate out, because its start cannot change. An account can hold SEVERAL non-overlapping daily rules (list_openai_ads_spend_windows returns each with a windowId): pass windowId to change one, or newRule:true (with startDate) to add another; with more than one rule OpenAI requires the windowId. endDate is exclusive; noEndDate:true clears it. A daily limit and a date-range window cannot overlap. Lowering it can stop delivery and raising it lets campaigns spend up to their own budgets, so show the user the current and new values first: without confirm:true AND expectedRevision (the revision list_openai_ads_spend_windows returns) nothing changes and the reply states what would. The result is read back from ChatGPT Ads.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Set the ChatGPT Ads account daily spending limit
    • idempotentHint: false
  • set_openai_ads_feed_sftpManage SFTP bulk delivery for a ChatGPT Ads product feed (the alternative to pushing products through update_openai_ads_feed_products).Reads text others write2 findings

    Why it is in this group

    • The name "set_openai_ads_feed_sftp" 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.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...ult): create or REPLACE the feed's SFTP credentials — authenticationMethod "password" (Open..."

      What this check looks for
    • Info

      The input schema at properties.action.description mentions "credentials".

      Matched text

      inputSchema.properties.action.description: "create (default) sets up or rotates credentials; activate or pause switches delivery on..."

      What this check looks for
    Description, as the server wrote it
    Manage SFTP bulk delivery for a ChatGPT Ads product feed (the alternative to pushing products through update_openai_ads_feed_products). action "create" (default): create or REPLACE the feed's SFTP credentials — authenticationMethod "password" (OpenAI returns the password ONCE in this reply; store it) or "ssh_key" (pass the public key as sshPublicKey). Replacing credentials invalidates the previous ones immediately, so re-run only when the user means to rotate. action "activate" / "pause": switch delivery on or off without touching credentials. The reply carries the connection URI and whether delivery is enabled; get_openai_ads_feed_sftp reads the same state without changing it. Files delivered over SFTP show up in list_openai_ads_feed_uploads with accepted / rejected / ads-eligible row counts.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Set up, activate or pause feed SFTP delivery
    • idempotentHint: false
  • set_openai_ads_lead_syncProvision lead delivery for this ChatGPT Ads account.Reads text others writeNo findings

    Why it is in this group

    • The name "set_openai_ads_lead_sync" 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
    Provision lead delivery for this ChatGPT Ads account. OMIT destinationUrl to deliver to HERMOSO: leads land in Hermoso’s own signed receiver, list_openai_ads_leads reads them and the HubSpot lead sync can push them into HubSpot (no secret to store). Or pass your own https destinationUrl (a managed webhook), optionally with your own signingSecret; then THE SIGNING SECRET IS RETURNED ONCE — every lead webhook is signed with it. Needs ChatGPT Ads connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Provision ChatGPT Ads lead delivery (webhook)
    • idempotentHint: false
  • set_openai_ads_spend_windowCreate (no windowId) or edit (windowId) an account-level spend-limit window on ChatGPT Ads: startDate YYYY-MM-DD inclusive, endDate YYYY-MM-DD EXCLUSIVE (the window ends the day be…Reads text others writeNo findings

    Why it is in this group

    • The name "set_openai_ads_spend_window" 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
    Create (no windowId) or edit (windowId) an account-level spend-limit window on ChatGPT Ads: startDate YYYY-MM-DD inclusive, endDate YYYY-MM-DD EXCLUSIVE (the window ends the day before), amount in the account currency (sent as micros), optional name and insertion-order id (ioId). A window is a CEILING on what the whole account may spend in that range; it never makes anything spend, and campaign budgets still apply underneath it. On edit, pass only the fields that change; a window whose canEdit is false (already started, per OpenAI) cannot be edited. Raising the amount lets campaigns spend up to their budgets, so show the user the old and new amounts. Reply carries the stored window (amount, spent so far, status). The live API serves this path since at least 2026-09-12 (it answered "Invalid URL" on 2026-09-03). It needs postpaid INVOICE billing and billing-management permission; a card-billed account is refused whatever key is used.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Create or edit a ChatGPT Ads spend-limit window
    • idempotentHint: false
  • set_openai_ads_statusTurn a ChatGPT Ads AD ACCOUNT, campaign, AD GROUP or AD on (active), off (paused), or ARCHIVE it.Reads text others writeNo findings

    Why it is in this group

    • The name "set_openai_ads_status" says "set": a word for a change.
    • 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
    Turn a ChatGPT Ads AD ACCOUNT, campaign, AD GROUP or AD on (active), off (paused), or ARCHIVE it. Pass level:"account" (NO id — the connection IS the account), level:"campaign" + campaignId, level:"adGroup" + adGroupId, or level:"ad" + adId. LEVEL "account" IS THE EMERGENCY STOP AND BEHAVES DIFFERENTLY FROM EVERY OTHER LEVEL: BOTH directions take confirm:true, because pausing it stops ALL ChatGPT Ads delivery for the brand at once and activating it un-suppresses EVERY active campaign underneath — Hermoso cannot tell you in advance which of them will start spending. An account cannot be archived. ACTIVATING STARTS REAL AD SPEND — you MUST first show the user the object and its budget, get an explicit yes, then call with status:"active" and confirm:true. Pausing is always safe and stops all spend. ARCHIVING IS IRREVERSIBLE: it is this platform’s only teardown (there is no delete and no un-archive, and OpenAI’s own guidance is "only archive objects you have no further use for"), so it ALSO requires confirm:true — prefer pausing unless the user is certain. Remember an ad only serves when the ad, its ad group AND its campaign are all active and the ad has passed OpenAI’s review. The resulting status is READ BACK from OpenAI before you are told it took.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate, pause or archive a ChatGPT Ads account / campaign / ad group / ad
  • set_pinterest_ads_budgetChange a Pinterest campaign’s budget — a DAILY cap or a LIFETIME cap, in the ad account’s currency.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Pinterest campaign’s budget — a DAILY cap or a LIFETIME cap, in the ad account’s currency. Pinterest allows only one of the two per campaign, so passing both is refused rather than silently picking one. Raising it on a LIVE (ACTIVE) campaign increases real spend immediately — you MUST show the user the new amount, get an explicit yes, then call with confirm:true. Read back after the change.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Set a Pinterest campaign budget
  • set_pinterest_ads_statusTurn a Pinterest campaign, AD GROUP or AD on (ACTIVE) or off (PAUSED) — and, because Pinterest has NO DELETE anywhere in its API, this is also the only way to retire one (ARCHIVED)…Reads text others writeNo findings

    Why it is in this group

    • The name "set_pinterest_ads_status" 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
    Turn a Pinterest campaign, AD GROUP or AD on (ACTIVE) or off (PAUSED) — and, because Pinterest has NO DELETE anywhere in its API, this is also the only way to retire one (ARCHIVED). Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, or level:"ad" + adId. ACTIVATING STARTS REAL AD SPEND, and ARCHIVING is effectively a delete: both require you to show the user exactly what changes, get an explicit yes, and call again with confirm:true. Pausing is always safe. The resulting status is READ BACK from Pinterest before you are told it took.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate, pause or archive a Pinterest campaign / ad group / ad
  • set_reddit_ads_statusThe one switch that arms real money on Reddit.Reads text others writeNo findings

    Why it is in this group

    • The name "set_reddit_ads_status" 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
    The one switch that arms real money on Reddit. Pass kind ("campaign", "ad_group" or "ad") plus the object id. ACTIVE starts real spend as soon as Reddit approves — show the user exactly what will run and get an explicit yes, then call again with confirm:true. PAUSED is always safe and never gated. REDDIT HAS NO DELETE OPERATION for these three: removal is a status, and ARCHIVED/DELETED here run the SAME blast-radius gate as delete_reddit_ads_object (call that one instead when you mean to remove something — it is the same code path and its unconfirmed call reports what goes with it). Remember Reddit’s three tiers all have to be ACTIVE for a single impression to serve: activating the campaign alone does nothing if its ad group and ad are still paused. The resulting status is READ BACK from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate, pause, archive or delete a Reddit campaign / ad group / ad
  • set_roleChange a workspace member’s role — admin (full access incl.No findings

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Change a teammate’s role
  • set_snapchat_ads_ai_declarationAdd or remove Snapchat's AI-content self-declaration (ai_content_source USER_AI_GEN) on media already uploaded to the ad account.Reads text others writeNo findings

    Why it is in this group

    • The name "set_snapchat_ads_ai_declaration" 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
    Add or remove Snapchat's AI-content self-declaration (ai_content_source USER_AI_GEN) on media already uploaded to the ad account. declared:true adds it, false removes it. The reply is what Snapchat stored, read back. A SNAP_AI_GENERATED mark from Snapchat's own AI tools can only be changed by Snapchat. upload_snapchat_ads_creative already declares a Hermoso render when it uploads it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Add or remove the AI-content declaration on Snapchat media
  • set_snapchat_ads_budgetChange the budget on a Snapchat AD SQUAD.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change the budget on a Snapchat AD SQUAD. BUDGETS LIVE ON THE AD SQUAD, not on the campaign — a campaign-level ask is refused by name rather than silently patching nothing. NEEDS confirm:true, and without it NOTHING CHANGES: you get a sentence naming the ad squad AS READ FROM SNAPCHAT and the amount, which you must show the user first. State a plain amount in dailyBudget and Hermoso converts to micro-currency; never pass both units. The new budget is READ BACK — report what Snapchat stored, in both micro and real money, not what you sent.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Change a Snapchat ad squad budget
    • idempotentHint: false
  • set_snapchat_ads_statusTHE ONE SWITCH THAT ARMS REAL MONEY ON SNAPCHAT.Reads text others writeNo findings

    Why it is in this group

    • The name "set_snapchat_ads_status" 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
    THE ONE SWITCH THAT ARMS REAL MONEY ON SNAPCHAT. ACTIVE starts real spend on the next auction; PAUSED stops it. EVERY change needs confirm:true, and WITHOUT confirm NOTHING CHANGES — you get a sentence naming each object AS READ FROM SNAPCHAT, with its real name and its current status, which you must show the user before asking for a yes. Confirming proves the caller meant to change SOMETHING; only reading the object back proves they aimed at the right one. EVERY TIER must be ACTIVE for a single impression to serve — a live ad under a paused ad squad shows nothing. THE ANSWER IS THE READ-BACK: report what Snapchat STORED per id, never the status you asked for. Snapchat has NO delete status — removal is a real DELETE verb, so use delete_snapchat_ads_object.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Activate or pause Snapchat campaigns, ad squads and ads
    • idempotentHint: false
  • set_tiktok_ads_brand_safetySet what content this TikTok ad account’s ads may appear next to.Reads text others writeNo findings

    Why it is in this group

    • The name "set_tiktok_ads_brand_safety" says "set": a word for a change.
    • The description says "CANNOT BE UNDONE".
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Set what content this TikTok ad account’s ads may appear next to. THREE RULES TIKTOK IMPOSES AND ONE THING THAT CANNOT BE UNDONE. (1) The suitability controls move as a TRIO: TikTok requires brandSafetyType, categoryExclusionIds and verticalSensitivityId "simultaneously", so read the current values with get_tiktok_ads_brand_safety and send all three — a partial update is refused here rather than silently doing something else. (2) NO_BRAND_SAFETY is a tier TikTok REPORTS but does not ACCEPT: the write enum is EXPANDED_INVENTORY / STANDARD_INVENTORY / LIMITED_INVENTORY only, so an account can be moved off it through the API and not back onto it. (3) Category exclusions and vertical sensitivity are valid only under STANDARD or LIMITED. Warning: coverAllObjectives IS A ONE-WAY DOOR — TikTok: "Once set to true, this setting cannot be updated back to false." Turning it on widens the settings from Reach / Video Views / Community Interaction to every objective, permanently, so that direction is confirm-gated and nothing else here is. AND MIND THE SCOPE: TikTok applies this to future Smart+ campaigns and explicitly NOT to regular campaigns created through /campaign/create/, which is what create_tiktok_ads_campaign uses. The reply is TikTok’s own stored row read back, so it reports what actually changed rather than what was sent. EXPANDED_INVENTORY is allowlist-only per advertiser; if TikTok refuses it the remedy is your TikTok rep, not a different field.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Set a TikTok ad account’s Brand Safety Hub settings
    • idempotentHint: false
  • set_tiktok_ads_budgetChange the budget on a TikTok campaign (level:"campaign") or ad group (level:"adgroup"), in the advertiser’s own currency.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change the budget on a TikTok campaign (level:"campaign") or ad group (level:"adgroup"), in the advertiser’s own currency. It needs confirm:true, and CALLING IT WITHOUT confirm CHANGES NOTHING and returns the sentence naming the object and the new amount — show the user that first. Everything Hermoso creates on TikTok is forced paused, so a budget change on one of those spends nothing; on an object somebody has ENABLED it takes effect on the next auction, and LOWERING the budget is the fastest way to slow real money down short of set_tiktok_ads_status(status:"DISABLE"). The new budget is READ BACK from TikTok — report what it returns, not what you sent, and say so plainly when the read-back could not confirm it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a TikTok campaign or ad group budget
  • set_tiktok_ads_rule_statusTURN_ON IS THE SWITCH THAT HANDS A RULE TO TIKTOK TO RUN UNATTENDED, and it is gated in two classes because the two are not the same act.Reads text others writeNo findings

    Why it is in this group

    • The name "set_tiktok_ads_rule_status" 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
    TURN_ON IS THE SWITCH THAT HANDS A RULE TO TIKTOK TO RUN UNATTENDED, and it is gated in two classes because the two are not the same act. A rule whose only actions are TURN_OFF, MESSAGE or a DECREASE cannot start or raise spend — the worst it does is under-deliver, which is recoverable by turning it off — so it needs confirm:true and nothing else. A rule that can TURN_ON an object or INCREASE / ADJUST_TO a budget or bid is standing permission to spend real money with nobody present, so it needs confirm:true AND confirmScope set to the scopeToken that list_tiktok_ads_rules prints. That token is computed from the rule AS TIKTOK STORES IT: confirm:true proves the caller meant to arm SOMETHING, and only the echo proves they aimed at the rule they actually inspected rather than one a teammate has edited since. CALLING WITHOUT THE GATE CHANGES NOTHING and returns the sentence describing exactly what the rule will be able to do — show the user that, get an unambiguous yes, then confirm. TURN_OFF and DELETE only ever reduce what runs unattended, so both take confirm:true and no echo; prefer TURN_OFF, because TikTok publishes no way to restore a deleted rule and turning one off is reversible. THE ANSWER IS THE READ-BACK: the result carries the status TikTok stored per rule, and says so when it could not confirm. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Arm, disarm or delete a TikTok automated rule
  • set_tiktok_ads_statusTHE ONE SWITCH THAT ARMS REAL MONEY ON TIKTOK.Reads text others writeNo findings

    Why it is in this group

    • The name "set_tiktok_ads_status" 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
    THE ONE SWITCH THAT ARMS REAL MONEY ON TIKTOK. Pass level ("campaign", "adgroup" or "ad"), the ids, and a status: ENABLE starts real spend on the next auction, DISABLE stops it, DELETE removes the objects (TikTok models removal as a STATUS — it publishes no delete verb — which is why delete_tiktok_ads_object is a thin wrapper over this same route). EVERY status change here needs confirm:true, and CALLING IT WITHOUT confirm CHANGES NOTHING and hands back the sentence describing exactly what would happen — show the user that, get an unambiguous yes, then confirm. EVERY TIER HAS TO BE ENABLED FOR AN IMPRESSION TO SERVE: Hermoso creates all three paused, so enabling the campaign alone does nothing while its ad group and ad are still disabled, and each level is a separate call. Ids can be passed in bulk, but TikTok’s QPS is 1 and calls are serialized, so a long list is simply slow. THE ANSWER IS THE READ-BACK: the result carries what TikTok STORED per id, plus a note when the read-back did not return every id — repeat that rather than the status you asked for.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Activate, pause or delete TikTok campaigns / ad groups / ads
  • set_tiktok_post_ad_authorizationTurn TikTok's 'Ad authorization' setting ON or OFF for a post the authorized account owns — THIS IS WHERE A SPARK ADS AUTHORIZATION CODE COMES FROM.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Turn Spark-Ads authorization on or off for the brand’s own post
    • idempotentHint: false
  • set_tiktok_smart_statusEnable, pause or delete Smart+ campaigns, ad groups or ads (up to 20 ids per call).Reads text others writeNo findings

    Why it is in this group

    • The name "set_tiktok_smart_status" 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
    Enable, pause or delete Smart+ campaigns, ad groups or ads (up to 20 ids per call). ENABLE starts REAL SPEND on the next auction and DELETE is permanent (a deleted campaign takes its ad groups and ads with it), so both require confirm:true after the user says yes. DISABLE (pause) is never gated. The reply is read back from TikTok and names any id whose new state it could not confirm.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Enable, pause or delete a Smart+ object
  • set_x_ads_statusPause or ACTIVATE an X ads CAMPAIGN (campaignId) or ONE LINE ITEM inside it (lineItemId) — pass exactly one.Reads text others writeNo findings

    Why it is in this group

    • The name "set_x_ads_status" 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
    Pause or ACTIVATE an X ads CAMPAIGN (campaignId) or ONE LINE ITEM inside it (lineItemId) — pass exactly one. ACTIVATING STARTS REAL SPEND on the next auction, so it requires confirm:true — this is the only switch on X that arms money. Tell the user the budget and what will start spending BEFORE you pass confirm. DELIVERY ON X IS THE AND OF BOTH LEVELS: an ACTIVE line item under a PAUSED campaign serves nothing, so the result reads the PARENT back too and states whether anything can actually spend rather than letting you infer it. Pausing a line item is the REVERSIBLE way to take one ad group out of delivery — deleting it is not.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Pause or activate an X campaign or line item
    • idempotentHint: false
  • share_onedrive_fileCreate a SHARING LINK to a OneDrive file or folder (fileId from list_onedrive_files): type view (read-only, default), edit, or embed (an <iframe> link, personal OneDrive only); sco…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Share a OneDrive file as a link
  • sync_leads_to_hubspotPush the leads the brand's LEAD FORMS collected into HubSpot as contacts — Meta, LinkedIn, TikTok (every published Instant Form, every lead region), X Ads, Snapchat and ChatGPT Ads…Reads text others writeNo findings

    Why it is in this group

    • The name "sync_leads_to_hubspot" says "sync": 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
    Push the leads the brand's LEAD FORMS collected into HubSpot as contacts — Meta, LinkedIn, TikTok (every published Instant Form, every lead region), X Ads, Snapchat and ChatGPT Ads (the last two: leads delivered to Hermoso by their lead webhooks). Each lead is upserted by email with lead status NEW and the platform + form + campaign written into the contact's Message property (a default HubSpot property, so no schema scope is needed). Synced lead ids are remembered per workspace, so a re-run, a scheduled run, a retry or a second agent never creates twins. Reports created / updated / already-synced / no-email per platform; a platform that is not connected, or cannot be read (Reddit has no API for leads), is REPORTED, not fatal. platforms narrows it. dryRun:true lists what would be synced and writes nothing. set_hubspot_lead_sync runs it automatically. Free. Needs HubSpot connected, plus the platforms whose leads you want.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Push lead-form leads into HubSpot
    • idempotentHint: false
  • 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
  • trigger_merchant_issue_actionFIRE one of the actions merchant_issue_help returned — most usefully 'request a review' on a disapproval.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "trigger_merchant_issue_action" says "trigger" and "issue": it writes something other people read.
    Description, as the server wrote it
    FIRE one of the actions merchant_issue_help returned — most usefully 'request a review' on a disapproval. SEVERAL OF THESE ARE ONE-SHOT and Google says so in its own dialog callout ('You can only request a review for disagreeing with this issue once. If it's not approved, you'll need to fix the issue and wait'), so read that callout back to the user before confirming: a review spent on the wrong issue cannot be spent again. WITHOUT `confirm` IT FIRES NOTHING. `actionContext` is OPAQUE by Google's own instruction — pass it back exactly as merchant_issue_help gave it; it cannot be constructed or edited. The answer is Google's own message to the business, relayed verbatim, because this endpoint returns no resource to read back. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Fire a Merchant Center issue action
  • unbind_tiktok_ads_spark_postRemove a TikTok post from this ad account’s authorised Spark Ads list — the cleanup for an authorization that has expired or been revoked.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "unbind_tiktok_ads_spark_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Remove a TikTok post from this ad account’s authorised Spark Ads list — the cleanup for an authorization that has expired or been revoked. IT IS NOT REVERSIBLE FROM OUR SIDE: re-authorising needs a FRESH code from the post’s owner, who is usually not the person making this call, so getting it wrong costs a conversation with a creator rather than a second API call — which is why it is confirm-gated even though it spends nothing. Ads already built on the post keep running; what is lost is the ability to build a NEW one. Calling it without confirm CHANGES NOTHING and returns the sentence describing exactly what would happen. THE READ-BACK INVERTS: the proof is the post’s ABSENCE from the authorised list afterwards, and an id that is still there is reported as not confirmed rather than done.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Remove a post from the authorised Spark Ads list
  • undo_google_ads_rule_actionPut back what one live run changed (the latest by default, or runId).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Put back what one live run changed (the latest by default, or runId). A change is reverted only if the object still holds the value the run gave it; anything changed since is left alone and named. If putting things back would RAISE spend (re-enabling, restoring a higher budget) it needs confirm:true. Does not switch the rule off. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Undo a Google Ads rule run
  • update_apple_ads_ad_accountRename an Apple Ads ad account or change which advertiser resources it delegates — how you link App Store Connect (a CONTENT_PROVIDER / CPID) to an account that cannot yet advertis…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename an Apple Ads ad account or change which advertiser resources it delegates — how you link App Store Connect (a CONTENT_PROVIDER / CPID) to an account that cannot yet advertise an app, or attach a brand for Apple Maps. WARNING: DELEGATIONS REPLACE RATHER THAN MERGE. The list you send becomes the account’s ENTIRE delegation set and anything omitted is removed, so to ADD one, read the current set with get_apple_ads_ad_account, append to it, and send the whole list back. productFeatures cannot be changed and Apple ignores it on update — an App Store account can never be converted into an Apple Maps one; create a second ad account instead. currency, timeZone and paymentModel are immutable, inherited from the organization. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Update an Apple Ads ad account
    • idempotentHint: false
  • update_apple_ads_budget_orderChange a budget order: its name, window, total value, attached ad account or invoice details.Reads text others writeNo findings

    Why it is in this group

    • The name "update_apple_ads_budget_order" says "update": a word for a change.
    • The input carries an amount (input.amount) and a currency, so it moves money.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a budget order: its name, window, total value, attached ad account or invoice details. Only the fields you send change; everything omitted keeps its value. RAISING `amount` IS HOW YOU EXTEND A BUDGET APPROACHING EXHAUSTION — an exhausted budget order stops every campaign drawing from it, so this is the tool to reach for when campaigns stop serving with budget left on their own daily caps. AN END DATE ON AN ACTIVE BUDGET ORDER CAN ONLY BE SHORTENED, NEVER EXTENDED; the one exception is openEnded:true, which clears the end date entirely and makes the budget run indefinitely. startTime, if changed, must still be tomorrow or later. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Update an Apple Ads budget order
    • idempotentHint: false
  • update_apple_ads_objectEdit an existing Apple Ads campaign, ad group, keyword, creative or ad.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit an existing Apple Ads campaign, ad group, keyword, creative or ad. Pass level and id plus ONLY the fields you want to change — Apple leaves every field you omit exactly as it is. Campaign: name, dailyBudget, startTime, endTime, countries, bidStrategyType. Ad group: name, defaultBid, startTime, endTime, searchMatch. Keyword: bid only — its text and match type are immutable, so delete and re-add to change either. Creative: name, plus (Apple Maps creatives only) a new creativeSpec — a creative’s type and destination are locked at creation, so pointing at a different app or product page means creating a NEW creative. Ad: name only — its creative and ad group are locked too, and Apple’s own instruction for serving a different creative is to create a new ad and delete the old one. Location group: name, description, and locationIds or rules. WARNING, AND IT APPLIES TO EVERY ARRAY HERE: AN ARRAY REPLACES RATHER THAN MERGES. The countries you send become the campaign’s entire geographic targeting, the targeting dimensions you send become the ad group’s entire setting for those dimensions, and Apple states it for location groups in terms — to add ONE shop to a group, read its current locationIds, append, and send the whole list back, or you have just removed every other shop. Send everything you want to keep, never just the new one. This tool deliberately CANNOT change a status: enabling arms real spend, so it lives behind set_apple_ads_status and its confirmation. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Edit an Apple Ads campaign, ad group, keyword or location group
    • idempotentHint: false
  • update_applovin_ads_campaignRename an AppLovin campaign or change its budget, goal value, countries, US states or metros, end date or landing page, read back.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename an AppLovin campaign or change its budget, goal value, countries, US states or metros, end date or landing page, read back. On a LIVE campaign a budget, goal, country or end-date change needs confirm:true. Status is set_applovin_ads_status; goal type, bidding and start date cannot change. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update an AppLovin Ads campaign
  • update_applovin_ads_creative_setEdit an AppLovin creative set, read back: rename it, change its countries or languages (an empty list means all), its landing page (url; "" falls back to the campaign’s), replace i…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit an AppLovin creative set, read back: rename it, change its countries or languages (an empty list means all), its landing page (url; "" falls back to the campaign’s), replace its assets (assetIds, checked against AppLovin’s own asset types first), or add it to more campaigns (addToCampaignIds, up to 20). Adding a LIVE set to a LIVE campaign needs confirm:true. Status is set_applovin_ads_status. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit an AppLovin creative set
  • 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_google_ads_adEDIT a responsive search ad IN PLACE so it keeps its history: headlines (3-15, ≤30 characters; {text, pin:"HEADLINE_1"} pins one), descriptions (2-4, ≤90), path1 / path2 (≤15), fin…Reads text others writeNo findings

    Why it is in this group

    • The name "update_google_ads_ad" 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 responsive search ad IN PLACE so it keeps its history: headlines (3-15, ≤30 characters; {text, pin:"HEADLINE_1"} pins one), descriptions (2-4, ≤90), path1 / path2 (≤15), finalUrls, finalMobileUrls, finalUrlSuffix, trackingUrlTemplate. A list you pass REPLACES the ad's list, so send it whole. Over-long text is refused, never cut. A live ad needs confirm:true and Google reviews it again. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Google responsive search ad in place
  • update_google_ads_ruleChange any part of a rule; anything not passed keeps its value.No findings

    Why it is in this group

    • The name "update_google_ads_rule" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Change any part of a rule; anything not passed keeps its value. Never switches it on or off. If the rule is ON and the new version can raise spend, it needs confirm:true plus confirmScope for the NEW version. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: false
    • title: Change a Google Ads automated rule
  • update_linkedin_ads_campaignChange an existing LinkedIn campaign’s targeting (sent whole), its political-advertising declaration, and/or its name.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an existing LinkedIn campaign’s targeting (sent whole), its political-advertising declaration, and/or its name. EU locations need the advertiser’s own declaration: ask, show LinkedIn’s wording (“I confirm this is not political advertising.”), pass politicalIntent only on their answer. Targeting on a LIVE campaign needs confirm:true. Read back from LinkedIn.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a LinkedIn campaign’s targeting or political declaration
  • update_linkedin_ads_creativeEdit a LinkedIn ad (creative) in place: its copy (text), landing page, button (callToAction), its name, or — while it is still DRAFT — the lead gen form it opens (leadFormId) and t…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit a LinkedIn ad (creative) in place: its copy (text), landing page, button (callToAction), its name, or — while it is still DRAFT — the lead gen form it opens (leadFormId) and that button’s label (leadButton). Copy, landing page and button live on the ad’s sponsored post and are edited there. An ACTIVE ad needs confirm:true because real people see the change on the next impression, and LinkedIn may review it again. Status is NOT changed here — use set_linkedin_ads_status. Everything is read back from LinkedIn. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a LinkedIn ad (copy, landing page, button, lead form)
  • update_linkedin_boostChange a RUNNING LinkedIn boost’s audience and/or political declaration, the only two things LinkedIn lets you change (budget, objective and schedule are fixed; there is no pause, …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a RUNNING LinkedIn boost’s audience and/or political declaration, the only two things LinkedIn lets you change (budget, objective and schedule are fixed; there is no pause, end_linkedin_boost stops it). Without confirm it previews the new audience and changes nothing; confirm:true applies it and reads it back. Send the COMPLETE audience: locations, targeting or audienceId.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a LinkedIn boost’s audience
  • update_linkedin_conversion_ruleRename a LinkedIn conversion rule, change its attribution windows or attribution model, or ENABLE/DISABLE it.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename a LinkedIn conversion rule, change its attribution windows or attribution model, or ENABLE/DISABLE it. Disabling is how a conversion rule is retired — LinkedIn publishes no delete for one, and while it is disabled every streamed event for it is refused. The rule’s `type` is immutable. The note quotes what LinkedIn returned on the read-back, not what was sent — repeat that. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update or disable a LinkedIn conversion rule
  • update_linkedin_lead_formEdit a LinkedIn lead gen form — name, headline, description, questions, privacy policy, disclaimer, consents, thank-you message / button / landing page — or retire it with state:"A…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Edit a LinkedIn lead gen form — name, headline, description, questions, privacy policy, disclaimer, consents, thank-you message / button / landing page — or retire it with state:"ARCHIVED". LinkedIn allows every field while no running ad uses the form; once a live ad does, only headline, description, disclaimer, privacy policy, the thank-you fields and state can change, and anything else is refused here by name. Changing the QUESTIONS can break a CRM that already mapped the form, so tell the user. Read back from LinkedIn. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit or archive a LinkedIn lead gen form
  • update_merchant_productChange SOME fields on a product already in a Merchant Center feed — the everyday operation, because price and availability move daily.Reads text others writeNo findings

    Why it is in this group

    • The name "update_merchant_product" 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 SOME fields on a product already in a Merchant Center feed — the everyday operation, because price and availability move daily. This is a PATCH: only the attributes you name are touched and everything else on the product survives, which is the difference from upsert_merchant_product (a whole-row write that wipes anything you leave out). It refuses if the product does not exist rather than quietly creating a half-populated one, and it refuses an empty change rather than sending an update mask with nothing behind it. The reply reports every field Google now holds, so you can see what survived. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update fields on a Merchant Center product
  • update_meta_ad_ruleChange a rule's name, what it looks at (send scope, conditions and window TOGETHER — Meta replaces the whole evaluation), its action and/or its schedule.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a rule's name, what it looks at (send scope, conditions and window TOGETHER — Meta replaces the whole evaluation), its action and/or its schedule. Never changes whether it is on (set_meta_ad_rule_status does). IF THE RULE IS ON and the new version can raise spend, this takes confirm:true plus confirmScope for the NEW version and is checked against the account caps: an edit is never a way round the switch-on gate. The answer is Meta's stored rule, read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a Meta automated rule
  • update_meta_objectUpdate an EXISTING campaign, ad set, or ad — rename, change its daily or lifetime budget, bid strategy, bid or cost cap, minimum ROAS, end time or optimization goal, retarget (ad s…Reads text others writeNo findings

    Why it is in this group

    • The name "update_meta_object" 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 an EXISTING campaign, ad set, or ad — rename, change its daily or lifetime budget, bid strategy, bid or cost cap, minimum ROAS, end time or optimization goal, retarget (ad sets), swap an ad's creative (creativeId, or imageHash / videoId from upload_meta_asset) or its UTMs (urlTags; Meta keeps creatives fixed, so a new one is built and the ad points at it, the old one kept), or change status (PAUSED / ACTIVE / ARCHIVED). Budget and bid fields go on one object per call, creative fields on an ad. Everything changed is read back. Pass objectId (from list_meta_ads) + adAccountId. Setting something ACTIVE can start REAL AD SPEND — show the user what will run + its budget, get a yes, then pass confirm:true. Pausing and renaming are always safe and always reversible. ARCHIVING IS NOT: Meta treats an archived object as DELETED and refuses to bring it back — every later edit answers "This campaign has been deleted, so you can only edit the name" (measured live 2026-08-05), archiving a campaign takes its ad sets and ads down with it, and the only way back is to duplicate it as a new object. Use PAUSED unless the user has said they are finished with it for good.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Meta campaign / ad set / ad
  • update_mixpanel_annotationChange the text or tags of a Mixpanel annotation (annotationId from list_mixpanel_annotations).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change the text or tags of a Mixpanel annotation (annotationId from list_mixpanel_annotations). Mixpanel cannot move an annotation to a new date; to fix a wrong date, delete it and create a new one. The edited row is read back. Needs the ANALYST role on the service account. 0 credits. Needs Mixpanel connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Mixpanel annotation
  • 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_openai_ads_accountUpdate the ChatGPT Ads account’s names, primary URL and/or favicon.Reads text others writeNo findings

    Why it is in this group

    • The name "update_openai_ads_account" 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 the ChatGPT Ads account’s names, primary URL and/or favicon. brandName is shown IN ADS, accountName is internal to Ads Manager, legalName is the business. Per OpenAI, a brand-name change PAUSES AD DELIVERY until brand review passes and a legal-name change restarts business review and may pause serving; an account name triggers no review. So a brand or legal change needs confirm:true: without it nothing changes and the reply names the old and new values and the pause, which the user must agree to first. Legacy name sets all three (cannot be combined with them). An unchanged name is not sent. Also url, faviconUrl (public image or home page, ≥256×256) or faviconFileId. An account whose brand review is not approved cannot serve: re-read it before promising anything runs. A 403 “not enabled” is OpenAI’s account setting, not a Hermoso failure.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update the ChatGPT Ads account (brand / account / legal name, URL, favicon)
  • update_openai_ads_audience_membersChange who is IN a ChatGPT Ads custom audience.Reads text others writeNo findings

    Why it is in this group

    • The name "update_openai_ads_audience_members" 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 who is IN a ChatGPT Ads custom audience. Pass plain emails, phone numbers and/or Google Advertising IDs (GAID, UUID-shaped) in ONE list — identifier types may be mixed in a single request: Hermoso normalises and SHA-256 hashes emails and phones locally and only the digests are sent; a GAID rides raw, as the API defines it. SIZE RULES (OpenAI, read 2026-09-03): an audience of ANY size, even empty, can be used for EXCLUSION once ready; for inclusion or bid adjustments plan on 25,000 matched users; there is no 5M ceiling any more, and the reported size is a privacy band (under_25k, 25k_100k, 100k_500k, 500k_1m, 1m_5m, 5m_plus). THREE OPERATIONS: "add" puts people in, "remove" takes the named people OUT (the only way to stop advertising to a segment already in a list), "replace" swaps the WHOLE membership. THIS IS ASYNCHRONOUS — ChatGPT Ads returns an operation id and the change is NOT applied when this returns; poll it with get_openai_ads_audience_operation until it reports succeeded or failed. A replace REQUIRES expectedRevision (read membershipRevision from get_openai_ads_audience) so a wholesale swap cannot land on top of someone else’s change; a mismatch is refused by ChatGPT Ads and applies nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Add, remove or replace ChatGPT Ads audience members
    • idempotentHint: false
  • update_openai_ads_feed_productsUpdate the PRICE, TITLE or AVAILABILITY of variants already in a ChatGPT Ads product feed — send only what changed instead of re-uploading the catalog.Reads text others writeNo findings

    Why it is in this group

    • The name "update_openai_ads_feed_products" 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 the PRICE, TITLE or AVAILABILITY of variants already in a ChatGPT Ads product feed — send only what changed instead of re-uploading the catalog. This is what stops a stale feed serving ads for out-of-stock items. Pass feedId and products:[{id, variants:[{id, title?, price?:{amount,currency}, availability?:{available|status}}]}], where products[].id is the PARENT product id and variants[].id the existing variant id, both from the catalog already in the feed. price.amount is an INTEGER IN MINOR UNITS — 8999 means $89.99 — so a decimal is a hundredfold error in the price you advertise, and is refused. IT UPDATES EXISTING VARIANTS ONLY: it never creates a feed, uploads a catalog, or adds a product that is not already there. ACCEPTED IS NOT LIVE — OpenAI applies the change asynchronously and returns no completion timestamp and no downstream result, so an out-of-stock product keeps serving until it propagates; say that rather than reporting it as done. A 403 naming product_feed_api_disabled / product_feed_delta_api_disabled means the ACCOUNT lacks Feeds access — nothing about the request was wrong and retrying it unchanged will not help. A 404 means the feed id is wrong, the feed is not linked to this ad account, or Feeds is not enabled.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Update ChatGPT Ads product-feed variants
  • update_openai_ads_feed_settingsRename a product feed and/or set searchEligibleRespected (its organic ChatGPT search listing follows each product’s is_eligible_search flag).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename a product feed and/or set searchEligibleRespected (its organic ChatGPT search listing follows each product’s is_eligible_search flag). Touches no ads or spend; the reply is what OpenAI stored.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a ChatGPT Ads feed’s name or organic-listing setting
  • update_openai_ads_lead_formSave a NEW DRAFT REVISION of a ChatGPT Ads lead form (the whole definition: name + fields are replaced).Reads text others writeNo findings

    Why it is in this group

    • The name "update_openai_ads_lead_form" 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
    Save a NEW DRAFT REVISION of a ChatGPT Ads lead form (the whole definition: name + fields are replaced). expectedDraftRevisionId must be the draftRevisionId you last read — ChatGPT Ads refuses a stale one so two editors cannot clobber each other. The published version is untouched until publish_openai_ads_lead_form.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Save a new draft of a ChatGPT Ads lead form
    • idempotentHint: false
  • update_openai_ads_objectEDIT an existing ChatGPT Ads object in place — rename it, change a campaign’s budget or geo targeting, rewrite an ad group’s context hints or bid, or replace an ad’s title, body, l…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EDIT an existing ChatGPT Ads object in place — rename it, change a campaign’s budget or geo targeting, rewrite an ad group’s context hints or bid, or replace an ad’s title, body, landing page or image. Pass level:"campaign" + campaignId, level:"adGroup" + adGroupId, or level:"ad" + adId. Only the fields you pass are changed, but note that context hints, bidding, TARGETING and the creative are REPLACED WHOLESALE rather than merged, so send the complete list. A patch that would silently DESTROY something is refused by name with what would have been lost, rather than going through: dropping a campaign’s geo, custom audiences or PLATFORM targeting, deleting an ad group’s max bid or cost target, or demoting a maximize_* / target_* bid strategy. The reply says if ChatGPT Ads stored a different bid than was sent, and flags a Max Bid / Max CPC ad group (retired 2027-01-01). Changing the budget, the bid or the creative of a LIVE (active) object changes what real money buys immediately — show the user the old and new values, get an explicit yes, then pass confirm:true. The object is READ BACK after the change.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a ChatGPT Ads campaign / ad group / ad
  • update_pinterest_ads_adEDIT an existing Pinterest ad in place — its name, DESTINATION URL, creative type, tracking URLs, deep links, lead form, or which ad group it sits in.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EDIT an existing Pinterest ad in place — its name, DESTINATION URL, creative type, tracking URLs, deep links, lead form, or which ad group it sits in. A PARTIAL edit: a field you do not name is left exactly as Pinterest has it. THE PIN CANNOT BE SWAPPED ON A REAL AD — Pinterest documents pinId as updatable "only for draft ads", so to promote a different Pin create a new ad in the same ad group with create_pinterest_ads_ad and archive this one; that is refused up front with the way through rather than after Pinterest rejects it. IT DOES NOT CHANGE STATUS — set_pinterest_ads_status owns ACTIVE / PAUSED / ARCHIVED, and passing status here is refused by name. EDITING AN AD SENDS IT BACK THROUGH PINTEREST’S REVIEW: the read-back reports the review status and says so when it moved, and an ad in review is NOT serving — never report an edited ad as live on the strength of the edit succeeding. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Pinterest ad
  • update_pinterest_ads_ad_groupEDIT an existing Pinterest ad group in place — its name, bid, budget, pacing, placement and, above all, its TARGETING.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EDIT an existing Pinterest ad group in place — its name, bid, budget, pacing, placement and, above all, its TARGETING. Before this, targeting was frozen the moment an ad group was created: a mistyped bid or a missing country meant building the whole tree again, and because PINTEREST HAS NO DELETE every correction left a permanent archived shell behind. This is a PARTIAL edit — a field you do not name is left exactly as Pinterest has it, so send only what changes, and never re-send everything you just read (that would overwrite a concurrent edit). targetingSpec is the exception: it REPLACES the whole targeting object, so include every criterion you still want. IT DOES NOT CHANGE STATUS — set_pinterest_ads_status owns ACTIVE / PAUSED / ARCHIVED, and passing status here is refused by name. Changing the bid, the budget, or which campaign it spends from WHILE IT IS LIVE moves real money on the next auction: show the user the exact new value, get an explicit yes, then pass confirm:true. Pinterest refuses targetingTemplateIds alongside targetingSpec / trackingUrls / autoTargeting / placementGroup, which is refused here naming the conflicting pair. The ad group is READ BACK from Pinterest afterwards and the note describes what Pinterest actually stored — print it verbatim. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Pinterest ad group
  • update_pinterest_ads_audienceRename a Pinterest audience, change its description or rule, or REMOVE it (remove:true).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename a Pinterest audience, change its description or rule, or REMOVE it (remove:true). Removing is destructive — any ad group that includes or excludes it loses that targeting and Pinterest has no undo — so it needs confirm:true; without it nothing changes and the reply names what would go. Read back from Pinterest afterwards. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit or remove a Pinterest audience
  • update_pinterest_ads_customer_listADD people to (or REMOVE people from) an existing Pinterest customer list by email or mobile ad id — hashed on our server before they leave it.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ADD people to (or REMOVE people from) an existing Pinterest customer list by email or mobile ad id — hashed on our server before they leave it. The list’s counts are read back before and after. Pinterest matches in the background, so the audience size can take hours to move. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Add or remove people on a Pinterest customer list
  • update_pinterest_ads_product_group_promotionChange one Pinterest product-group promotion — status (ACTIVE / PAUSED / ARCHIVED), bid, included, trackingUrl.Reads text others writeNo findings

    Why it is in this group

    • The name "update_pinterest_ads_product_group_promotion" 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 one Pinterest product-group promotion — status (ACTIVE / PAUSED / ARCHIVED), bid, included, trackingUrl. Activating it, or moving its bid, under a LIVE campaign and ad group changes real spend and needs confirm:true. Read back from Pinterest. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Change a Pinterest product-group promotion
  • update_reddit_ads_adEdit a Reddit ad, including a LIVE one: rename it, point it at a different post, change its click url, set or clear its UTM / tracking parameters (clickUrlQueryParameters; pass nul…Reads text others writeNo findings

    Why it is in this group

    • The name "update_reddit_ads_ad" 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 Reddit ad, including a LIVE one: rename it, point it at a different post, change its click url, set or clear its UTM / tracking parameters (clickUrlQueryParameters; pass null to clear), switch on or refresh its PREVIEW link (previewDays 1-30, read back as previewUrl; previewOff:true switches it off), replace its third-party event trackers, or for a catalog ad change its shoppingCreative / featured productIds. Does not activate or pause it — use set_reddit_ads_status. Swapping the post changes what people see, so confirm the new creative with the user first — and Reddit does NOT move the click url with the post, so the reply says where clicks still go. The reply also carries Reddit’s rejection reason when the ad was rejected. The result is read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Reddit ad
  • update_reddit_ads_ad_groupChange an existing Reddit ad group’s name, budget, goal type, bid, schedule dates or targeting.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an existing Reddit ad group’s name, budget, goal type, bid, schedule dates or targeting. Budget and bid are ordinary amounts in the ad account’s currency. Targeting MERGES KEY BY KEY — measured live 2026-08-05, and it is NOT a wholesale replace: a key you send replaces that whole list, a key you LEAVE OUT is kept exactly as it was, and an explicit empty array (geolocations: []) is the only way to clear one. So passing just {communities:[…]} does NOT drop an existing geo or interest filter on an ad group that holds the budget — name every key you want gone. This does NOT activate or pause anything; use set_reddit_ads_status for that. The result is read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Reddit ad group
  • update_reddit_ads_audience_usersAdd people to, or remove people from, a Reddit custom audience.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add people to, or remove people from, a Reddit custom audience. Pass ordinary email addresses and/or mobile advertising ids — each one is canonicalised the way Reddit specifies and SHA-256 hashed on our server before it is sent, so raw customer data never reaches Reddit, and an identifier you already hashed is passed through untouched. Up to 2,500 rows per call; send bigger lists as repeated calls and the audience accumulates. EVERY ROW MUST CARRY THE SAME FIELDS: Reddit’s upload is positional, so if some rows have an email and others do not, the values shift into the wrong column and match nobody — split those into separate calls instead. After Reddit accepts the upload the size does not move for up to 4 hours and processing can take 36, so never re-send the same batch because the count looks unchanged. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Add or remove people in a Reddit custom audience
    • idempotentHint: false
  • update_reddit_ads_campaignChange an existing Reddit campaign’s name, spend cap, budget, goal type or flight dates.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an existing Reddit campaign’s name, spend cap, budget, goal type or flight dates. Amounts are ordinary numbers in the ad account’s currency. The OBJECTIVE and useCatalog cannot be changed: Reddit freezes both at creation and refuses a change even from an old objective name to its new one (IMPRESSIONS to BRAND_AWARENESS), so create a new campaign instead. This does NOT activate, pause or archive anything — use set_reddit_ads_status for that. The result is read back from Reddit before you are told it took.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Reddit campaign
  • update_reddit_ads_catalog_objectChange a Reddit catalog (kind "catalog": its name or attached pixelIds — currency and language are fixed), a product FEED (kind "feed": url, mode, name, credentials or its schedule…Reads text others write1 finding

    Why it is in this group

    • The name "update_reddit_ads_catalog_object" 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.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...uct FEED (kind "feed": url, mode, name, credentials or its schedule, including pausing it w..."

      What this check looks for
    Description, as the server wrote it
    Change a Reddit catalog (kind "catalog": its name or attached pixelIds — currency and language are fixed), a product FEED (kind "feed": url, mode, name, credentials or its schedule, including pausing it with schedule.isPaused) or a PRODUCT SET (kind "product_set": name or filter, same rule format as create_reddit_ads_product_set). A changed product-set filter changes what every catalog ad group using that set advertises, immediately — say so before doing it. Read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Reddit catalog, feed or product set
  • update_reddit_ads_max_templateChange a Reddit Max template ad: its assets (5 to 45 ACTIVE, at least 3 HEADLINE and 2 IMAGE or VIDEO, read and counted before anything is sent), thumbnails, destination URL, suppl…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a Reddit Max template ad: its assets (5 to 45 ACTIVE, at least 3 HEADLINE and 2 IMAGE or VIDEO, read and counted before anything is sent), thumbnails, destination URL, supplementary text, user-generated content enrollment or name. The reply is the template read back, including whether Reddit regenerated the ads. Pausing, activating or archiving it is set_reddit_ads_status.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Edit a Reddit Max template ad
    • idempotentHint: false
  • update_reddit_ads_postTurn comments ON or OFF on an existing Reddit ad post.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "update_reddit_ads_post" says "update" and "post": it writes something other people read.
    Description, as the server wrote it
    Turn comments ON or OFF on an existing Reddit ad post. THAT IS THE ONLY EDIT REDDIT ALLOWS: its post-update schema permits exactly one field, `allow_comments`, and REQUIRES it — headline and body both answer “Additional fields not permitted” once a post is published (measured live 2026-08-05). So a copy change is not an edit at all: create a new post with create_reddit_ads_post and point the ad at it with update_reddit_ads_ad, or fix the wording in Reddit’s Ads Manager. Never promise to reword a live post. A REDDIT AD POST CANNOT BE REMOVED THROUGH THE API AT ALL: Reddit publishes no delete endpoint for one and its update schema has no status, archived or deleted field (re-checked against Reddit’s own reference on 2026-08-05), so creating one is a one-way door and the only way to take it down is Reddit’s Ads Manager. Say that plainly rather than offering to delete it. Turning comments off is publicly visible on a post people may already be replying to, so confirm it with the user first.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn comments on or off on a Reddit ad post
  • update_reddit_ads_saved_audienceRename a Reddit saved audience or replace its targeting.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename a Reddit saved audience or replace its targeting. Targeting MERGES KEY BY KEY — measured live 2026-08-05, not a wholesale replace: a key you send replaces that whole list, a key you LEAVE OUT is kept as it was, and an explicit empty array (geolocations: []) is the only way to clear one — so name every key you want gone. Editing one that live ad groups already use re-targets all of them immediately, so say how many are affected and get a yes before changing targeting on a running account. The result is read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a Reddit saved audience
  • update_salesforce_recordChange fields on one Salesforce record (move an opportunity's stage, set an amount, owner or close date, fix an email), then read it back.Reads text others writeNo findings

    Why it is in this group

    • The name "update_salesforce_record" 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 fields on one Salesforce record (move an opportunity's stage, set an amount, owner or close date, fix an email), then read it back. Send only what changes; null clears a field. Free. Needs Salesforce connected.

    Annotations the server declares

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

    Why it is in this group

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

    Annotations the server declares

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

    Why it is in this group

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

    Annotations the server declares

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

    Why it is in this group

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

    What it can reach

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Write to a range in a Google Sheet
  • update_snapchat_ads_audience_usersAdd people to, or remove them from, a Snapchat FIRST_PARTY customer-list audience.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add people to, or remove them from, a Snapchat FIRST_PARTY customer-list audience. Pass plain emails, phone numbers WITH their country code (+1 555 …), or mobile advertising ids — Hermoso normalises them the way Snapchat specifies and SHA-256 hashes them before anything leaves (a 64-hex value is taken as already hashed). ONE schema per call (Snapchat's rule). Values that are not valid are refused and counted, never sent. action 'remove' and 'remove_all' (empties the list) need confirm:true. Matching is Snapchat's: the reply reports what it accepted and the audience's size and targetable status read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Add or remove people in a Snapchat customer list
    • idempotentHint: false
  • update_snapchat_ads_objectEdit a live or paused Snapchat object IN PLACE, only where Snapchat allows it.Reads text others writeNo findings

    Why it is in this group

    • The name "update_snapchat_ads_object" 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 live or paused Snapchat object IN PLACE, only where Snapchat allows it. campaign / ad: name, startTime, endTime. adsquad: name, startTime, endTime, bid, bidStrategy, pixelId, audiences / excludeAudiences (changing targeting sends its ads back to review and briefly pauses a live squad). creative: name, headline (max 34), brandName (max 32), callToAction, landingPageUrl, utm / addUtm — the URL only on WEB_VIEW creatives; a creative edit re-submits every ad using it for review. Refused BY NAME because Snapchat does not allow them: an ad's creative, a squad's optimization goal or billing event, a creative's type. Status and budget are set_snapchat_ads_status and set_snapchat_ads_budget. confirm:true required — without it NOTHING changes and you get each field's before -> after to show the user. The answer is the READ-BACK, per field.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Edit a Snapchat campaign, ad squad, ad or creative
    • idempotentHint: false
  • update_stripe_promotion_codeSwitch a Stripe promotion code OFF (active:false) or back on (active:true), or change its metadata.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Switch a Stripe promotion code OFF (active:false) or back on (active:true), or change its metadata. Pass promotionCodeId (promo_…) or the code itself. Switching a code off ALWAYS needs confirm:true, test keys included, because anyone holding it from an ad is then refused at checkout. Read back; a code Stripe will not reactivate (its coupon is no longer valid) is reported, not claimed. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: update stripe promotion code
    • idempotentHint: false
  • update_tag_manager_tagCHANGE AN EXISTING TAG in the draft workspace: rename it, fix a wrong conversion id or label, move it onto a different trigger, or pause it.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    CHANGE AN EXISTING TAG in the draft workspace: rename it, fix a wrong conversion id or label, move it onto a different trigger, or pause it. Like create_tag_manager_tag this lands in a DRAFT and does not reach the website until a human publishes the container. Hermoso reads the tag first and merges your change on top of it, because Tag Manager's update replaces the whole tag and sending only the changed field would silently strip its parameters and triggers. A tag's type cannot be changed: that is deleting one tag and creating another. If somebody edited the tag in Tag Manager after Hermoso read it the change is REFUSED rather than overwriting their edit, and the fix is to read it again and reapply. To stop a tag running, pause it rather than removing its trigger. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Change a tag in the container draft
    • idempotentHint: false
  • update_tiktok_ads_adEDIT an existing TikTok ad in place — its ad text, call-to-action, landing URL, URL parameters (UTMs), name, video and cover, carousel sound or Instant Form — instead of deleting a…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EDIT an existing TikTok ad in place — its ad text, call-to-action, landing URL, URL parameters (UTMs), name, video and cover, carousel sound or Instant Form — instead of deleting and rebuilding it, which throws away its review history and delivery learning. Only the fields you pass change. TikTok blanks any field a full update leaves out, so Hermoso rebuilds the edit from TikTok’s own stored copy of the ad and lays your changes over it; a text/name/media-only edit uses TikTok’s incremental mode. An ad that is SWITCHED ON needs confirm:true, because the change reaches real viewers once TikTok accepts it (and TikTok reviews it again); a paused ad edits freely. A CTA change also clears a dynamic-CTA portfolio, which TikTok would otherwise show instead, and the reply says so. The result is READ BACK from TikTok field by field — relay `verified` and the note as given. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a TikTok ad
  • update_tiktok_ads_ad_groupEDIT an existing TikTok ad group after launch: targeting (locationIds, zipcodeIds, ageGroups AGE_18_24…, gender, languages, interestCategoryIds, interestKeywordIds, audienceIds, ex…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EDIT an existing TikTok ad group after launch: targeting (locationIds, zipcodeIds, ageGroups AGE_18_24…, gender, languages, interestCategoryIds, interestKeywordIds, audienceIds, excludedAudienceIds, operatingSystems, networkTypes, spendingPower, householdIncome, deviceModelIds), bid (bidType BID_TYPE_CUSTOM cost cap or BID_TYPE_NO_BID, bid, roasBid) and schedule (startTime before it starts, endTime, dayparting 336 characters). Placement, optimization goal and billing cannot change; budget is set_tiktok_ads_budget. TikTok's update replaces the whole ad group, so everything you do not change is resent from TikTok's stored row. A switched-on ad group needs confirm:true. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Edit a TikTok ad group (targeting, bid, schedule)
  • update_tiktok_ads_audienceRename a TikTok custom audience.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rename a TikTok custom audience. THAT IS ALL IT CHANGES, and the limit is TikTok’s rather than ours: their only other update path replaces the uploaded customer FILE, which Hermoso deliberately does not build (hashed personal data under TikTok’s own Terms, over a transport this integration does not have, where a wrong hash yields a silently EMPTY audience). Changing WHO is in an audience means creating a new one. The new name is READ BACK from TikTok because their update returns an empty body, so a bare success proves nothing — if the read-back disagrees with what you sent, the reply says so and the read-back is the truth.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Rename a TikTok custom audience
    • idempotentHint: false
  • update_tiktok_ads_ruleReplace an automated rule’s WHOLE definition.Reads text others writeNo findings

    Why it is in this group

    • The name "update_tiktok_ads_rule" 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
    Replace an automated rule’s WHOLE definition. TikTok’s update is a full replace rather than a patch, so send every field the rule should keep — anything omitted is gone. IF THE RULE IS CURRENTLY RUNNING AND THE NEW VERSION CAN START OR RAISE SPEND, this arms it the moment it saves, so it takes the same confirm:true plus confirmScope echo as arming one: an edit must never be a route by which a harmless rule becomes a spending rule behind a gate it passed when it meant something else. A rule that is currently OFF needs no gate here, because arming it later runs the gate against the new definition. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Replace a TikTok automated rule’s definition
  • update_tiktok_tto_campaignAdd creators or ad accounts to an existing TikTok One campaign.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add creators or ad accounts to an existing TikTok One campaign. IT ONLY EVER ADDS: TikTok appends what you pass to what the campaign already holds and publishes nothing that removes either, so there is no way to un-invite a creator or unlink an ad account through the API: the reply therefore reports what the campaign NOW HOLDS rather than what you sent. The name, description, brand and anchor cannot be changed after creation at all; TikTok’s own create endpoint accepts a campaign_id and then ignores every field except the account and the handles, which is why a rename is impossible rather than merely unsupported here. handleNames is not accepted on a BRAND_LINK campaign, because a brand-level link is open to whoever opens it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Add creators or ad accounts to a TikTok One campaign
    • idempotentHint: false
  • update_x_ads_audienceChange an X custom audience: rename / redescribe it, and/or ADD or REMOVE people (operation add|remove) — same identifiers as create_x_ads_audience, hashed on our server.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an X custom audience: rename / redescribe it, and/or ADD or REMOVE people (operation add|remove) — same identifiers as create_x_ads_audience, hashed on our server. X reports how many it processed and Hermoso relays it; a mismatch is flagged as not fully applied. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Change an X custom audience
    • idempotentHint: false
  • update_x_ads_campaignChange a LIVE X campaign — budget, name, delivery pacing.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a LIVE X campaign — budget, name, delivery pacing. THIS IS HOW YOU THROTTLE OR RAISE SPEND on a running campaign without rebuilding it, and lowering dailyBudget is the fastest way to slow money down short of pausing. Budgets are in the ad account's own currency. Only fields X actually applies are offered: startTime/endTime are DEPRECATED on an X campaign (its schedule lives on the LINE ITEM — use update_x_ads_line_item) and frequency capping needs an X account feature we cannot enable, so both are refused BY NAME with the reason instead of being sent and silently ignored. THE READ-BACK IS A DIFF against the before-state: a field X did not move is reported as REFUSED, never counted as applied. Print the returned note verbatim.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Change an X campaign budget or settings
    • idempotentHint: false
  • update_x_ads_lead_formChange an X lead form.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an X lead form. Only the fields you pass change — but X replaces the fields list and each section (intro, thank-you page, privacy policy) WHOLE, so pass the complete new value of any you touch. An archived form cannot be changed. Read back from X. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Change an X lead form
    • idempotentHint: false
  • update_x_ads_line_itemChange an X line item — BID, bid strategy, SCHEDULE, goal or name.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change an X line item — BID, bid strategy, SCHEDULE, goal or name. An X campaign's start and end times are deprecated, so the schedule genuinely lives HERE. Lowering `bidAmount` is also the fix when X refuses a campaign budget with “Bid is too close to Budget”. NOT changeable after creation: `objective` and `productType` — X answers 200 and silently keeps the old value (measured), so both are refused BY NAME here and a different objective means a NEW line item. Changing `goal` also requires `bidAmount` (X refuses the goal alone) and that is stated up front rather than relayed. A line-item dailyBudget/totalBudget is only legal when the parent campaign is NOT budget-optimised — that is the campaign's setting, so those two are forwarded and X's own refusal names the remedy rather than Hermoso blocking a legal edit. THE READ-BACK IS A DIFF against an independent re-read: a field X accepted but did not move is reported as REFUSED. Print the returned note verbatim.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Change an X line item (ad group)
    • idempotentHint: false
  • upload_google_ads_videoUpload a Hermoso video (render id, Library id, attachment://N or Hermoso link) straight into Google Ads — no YouTube channel needed: it goes UNLISTED to the Google-managed channel …Reads text others writeNo findings

    Why it is in this group

    • The name "upload_google_ads_video" says "upload": 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
    Upload a Hermoso video (render id, Library id, attachment://N or Hermoso link) straight into Google Ads — no YouTube channel needed: it goes UNLISTED to the Google-managed channel of the ad account (or to your own brand channel with channelId, where PUBLIC is allowed). Waits for YouTube to process it, then returns the video asset ready for create_google_ads_demand_gen_campaign or Performance Max. AI-generated renders are disclosed as such. action "status" finishes a slow one (uploadId), "list" shows uploads, "remove" deletes one (confirm:true). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a video straight into Google Ads
  • upload_snapchat_ads_creativePUT A FINISHED HERMOSO RENDER ONTO THE SNAPCHAT AD ACCOUNT so an ad can point at it — create_snapchat_ads_ad needs the creativeId it returns.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    PUT A FINISHED HERMOSO RENDER ONTO THE SNAPCHAT AD ACCOUNT so an ad can point at it — create_snapchat_ads_ad needs the creativeId it returns. Pass the public https url of a render; SNAPCHAT HAS NO UPLOAD-FROM-URL, so Hermoso fetches the bytes and posts them as multipart. This does TWO things in one call — it uploads the MEDIA and then builds the CREATIVE that wraps it — because a Snapchat ad points at a CREATIVE and never at a media id, and stopping after the upload leaves an asset nothing can use. A PUBLIC PROFILE IS MANDATORY: Snapchat has required profile_properties on every ad creative since 2024-02-26, so snapProfileId is REQUIRED and a call without one is refused BEFORE any bytes move (which is what stops an orphan media row being left on the ad account for a creative that could never be created). Get one from list_snapchat_ads_profiles, or read it in Snapchat Ads Manager. headline is required too. COPY LIMITS ARE SHORT AND ENFORCED: headline max 34 characters, brandName max 32, and over-long copy is REFUSED rather than truncated, because shipping words nobody wrote is worse than a refusal. To build a SECOND creative on media already uploaded, pass mediaId instead of url — nothing is downloaded or uploaded again. A file over 32MB is refused by name (Snapchat requires a chunked upload flow above that which Hermoso does not implement). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
    • title: Upload a render to Snapchat as media + creative
    • idempotentHint: false
  • upsert_merchant_productCreate or replace a product in a Merchant Center feed — this is how a merchant's catalogue gets populated, and it is what Shopping ads, free listings and retail Performance Max act…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create or replace a product in a Merchant Center feed — this is how a merchant's catalogue gets populated, and it is what Shopping ads, free listings and retail Performance Max actually serve. It is an UPSERT and a WHOLE-ROW write: calling it again for the same offerId REPLACES the product rather than patching it, so send every field you want kept each time. You do not have to find a feed first — omit dataSource and it resolves the account's one writable feed, creates one if there is none, and REFUSES by name if there are several rather than putting the product in a market the campaigns may not target. offerId, contentLanguage and feedLabel together ARE the product's identity and are all immutable; contentLanguage and feedLabel are taken from the feed when the feed declares them. For the product to serve at all Google needs title, description, link, imageLink, availability and price — a row missing any of them is stored and then disapproved, and the reply says so rather than letting you believe it published. The reply reports what GOOGLE STORED, not what was sent. Free: a feed edit cannot spend.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Create or replace a Merchant Center product
  • upsert_microsoft_merchant_productAdd or update product offers in a Microsoft Merchant Center store.Reads text others writeNo findings

    Why it is in this group

    • The name "upsert_microsoft_merchant_product" says "upsert": 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 or update product offers in a Microsoft Merchant Center store. THE ONE THING TO KNOW BEFORE CALLING IT: Microsoft has NO partial update — 'because an update is an insert operation, you must include all fields of the offer in the request' — so a title-only 'update' CLEARS every other field. Always send the whole offer. Ten fields are required: availability, channel, condition, contentLanguage, imageLink, link, offerId, price, targetCountry, title; brand/gtin/mpn are strongly recommended and their absence is set as identifierExists:false for you. Pass product for one offer or products[] for a batch (Hermoso caps a batch at 300 — Microsoft publishes two contradictory ceilings for this and we take the lower). Pass dryRun:true to validate against Microsoft without writing anything; Microsoft returns no ids on a dry run, so none is claimed. Feed edits cannot spend and cannot start an auction, but an offer goes through editorial review — being STORED is not the same as being served. Everything is read back from Microsoft. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Add or update Microsoft Merchant Center product offers
  • upsert_reddit_ads_productsAdd products to a Reddit catalog, or update them — re-sending an id you already sent UPDATES that product, it never duplicates it.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add products to a Reddit catalog, or update them — re-sending an id you already sent UPDATES that product, it never duplicates it. Up to 1,000 per call. Fields are Reddit’s own snake_case product attributes: id (your SKU, required), title, description, price as "<amount> <ISO currency>" e.g. "19.99 USD", link, image_link, availability (IN_STOCK, OUT_OF_STOCK, PREORDER, BACKORDER), brand, sale_price, additional_image_links, product type, Google product category, gtin, mpn, condition, color, size, gender, age_group, item_group_id, custom_label_0…4 and the rest of Reddit’s list. Reddit answers per product — CREATED, UPDATED, UNCHANGED or INVALID with the exact field and issue code — and that answer is what is reported. New products go through Reddit’s review before they can serve. Spends nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
    • title: Add or update products in a Reddit catalog
Can't be undone 10Claude Code: ask
  • create_stripe_priceAdd a price to an existing Stripe product: `amount` in MAJOR units (19 or 19.00 is $19.00, never 1900), currency, optional recurring interval and intervalCount, optional nickname.Reads text others writeNo findings

    Why it is in this group

    • The name "create_stripe_price" says "create": a word for a change.
    • The input carries an amount (input.amount) and a currency, so it moves money.

    What it 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 price to an existing Stripe product: `amount` in MAJOR units (19 or 19.00 is $19.00, never 1900), currency, optional recurring interval and intervalCount, optional nickname. Read back. LIVE key: confirm:true after showing the preview. Idempotent on its arguments. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: create stripe price
    • idempotentHint: false
  • create_stripe_productCreate a product on the brand's Stripe account together with its default price: name, optional description, `amount` in MAJOR units — 19 or 19.00 both mean $19.00, and a zero-decim…Reads text others writeNo findings

    Why it is in this group

    • The name "create_stripe_product" says "create": a word for a change.
    • The input carries an amount (input.amount) and a currency, so it moves money.

    What it 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 product on the brand's Stripe account together with its default price: name, optional description, `amount` in MAJOR units — 19 or 19.00 both mean $19.00, and a zero-decimal currency like JPY is whole — a 3-letter currency, and an optional recurring interval (day, week, month, year) with intervalCount. Returns both ids, read back. On a LIVE key it shows what it is about to create and needs confirm:true; on a test key it just does it. Idempotent on its arguments. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: create stripe product
    • idempotentHint: false
  • inbox_statsUse this for "how fast do we reply", "when are we busiest", "how many messages did we get" or "who is waiting".Reads text others writeCan send data out1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Use this for "how fast do we reply", "when are we busiest", "how many messages did we get" or "who is waiting". Across every connected messaging channel (WhatsApp, Messenger, Instagram, Telegram, SMS, LINE, WeChat, Slack, Discord, email; X only with includeX, because X bills per message read): messages received and sent per day and per channel, a day × hour heatmap on the user's clock with the busiest hours, response time (median, p90, fastest, slowest, histogram) per channel and per receiving account, reply rate, conversations waiting now, and per-conversation rows. Counts from when the inbox was first read: Hermoso keeps each message's time and direction, never its text. A channel it could not read is named, never shown as empty. Print `text`. Free (X: X's per-read price).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Inbox stats: volume, busiest hours, response times
    • idempotentHint: true
  • list_stripe_refundsRefunds on the brand's Stripe account, newest first: amount, status, reason and the charge refunded; filter by charge.Reads text others write1 finding

    Why it is in this group

    • The name "list_stripe_refunds" says "list": a word for reading.
    • The description's first verb is "refund": a word that usually means money moves, which cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Refunds on the brand's Stripe account, newest first: amount, status, reason and the charge refunded; filter by charge. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: list stripe refunds
    • idempotentHint: true
  • list_tiktok_ads_payment_portfoliosThe payment portfolios under a TikTok Business Center; how a customer’s ad accounts are actually funded, whether the money is pooled across them (an Advanced portfolio) or held per…Reads text others write1 finding

    Why it is in this group

    • The name "list_tiktok_ads_payment_portfolios" says "list": a word for reading.
    • The description's first verb is "payment": a word that usually means money moves, which cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    The payment portfolios under a TikTok Business Center; how a customer’s ad accounts are actually funded, whether the money is pooled across them (an Advanced portfolio) or held per account (a Standard one), how many accounts draw on each, and what credit line it carries. WORTH READING WHEN CAMPAIGNS STOP DELIVERING, because that is very often a funding answer rather than an ads answer, and nothing else in Hermoso can see it. By TikTok’s own default this lists every portfolio belonging to the same CLIENT as the Business Center, including ones not linked to it; pass bcRelated:true to narrow it. READ-ONLY BY DESIGN: Hermoso never creates a portfolio, moves an ad account onto one, or allocates a credit line, because each of those decides where a customer’s money sits. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok payment portfolios
    • idempotentHint: true
  • merge_openai_ads_audiencesCombine 2 to 64 existing ChatGPT Ads custom audiences into ONE new audience.Reads text others writeNo findings

    Why it is in this group

    • The name "merge_openai_ads_audiences" says "merge": a word for a change that another call does not undo.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Combine 2 to 64 existing ChatGPT Ads custom audiences into ONE new audience. The SOURCE audiences are left unchanged, later updates to them do NOT propagate into the merged one, and no existing campaign switches to the new id by itself — re-point targeting deliberately if that is the intent. Creates a new audience; changes nothing that is already serving.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Merge ChatGPT Ads custom audiences
    • idempotentHint: false
  • posting_insightsUse this for "when should I post", "how often should I post", "how long do my posts keep earning" or "how are my followers growing".Can send data out1 finding

    Why it is in this group

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

    What it can reach

    • outboundThe input takes a destination (input.channel): what the tool writes goes there.

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Use this for "when should I post", "how often should I post", "how long do my posts keep earning" or "how are my followers growing". From this brand's own measured posts, per channel, on the user's clock: view best_time (day × hour grid, best day and time band; Instagram's followers-online hours beside it), frequency (engagement per post and rate at each posts-per-week, plus follower change; names the highest cadence before per-post engagement drops), decay (% of a post's final engagement and reach reached by each age) or followers (count per account per day/week/month, up to a year, with change). Default view summary = all four. Never adds a metric across channels; below its floor (15 measured posts for a time, 3 weeks per cadence, 5 settled posts for decay) it says how many it has and names nothing; a count it could not read is unknown, never 0; YouTube is listed without derived numbers (its API policy). Print `text`. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Best time to post, frequency, decay, follower history
    • idempotentHint: true
  • preview_openai_ads_business_agentSend a message (or a whole messages[] transcript) to a ChatGPT Ads Business Agent and get its reply — a PREVIEW that publishes and serves nothing.Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "preview_openai_ads_business_agent" says "preview": a word for reading.
    • The description's first verb is "send": a word for sending, and what is sent cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • private-dataThe description's first sentence says "message": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "send" and "message": it reads messages, which other people can write.

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Send a message (or a whole messages[] transcript) to a ChatGPT Ads Business Agent and get its reply — a PREVIEW that publishes and serves nothing. Use it to test instructions before publish_openai_ads_business_agent.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Chat with a Business Agent (preview)
    • idempotentHint: true
  • record_shopify_marketing_activityRecord an ad or campaign the merchant is running (on Meta, Google, TikTok, email, anywhere) in their Shopify admin under Marketing, so Shopify's own reports attribute storefront vi…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The input carries an amount (input.budget.amount) and a currency, so it moves money.

    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
    Record an ad or campaign the merchant is running (on Meta, Google, TikTok, email, anywhere) in their Shopify admin under Marketing, so Shopify's own reports attribute storefront visits and sales to it by its UTM. REPORTING ONLY: it publishes nothing and spends nothing. Pass title, remoteUrl (where the ad is managed, e.g. The Ads Manager link), the utm {campaign, source, medium} the ad's links carry, and optionally tactic (AD default, RETARGETING, POST, LINK, NEWSLETTER, …), channel (SOCIAL default, SEARCH, DISPLAY, EMAIL, REFERRAL), status (ACTIVE default, PAUSED, SCHEDULED, INACTIVE, DELETED_EXTERNALLY), budget {type DAILY|LIFETIME, amount, currency}, adSpend {amount, currency}, start / end / scheduledEnd dates and previewImageUrl. RemoteId is YOUR stable id for the activity (the ad platform's campaign id is ideal); calling again with the same remoteId UPDATES that one row, and every field you leave out is KEPT from the existing record (Shopify's own upsert would erase it; the reply lists what was kept). Read back from Shopify. Needs the store to have approved Hermoso's marketing permission: if it has not, the reply says to open Hermoso once from the Shopify admin to approve it. Works for the Shopify store connected to this brand or the store this account was installed on. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Record an ad or campaign in Shopify > Marketing
  • revenue_by_sourceWhich posts, ads and emails led to actual sales: the brand's payments (Shopify orders and Stripe charges, whichever is connected) matched back to what Hermoso published or sent, wi…Reads text others writeCan send data out1 finding

    Why it is in this group

    • The description's first verb is "post" and "email": it sends a message, which cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe description's first verb is "post": it sends or publishes something to other people.

    Findings

    • Warn

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

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "post" and "email": it sends a message, which cannot be taken back.

      What this check looks for
    Description, as the server wrote it
    Which posts, ads and emails led to actual sales: the brand's payments (Shopify orders and Stripe charges, whichever is connected) matched back to what Hermoso published or sent, with revenue, payments and customers per channel, campaign, single post/ad/email (groupBy item) or match method. Each payment is matched ONCE, strongest first, and says how: utm (a Hermoso tracking id on the visit), reference (a Hermoso id on a Stripe checkout), code (a discount code Hermoso created, or one you name in codes), ad_utm (the UTM tags Hermoso puts on ads it builds), tag (Hermoso's tags without an id) — these LED TO the sale; email (the buyer is someone Hermoso emailed or who replied, within emailWindowDays before paying) and referrer (the visit came from a social platform the brand posts to) are looser matches, never causation. The unattributed remainder is stated plainly. GA4's own attribution of purchases to Hermoso's tags and the ad platforms' own reported conversions (Meta, Google Ads) are shown APART, never added in: they can describe the same sales again. Money is per currency, never summed across currencies. A source that could not be read is said as such, never as zero sales. Default: the last 30 days (Shopify lets apps read its last 60). Read-only, free. Links carry Hermoso's ids only when tracking links are on (set_tracking_links).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Revenue by source (posts, ads, emails)
Changes things 245Claude Code: ask
  • add_apple_ads_keywordsAdd targeting keywords to an Apple Ads ad group.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add targeting keywords to an Apple Ads ad group. keywords is [{text, matchType, bid}] — matchType EXACT (default), BROAD, PHRASE or CATEGORY, and bid optionally overrides the ad group default for that one term. Up to 1000 per call and 5000 per ad group. They are sent ONE AT A TIME on purpose: a single term Apple refuses cannot take the rest of the batch down, and the reply names every refusal with Apple’s own reason, then reads the ad group’s keywords back to prove what actually landed. Keyword text and match type are IMMUTABLE — to change either, delete the keyword and add it again. A keyword is created ENABLED because it cannot serve unless its ad group and campaign are enabled too; if the ad group is ALREADY live, adding keywords serves on the next auction and therefore takes confirm:true. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Add Apple Ads keywords
    • idempotentHint: false
  • add_apple_ads_negative_keywordsAdd negative keywords to an Apple Ads campaign or ad group — search terms your ads must NOT show for.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add negative keywords to an Apple Ads campaign or ad group — search terms your ads must NOT show for. Pass exactly one of campaignId (campaign-wide) or adGroupId (that ad group only); Apple rejects a request carrying both. keywords is [{text, matchType}] with matchType BROAD (default) or EXACT. Never confirm-gated and never a spend risk, because a negative keyword only ever RESTRICTS where you show. Text and match type are immutable — delete and re-add to change either. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Add Apple Ads negative keywords
    • idempotentHint: false
  • add_bing_webmaster_siteAdd a site to the connected Bing Webmaster account.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add a site to the connected Bing Webmaster account. Important: ADDING IS NOT VERIFYING, and saying so is most of this tool's value: the site arrives UNVERIFIED and every read on it is refused until an ownership proof is placed on the site itself — an XML file at the root, a meta tag in the home page <head>, or a CNAME DNS record — which no API can do. Place one, then call verify_bing_webmaster_site. Microsoft documents that adding a site which is already there does NOT error, so a success here is not even evidence anything changed, which is why the answer is read back from Bing's site list. It is also NOT shared with this profile until the user ticks it under Connectors > Bing Webmaster Tools > Manage accounts (or call list_connector_accounts with provider bing_webmaster, then set_connector_accounts). 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Add a site to the Bing Webmaster account
    • idempotentHint: false
  • add_google_ads_assetsAdd ASSETS (extensions) to a Google Ads campaign, ad group or the whole account (level:"customer") — and ATTACH them, which is what makes them show.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add ASSETS (extensions) to a Google Ads campaign, ad group or the whole account (level:"customer") — and ATTACH them, which is what makes them show. Pass assetType plus assets[]: SITELINK {linkText ≤25, finalUrl, description1/2}; CALLOUT {calloutText ≤25}; STRUCTURED_SNIPPET {header, values[] ≥3}; CALL {phoneNumber, countryCode}; PROMOTION {promotionTarget ≤20, percentOff OR moneyAmountOff, finalUrl, promotionCode?, occasion?, startDate?, endDate?}; PRICE {priceType, offerings[3–8] of {header ≤25, description ≤25, price, unit?, finalUrl}}; LEAD_FORM {businessName, headline, description, privacyPolicyUrl, callToActionType, callToActionDescription, finalUrl, fields?}; BUSINESS_NAME {businessName ≤25}; BUSINESS_LOGO {image: a square Hermoso image}. Or link existing ones with assetResourceNames[]. Edit, pause or detach later with manage_google_ads_assets. (Google does not let apps attach Search image extensions; images go through Performance Max, Demand Gen and display ads.) Assets and links go up in ONE atomic operation, so a rejected link never strands an orphan asset, and the links are READ BACK from Google before you are told they exist. Attaching a live asset to a LIVE (ENABLED) campaign changes what that ad shows on the very next auction — show the user what would appear, get an explicit yes, then pass confirm:true. On a paused campaign it never needs confirmation.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Add sitelinks, callouts, call, promotion, price, lead-form and brand assets to Google Ads
  • add_google_ads_keywordsAdd keywords — and NEGATIVE keywords — to a Google Ads ad group.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add keywords — and NEGATIVE keywords — to a Google Ads ad group. A Search ad group with no keywords never shows. Each keyword takes text (≤80 chars, ≤10 words) and matchType EXACT | PHRASE | BROAD (default PHRASE). Set negative:true to BLOCK a term instead of targeting it, which is the cheapest way to stop wasted spend. Read back from Google before you are told they exist. If the parent campaign and ad group are already LIVE, a positive keyword starts bidding real money at once — get an explicit yes and pass confirm:true, or add it with paused:true. Negative keywords only restrict spend and never need confirmation.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Add Google Ads keywords
  • add_microsoft_ads_keywordsAdd keywords to a Microsoft Advertising ad group.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add keywords to a Microsoft Advertising ad group. Match types are Exact, Phrase and Broad — Microsoft has no broad-match-modifier. Keywords are added Paused unless you set status:"Active"; an Active keyword on a live ad group makes the campaign bid on a new term immediately, so that needs confirm:true. Note that per-keyword bids are honoured but ad-group / keyword BID STRATEGIES are silently ignored by Microsoft — they inherit the campaign’s. Only the keywords Microsoft confirms on the read-back are reported as added.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Add Microsoft Advertising keywords
  • add_microsoft_ads_negative_keywordsEXCLUDE searches from a Microsoft Advertising campaign or ad group with negative keywords — Exact or Phrase only (Microsoft has no broad negative; default Phrase, which blocks ever…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EXCLUDE searches from a Microsoft Advertising campaign or ad group with negative keywords — Exact or Phrase only (Microsoft has no broad negative; default Phrase, which blocks every search containing the phrase), up to 20,000 per campaign or ad group. Broad-match keywords without negatives are the classic way to waste money: “stop paying for free” is this tool. It can only narrow spend, so it is never confirm-gated. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Exclude searches on Microsoft Advertising (negative keywords)
  • add_search_console_siteAdd a property to the connected Google account.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add a property to the connected Google account. TWO THINGS THAT MUST REACH THE USER, and the answer states both: (1) ADDING IS NOT VERIFYING — the property arrives with the account as an unverified user and EVERY read on it is refused until ownership is proven with a DNS record, an HTML file or a tag, which no API can do and which the user completes in Search Console itself; (2) the new property is NOT yet shared with this profile, so someone has to tick it under Connectors > Google Search Console > Manage accounts (or call list_connector_accounts with provider google_search_console, then set_connector_accounts) before any tool here can use it. The permission level is READ BACK from Google, so the answer says which of those two states it is actually in. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Add a property to Search Console
    • idempotentHint: false
  • add_x_ads_targetingAdd targeting criteria to an X LINE ITEM.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add targeting criteria to an X LINE ITEM. Targeting does NOT attach to a campaign on X — a campaign carries only budget and funding. Pass locationIds resolved with x_ads_geo_search, and/or criteria[] for any of X's other 37 targeting vocabularies when you already hold the ids. X takes ONE criterion per API call, so a set is several calls: each is reported individually, a partial failure NAMES what did not apply, and the line item's FULL targeting is read back afterwards so the answer is what the line item carries rather than what was sent. Adds no spend — the line item stays PAUSED.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Target an X ads line item
    • idempotentHint: false
  • amplitude_active_usersAmplitude ACTIVE or NEW user counts over a date range — the top-line "is the product growing" number, and the cheapest Amplitude call to run first after connecting because it prove…Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

      The description mentions "credential".

      Matched text

      description: "...after connecting because it proves the credential with no setup. metric is "active" or "n..."

      What this check looks for
    Description, as the server wrote it
    Amplitude ACTIVE or NEW user counts over a date range — the top-line "is the product growing" number, and the cheapest Amplitude call to run first after connecting because it proves the credential with no setup. metric is "active" or "new"; interval 1 daily, 7 weekly, 30 monthly. An empty series on a new project is the CORRECT answer and means the connection works and there is no data yet — never report it as a failure. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Amplitude active / new users
    • idempotentHint: true
  • amplitude_funnelAMPLITUDE FUNNELS: conversion and drop-off across ordered steps.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    AMPLITUDE FUNNELS: conversion and drop-off across ordered steps. Pass `events` as an ORDERED array of at least two steps. mode is ordered / unordered / sequential. conversionWindowSeconds is how long a user has to complete the funnel and DEFAULTS TO 2,592,000 SECONDS (30 DAYS) — ALWAYS state which window a conversion rate was measured over, because a 30-day window makes a funnel look dramatically healthier than a same-session one and the difference is invisible in the number itself. At most ONE group-by: segmentation allows two, funnels do not, and a second is refused by name rather than silently dropped. Returns step-by-step and cumulative conversion plus median and average transition times. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Amplitude funnel (conversion + drop-off)
    • idempotentHint: true
  • amplitude_retentionAMPLITUDE RETENTION — of the people who did startEvent, how many came back and did returnEvent.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    AMPLITUDE RETENTION — of the people who did startEvent, how many came back and did returnEvent. The two magic values are "_new" (first-time users) and "_active" (any active user), which is what makes "new-user retention" a single call. retentionMode is n-day / bracket / rolling, and "bracket" additionally REQUIRES `brackets` — it is refused without them rather than silently switched to another mode, because a retention curve computed under a different definition than the one asked for is a wrong answer that looks right. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Amplitude retention
    • idempotentHint: true
  • amplitude_segmentationAMPLITUDE EVENT SEGMENTATION — an event over time, with filters and group-bys.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    AMPLITUDE EVENT SEGMENTATION — an event over time, with filters and group-bys. metric is uniques / totals / pct_dau / average / histogram / sums / value_avg / formula (and "formula" additionally REQUIRES `formula`, or Amplitude refuses it). Dates take YYYY-MM-DD or YYYYMMDD. AMPLITUDE'S RATE LIMIT IS COST-BASED, not per-request: cost = days × conditions × query type, 1000 per 5-minute window, so one very wide query can exhaust the budget on its own — the fix for a 429 here is to NARROW the range or the conditions, not to retry. AN EMPTY RESULT IS A VALID ANSWER, not a failure: a new or low-traffic Amplitude project genuinely has no data, and reporting that as a broken connection sends the user to fix something that is working. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Amplitude event segmentation
    • idempotentHint: true
  • amplitude_user_activityONE PERSON'S ACTIVITY STREAM in Amplitude.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ONE PERSON'S ACTIVITY STREAM in Amplitude. Pass a user id, device id or user-id PREFIX and it SEARCHES; pass a numeric Amplitude ID and it returns that user's recent events with their properties. Two steps, because Amplitude splits them across two endpoints: search resolves a human-typed identifier to an Amplitude ID, and only that id reads an activity stream. NOTE these two endpoints sit on a DIFFERENT rate limit from the rest of Amplitude — flat counts (10 concurrent, 360 queries/hour) rather than the cost model — so they do not consume the segmentation budget and are not protected by it either. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: One person’s Amplitude activity stream
    • idempotentHint: true
  • analytics_realtimeWHO IS ON THE SITE RIGHT NOW — GA4's realtime report, covering roughly the last 30 minutes.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHO IS ON THE SITE RIGHT NOW — GA4's realtime report, covering roughly the last 30 minutes. Use it to see a launch, a post or a campaign landing in real time. IT IS A DIFFERENT REPORT WITH A DIFFERENT METRIC SET, NOT a shortcut for analytics_report: realtime accepts activeUsers, screenPageViews, conversions and eventCount, and REJECTS `sessions` outright — asking for sessions here returns an error, not a zero. Realtime dimensions are also narrower (unifiedScreenName, country, deviceCategory, platform, eventName …) and there is no date range at all. The property is the NUMERIC id from list_analytics_properties, never the G-XXXXXXX Measurement ID. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Who is on the site right now (GA4 realtime)
    • idempotentHint: true
  • analytics_reportWHAT HAPPENED ON THE SITE — the GA4 Data API report, and the tool that answers "where is our traffic coming from", "which campaign converted", "which landing page is 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.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHAT HAPPENED ON THE SITE — the GA4 Data API report, and the tool that answers "where is our traffic coming from", "which campaign converted", "which landing page is working". Pass metrics by name (activeUsers, sessions, screenPageViews, conversions, totalRevenue, engagementRate, bounceRate, averageSessionDuration …) and dimensions to break them down by (sessionDefaultChannelGroup, sessionSource / sessionMedium / sessionCampaignName, landingPage, pagePath, country, deviceCategory, date, eventName …). GA4 publishes hundreds of both and each property ships its OWN custom dimensions, so names are forwarded as given rather than validated against a copied list — use list_analytics_definitions to see a property's custom ones. THE PROPERTY IS A NUMERIC ID (e.g. 123456789), NOT the G-XXXXXXX Measurement ID — run list_analytics_properties to resolve it. Dates default to the last 28 days and accept either YYYY-MM-DD or GA4's relative forms ("28daysAgo", "yesterday", "today"). PERIOD OVER PERIOD IN ONE CALL: compare:"previous_period" (or "previous_year") adds the earlier period and returns per-period totals plus `change` (absolute + %) computed from GA4's own totals — quote it, never redo the maths; or pass up to 4 named dateRanges. comparisons put segments side by side; totals:true adds a total row. Rows come back as flat named objects. When GA4 says the data is SAMPLED, TRUNCATED, rolled into an "(other)" row or thresholded, completenessNotes says so in words; repeat those when reporting. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Run a GA4 report
    • idempotentHint: true
  • analyze_campaignsUse this when the user asks how their paid ads are doing across platforms, or what to scale, pause, fix or test next.Reads text others write2 findings

    Why it is in this group

    • The name "analyze_campaigns" 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.

    Findings

    • Info

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

      Matched text

      description ends: "...in any ad account and spends no ad money; it bills one model call over the table."

      What this check looks for
    • Warn

      The server marks "analyze_campaigns" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Use this when the user asks how their paid ads are doing across platforms, or what to scale, pause, fix or test next. One verdict across every connected ad platform: it pulls each platform's own report (Meta, Google Ads, ChatGPT Ads, TikTok, LinkedIn, Microsoft Advertising, Pinterest, Reddit, Snapchat, X, Apple Ads), normalises every campaign / ad set / ad into ONE table — spend, impressions, clicks, CTR, CPC, conversions, CPA, ROAS and frequency where the platform reports them — and answers with four lists: `scale`, `pause`, `fix` and `test_next`, plus `insufficient_data`. Each recommendation carries the row's own numbers, the reason, a next action and the exact tool call that would apply it (e.g. set_meta_campaign_status with confirm), which this tool never runs. FOUR REFUSALS TO REPEAT RATHER THAN PAPER OVER: (1) A ROW BELOW THE DATA FLOOR IS NEVER JUDGED — the minimums are stated in the reply, and an under-powered row lands in insufficient_data with what it lacks, never in "pause"; a row whose conversions are too few for a CPA verdict can still be read on CTR and CPC and says so. (2) A PLATFORM WHOSE READ FAILED IS NAMED AS UNREADABLE and its numbers are MISSING, never zero — never move budget on the strength of an absence. (3) A META AD SET IN THE LEARNING PHASE IS HELD BACK, because editing it restarts learning. (4) A CONVERSION COLUMN THE PLATFORM DOES NOT PUBLISH READS UNMEASURED, not zero (Reddit, Snapchat and X in this report). Conversion definitions differ per platform and travel with every row, and each platform's days are its own account's days, so a cross-platform CPA comparison must carry that caveat. Args: days (complete days ending yesterday, default 14, max 90), platforms (omit for every connected one), goal ("lowest CPA", "ROAS", "leads under $30"), level (campaign | ad_group | ad — a platform with no report at that tier is read at campaign level and says so). Changes nothing in any ad account and spends no ad money; it bills one model call over the table.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: What to scale, pause, fix and test next
  • 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
  • apple_ads_change_historyWho changed what on this Apple Ads account, and when.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Who changed what on this Apple Ads account, and when. Call it with start and/or end to get one row per TRANSACTION GROUP — a single user action that may have touched several fields, which is what changeCount counts — with the user, the entity and the event type (CREATE / UPDATE / DELETE). Then pass a row’s detailId back as detailId to get the field-by-field before and after. THE TIME BOUND IS MANDATORY: Apple answers 400 without one, so pass start (meaning "since then"), end ("up to then"), or both. Narrow with campaignId, adGroupId, entityType, eventType or userId. Useful for "why did this campaign’s budget change overnight" and for reconstructing what an agent did on the account. On a CREATE event the old values are empty by design; a DELETE is implemented as a record update so its old values ARE populated. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Apple Ads change history
    • idempotentHint: true
  • apple_ads_impression_shareCOMPETITIVE INTELLIGENCE: what fraction of the available impressions your app actually captures for each search term, by market and day or 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.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    COMPETITIVE INTELLIGENCE: what fraction of the available impressions your app actually captures for each search term, by market and day or week. This is the report that finds where you are being out-bid or out-budgeted — a LOW share on a term with high search popularity means budget, bid or eligibility is capping your reach on a term people are really searching, which is the most actionable row Apple publishes. READ THE ENCODING BEFORE QUOTING A NUMBER: lowImpressionShare and highImpressionShare are TIERED, not continuous. Below 91% the two are equal and read as a single percentage; a row where they diverge to 0.91 and 1.0 means ">90%", not "91 to 100". granularity DAILY covers at most 30 days; WEEKLY_SUN_SAT covers at most 4 weeks and its start date MUST be a Sunday (both are refused for free before any request). reportType FIRST_SLOT (default) is the top ad position only; ALL_SLOTS aggregates every position. Timezone is fixed to UTC by Apple. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Apple Ads impression share
    • idempotentHint: true
  • apple_ads_keyword_suggestionsApple’s OWN search data for an app you advertise — the fastest way to build a real Apple Search Ads keyword list instead of guessing.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Apple’s OWN search data for an app you advertise — the fastest way to build a real Apple Search Ads keyword list instead of guessing. THE THREE KINDS DO NOT SHARE A FILTER VOCABULARY and Apple 400s any field that is not an attribute of the one you query, so each takes different parameters. kind:"keyword" (the default) returns suggested keyword strings and accepts `terms` + `countriesOrRegions` — it has NO queryType, and passing one is refused. kind:"phrase" returns longer search phrases and REQUIRES `phrases` (the phrases to look up); kind:"category" returns App Store categories and REQUIRES `categories`. Neither accepts `terms`. POPULARITY IS RELATIVE, NOT A VOLUME: it ranks terms against each other and cannot be read as searches per month. queryType defaults to "SEARCH", which looks up phrases/categories you name; "SUGGESTION" asks Apple to discover new ones and IS CURRENTLY BROKEN AT APPLE — measured 2026-08-17, it hangs ~34s and returns a server error for a request identical to Apple’s own published example, so retrying will not clear it. REQUIRED: promotedObjectId — the app’s adamId (search_apple_ads_apps with no arguments lists the apps this organization owns) or an Apple Maps brandId. An empty result is about the APP, not the account. Feed the winners straight into add_apple_ads_keywords or bulk_apple_ads_keywords. Read-only, free, spends nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Apple Ads keyword, phrase and category suggestions
    • idempotentHint: true
  • apple_ads_rejection_reasonsWHY an Apple Ads creative, custom product page or Maps brand was REJECTED: Apple’s reason code, type and level (default or custom product page, or a locale of one), the asset or pr…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHY an Apple Ads creative, custom product page or Maps brand was REJECTED: Apple’s reason code, type and level (default or custom product page, or a locale of one), the asset or product page it applies to, the country and language, and Apple’s comment — read live. Use it whenever list_apple_ads_creatives shows systemStatus INVALID, or the user asks why an Apple ad is not running. Pass adamId for an app’s reasons, mapsBrandId for a Maps brand’s policy reasons, or rejectionReasonId for one reason. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Why an Apple Ads creative or brand was rejected
  • apple_ads_reportApple Ads performance — impressions, taps, installs, spend, TTR, CPT, CPA.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...first after connecting — it proves the credentials work with zero spend risk."

      What this check looks for
    Description, as the server wrote it
    Apple Ads performance — impressions, taps, installs, spend, TTR, CPT, CPA. level is campaign / adgroup / ad / keyword / searchterm; promotedObjectType is apps (App Store, the default) or business-brands (Ads on Apple Maps). startTime and endTime are REQUIRED, as YYYY-MM-DD. campaignId is REQUIRED for every level except campaign — it moved from the URL into a filter, but Apple still enforces it (measured: “campaignId filter is required for AD_GROUP reports when promotedObjectType is APPS”), so only a campaign-level report may be account-wide. adGroupId narrows it further. groupBy is restricted PER LEVEL and an unsupported dimension is refused by name, never dropped: campaign and adgroup take deviceClass/ageRange/gender/countryCode/adminArea/locality/storefront/countryOrRegion, keyword and searchterm take only deviceClass/storefront/countryOrRegion, and ad takes only storefront/countryOrRegion. granularity is optional and carries Apple’s own date rules (HOURLY reaches back 7 days and is unavailable on ad and searchterm reports; DAILY 90 days and needs a range longer than one day; WEEKLY 365 days with an end date at least 14 days ago; MONTHLY needs an end date at least 90 days ago). FOR A SINGLE DAY, OMIT granularity — the totals come back in each row’s totalMetrics. Search-term reports are ORTZ-only. grandTotals adds a summary row; emptyMetrics includes entities with no delivery — App Store reports only, never together with groupBy, and never on a search-term report. A report with NO rows genuinely means there was NO delivery in that window and scope: say exactly that, and never present zeros as measured performance. Read-only and free, so run it first after connecting — it proves the credentials work with zero spend risk.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Apple Ads performance report
    • idempotentHint: true
  • apple_ads_target_cpa_suggestionWhat Apple thinks an install should cost you.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What Apple thinks an install should cost you. Returns the suggested target CPA for an app — the MAXIMUM tap-install CPI Apple observed across that app’s eligible markets over the last 28 days, together with the market that produced it. Only markets with at least 10 installs in that window qualify, so a brand-new or low-volume app legitimately has no suggestion yet and that is an answer, not a failure. This is the number to put on a MAX_CONVERSIONS campaign, where the campaign-level bid IS the target CPA — it is NOT a per-tap bid and does not belong on a MANUAL_CPT campaign, which refuses a campaign-level bid outright. Scope it with countriesOrRegions to ask about specific markets. Read-only, free, spends nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Apple Ads suggested target CPA
    • idempotentHint: true
  • applovin_ads_change_historyWho changed what on the brand’s AppLovin campaigns, and when: creation, edits (field by field, before and after), status changes and ARCHIVING — including archived campaigns that l…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Who changed what on the brand’s AppLovin campaigns, and when: creation, edits (field by field, before and after), status changes and ARCHIVING — including archived campaigns that list_applovin_ads_campaigns no longer returns. One campaign (campaignId) or the whole account; since/until must fall within the latest 30 UTC days and go together (neither = the last 7 days). Read-only, free. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: AppLovin campaign change history
    • idempotentHint: true
  • applovin_ads_pixelThe AppLovin pixel for the brand’s website: AppLovin’s own install snippet with the account’s Event Key filled in, where it goes (every page’s <head>, Google Tag Manager, or the Ap…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
    The AppLovin pixel for the brand’s website: AppLovin’s own install snippet with the account’s Event Key filled in, where it goes (every page’s <head>, Google Tag Manager, or the AppLovin Shopify app), the events to fire for a store or a lead-gen site with copy-ready examples, dedupe ids, and how to validate it. The Event Key is public by design. Calls nothing at AppLovin. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: AppLovin pixel install snippet
  • applovin_ads_reportAppLovin Ads performance: impressions, clicks, CTR, spend, sales, ROAS and checkout revenue by day, campaign, creative set or country.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    AppLovin Ads performance: impressions, clicks, CTR, spend, sales, ROAS and checkout revenue by day, campaign, creative set or country. Works with the Reporting Key alone, which every AppLovin account has. Web reports reach back 90 days, app 45; UTC. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: AppLovin Ads performance report
    • idempotentHint: true
  • authorize_tiktok_ads_spark_postApply an authorization code so this ad account may promote somebody else’s TikTok post.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "authorize_tiktok_ads_spark_post" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Apply an authorization code so this ad account may promote somebody else’s TikTok post. THE CODE CANNOT BE MINTED FROM THE API — only the post’s owner can generate one, in the TikTok app: open the post -> three-dot menu -> Ad settings -> toggle Ad authorization -> choose a duration -> copy the code. Ask them for it; there is no way around this and no endpoint that creates one. Applying a code SPENDS NOTHING and creates nothing that can serve — it only grants permission — so it is deliberately not confirm-gated. If the post is a DUET or STITCH of another post, or mentions one, TikTok requires the ORIGINAL post owner’s code too: pass it as originalPostAuthCode or the call is refused. THE ANSWER IS THE READ-BACK: the reply lists the posts now authorised, because TikTok’s own response body is empty and a bare 200 proves nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Apply a TikTok Spark Ads authorization code
    • idempotentHint: false
  • bind_tiktok_ads_ruleBind campaigns, ad groups or ads to an EXISTING automated rule, or unbind them from one.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
    Bind campaigns, ad groups or ads to an EXISTING automated rule, or unbind them from one. BINDING TO A RULE THAT IS RUNNING AND ABLE TO SPEND puts those objects under standing permission to have their budget or bid raised, which is the same act as arming the rule for them — so it takes the same confirm:true plus confirmScope echo, computed from the rule as TikTok stores it. UNBINDING only ever narrows a rule’s reach and needs neither. TikTok answers a bind with an empty body, so the result is read back off the rule rather than taken from the 200. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Put objects under a TikTok automated rule, or take them out
  • bing_webmaster_crawlWhether Bing can actually reach the site's pages: crawl statistics (mode "stats"), the URLs with problems (mode "issues", the default), one page's index detail (mode "page", needs …Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "bing_webmaster_crawl" says "crawl": it reads web pages, which anyone can write.
    • untrusted-inputThe description's first sentence says "crawl": 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.
    Description, as the server wrote it
    Whether Bing can actually reach the site's pages: crawl statistics (mode "stats"), the URLs with problems (mode "issues", the default), one page's index detail (mode "page", needs `url`), a directory's (mode "directory"), or the crawl settings themselves (mode "settings"). Issue names are DECODED from Bing's bitmask into readable ones — Code301, Code302, Code4xx, Code5xx, BlockedByRobotsTxt, ContainsMalware, ImportantUrlBlockedByRobotsTxt, DnsErrors, TimeOutErrors — because the raw JSON hands back an integer that means nothing on its own, and a bit Microsoft has added since is reported as unknown rather than dropped. Microsoft notes it may take a few days for a FIXED issue to disappear from this list, so a listed issue is not proof it is still live. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Can Bing crawl this site?
    • idempotentHint: true
  • bing_webmaster_keywordsBing search impressions for any term.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Bing search impressions for any term. Modes: "keyword" (impressions for exactly this term over a date range), "related" (the same for terms Bing considers related — the one to use for expanding a seed into a list), "history" (the term's historical series). NOT SITE-SCOPED — these are Microsoft's signatures and they take no site, so it works for ANY term including a competitor's brand, and no property tick list applies. `country` AND `language` are BOTH REQUIRED and are deliberately never defaulted: a search volume with no market is unactionable, and picking one for you would answer confidently about the wrong country. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Keyword research with real impression volumes, no ad spend
    • idempotentHint: true
  • bing_webmaster_submission_quotaHow many URLs this site may still submit to Bing today and this month, plus the separate content-submission budget.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    How many URLs this site may still submit to Bing today and this month, plus the separate content-submission budget. BING SETS THIS PER SITE AND IT VARIES — Microsoft's own documented example allows 5 a day and 24 a month — so it is always read live and never assumed. Check it before promising anyone a bulk submission, because Bing rejects an over-quota batch as a WHOLE rather than taking what fits. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: How many URLs can still be submitted to Bing today
    • idempotentHint: true
  • bing_webmaster_trafficBing clicks and impressions over time — for the whole site (mode "site", the default), for one page (mode "page", needs `url`), or for every page under one directory (mode "directo…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Bing clicks and impressions over time — for the whole site (mode "site", the default), for one page (mode "page", needs `url`), or for every page under one directory (mode "directory", needs `url`). An unknown mode is refused by name. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Bing clicks and impressions
    • idempotentHint: true
  • buy_creditsOut of credits?Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

      The description mentions "CREDENTIAL".

      Matched text

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

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

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Buy credits
  • check_analytics_compatibilityFREE PRE-FLIGHT FOR analytics_report — ask Google whether these dimensions and metrics can appear in ONE report together, BEFORE running the report that would fail.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    FREE PRE-FLIGHT FOR analytics_report — ask Google whether these dimensions and metrics can appear in ONE report together, BEFORE running the report that would fail. Use it whenever a report combines fields you have not combined before, and especially when one of them is a custom dimension: GA4 has real pairs that are each perfectly valid alone and cannot be queried together, and `analytics_report` deliberately forwards names AS GIVEN (GA4 publishes hundreds of dimensions and every property ships its own custom ones, so validating against a copied list would go stale and start REFUSING names Google accepts). Pass EXACTLY what you would pass to analytics_report — same metrics, same dimensions, same filters — and it returns which fields are INCOMPATIBLE so you can drop one and run the real report once. IT DOES NOT CHECK THAT A NAME EXISTS: an unknown api name is refused by Google outright, and list_analytics_metadata is what resolves names. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check a GA4 report will work, before running it
    • idempotentHint: true
  • check_apple_ads_app_eligibilityAsk Apple whether an app may be advertised at all, PER PLACEMENT AND PER COUNTRY — the check Apple tells you to run before building a campaign around an 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.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Ask Apple whether an app may be advertised at all, PER PLACEMENT AND PER COUNTRY — the check Apple tells you to run before building a campaign around an app. Each row is ELIGIBLE or INELIGIBLE for one combination of placement, country or region and device class, with the minimum age rating for that market. A campaign targeting a country the app is INELIGIBLE in simply will not deliver there and nothing in the campaign build says so, so this is how you find out for free beforehand. adamId is REQUIRED. NO ROWS IS NOT THE SAME AS INELIGIBLE — it usually means the app is not owned by this organization; report that distinction rather than presenting it as a refusal. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check whether an app may be advertised
    • idempotentHint: true
  • check_domain_email_healthCheck a domain’s email setup from public DNS and say what to fix: MX (who receives its mail), SPF (which servers may send as it, counted against the 10-lookup limit), DKIM (signing…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Check a domain’s email setup from public DNS and say what to fix: MX (who receives its mail), SPF (which servers may send as it, counted against the 10-lookup limit), DKIM (signing keys; pass the selector when known, otherwise common ones are tried), DMARC (policy and reports) and blocklists (its mail servers on public spam lists whose terms allow this lookup). Pass `checks` to run only some. Use it when mail lands in spam, before sending a campaign, or to check SPF, DKIM or DMARC. Free; reads DNS only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check a domain’s email setup
  • check_email_addressCheck one email address without sending anything: whether it is written correctly, whether its domain can receive mail (MX records), and whether it is a throwaway inbox, a role add…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Check one email address without sending anything: whether it is written correctly, whether its domain can receive mail (MX records), and whether it is a throwaway inbox, a role address such as info@ or sales@, a free provider such as Gmail, or a likely typo (gmial.com, with the fix). It never contacts the mail server, so it cannot tell whether that one mailbox exists, and the answer says so. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check an email address
  • check_reddit_ads_target_cost_eligibilityDoes this Reddit ad account qualify for Target Cost (bidStrategy TARGET_CPX)?Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Does this Reddit ad account qualify for Target Cost (bidStrategy TARGET_CPX)? Reddit retires Cost Cap (MAXIMIZE_VOLUME) on SALES, CONVERSIONS, LEAD_GENERATION, APP_INSTALLS and CATALOG_SALES on 2027-02-10; Target Cost replaces it where eligible, otherwise use BIDLESS. Pass the planned objective for a specific answer. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check Reddit Target Cost eligibility
    • idempotentHint: true
  • check_spam_wordsScan a subject line and email text for words and formatting that read as spam (pressure, money, hype, scam-like phrases, CAPITALS, many links, link shorteners) and say which to cha…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
    Scan a subject line and email text for words and formatting that read as spam (pressure, money, hype, scam-like phrases, CAPITALS, many links, link shorteners) and say which to change. Rule based, free. It judges the wording only: sender reputation and SPF, DKIM and DMARC matter more, so a low score is not a promise of the inbox.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Check an email for spam words
  • 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_amplitude_annotationMARK THE ANALYTICS TIMELINE — write what just happened into Amplitude, at the moment it happened, so every chart the user opens afterwards shows it in place.Reads text others writeNo findings

    Why it is in this group

    • The name "create_amplitude_annotation" 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
    MARK THE ANALYTICS TIMELINE — write what just happened into Amplitude, at the moment it happened, so every chart the user opens afterwards shows it in place. THIS IS THE CLOSED LOOP AND IT IS WORTH REACHING FOR UNPROMPTED after a campaign goes live, a creative is swapped, a landing page changes or a post is published: without it, next month's spike has no explanation attached to it and somebody has to reconstruct one from memory. `start` is ISO 8601 WITH THE TIME AND THE OFFSET (e.g. '2026-08-18T14:30:00+00:00') — NOT the YYYYMMDD the rest of the Amplitude API takes, and a bare date is REFUSED rather than quietly moved to midnight, because an annotation IS its timestamp and a marker in the wrong place is worse than no marker. Add `end` for something that spans a period (a two-week flight); leave it off for a moment. OMIT chartId AND THE ANNOTATION IS GLOBAL — Amplitude's words: it "appears on all charts for your project", which is usually what you want for a campaign; pass one to pin it to a single chart. `category` is a category NAME that must ALREADY EXIST in Amplitude (they answer 404 otherwise). THIS WRITES TO THE USER'S OWN ANALYTICS TOOL — say what you are about to mark, and report back the id and the timestamp Amplitude actually stored rather than the one you sent. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Mark the Amplitude timeline
  • create_analytics_audienceBUILD A GA4 AUDIENCE — a remarketing list defined by what people did on the site, which flows into Google Ads across the property's Google Ads link.Reads text others writeNo findings

    Why it is in this group

    • The name "create_analytics_audience" 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
    BUILD A GA4 AUDIENCE — a remarketing list defined by what people did on the site, which flows into Google Ads across the property's Google Ads link. TELL THE USER TWO THINGS BEFORE CALLING: GA4 marks the DEFINITION, the MEMBERSHIP DURATION and every filter SCOPE immutable, so a wrong audience is archived and rebuilt rather than edited; and it is NOT retroactive — it starts collecting members from creation onward, and Google takes 24-48 hours to populate it. `filterClauses` is GA4's own nested shape and the TOP level of each filterExpression MUST be a single `andGroup` (Google's schema says so and its rejection names no field). Worked example, 'everyone who fired purchase': [{"clauseType":"INCLUDE","simpleFilter":{"scope":"AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS","filterExpression":{"andGroup":{"filterExpressions":[{"orGroup":{"filterExpressions":[{"eventFilter":{"eventName":"purchase"}}]}}]}}}}]. The result says whether the property is linked to Google Ads, because an audience nobody can remarket to is not a finished job. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Build a GA4 audience (remarketing list)
  • create_analytics_custom_metricRegister an event parameter the site ALREADY SENDS as a GA4 custom METRIC, so reports can SUM or AVERAGE it.Reads text others writeNo findings

    Why it is in this group

    • The name "create_analytics_custom_metric" 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
    Register an event parameter the site ALREADY SENDS as a GA4 custom METRIC, so reports can SUM or AVERAGE it. This is the other half of the pair: a custom DIMENSION makes a value something you can group BY, a custom METRIC makes it something you can TOTAL — 'order_value' as a dimension gives you a list of prices, as a metric it gives you revenue. TELL THE USER TWO THINGS BEFORE CALLING: a GA4 custom metric CANNOT be deleted, only archived, and a property is capped at 50 (125 on Analytics 360) — a duplicate or a typo permanently burns a slot, so run list_analytics_definitions first, which lists metrics beside dimensions. measurementUnit IS REQUIRED and is never guessed for you: STANDARD for a plain count or quantity, CURRENCY for money, SECONDS/MINUTES/HOURS for durations. CURRENCY additionally REQUIRES restrictedMetricType (REVENUE_DATA for money coming in, COST_DATA for money going out) and every other unit REFUSES it — both directions are refused before the call is made, because Google's own error names neither field. METRICS ARE EVENT-SCOPED ONLY, unlike dimensions, which take EVENT | USER | ITEM. Not retroactive: it collects from creation onward. The result is READ BACK from Google, never echoed from the request. Needs edit access on the property. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Register a GA4 custom metric
  • create_analytics_key_eventMark an event GA4 ALREADY COLLECTS as a KEY EVENT — what GA4 calls a conversion since the 2024 rename (the resource is keyEvents; the old conversionEvents spelling is deprecated).Reads text others writeNo findings

    Why it is in this group

    • The name "create_analytics_key_event" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Mark an event GA4 ALREADY COLLECTS as a KEY EVENT — what GA4 calls a conversion since the 2024 rename (the resource is keyEvents; the old conversionEvents spelling is deprecated). This is what makes an event countable as a result in reports and importable into Google Ads as a conversion. THE EVENT NAME MUST MATCH AN EVENT THE SITE ALREADY SENDS ("purchase", "generate_lead", "sign_up", or a custom one) — marking an event that is never fired creates a key event that can never fire, so check list_analytics_definitions or an analytics_report broken down by eventName first. countingMethod ONCE_PER_EVENT counts EVERY occurrence; ONCE_PER_SESSION counts the event at most ONCE PER SESSION, however many times it fires in that session. Those are the only two GA4 accepts — there is no per-USER counting method, and asking for one is refused rather than quietly counted per event. The result is READ BACK from Google, never echoed from the request. The property is the NUMERIC id from list_analytics_properties. Needs the Google Analytics connection to have edit access on the property.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Mark a GA4 event as a key event (conversion)
  • create_apple_ads_ad_accountCreate a new ad account under this Apple Ads organization — the container an agency opens per client, or a business opens to run Apple Maps ads alongside App Store ones.Reads text others writeNo findings

    Why it is in this group

    • The name "create_apple_ads_ad_account" 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 ad account under this Apple Ads organization — the container an agency opens per client, or a business opens to run Apple Maps ads alongside App Store ones. AN AD ACCOUNT SPENDS NOTHING: it holds campaigns, and every campaign inside it is still born PAUSED. productFeatures is REQUIRED, is a CHOICE OF ONE, and is IMMUTABLE FOREVER — APPSTORE_APP_MANUAL for App Store advertising or BUSINESS_BRAND_MANUAL for Apple Maps, never both, and an organization needing both keeps two accounts. Delegations must MATCH that choice: an App Store account delegates a CONTENT_PROVIDER (a CPID from list_apple_ads_advertiser_resources), a Maps account delegates a BUSINESS_BRAND — a mismatch is refused for free here, because Apple accepts it and you get an account that cannot advertise anything. currency, timeZone and paymentModel are inherited from the organization and cannot be set. NOTE: Hermoso keeps writing to the ONE ad account this connection is pinned to — reconnect Apple Ads and choose the new account to build inside it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create an Apple Ads ad account
    • idempotentHint: false
  • create_apple_ads_location_groupCreate a location group — the set of a brand’s shops an Apple Maps ad group promotes.Reads text others writeNo findings

    Why it is in this group

    • The name "create_apple_ads_location_group" 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 location group — the set of a brand’s shops an Apple Maps ad group promotes. TWO KINDS. STATIC takes an explicit locationIds list (from list_apple_ads_locations) and is VALID immediately. DYNAMIC takes rules and maintains itself as the brand opens and closes shops, but starts PENDING while Apple evaluates them — wait for systemStatus VALID before targeting it. A RULE THAT MATCHES NOTHING IS APPLE’S ONE SILENT FAILURE HERE: it returns no error and simply builds a group with groupTotal 0, so adminArea must be the FULL English name ("California", never "CA") and locality must be countryOrRegion|adminArea|locality ("US|New York|Brooklyn", never "Brooklyn") — both shapes are refused here before the group is built. A group SPENDS NOTHING and does not decide who sees the ad or how near they are: it only scopes WHICH shops the ad group promotes, while radius and geo targeting on the ad group decide reach. mapsBrandId and the ad account are locked in permanently at creation. Target it afterwards with create_apple_ads_ad_group(targeting.locationGroupIds) or update_apple_ads_object(level:"adgroup"). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create an Apple Maps location group
    • idempotentHint: false
  • 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_google_ads_conversion_actionCreate a CONVERSION ACTION — the thing that tells Google what counts as a result on this account.Reads text others writeNo findings

    Why it is in this group

    • The name "create_google_ads_conversion_action" 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 CONVERSION ACTION — the thing that tells Google what counts as a result on this account. This is a PREREQUISITE, not a nicety: MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_CPA, TARGET_ROAS and every Performance Max campaign are undeliverable without one, because Google has nothing to optimise toward. type WEBPAGE (a purchase / lead / signup on the site — the normal choice), UPLOAD_CLICKS or UPLOAD_CALLS; every other Google conversion type (Firebase, Google Analytics 4, Floodlight, store visits) is READ-ONLY and is created in those products, not here. Set category to what actually happened (PURCHASE, SUBMIT_LEAD_FORM, SIGNUP, BOOK_APPOINTMENT…) and defaultValueUsd when a conversion has a known worth — TARGET_ROAS has nothing to maximise without a value. Created ENABLED and counted in "conversions" by default, because a conversion action that is neither records nothing. It CANNOT SERVE AN AD and cannot spend a cent, so it needs no confirmation. A WEBPAGE action records NOTHING until its Google tag is installed on the site — say that when you report it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Ads conversion action
  • create_google_ads_ruleAUTOMATED RULES ON GOOGLE ADS — "pause ad groups whose CPA is over $50 over the last 7 days", "raise the budget 20% when ROAS > 4, never above $300", on a schedule with optional qu…Reads text others writeNo findings

    Why it is in this group

    • The name "create_google_ads_rule" 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
    AUTOMATED RULES ON GOOGLE ADS — "pause ad groups whose CPA is over $50 over the last 7 days", "raise the budget 20% when ROAS > 4, never above $300", on a schedule with optional quiet hours. Google's API has NO rules resource (its UI rules are not reachable by any API), so HERMOSO runs these: every run reads the metrics, applies the caps against real numbers, writes through Google's own mutates, reads the result back, and logs it (google_ads_rule_history); a live run can be undone (undo_google_ads_rule_action). EVERY RULE IS CREATED SWITCHED OFF; dry-run it with run_google_ads_rule, then switch it on with set_google_ads_rule_status. Conditions take derived metrics or any metrics.<field> Google reports; actions pause / enable / notify / change a budget (campaign) or the manual CPC bid (ad group) by percent, amount or to a value. An increase needs a limit. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Ads automated rule (created switched OFF)
  • create_linkedin_ads_campaign_groupCreate a LinkedIn CAMPAIGN GROUP — the container LinkedIn has required every campaign to live inside since 2020.Reads text others writeNo findings

    Why it is in this group

    • The name "create_linkedin_ads_campaign_group" 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 LinkedIn CAMPAIGN GROUP — the container LinkedIn has required every campaign to live inside since 2020. Created DRAFT, which is LinkedIn’s own structural safety net: it REFUSES to hold an ACTIVE campaign inside a DRAFT group, so while the group is a draft nothing beneath it can serve whatever its own status says. Creating it ACTIVE removes that protection and therefore requires confirm:true. LinkedIn REQUIRES a run schedule on a campaign group: it starts today unless you pass startDate, and if you set totalBudget you MUST also pass endDate — that pairing is LinkedIn’s own rule and it is refused here before anything is created. Read back from LinkedIn before you are told it exists.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a LinkedIn campaign group (draft)
  • create_linkedin_conversion_ruleCreate a LinkedIn CONVERSION RULE — the object LinkedIn attributes conversions to, and the prerequisite for send_linkedin_conversions.Reads text others writeNo findings

    Why it is in this group

    • The name "create_linkedin_conversion_rule" 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 LinkedIn CONVERSION RULE — the object LinkedIn attributes conversions to, and the prerequisite for send_linkedin_conversions. `type` is the behaviour being tracked (LEAD, PURCHASE, SIGN_UP, QUALIFIED_LEAD, KEY_PAGE_VIEW…). THE RULE IS BORN ASSOCIATED WITH NOTHING: until you attach campaigns with associate_linkedin_conversion_campaigns it attributes nothing, which also makes it the safe place to send test events — LinkedIn has no test mode on the wire. Pass associateAllCampaigns:true to attach it to up to 200 ACTIVE campaigns instead; that spends nothing but it changes what those live campaigns optimise toward and what their reports count, so ask the user first. Attribution windows are 1, 7, 30 or 90 days (365 only for SUBMIT_APPLICATION, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD and LEAD). Creating a rule cannot spend money — it is a definition. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a LinkedIn conversion rule
  • create_linkedin_lead_formCreate a LinkedIn LEAD GEN FORM — the form a lead gen ad opens, prefilled from the member’s LinkedIn profile so they submit in two taps.Reads text others writeNo findings

    Why it is in this group

    • The name "create_linkedin_lead_form" 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 LinkedIn LEAD GEN FORM — the form a lead gen ad opens, prefilled from the member’s LinkedIn profile so they submit in two taps. Owned by an ad account (adAccountId, the usual choice for ads) or a company Page (pageId). Give it a name (only shown in Campaign Manager), the headline people see, the questions (predefined fields LinkedIn prefills, plus custom text or multiple-choice questions), a privacy policy URL, optional consent checkboxes, a thank-you message and a thank-you button with its landing page. Created PUBLISHED by default — LinkedIn still lets you edit every field until a running ad uses it. Read back from LinkedIn before you are told it exists. Then attach it with create_linkedin_ads_creative(leadFormId) under a LEAD_GENERATION campaign. A form cannot spend money. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a LinkedIn lead gen form
  • create_merchant_data_sourceCreate an API product feed on a Merchant Center account — the container upsert_merchant_product writes into.Reads text others writeNo findings

    Why it is in this group

    • The name "create_merchant_data_source" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an API product feed on a Merchant Center account — the container upsert_merchant_product writes into. Most accounts have none until one is made: a store set up through the Merchant Center UI has a UI feed, which is read-only. feedLabel and contentLanguage must be set TOGETHER or not at all and BOTH ARE IMMUTABLE — leave them off and the feed accepts products for any market and language, which is the safer default because a wrong feed label can never be corrected. Omit destinations to inherit wherever the account already sells. Creating a feed costs nothing and cannot spend.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Merchant Center product feed
  • create_merchant_promotionPUT A SALE BADGE ON THE MERCHANT'S SHOPPING LISTINGS — the most seasonal thing a retail advertiser does.Reads text others writeNo findings

    Why it is in this group

    • The name "create_merchant_promotion" 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
    PUT A SALE BADGE ON THE MERCHANT'S SHOPPING LISTINGS — the most seasonal thing a retail advertiser does. It creates the promotion and resolves (or creates) the promotion DATA SOURCE that country/language needs automatically; a promotion data source is its own kind and cannot be the product feed. IT IS NOT LIVE ON CREATE: Google validates promotions asynchronously and can take days to approve one, so report it as SUBMITTED and re-read with list_merchant_promotions. Everything Google marks Required is refused up front by name, including the pairings its own 400 does not mention — PERCENT_OFF needs percentOff, MONEY_OFF needs moneyOffAmount, GENERIC_CODE needs genericRedemptionCode — because otherwise Google accepts the promotion and disapproves it hours later where nobody is watching. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Merchant Center promotion (sale badge)
  • create_meta_ad_ruleAUTOMATED RULES ON META — a standing instruction META runs on the user's ad account on its own schedule, with nobody watching: "pause any ad set whose cost per result is over $X to…Reads text others writeNo findings

    Why it is in this group

    • The name "create_meta_ad_rule" 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
    AUTOMATED RULES ON META — a standing instruction META runs on the user's ad account on its own schedule, with nobody watching: "pause any ad set whose cost per result is over $X today", "raise the budget 20% when ROAS is above 3, at most once a day, never above $200". Meta runs these rules itself (Ads Manager > Automated rules shows them too). EVERY RULE IS CREATED SWITCHED OFF and read back from Meta to prove it; switching it on is a separate act (set_meta_ad_rule_status). Actions: pause, enable, notify, or change a budget/bid by a percent or amount. A rule that RAISES needs a limit (the ceiling), and the reply says plainly what it will be able to do unattended. Money values are in the account currency's BASE UNIT (for USD 1000 = $10.00), as Meta defines them. Conditions take any Meta rule filter field; for anything the plain fields cannot say, pass Meta's raw evaluationSpec / executionSpec / scheduleSpec. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Meta automated rule (created switched OFF)
  • create_meta_audienceBuild a retargeting audience on a connected Meta ad account.Reads text others writeNo findings

    Why it is in this group

    • The name "create_meta_audience" 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
    Build a retargeting audience on a connected Meta ad account. Four kinds: kind:"website" (people whose visited URL contains urlContains, seen by pixelId — pass the brand’s own domain for "all visitors"; retentionDays up to 180), kind:"engagement" (people who did `event` on the brand’s Facebook Page, or its Instagram business profile with source:"instagram"; retentionDays up to 730), or kind:"lookalike" (sourceAudienceId + country + ratio 0.01–0.20 = the top 1%–20% most similar people, lookalikeType "similarity" or "reach", or startingRatio for a band such as 1%–3%). Meta delivers a lookalike to the locations of the AD SET that targets it, so `country` is where you will run it — target the same country in that ad set. CREATING AN AUDIENCE SPENDS NOTHING — it is a definition; money only moves when an ad set targets it and that campaign is activated through set_meta_campaign_status(confirm:true). Meta needs roughly 30 minutes and ~1,000 people before a new audience can be targeted, so a fresh one reporting no size is normal. kind:"customerfile" is the brand's OWN CUSTOMER LIST (emails, phones, names…) for retargeting, suppression or as a lookalike seed: pass customerFileSource (a required attestation of where the data came from: USER_PROVIDED_ONLY, PARTNER_PROVIDED_ONLY or BOTH_USER_AND_PARTNER_PROVIDED), plus schema (the column names in order, from EMAIL, PHONE, FN, LN, FI, CT, ST, ZIP, COUNTRY, DOB, DOBY, GEN, MADID, EXTERN_ID) and rows (arrays in that order, up to 10,000 per call) to upload them in the same call. Hermoso normalizes and SHA-256-hashes every value before it leaves the server, exactly as Meta requires, and reports Meta’s own match counts (a mostly-rejected upload is a format problem and says so). To ADD more people to an existing list, call again with kind:"customerfile" + audienceId + schema + rows (uploads add, they never replace). Meta asks the ad account to accept its Custom Audience Terms once; if it has not, Meta’s refusal says so.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Meta custom audience or lookalike
    • idempotentHint: false
  • create_meta_lead_formCreate an INSTANT LEAD FORM on a connected Facebook Page — the in-app form a Meta lead ad opens instead of sending someone to a website, so a person can sign up without leaving the…Reads text others writeNo findings

    Why it is in this group

    • The name "create_meta_lead_form" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an INSTANT LEAD FORM on a connected Facebook Page — the in-app form a Meta lead ad opens instead of sending someone to a website, so a person can sign up without leaving the app. `questions` takes Meta’s own type names, e.g. ["FULL_NAME","EMAIL","PHONE"]; for anything bespoke pass {type:"CUSTOM", label:"What size fleet do you run?"} and add options:[…] to make it a dropdown. Ask FEWER questions than you think — every extra field costs completions. privacyPolicyUrl is REQUIRED: the form collects real people’s contact details and has to say where their data goes. Optional: headline, contextCard {title, bullets[], buttonText} for the why-should-I screen, thankYou {title, body, buttonType, buttonText, websiteUrl}, locale, followUpActionUrl. CREATING A FORM SPENDS NOTHING and publishes nothing — it is invisible to the public until an ad points at it (create_meta_ad with objective:"OUTCOME_LEADS" + leadFormId), and that ad is created PAUSED. Read the submissions with read_meta_leads. NEEDS pages_manage_ads — see list_meta_lead_forms for what to do if Meta refuses it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Meta instant (lead) form
    • idempotentHint: false
  • create_microsoft_ads_conversion_goalCreate a Microsoft Advertising CONVERSION GOAL, read back.Reads text others writeNo findings

    Why it is in this group

    • The name "create_microsoft_ads_conversion_goal" 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 Microsoft Advertising CONVERSION GOAL, read back. type: Url (a thank-you page: urlExpression + urlOperator), Event (a UET custom event: eventAction / eventCategory / eventLabel / eventValue), OfflineConversion (conversions uploaded from a CRM with send_microsoft_ads_offline_conversions — no tag; Microsoft asks for 2 hours before the first upload), Duration (minimumDurationSeconds) or PagesViewedPerVisit (minimumPagesViewed). Every type but OfflineConversion needs tagId (create_microsoft_ads_uet_tag). category is required for Url / Event / Offline. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Microsoft Advertising conversion goal
  • create_microsoft_ads_customer_listCreate an EMPTY Customer Match list on a Microsoft Advertising account, ready for apply_microsoft_ads_customer_list to fill.Reads text others writeNo findings

    Why it is in this group

    • The name "create_microsoft_ads_customer_list" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an EMPTY Customer Match list on a Microsoft Advertising account, ready for apply_microsoft_ads_customer_list to fill. membershipDuration is 1–390 days, or -1 for no expiration (Microsoft's default is 30). scope 'Account' (the default) makes it usable only by that ad account; scope 'Customer' makes it usable by every account under the manager — Hermoso derives the right parent id for whichever you choose, because getting that pair wrong mis-parents the list silently. An audience is a definition: it cannot spend and it cannot serve on its own. Read back from Microsoft. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Create an empty Microsoft Advertising Customer Match list
  • create_microsoft_ads_uet_tagCreate a UET tag (Microsoft’s site tracking pixel) and get its install snippet, read back.Reads text others writeNo findings

    Why it is in this group

    • The name "create_microsoft_ads_uet_tag" 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 UET tag (Microsoft’s site tracking pixel) and get its install snippet, read back. Url / Event / Duration / PagesViewedPerVisit conversion goals, remarketing lists and conversion bidding all need one. Name ≤100 characters, unique per customer. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Microsoft Advertising UET tag
  • create_mixpanel_annotationMARK THE MIXPANEL TIMELINE: write what just happened into Mixpanel at the moment it happened, so every chart afterwards shows it in place.Reads text others writeNo findings

    Why it is in this group

    • The name "create_mixpanel_annotation" 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
    MARK THE MIXPANEL TIMELINE: write what just happened into Mixpanel at the moment it happened, so every chart afterwards shows it in place. The same closed loop as the PostHog and Amplitude annotation tools, worth reaching for unprompted after a campaign goes live, a creative is swapped or a landing page changes. `date` is "YYYY-MM-DD HH:mm:ss" (Mixpanel's own format, charted in the PROJECT's timezone), "YYYY-MM-DD", or an ISO timestamp with its offset (written in the project's timezone so the mark sits at that exact instant, read back to prove it); omit it for NOW. tags are numeric annotation-tag ids. The stored row is read back. Mixpanel only lets a service account with at least the ANALYST role write annotations; a lower role is refused by name, and that is a role change in Mixpanel, not a reconnect. 0 credits. Needs Mixpanel connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Mark the Mixpanel timeline
  • 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_openai_ads_audienceCreate a ChatGPT Ads custom audience from a customer list.Reads text others writeNo findings

    Why it is in this group

    • The name "create_openai_ads_audience" 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 ChatGPT Ads custom audience from a customer list. Pass plain emails and/or phone numbers: Hermoso NORMALISES AND SHA-256 HASHES THEM LOCALLY and uploads only the digests, so no plaintext personal data leaves Hermoso. OR pass fileUrl: a public link to a UTF-8 .csv or .txt customer list (a CSV needs a header naming its column: email, phone_number, email_sha256, phone_number_sha256 or gaid; identifierResolution "auto" reads several columns at once). A file is uploaded to ChatGPT Ads as it is and OpenAI hashes raw emails and phones itself; the members list is hashed here first. Matching is asynchronous, so read the audience back for its matched count. Values that are neither an email nor a phone number are skipped and counted, never silently dropped. An audience is a definition and cannot spend.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a ChatGPT Ads custom audience
    • idempotentHint: false
  • create_openai_ads_conversion_api_keyCreate a ChatGPT Ads Conversions API key — the credential a SERVER uses to send conversion events, which is the only way a conversion that happens off the page (an offline sale, a …Reads text others write1 finding

    Why it is in this group

    • The name "create_openai_ads_conversion_api_key" 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.

    Findings

    • Info

      The description mentions "credential".

      Matched text

      description: "...a ChatGPT Ads Conversions API key — the credential a SERVER uses to send conversion events..."

      What this check looks for
    Description, as the server wrote it
    Create a ChatGPT Ads Conversions API key — the credential a SERVER uses to send conversion events, which is the only way a conversion that happens off the page (an offline sale, a webhook, a mobile backend) can be counted at all. PERMANENT AND UNREPEATABLE, and both halves of that are why it is confirm-gated even though a key cannot spend: ChatGPT Ads publishes NO way to list, rotate or delete a key, so it exists on the ad account forever and Hermoso cannot clean it up; and OpenAI returns the secret EXACTLY ONCE. Tell the user both facts, get an explicit yes, then call with confirm:true — and tell them to store it in a server-side secret manager and never place it in browser code, client-visible environment variables, logs or source control. If OpenAI answers that key creation is not enabled for this ad account, that is an account-enablement answer from OpenAI (they say to contact your partner representative) — the connection is fine and nothing is broken on Hermoso’s side.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a ChatGPT Ads Conversions API key
  • create_openai_ads_conversion_eventDefine what counts as a conversion on ChatGPT Ads, measured from one or more pixels.Reads text others writeNo findings

    Why it is in this group

    • The name "create_openai_ads_conversion_event" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Define what counts as a conversion on ChatGPT Ads, measured from one or more pixels. THIS IS THE PREREQUISITE for a conversion-optimised campaign: pass the returned id as conversionEventSettingIds to create_openai_ads_campaign. Creating one cannot spend and cannot serve — it is a definition, so it is not confirm-gated.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Define a ChatGPT Ads conversion
    • idempotentHint: false
  • create_openai_ads_feedCreate an EMPTY product feed on ChatGPT Ads with a name and the countries it serves (ISO codes).Reads text others writeNo findings

    Why it is in this group

    • The name "create_openai_ads_feed" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an EMPTY product feed on ChatGPT Ads with a name and the countries it serves (ISO codes). Fill it with update_openai_ads_feed_products, or set up SFTP bulk delivery with set_openai_ads_feed_sftp. inventoryType:"hotel" creates a HOTEL property feed instead (schema hotel_property_v1, filled with a full property snapshot over SFTP; an OpenAI limited beta for approved pilot advertisers, so an account outside the pilot is refused by OpenAI).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a ChatGPT Ads product feed
    • idempotentHint: false
  • create_openai_ads_lead_formDraft a ChatGPT Ads LEAD FORM: a name, an optional privacy policy URL, and fields — each {fieldId, fieldType "text" | "choice", label, required, options (choice only)}.Reads text others writeNo findings

    Why it is in this group

    • The name "create_openai_ads_lead_form" 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
    Draft a ChatGPT Ads LEAD FORM: a name, an optional privacy policy URL, and fields — each {fieldId, fieldType "text" | "choice", label, required, options (choice only)}. Created as a DRAFT with a draftRevisionId; publish_openai_ads_lead_form makes it live, then reference it from a Business Agent (leadFormId). Needs ChatGPT Ads connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a ChatGPT Ads lead form (draft)
    • idempotentHint: false
  • create_openai_ads_pixelCreate a ChatGPT Ads web pixel — the thing that observes actions on the site.Reads text others writeNo findings

    Why it is in this group

    • The name "create_openai_ads_pixel" 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 ChatGPT Ads web pixel — the thing that observes actions on the site. IT RECORDS NOTHING until its snippet is installed on the site, so say that rather than implying tracking is live. MATCH RATE: the snippet’s oaiq("init", { user: {…} }) call accepts email_sha256, phone_number_sha256, external_id_sha256, first_name_sha256, last_name_sha256 (all SHA-256, lowercase hex) plus raw country, city, region and postal_code — tell the site owner to pass whatever they know about a logged-in visitor, because every field improves conversion matching. A pixel is a measurement definition and cannot spend. The next step is create_openai_ads_conversion_event, which says WHICH observed action counts as a conversion. AUTOMATIC ADVANCED MATCHING IS ON BY DEFAULT — that is OpenAI’s own default for pixels created through the Ads API since 2026-08-17, and it means the Pixel COLLECTS AND HASHES CUSTOMER INFORMATION (email, phone) from the page. Tell the user that in plain words, and pass automaticAdvancedMatching:false if they want it off. The reply reports what OpenAI actually stored: there is no endpoint to read a pixel back afterwards, so that one reply is the only record you will ever get.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a ChatGPT Ads pixel
    • idempotentHint: false
  • create_pinterest_ads_audienceCreate a Pinterest AUDIENCE to retarget or suppress.Reads text others writeNo findings

    Why it is in this group

    • The name "create_pinterest_ads_audience" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a Pinterest AUDIENCE to retarget or suppress. audienceType: VISITOR (people who fired your Pinterest tag — conversionTagIds, optional event, retentionDays 1–540), ENGAGEMENT (people who engaged with your Pins — engagementDomains REQUIRED, your claimed domain; optional engagementType click/save/closeup/comment/like), ACTALIKE (people similar to seedAudienceIds — country US, CA or GB, percentage 1–10) or CUSTOMER_LIST (customerListId, OR pass emails / maids and the list is uploaded — hashed on our server — and the audience made in one call). Every range Pinterest documents is checked before anything is sent. READ BACK from Pinterest; a new audience starts INITIALIZING. Spends nothing, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Pinterest audience
  • create_pinterest_ads_conversion_tagCreate a Pinterest conversion TAG on the ad account — the base code a website installs so Pinterest sees page visits, sign-ups and checkouts, and a WEB_CONVERSION / SALES campaign …Reads text others writeNo findings

    Why it is in this group

    • The name "create_pinterest_ads_conversion_tag" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a Pinterest conversion TAG on the ad account — the base code a website installs so Pinterest sees page visits, sign-ups and checkouts, and a WEB_CONVERSION / SALES campaign has something to optimise for. Returns the tag id and the code snippet to paste into every page’s <head>, READ BACK from Pinterest. enhancedMatch:true (or a per-field object) turns on Pinterest’s Automatic Enhanced Match. Spends nothing, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Pinterest conversion tag
  • create_pinterest_ads_customer_listUpload a Pinterest CUSTOMER LIST from emails (or mobile ad ids) — buyers, subscribers or leads — and, by default, make the CUSTOMER_LIST audience that targets it in the same call.Reads text others writeNo findings

    Why it is in this group

    • The name "create_pinterest_ads_customer_list" 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
    Upload a Pinterest CUSTOMER LIST from emails (or mobile ad ids) — buyers, subscribers or leads — and, by default, make the CUSTOMER_LIST audience that targets it in the same call. Every address is SHA-256 hashed on our server; no plain address reaches Pinterest. Pinterest must find at least 100 of them on Pinterest or the list ends TOO_SMALL and cannot deliver. READ BACK from Pinterest. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a Pinterest customer list
  • create_posthog_annotationMARK THE POSTHOG TIMELINE — write what just happened into PostHog at the moment it happened, so every chart afterwards shows it in place.Reads text others writeNo findings

    Why it is in this group

    • The name "create_posthog_annotation" 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
    MARK THE POSTHOG TIMELINE — write what just happened into PostHog at the moment it happened, so every chart afterwards shows it in place. The same closed loop as create_amplitude_annotation, and worth reaching for unprompted after a campaign goes live, a creative is swapped or a landing page changes. `dateMarker` is what POSITIONS the marker on the x-axis (ISO 8601); omit it and NOW is used, which is right for "this just went live" — and the timestamp PostHog actually STORED is reported back rather than the one sent. `scope` is project (the default — shows on everything) / organization / dashboard / dashboard_item, and `dashboard` and `dashboard_item` each need their id or the annotation attaches to nothing and appears nowhere. PostHog also publishes a `recording` scope which THEY THEMSELVES REJECT, so it is refused by name here rather than sent. `creationType` USR means a person wrote it, GIT means a bot or a deployment did. NEEDS THE `annotation:write` SCOPE on the personal API key — a key made before Hermoso supported annotations will not have it; PostHog names it in their refusal, and it is added in PostHog > Settings > Personal API keys without reconnecting. THIS WRITES TO THE USER'S OWN ANALYTICS TOOL. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Mark the PostHog timeline
  • create_reddit_ads_audienceCreate an empty custom audience on a Reddit ad account, then fill it with update_reddit_ads_audience_users.Reads text others writeNo findings

    Why it is in this group

    • The name "create_reddit_ads_audience" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an empty custom audience on a Reddit ad account, then fill it with update_reddit_ads_audience_users. Reddit only supports ONE kind of audience through the API — an uploaded CUSTOMER LIST matched on hashed emails and mobile advertising ids; pixel-retargeting, engagement and lookalike audiences are built by Reddit itself in Ads Manager and cannot be created here. The audience arrives empty and stays unusable until it matches roughly 1,000 redditors, and Reddit takes up to 4 hours to show a size change and up to 36 hours to finish processing a list — so do not create, upload and then report success on reach in the same breath. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Reddit custom audience (customer list)
    • idempotentHint: false
  • create_reddit_ads_catalogCreate an empty Reddit PRODUCT CATALOG on the business behind the shared ad account — the product inventory a catalog SALES campaign advertises (dynamic product ads, collection ads…Reads text others writeNo findings

    Why it is in this group

    • The name "create_reddit_ads_catalog" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an empty Reddit PRODUCT CATALOG on the business behind the shared ad account — the product inventory a catalog SALES campaign advertises (dynamic product ads, collection ads). Spends nothing. Name it, give the CURRENCY your prices are in (USD, GBP, CAD, EUR, AUD, JPY, CHF, NZD, SEK, NOK or BRL — Reddit’s list) and optionally the language and the Reddit pixel(s) to match products against (list_reddit_ads_pixels; catalog ads optimize on pixel events such as PURCHASE). The currency and language cannot be changed later. Then fill it — upsert_reddit_ads_products for a handful, or create_reddit_ads_product_feed to have Reddit fetch your product file on a schedule — and define which products to advertise with create_reddit_ads_product_set. Reddit requires its Catalog manager role for catalog writes, which Business admin does not include (a login that can run campaigns can still be refused “no permissions to Create Catalog action”) — that refusal is about the role, not the connection, and the reply says how to fix it. Read back from Reddit.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Reddit product catalog
    • idempotentHint: false
  • create_reddit_ads_postCreate the CREATIVE for a Reddit ad.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_reddit_ads_post" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "create_reddit_ads_post" says "create" and "post": it writes something other people read.
    Description, as the server wrote it
    Create the CREATIVE for a Reddit ad. This is the step people skip: a Reddit ad has no creative of its own — it points at a post — so a campaign and ad group with no post behind them can never serve. Types are TEXT (headline + body), IMAGE, VIDEO and CAROUSEL (up to 6 images), and an IMAGE, VIDEO or CAROUSEL post can carry body text too. For image/video/carousel pass media[] with a PUBLIC mediaUrl; Reddit fetches and validates it itself (minimum 140×140), and a video also needs a thumbnailUrl. The destination for a click rides on the media entry’s destinationUrl, NOT on the ad. Reddit’s call-to-action values are human-readable strings with spaces and capitals — "Learn More", "Shop Now", "Sign Up" — not SCREAMING_SNAKE; the error lists all of them. The post is published on the profile immediately, so show the user the exact headline and body first. Reddit builds every post in the background: a TEXT post needs a body, an IMAGE post and every carousel card a destinationUrl. The answer is usually the post, and when Reddit is still building it the answer says pending with a jobId, so call this again with redditProfileId and that jobId (never re-send the post, which would make a second one).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create the Reddit post an ad will promote
    • idempotentHint: false
  • create_reddit_ads_product_setDefine a PRODUCT SET in a Reddit catalog — the rule that picks which products a catalog ad group advertises; its id is the productSetId create_reddit_ads_ad_group takes.Reads text others writeNo findings

    Why it is in this group

    • The name "create_reddit_ads_product_set" 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
    Define a PRODUCT SET in a Reddit catalog — the rule that picks which products a catalog ad group advertises; its id is the productSetId create_reddit_ads_ad_group takes. The filter is Reddit’s JSON rule: one rule {"attribute":{"operator":value}} or several combined with {"and":[…]} / {"or":[…]}. Attributes: id, title, description, price, currency, sale_price, availability, brand, color, gender, product type, item_group_id, condition, age_group, size, pattern, material, custom_label_0…4. Operators: contains, not_contains, i_contains, i_not_contains, starts_with, i_starts_with, is_any, is_not_any, i_is_any, i_is_not_any (the *_any ones take a list), eq, neq, lt, lte, gt, gte — case-sensitive unless prefixed i_. Examples: everything in stock {"availability":{"eq":"IN_STOCK"}}; a brand under 50 {"and":[{"brand":{"eq":"Acme"}},{"price":{"lt":"50"}}]}. Validated before Reddit is asked; spends nothing; read back with how many products match.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Reddit product set (which catalog products to advertise)
    • idempotentHint: false
  • create_reddit_ads_saved_audienceSave a targeting definition under a name so every ad group can reuse it — define "our people" once, then pass savedAudienceId when creating ad groups instead of retyping communitie…Reads text others writeNo findings

    Why it is in this group

    • The name "create_reddit_ads_saved_audience" 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
    Save a targeting definition under a name so every ad group can reuse it — define "our people" once, then pass savedAudienceId when creating ad groups instead of retyping communities and interests each time, and one later edit re-targets every ad group using it. Takes the same targeting block as create_reddit_ads_ad_group, so resolve community names and interest ids with search_reddit_ads_targeting first. Creates targeting only: no budget, no spend. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a reusable Reddit saved audience
    • idempotentHint: false
  • create_salesforce_recordCreate a contact, lead, account or opportunity in the brand's Salesforce, then read it back.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_salesforce_record" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.phone): what the tool writes goes there.
    Description, as the server wrote it
    Create a contact, lead, account or opportunity in the brand's Salesforce, then read it back. Required: contact lastName; lead lastName (company defaults to "[not provided]"); account name; opportunity name, stage and closeDate. Any other field by API name in fields (describe_salesforce_object lists them, which are required, and the picklist values). The org's validation and duplicate rules answer in Salesforce's words. Free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Salesforce record
    • idempotentHint: false
  • create_sheetCreate a new Google Spreadsheet in the user’s Drive and optionally fill it with rows — e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "create_sheet" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a new Google Spreadsheet in the user’s Drive and optionally fill it with rows — e.g. export a swipefile, ad list, or performance report. Pass rows as an array of row arrays (first row = headers). Returns the spreadsheet id + URL. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a Google Sheet
  • create_snapchat_ads_audienceCreate a Snapchat custom audience.Reads text others writeNo findings

    Why it is in this group

    • The name "create_snapchat_ads_audience" 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 Snapchat custom audience. sourceType FIRST_PARTY: a customer list, EMPTY until update_snapchat_ads_audience_users adds people (retention defaults to lifetime). LOOKALIKE: people like a customer-list seed — seedSegmentId + countries, lookalikeType BALANCE (default) / SIMILARITY / REACH, retention max 180. PIXEL: people who fired Snap Pixel events — pixelId + events (e.g. PURCHASE, ADD_CART) + retentionInDays up to 395. ENGAGEMENT is read-only on Snapchat and refused. An audience spends nothing; it is read back from Snapchat. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Snapchat audience
    • idempotentHint: false
  • create_snapchat_ads_lead_formCreate the in-app form a Snapchat lead ad opens.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_snapchat_ads_lead_form" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.endPage.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Create the in-app form a Snapchat lead ad opens. Snapchat's rules are refused BY NAME, never repaired: FIRST_NAME and LAST_NAME are required, plus at least one of EMAIL or PHONE_NUMBER; ADDRESS and POSTAL_CODE cannot both be on one form; title max 25 characters, description max 180, legal title 35 / description 80, at most 2 consent checkboxes, only one question may use preferred options, and an end page (endPage) is required. A form spends nothing; it is read back from Snapchat. Snapchat has NO endpoint that lists leads afterwards — to receive them, turn on delivery with manage_snapchat_ads_lead_webhook(action:'subscribe'). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a Snapchat lead form
    • idempotentHint: false
  • create_stripe_couponCreate a Stripe coupon: exactly one of percentOff (1–100) or amountOff (major units) + currency; duration once (default), repeating (with durationInMonths) or forever; optional nam…Reads text others writeNo findings

    Why it is in this group

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

    What it 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 Stripe coupon: exactly one of percentOff (1–100) or amountOff (major units) + currency; duration once (default), repeating (with durationInMonths) or forever; optional name, id and maxRedemptions. A coupon alone has NO code a customer can type: pass `code` (letters, digits, dashes) to also mint the customer-typable promotion code in the same call, with optional codeMaxRedemptions, expiresAt, firstTimeOnly and minimumAmount. Read back. LIVE key: confirm:true after showing the preview. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: create stripe coupon
    • idempotentHint: false
  • create_stripe_customerCreate a Stripe customer by email (optional name, phone, description, metadata).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_stripe_customer" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.phone): what the tool writes goes there.
    Description, as the server wrote it
    Create a Stripe customer by email (optional name, phone, description, metadata). If a customer with that email already exists it is returned instead and nothing is created — pass allowDuplicate:true to create a second one on purpose. LIVE key: confirm:true after showing the preview. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: create stripe customer
    • idempotentHint: false
  • create_stripe_promotion_codeCreate a customer-typable promotion code (e.g.Reads text others writeNo findings

    Why it is in this group

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

    What it 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 customer-typable promotion code (e.g. SUMMER20) for an existing Stripe coupon — the thing a "use code X" ad needs, since a coupon alone has no code. couponId (from list_stripe_coupons); optional code (letters, digits and dashes; Stripe generates one if omitted — a code with spaces or symbols is refused, never altered), maxRedemptions, expiresAt (YYYY-MM-DD), firstTimeOnly, minimumAmount + minimumAmountCurrency (major units), customerId. Read back. LIVE key: confirm:true after showing the preview. Use it on a payment link with allowPromotionCodes. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: create stripe promotion code
    • idempotentHint: false
  • create_tag_manager_tagINSTALL A TAG in the container's draft workspace: a Google Ads conversion tag, a GA4 event, or a third-party pixel.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tag_manager_tag" 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
    INSTALL A TAG in the container's draft workspace: a Google Ads conversion tag, a GA4 event, or a third-party pixel. IT DOES NOT GO LIVE. Everything written here lands in a WORKSPACE, which is a draft, and it does not run on the website until a human opens Tag Manager and publishes the container. Staging NEVER publishes: making a tag live is a separate, explicitly confirmed call (publish_tag_manager_container), because publishing changes what executes for every visitor on the live site. Always tell the user the change is staged, and that it does nothing until it is published. TWO THINGS YOU MUST GET FROM THE CONTAINER RATHER THAN INVENT. (1) type is a Tag Manager type string and Google publishes no machine-readable list of them, so Hermoso forwards whatever you pass rather than validating against a list that would go stale and start refusing real types. Get the right one by calling list_tag_manager_tags and copying the type off a tag of the same kind that already exists, or read it in Tag Manager. (2) firingTriggerId is required and must name at least one real trigger id from list_tag_manager_tags, because a tag with no trigger is installed and never runs, which is worse than not installing it. Use create_tag_manager_trigger if the container has no suitable trigger. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Install a tag in the container draft
    • idempotentHint: false
  • create_tag_manager_triggerCREATE A TRIGGER, the rule that decides when a tag fires, in the container's draft workspace.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tag_manager_trigger" 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 TRIGGER, the rule that decides when a tag fires, in the container's draft workspace. Use it when list_tag_manager_tags shows no trigger matching what a conversion needs, for example a purchase confirmation page or a dataLayer purchase event. A trigger on its own fires nothing: it has to be named in a tag's firingTriggerId, so create the trigger, then create or update the tag that uses it. Like every other write here it lands in a DRAFT and does not reach the website until a human publishes the container. type must be one of Tag Manager's own trigger types, and an unrecognised one is refused by name with the accepted list, for free, before any request. A customEvent trigger with no customEventFilter fires on EVERY dataLayer event in the container rather than the one you meant, so that is refused too. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a trigger in the container draft
    • idempotentHint: false
  • create_tiktok_ads_accountCreate a NEW TikTok ad account (advertiser) for the user's business, inside a TikTok Business Center that their own TikTok login administers.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_account" 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 TikTok ad account (advertiser) for the user's business, inside a TikTok Business Center that their own TikTok login administers. This is how someone with no TikTok ad account gets one without leaving Hermoso: when the user wants TikTok ads and has no ad account, offer to create one with this tool, and also when they ask for another one. It runs on the user's OWN TikTok Ads connection and in THEIR company name, never Hermoso's. TWO STEPS, ALWAYS. First call it WITHOUT confirm: that creates nothing and either lists what is still missing (with the industry list when industry is missing) or returns the exact account TikTok would create. Ask the user for every missing field and never guess one: account name, legal company name, industry (a tier-2 id from the list), registeredArea (country of registration, e.g. US) and timezone (e.g. America/New_York). Currency must match the Business Center's and defaults to it. Show the user the summary, then call again with confirm:true. A TikTok ad account CANNOT BE DELETED, only disabled in Business Center. It spends nothing: it has no payment method and no campaigns until the user adds billing in TikTok. Accounts registered in mainland China, Hong Kong, France, Brazil or Mexico need uploaded business documents and are refused unless qualificationId reuses a verified one. If the login has no Business Center yet, create_tiktok_ads_business_center makes one. The new account is read back from TikTok and, when the connection can already reach it, ticked on this brand so every TikTok tool can use it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a new TikTok ad account
  • create_tiktok_ads_audienceCreate a TikTok custom audience from what people actually did — the thing that turns TikTok targeting from interests-and-geo into retargeting.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_audience" 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 TikTok custom audience from what people actually did — the thing that turns TikTok targeting from interests-and-geo into retargeting. audienceType chooses the source and EACH ONE READS A DIFFERENT ID SPACE for eventSourceIds, which is the mistake to avoid: PIXEL takes pixel ids (list_tiktok_ads_pixels), APP takes app ids (list_tiktok_ads_apps), ENGAGEMENT takes AD GROUP ids, ENGAGEMENT_ORGANIC_VIDEO takes TikTok post ids (list_tiktok_ads_identity_posts, max 10), TIKTOK_SHOP takes shop ids, OFFLINE takes offline event-set ids — and a LEAD_GENERATION audience must carry NO eventSourceIds at all, because TikTok errors if the field is present. The `event` on each rule must belong to that audience type: an event from a different family is refused here by name rather than silently building an audience that measures the wrong thing. THE AUDIENCE IS NOT USABLE IMMEDIATELY — TikTok takes up to 48 hours to process it, and until then it cannot be attached to an ad group. Creating one spends nothing: an audience is a definition. The reply is READ BACK from TikTok, because TikTok’s create returns an id and nothing else.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Build a TikTok retargeting audience from real behaviour
    • idempotentHint: false
  • create_tiktok_ads_business_centerCreate a TikTok Business Center for the user's business, on their OWN TikTok Ads connection and in THEIR company name, never Hermoso's.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_business_center" 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 TikTok Business Center for the user's business, on their OWN TikTok Ads connection and in THEIR company name, never Hermoso's. Use it when create_tiktok_ads_account reports the login has no Business Center it administers. TWO STEPS, ALWAYS: call it first WITHOUT confirm. That sends nothing and either lists what is missing or returns the exact Business Center and the TikTok terms the user would be agreeing to. Ask the user for every field and never guess one: bcName, companyName (their legal name), registeredArea, timezone (permanent) and currency. Show the user that reply word for word, and call again with confirm:true only after THEY have agreed. The reply is read back from TikTok. Then create the ad account inside it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a TikTok Business Center
  • create_tiktok_ads_catalogCreate a product catalog inside a TikTok Business Center — the container Dynamic Product Ads sell from.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_tiktok_ads_catalog" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.
    Description, as the server wrote it
    Create a product catalog inside a TikTok Business Center — the container Dynamic Product Ads sell from. REGION AND CURRENCY ARE SET ONCE AND CAN NEVER BE CHANGED: TikTok’s own catalog-update endpoint changes the NAME and nothing else, so a catalog created in the wrong region or currency has to be replaced. Confirm both with the user before calling, and use list_tiktok_ads_catalogs(regions:true) to see which regions this Business Center may use. The new catalog IS EMPTY — products arrive through a scheduled feed, so the next step is always manage_tiktok_ads_catalog_feed. ENTERTAINMENT and MINI_SERIES catalogs are allowlist-only at TikTok and are offered rather than refused, because an allowlisted advertiser can use them. Creating a catalog spends nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a TikTok product catalog
    • idempotentHint: false
  • create_tiktok_ads_crm_event_setCreate a CRM Event set — the container for lead-lifecycle events, and the id send_tiktok_ads_events needs as eventSourceId when eventSource is "crm".Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_crm_event_set" 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 CRM Event set — the container for lead-lifecycle events, and the id send_tiktok_ads_events needs as eventSourceId when eventSource is "crm". Making one is how a LEAD_GENERATION campaign stops optimising toward form fills and starts optimising toward leads that qualify and close. Warning: TIKTOK PUBLISHES CREATE AND LIST FOR THESE AND NOTHING ELSE — no update and no delete anywhere in its API reference — so a set made here is PERMANENT, in the same way a TikTok pixel is, and an advertiser is capped at fifty with no API way to free a slot. Name it something the user will still recognise in a year. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Create a TikTok CRM Event set
  • create_tiktok_ads_lookalike_audienceCreate a TikTok Lookalike Audience — TikTok finds people who resemble a seed audience you already have.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_lookalike_audience" 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 TikTok Lookalike Audience — TikTok finds people who resemble a seed audience you already have. The seed must exist, must hold AT LEAST 100 people, and cannot itself be a lookalike. audienceSize trades reach against similarity: NARROW is closest to the seed, BROAD reaches furthest. includeSource has NO DEFAULT and TikTok requires it — it decides whether the seed’s own people remain inside the new audience, which matters because including them double-targets people you are already reaching. LOOKALIKE LOCATIONS ARE A SHORTER LIST THAN ORDINARY AD TARGETING (39 countries), so a location id that works on an ad group is not automatically valid here; an unsupported one is refused by name with the full list rather than sent. Takes up to 48 hours to process, and cannot be attached to a Reach & Frequency ad group. Creating one spends nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Grow a TikTok lookalike from an existing audience
    • idempotentHint: false
  • create_tiktok_ads_pixelCreate a new TikTok pixel on an ad account so conversion campaigns have something to optimise toward.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_pixel" 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 TikTok pixel on an ad account so conversion campaigns have something to optimise toward. Returns the pixel id and the pixel CODE plus the script to install. A PIXEL ALONE IS NOT ENOUGH AND THIS IS THE PART PEOPLE MISS: it measures nothing until (1) the script is installed on the website and (2) the specific conversion EVENT is defined on it — until then TikTok refuses a conversion ad group with "This pixel event type does not exist." TikTok caps the name at 40 characters, rejects emojis and rejects DUPLICATE names, and it recommends naming the pixel after the site it measures. Creating a pixel spends nothing and serves nothing — it is a measurement definition. NOTE: TikTok publishes NO endpoint that deletes a pixel, so a pixel created here is permanent on that ad account.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a TikTok conversion pixel
    • idempotentHint: false
  • create_tiktok_ads_ruleAUTOMATED RULES — a standing instruction TikTok runs on the user’s ad account on TIKTOK’S schedule, with nobody watching.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_ads_rule" 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
    AUTOMATED RULES — a standing instruction TikTok runs on the user’s ad account on TIKTOK’S schedule, with nobody watching. WHAT A RULE CAN DO UNATTENDED, depending on its actions: pause a campaign / ad group / ad (TURN_OFF), email a report (MESSAGE), LOWER a daily budget, lifetime budget or bid (DECREASE) — or TURN AN OBJECT BACK ON and RAISE a budget or bid (TURN_ON, INCREASE, ADJUST_TO). The second group is standing permission to spend the user’s money without anyone present, on objects the rule re-selects at every execution, so treat it as such and say so before creating one. EVERY RULE IS CREATED TURNED OFF AND READ BACK TO PROVE IT: TikTok publishes no status field on its create and its own example shows a fresh rule running, so Hermoso creates it and disarms it in a second call — and if that second call fails the reply says LOUDLY that a live rule is on the account and how to switch it off. ARMING IS A SEPARATE ACT (set_tiktok_ads_rule_status), which is what makes the rule inspectable in between. An INCREASE or DECREASE must carry value.limit; TikTok requires it and it IS the safety rail — an increase without a ceiling ratchets upward every time the rule fires. TWO THINGS TIKTOK ITSELF PUBLISHES ABOUT THIS ENDPOINT: it is "supported exclusively for direct advertisers" and says SaaS platforms managing multiple advertisers cannot use it, so it may simply be refused for this account — that is THEIR restriction, not a broken connection and no reconnect changes it; and every notification it generates goes to the developer address registered on the app rather than to the user, so tiktok_ads_rule_results is the only place they will see what a rule did. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a TikTok automated rule (created turned OFF)
    • idempotentHint: false
  • create_tiktok_tto_brand_profileCreate a Brand Profile on a TikTok One account; the identity creators see when they open an invite link.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tiktok_tto_brand_profile" 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 Brand Profile on a TikTok One account; the identity creators see when they open an invite link. THE NAME, INDUSTRY AND LOGO ARE PERMANENT: TikTok marks all three "cannot be updated" and publishes no brand-profile update endpoint anywhere in its API, so a profile is authored exactly once and a typo has to be lived with. Confirm all three with the user before calling. The logo must be a 1:1 image under 5MB at a publicly reachable URL, and the website must start with https. Adding tiktokAccountUrl lets creators see the brand’s own TikTok account on the profile, which TikTok says improves how many of them take the invitation seriously. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create a TikTok One brand profile
    • idempotentHint: false
  • create_x_ads_audienceCreate an X custom audience (a customer list for retargeting or exclusion), optionally filled with people in the same call.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_x_ads_audience" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a destination (input.phones): what the tool writes goes there.
    Description, as the server wrote it
    Create an X custom audience (a customer list for retargeting or exclusion), optionally filled with people in the same call. Pass ordinary emails, phones (E.164), X handles, X user ids or device ids — they are normalised and SHA-256 hashed on Hermoso's server before X sees them; 64-hex hashes pass as is; anything unusable is named, never sent. X needs up to 48h and about 100 matched people before it can be targeted (add_x_ads_targeting with targetingType CUSTOM_AUDIENCE). Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create an X custom audience
    • idempotentHint: false
  • create_x_ads_cardCreate an X card — the big image/video with a headline or button that an X ad clicks through on.Reads text others writeNo findings

    Why it is in this group

    • The name "create_x_ads_card" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an X card — the big image/video with a headline or button that an X ad clicks through on. ONE destination: websiteUrl (a website card, with a headline `title`), leadFormId (opens an X lead form — headline, or a button with buttonLabel), or an app (iosAppId/googlePlayAppId + countryCode, a button). Media: mediaKey, or 2–6 mediaKeys for a swipeable card (upload_x_ads_media). utm {source,medium,campaign,content,term} is appended to websiteUrl without overwriting the URL's own. Read back from X; a card is used by create_x_ads_post(cardUri). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Build an X ad card
    • idempotentHint: false
  • create_x_ads_lead_formCreate an X lead form — the native form an X lead ad opens, so people sign up without leaving X.Reads text others writeNo findings

    Why it is in this group

    • The name "create_x_ads_lead_form" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create an X lead form — the native form an X lead ad opens, so people sign up without leaving X. The X lead ad chain: lead form -> create_x_ads_card(leadFormId) -> create_x_ads_post(cardUri, lineItemId) on a WEBSITE_CLICKS line item (X retired the LEAD_GENERATION objective) -> get_x_ads_leads. Needs name, purpose, fields (at least one required), and an https privacy policy URL + company name. X ties every form to a conversion event: an ad account with no X Pixel needs conversionEventId, and the refusal says so plainly. X also builds a customer-list audience of the form's leads. Read back from X. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Create an X lead form
    • idempotentHint: false
  • create_x_ads_postWrite an X post FOR ADS — PROMOTED-ONLY by default (X's 'nullcast'): it never appears on the brand's timeline or in followers' feeds and serves only as an ad, so you can test sever…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "create_x_ads_post" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "create_x_ads_post" says "create" and "post": it writes something other people read.
    Description, as the server wrote it
    Write an X post FOR ADS — PROMOTED-ONLY by default (X's 'nullcast'): it never appears on the brand's timeline or in followers' feeds and serves only as an ad, so you can test several creatives without spamming followers. Carry a card (cardUri from create_x_ads_card) OR up to 4 media (mediaKeys from upload_x_ads_media). Posted as the ad account's own promotable user (asUserId to choose). Pass lineItemId to attach it straight to a line item (which stays PAUSED). promotedOnly:false makes it a normal public post and needs confirmPublic:true. Read back from X. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Write a promoted-only X post for ads
    • idempotentHint: false
  • dismiss_apple_ads_recommendationDecline an Apple Ads recommendation.Reads text others writeNo findings

    Why it is in this group

    • The name "dismiss_apple_ads_recommendation" says "dismiss": 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
    Decline an Apple Ads recommendation. NOTHING ABOUT THE CAMPAIGN CHANGES — no budget moves, no CPA moves, no status changes — it records that you reviewed the recommendation and said no, and Apple stops offering that particular one (it may generate a new one later). No confirmation is needed and that is deliberate rather than an oversight: dismissing cannot spend money, and gating the safe direction is what teaches people to pass confirm reflexively on the direction that matters. Only an AVAILABLE recommendation can be dismissed; APPLIED and DISMISSED are terminal, and trying to re-action one is refused for free. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Dismiss an Apple Ads recommendation
    • idempotentHint: false
  • dismiss_microsoft_ads_recommendationsDismiss Microsoft Advertising recommendations by id so Microsoft stops offering them.Reads text others writeNo findings

    Why it is in this group

    • The name "dismiss_microsoft_ads_recommendations" says "dismiss": 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
    Dismiss Microsoft Advertising recommendations by id so Microsoft stops offering them. IT CANNOT SPEND and it changes nothing about what the account runs (it takes advice off the list), so it takes no confirmation at all, which is the point: reach for this rather than applying something just to clear it. Nothing is destroyed either: Microsoft still returns a dismissed recommendation from a read, flagged as dismissed, and microsoft_ads_recommendations will show it again with includeDismissed. Ids Microsoft has already withdrawn are reported and are not an error, they are already off the list, which is the outcome you wanted. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Dismiss Microsoft recommendations
    • idempotentHint: false
  • download_tiktok_ads_leadsDOWNLOAD THE ACTUAL LEADS — the names, emails and phone numbers people entered in a TikTok Instant Form.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
    DOWNLOAD THE ACTUAL LEADS — the names, emails and phone numbers people entered in a TikTok Instant Form. REGION IS REQUIRED AND THERE IS NO "ALL": TikTok keeps US, EEA/CH/UK and everywhere-else leads in three SEPARATE stores and returns only the one you name, so asking for the wrong one returns an empty file that reads exactly like "this ad got no leads". Run it once per region if the ad targets more than one. TikTok restricts lead download to ad-account ADMINS, so a refusal is a Business Center role rather than a broken connection and reconnecting will not fix it. Hermoso creates the download task, polls it and parses the CSV in ONE call because TikTok expires the generated file after 10 minutes. A task that has not finished, or a file TikTok zipped because it exceeded 10MB, is reported as "could not read" — never as "no leads". THE ROWS ARE PERSONAL DATA. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Download the leads from a TikTok lead ad
    • idempotentHint: false
  • duplicate_google_ads_campaignDUPLICATE a Google Ads Search or Display campaign: budget amount, bidding, networks, locations, languages, schedule, negatives, ad groups, keywords and responsive ads, rebuilt in o…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
    DUPLICATE a Google Ads Search or Display campaign: budget amount, bidding, networks, locations, languages, schedule, negatives, ad groups, keywords and responsive ads, rebuilt in one step (Google's API has no copy operation) and born PAUSED. History and Quality Score start fresh. dryRun:true checks it without creating anything. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Duplicate a Google Ads campaign (paused)
  • duplicate_meta_objectDUPLICATE a Meta campaign, ad set or ad with Meta's copy feature.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
    DUPLICATE a Meta campaign, ad set or ad with Meta's copy feature. A campaign or ad set is copied with everything under it (deep:false copies only the top object). Every copy is born PAUSED and read back, so it spends nothing until switched on. Copy an ad set into another campaign with targetCampaignId, or an ad into another ad set with targetAdSetId. Up to 50 ads per call. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Duplicate a Meta campaign / ad set / ad (paused)
  • enable_toolsLIST a group of tools that is not in this session's roster.1 finding

    Why it is in this group

    • The name "enable_tools" says "enable": a word for a change.

    Findings

    • Warn

      The description contains "Every other tool", wording about other tools or servers.

      Matched text

      description: "...few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone —..."

      What this check looks for
    Description, as the server wrote it
    LIST a group of tools that is not in this session's roster. IT IS NOT HOW YOU REACH A TOOL — call_tool runs any Hermoso tool whether or not it is listed, and that works everywhere. Use this when the session will use MANY tools from one area and you want them in your list. WORKS ON CLIENTS THAT RE-READ THE TOOL LIST (stdio, the CLI, Cursor, Claude Code); a host that fixed its roster at connect time — claude.ai and ChatGPT do — will not show the new tools until it reconnects, and this tool says so in its reply rather than reporting a success you cannot use. The connect-time route that always works is `?tools=all` on the server URL. The default roster is CORE-FIRST: the core tools plus a few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone — the whole registry is several hundred thousand tokens of schema re-sent on every turn, and a roster far past the 30-50 tool mark measurably degrades tool choice. The heaviest groups are `ads`, `analytics`, `channel_admin`: paid-campaign management across every ad platform is most of the total schema weight. NOTHING held out is unfinished or unsafe, and nothing is unreachable — find_tools finds it and call_tool runs it. CALL THIS WHEN A WHOLE AREA IS IN PLAY. If the user settles into building, budgeting, targeting or reporting on ad campaigns, call enable_tools({groups:['ads']}) and the tools appear. If they ask about their own site or product analytics, a tag/tracking container, or how a search engine crawls, indexes or ranks their site, call enable_tools({groups:['analytics']}). Groups: core, research, create, channels, channel_admin, analytics, ads, files, workspace — or 'all'. Free, instant, and it never turns anything off.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Turn on more Hermoso tools
  • error_detailOne error group in full by fingerprint (from list_errors): every field, plus the most recent redacted occurrences — status, connector, job id, workspace, and a shape-only echo of t…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    One error group in full by fingerprint (from list_errors): every field, plus the most recent redacted occurrences — status, connector, job id, workspace, and a shape-only echo of the inputs. This is what makes a bug reproducible. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Error detail
    • idempotentHint: true
  • estimate_meta_reachAsk Meta how many people a targeting spec can actually reach — BEFORE any budget is committed.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Ask Meta how many people a targeting spec can actually reach — BEFORE any budget is committed. Two ways: pass adSetId to size an ad set you already built (Meta uses its own saved targeting), or pass the same `targeting` object you would give create_meta_ad (plus optional objective / optimizationGoal / country / pixelId) to size an audience you are considering. Returns the monthly-active range, a daily-active estimate, and an explicit warning when the audience is too narrow to deliver. Free, read-only, creates nothing and spends nothing. Use it before recommending a budget and every time the user narrows a geo or piles on interests.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Estimate how many people a Meta audience reaches
    • idempotentHint: true
  • export_schedule_to_notionExport the posting schedule to a Notion database, one row per post: date, channels, caption, media link and status.Reads text others writeNo findings

    Why it is in this group

    • The name "export_schedule_to_notion" says "schedule": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Export the posting schedule to a Notion database, one row per post: date, channels, caption, media link and status. Creates a new database (under parentPageId, or private in the workspace) or writes into an existing one (databaseId), matching its columns by name. historyDays adds posts already published. Up to 100 rows per run; the answer says if more were left. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Export the schedule to Notion
  • export_swipefile_deckTurn a SWIPEFILE COLLECTION into a real Google Slides deck — one slide per saved ad, carrying the creative, the brand, the ad copy, the run dates with the run length, and the platf…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Turn a SWIPEFILE COLLECTION into a real Google Slides deck — one slide per saved ad, carrying the creative, the brand, the ad copy, the run dates with the run length, and the platform. This is the thing a marketer actually presents to a client or a team. Returns the presentation id + URL. Creates a NEW deck every time: under the drive.file scope Hermoso can only touch files it created, so it cannot add slides to a deck the user already has. A creative whose ad-library link has expired cannot be embedded — Meta signs those URLs with a short expiry — so that slide says so in words and keeps its copy and run dates, and the reply reports how many. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets, Docs and Slides).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Swipefile to Google Slides
  • extend_tiktok_post_ad_authorizationExtend how long a post the authorized account owns stays promotable as a Spark Ad — and REGENERATE its code if it was deleted.Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "extend_tiktok_post_ad_authorization" says "post": it sends or publishes something to other people.
    Description, as the server wrote it
    Extend how long a post the authorized account owns stays promotable as a Spark Ad — and REGENERATE its code if it was deleted. THE DAYS ARE ADDED, NOT SET: TikTok's own example is that a post with 180 days remaining, extended by 180, ends up at 360 — so passing '365' to a post that already has time left does not mean 'expires in a year'. Must be one of 7, 30, 60, 180, 365. Ad authorization has to be ON already (set_tiktok_post_ad_authorization) or TikTok refuses. The reply reads the new window back, because TikTok's own response body is empty. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Extend a post’s Spark-Ads authorization
    • idempotentHint: false
  • fetch_bing_webmaster_urlAsk Bingbot to fetch one URL now, so you can then read back what the crawler actually received with list_bing_webmaster_fetched_urls.Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "fetch_bing_webmaster_url" 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 name "fetch_bing_webmaster_url" says "fetch" and "url": it reads web pages, which anyone can write.
    • untrusted-inputThe description's first sentence says "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.

    Findings

    • Warn

      The server marks "fetch_bing_webmaster_url" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Ask Bingbot to fetch one URL now, so you can then read back what the crawler actually received with list_bing_webmaster_fetched_urls. THE FETCH IS QUEUED, NOT PERFORMED WHILE YOU WAIT — so "it has not appeared in the fetched list yet" is the normal FIRST answer, and it is reported as "requested, not yet done" rather than as a failure or as success. A URL that is not on this site is refused before anything is requested. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Ask Bingbot to fetch a page now
    • idempotentHint: false
  • generate_dns_recordWrite an SPF or DMARC TXT record from plain choices, ready to paste at the DNS host.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Write an SPF or DMARC TXT record from plain choices, ready to paste at the DNS host. SPF: `providers` by id (google, microsoft, zoho, fastmail, proton, icloud, godaddy, namecheap, mailgun, zendesk, salesforce, freshdesk; amazonses, sendgrid, postmark, mailchimp, brevo, hubspot, klaviyo, shopify and intercom answer with what they need instead), extra `include` domains, `ip4`/`ip6` addresses and the ending (~all by default); with a `domain`, the includes are read and counted against the 10-lookup limit. DMARC: `policy` none, quarantine or reject, `rua` report addresses and alignment. It writes the record; publishing it at the DNS host is the user’s step. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Write an SPF or DMARC record
  • google_ads_change_historyWHAT CHANGED ON THE ACCOUNT, AND WHEN — the answer to "performance fell off a cliff on Tuesday, what happened?".Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHAT CHANGED ON THE ACCOUNT, AND WHEN — the answer to "performance fell off a cliff on Tuesday, what happened?". source:"change_event" (default) is FIELD-LEVEL over the last 30 days: the change time, who made it, from which client (web UI, API, scripts, bulk upload, automated rule), whether it was a CREATE / UPDATE / REMOVE, and exactly which fields moved — with detail:true it also carries the old and new resource snapshots. source:"change_status" reaches 90 days and is the ONLY one that catches GOOGLE ADS EDITOR and criterion-level edits: Google documents change_event as NEVER returning Editor changes, so an Editor-managed account looks completely untouched there. CHECK BOTH BEFORE TELLING ANYONE NOTHING CHANGED. An unknown source is refused by name; the 30/90-day windows and Google’s own 10,000-row cap are enforced here with the reason instead of surfacing as an unreadable Google error, and a change takes up to three minutes to appear. Neither resource carries any metric or segment, so this says what changed, never what it cost. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What changed on a Google Ads account, and when
    • idempotentHint: true
  • google_ads_keyword_ideasGoogle’s own KEYWORD PLANNER: real keyword ideas with average monthly search volume, competition level and top-of-page bid estimates, so keyword choices are measured instead of gue…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Google’s own KEYWORD PLANNER: real keyword ideas with average monthly search volume, competition level and top-of-page bid estimates, so keyword choices are measured instead of guessed. Seed it with keywords[] (terms you already have), url (one landing page to mine) or site (a whole domain — the fastest way to size a competitor). Narrow by locations (place NAMES, resolved for you) and language. Results come back sorted by monthly volume. Use this BEFORE add_google_ads_keywords or create_google_ads_campaign so the ad group targets terms people actually search, and quote the volumes when you propose them. Read-only, free, spends nothing and creates nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Keyword ideas with real Google search volume
  • google_ads_local_services_eligibilityAsk Google whether a Business Profile listing can run LOCAL SERVICES ads on this Google Ads account: eligible or not, why not, and which lead types and categories it qualifies for.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Ask Google whether a Business Profile listing can run LOCAL SERVICES ads on this Google Ads account: eligible or not, why not, and which lead types and categories it qualifies for. Read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check Google Local Services eligibility
  • google_ads_policy_issuesWHY Google rejected or limited something: every DISAPPROVED or APPROVED_LIMITED ad, asset (headlines, images, sitelinks, Performance Max assets) and keyword on the account or one c…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHY Google rejected or limited something: every DISAPPROVED or APPROVED_LIMITED ad, asset (headlines, images, sitelinks, Performance Max assets) and keyword on the account or one campaign, with Google’s policy topic, its effect, the evidence (offending text, a broken landing page and its HTTP code, restricted countries) and appeal state. includeApproved lists everything. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Why Google rejected or limited an ad
  • google_ads_recommendationsGoogle Ads’ own advice for the account: the optimization score (account and per campaign), every open recommendation with what applying it would change (budget $X -> $Y, a keyword,…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Google Ads’ own advice for the account: the optimization score (account and per campaign), every open recommendation with what applying it would change (budget $X -> $Y, a keyword, a bid target, a Google-written ad) and Google’s weekly impact estimate, each tagged spend (changes what the account buys) or serves (changes what an ad shows), plus which types Google is auto-applying by itself. An empty list means Google has no advice yet, never that the account is optimal. Ids go stale fast, so act on a fresh read. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Google Ads recommendations + optimization score
  • google_ads_reportUse this when the user asks how their Google Ads campaigns performed.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Use this when the user asks how their Google Ads campaigns performed. Run a GAQL (Google Ads Query Language) report for detailed performance breakdowns — ad groups, ads, keywords, search terms, demographics, geo. Pass customerId + a GAQL query (SELECT … FROM <resource> WHERE segments.date DURING LAST_30_DAYS). Allowed FROM resources: campaign, ad_group, ad_group_ad, keyword_view, campaign_budget, campaign_criterion, ad_group_criterion, conversion_action, campaign_conversion_goal, search_term_view, age_range_view, gender_view, geographic_view, asset, change_event and every other documented GAQL report resource (the refusal names the full list if one is missing). Campaign network settings (Search partners / Display) are readable here as campaign.network_settings.* and changed with set_google_ads_networks. cost_micros is micros — divide by 1,000,000 for the account currency. Reach (metrics.unique_users, unique_users_two_plus…ten_plus, cross_device_conversions) reads FROM campaign or customer and is never summed across rows; the reply notes its window limits. Lead form submissions: list_google_ads_lead_submissions. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Google Ads GAQL report
    • idempotentHint: true
  • google_ads_rule_historyEvery run, newest first: when, dry/live/undo, what it measured, what it changed (read back from Google) or skipped and why, what a cap held back.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
    Every run, newest first: when, dry/live/undo, what it measured, what it changed (read back from Google) or skipped and why, what a cap held back. Filter by ruleId, mode, or changesOnly. Read-only. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: What Google Ads automated rules did
  • hermoso_capabilitiesProbe what this Hermoso account can do RIGHT NOW: available image/video model ids + their credit costs (estimates: a render is charged its actual cost), aspect ratios, video durati…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Probe what this Hermoso account can do RIGHT NOW: available image/video model ids + their credit costs (estimates: a render is charged its actual cost), aspect ratios, video durations, the recipe ids, and the canEdit/canAvatar flags. Call it when you need a specific model id, a credit cost, or a capability you are not sure of. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Hermoso models, options and credit costs
    • idempotentHint: true
  • hermoso_other_capabilitiesUse this when the user asks for something this connection's tools do not cover, or asks which Hermoso app or connection does what.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Use this when the user asks for something this connection's tools do not cover, or asks which Hermoso app or connection does what. Returns each area of Hermoso (posting, paid ads, ad creation, research, analytics and the rest) with the Hermoso app or connection that covers it and its link, so you can tell the user where to do it. Read-only: it runs nothing and changes nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Where each Hermoso feature is
  • hubspot_deals_reportDeals from the brand's HubSpot created in the window (default the last 90 days): count and amount by stage (labels resolved through the deal pipelines, closed-won recognised from t…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Deals from the brand's HubSpot created in the window (default the last 90 days): count and amount by stage (labels resolved through the deal pipelines, closed-won recognised from the stage's own metadata), by original source, BY CAMPAIGN (source -> platform -> campaign from HubSpot's Original Source drill-downs, so PAID_SOCIAL splits into the actual campaigns), BY OWNER (the sales rep holding each deal, by name), a monthly created / closed-won series, and totals. Capped at 2,000 deals and says so. Read-only, free. Needs HubSpot connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: HubSpot deals report
    • idempotentHint: true
  • 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
  • linkedin_ads_reportLinkedIn ad performance — impressions, clicks, cost, website conversions, leads and social actions — pivoted by CAMPAIGN (default), CAMPAIGN_GROUP, CREATIVE, ACCOUNT, CONVERSION, P…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    LinkedIn ad performance — impressions, clicks, cost, website conversions, leads and social actions — pivoted by CAMPAIGN (default), CAMPAIGN_GROUP, CREATIVE, ACCOUNT, CONVERSION, PLACEMENT_NAME, IMPRESSION_DEVICE_TYPE, SERVING_LOCATION… or by AUDIENCE DEMOGRAPHICS: MEMBER_COMPANY_SIZE, MEMBER_INDUSTRY, MEMBER_SENIORITY, MEMBER_JOB_TITLE, MEMBER_JOB_FUNCTION, MEMBER_COUNTRY_V2, MEMBER_REGION_V2, MEMBER_COMPANY. The MEMBER_* pivots report job title, seniority, company size and the other member demographics. LinkedIn allows exactly ONE pivot per report, so ask for them one at a time and join the answers yourself. An unknown pivot or granularity is refused BY NAME rather than forwarded. On a demographic pivot LinkedIn returns only the top 100 values, DROPS any value under 3 events (so the rows will not sum to the campaign total) and lags 12–24 hours behind the performance numbers — the note says so, every time. Window via since/until (YYYY-MM-DD). ZERO rows genuinely means no delivery in that window; say exactly that and never present zeros as measured performance. A LinkedIn TEST ad account NEVER returns analytics, and the note says so when that is what you are looking at. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: LinkedIn ads performance report
    • idempotentHint: true
  • linkedin_bid_pricingLinkedIn’s OWN suggested bid and daily-budget range for a specific audience — the suggested bid with a low/mid/high range, the hard bid limits, and the minimum, default and maximum…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    LinkedIn’s OWN suggested bid and daily-budget range for a specific audience — the suggested bid with a low/mid/high range, the hard bid limits, and the minimum, default and maximum daily budget, all in the ad account’s currency. Use it before proposing a number to a user instead of guessing what LinkedIn costs, and pair it with linkedin_audience_count to answer "can we afford this audience?" in one go. Below LinkedIn’s minimum bid it says delivery "may be poor" for Sponsored Update campaigns and is impossible for every other format. These are ESTIMATES for this audience, not prices, and nothing is committed until a campaign is activated with set_linkedin_ads_status(confirm:true). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: LinkedIn suggested bid and budget range
    • idempotentHint: true
  • linkedin_boost_analyticsHow a BOOSTED LinkedIn post performed, from LinkedIn’s boost analytics: impressions, clicks, click-through rate, reactions, comments, shares, follows, spend and approximate unique …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    How a BOOSTED LinkedIn post performed, from LinkedIn’s boost analytics: impressions, clicks, click-through rate, reactions, comments, shares, follows, spend and approximate unique members reached (reach is omitted for boosts longer than 92 days). Up to 50 posts; a post never boosted returns nothing and is named. Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: LinkedIn boost results
    • idempotentHint: true
  • list_posthog_projectsThe PostHog projects the connected personal API key can see, and which ONE this profile is pointed at.Reads text others write1 finding

    Why it is in this group

    • The name "list_posthog_projects" says "list": a word for reading.
    • The description's first verb is "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    The PostHog projects the connected personal API key can see, and which ONE this profile is pointed at. Only the ACTIVE project is readable. That is deliberate: PostHog's API otherwise falls back to "the last project you visited in the UI", which would make every answer depend on the user's browsing history, so Hermoso pins a project at connect time instead of relying on their implicit default. To move this profile to a different project, the user reconnects PostHog under Connectors > PostHog, or with connect_connector, with that project id. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the PostHog projects this key can see
    • idempotentHint: true
  • list_posthog_surveysPostHog SURVEYS.Reads text others write1 finding

    Why it is in this group

    • The name "list_posthog_surveys" says "list": a word for reading.
    • The description's first verb is "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    PostHog SURVEYS. Without surveyId: the project's surveys (name, type, running / complete / draft / archived, dates, questions); filter by status or search. With surveyId: that survey's questions (with their ids, for posthog_survey_responses) plus its stats: shown / dismissed / sent counts, response and dismissal rates, and per-question distributions and rating averages. NEEDS THE OPTIONAL survey:read SCOPE on the PostHog personal API key: a key without it connects fine and works for everything else, and this tool then says exactly which box to tick in PostHog > Settings > Personal API keys. That is never a reconnect. Read-only, 0 credits. Needs PostHog connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: PostHog surveys
    • idempotentHint: true
  • list_product_photosList the product photos ALREADY saved in your workspace — the brand's product library plus any app-store screens (also surfaces photos locked in your OTHER creations, since a set p…1 finding

    Why it is in this group

    • The name "list_product_photos" says "list": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    Findings

    • Warn

      The server marks "list_product_photos" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    List the product photos ALREADY saved in your workspace — the brand's product library plus any app-store screens (also surfaces photos locked in your OTHER creations, since a set product lands in the shared library). FREE — returns each photo's url + the product it shows (the shop's own title when one is on file). These are already saved: never ask the user to upload them again. Reads YOUR saved brand (pass brandId to target a specific profile — that switches this key's active profile like use_brand).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List product photos
  • list_stripe_promotion_codesPromotion codes on the brand's Stripe account — the codes customers TYPE at checkout — with the coupon each applies, active or not, times redeemed / max, expiry, first-purchase-onl…Reads text others write1 finding

    Why it is in this group

    • The name "list_stripe_promotion_codes" says "list": a word for reading.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Promotion codes on the brand's Stripe account — the codes customers TYPE at checkout — with the coupon each applies, active or not, times redeemed / max, expiry, first-purchase-only and minimum-order rules. Filter by active, code or couponId. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: list stripe promotion codes
    • idempotentHint: true
  • log_salesforce_activityLog something that happened as a completed Task on a Salesforce contact or lead, or on an account or opportunity: body (the text), optional subject, channel (call, email, meeting, …Reads private dataReads text others writeCan send data out1 finding

    Why it is in this group

    • The name "log_salesforce_activity" says "log": 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 "log" and "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 "log" and "email": it reads inbound email, which other people can write.
    • outboundThe input takes a destination (input.channel): what the tool writes goes there.

    Findings

    • Warn

      The server marks "log_salesforce_activity" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Log something that happened as a completed Task on a Salesforce contact or lead, or on an account or opportunity: body (the text), optional subject, channel (call, email, meeting, whatsapp, sms, instagram, messenger, telegram, other), direction and occurredAt. Read back. Free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Log an activity in Salesforce
    • idempotentHint: false
  • manage_x_ads_conversion_eventsThe X Pixel's CONVERSION EVENTS on an X ad account.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 X Pixel's CONVERSION EVENTS on an X ad account. action: list (each event's id, type, status UNVERIFIED or TRACKING, and the pixel id) | create (name + type: PURCHASE, SIGN_UP (lead), SITE_VISIT (page view), ADD_TO_CART, CHECKOUT_INITIATED, DOWNLOAD, SUBSCRIBE, START_TRIAL, ADDED_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, PRODUCT_CUSTOMIZATION, SEARCH, CUSTOM; clickWindow 1/7/14/30 days, default 30; viewThroughWindow 0/1/7/14/30, default 1; retargetingEnabled) | update (eventId + any of those). The pixel itself is made in X Events Manager. Read back. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: X Pixel conversion events (list / create / update)
  • merchant_issue_helpGOOGLE'S OWN FIX STEPS, not just the name of the problem.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    GOOGLE'S OWN FIX STEPS, not just the name of the problem. list_merchant_issues stops at the symptom; this returns the remediation content Google writes for each issue, plus the ACTIONS available on it — request a review, claim the website, edit a named attribute — with the exact opaque ids trigger_merchant_issue_action needs. Pass an offerId (with feedLabel, and contentLanguage if it is not 'en') for one PRODUCT's issues, or leave it off for the ACCOUNT's. The fix text is Google's and is relayed verbatim: RELAY IT, do not paraphrase a remediation step into something that sounds simpler. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Google's own fix steps for a Merchant Center issue
    • idempotentHint: true
  • merchant_quotaMerchant Center API quota and account limits, which is the difference between "the API refused" and "you are out of daily quota".Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Merchant Center API quota and account limits, which is the difference between "the API refused" and "you are out of daily quota". Two different things in one answer: quota groups are how many API CALLS each method group has left today, and account limits are how many PRODUCTS the account may hold per destination. Google resets the daily quota at 12:00 PM MIDDAY UTC, not at midnight. If one half of the read fails it comes back null with a warning, which means unknown rather than zero. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Merchant Center quota and limits
  • merchant_reportCOMPETITOR INTELLIGENCE GOOGLE COMPUTES FOR FREE, for any retail brand with a Merchant Center.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    COMPETITOR INTELLIGENCE GOOGLE COMPUTES FOR FREE, for any retail brand with a Merchant Center. Ten report views, read with a SQL-like MCQL query. The three worth reaching for first: `competitive_visibility_competitor_view` (WHICH other domains appear beside this merchant, their rank, page-overlap and higher-position rates — i.e. who is actually beating them), `best_sellers_product_cluster_view` (what is SELLING on Google in a category right now, with an inventory_status saying whether this merchant even stocks it) and `price_insights_product_view` (Google's own suggested price plus the predicted click and conversion change). Also: competitive_visibility_benchmark_view, competitive_visibility_top_merchant_view, best_sellers_brand_view, price_competitiveness_product_view, product_view, product_performance_view, non_product_performance_view. MCQL IS NOT SQL: no OR, no subqueries, no GROUP BY, no aggregates, no JOIN, and ORDER BY may only name fields already in SELECT. Date filters use `WHERE date BETWEEN '2026-01-01' AND '2026-01-31'` or `WHERE date DURING LAST_30_DAYS`. Several views REQUIRE specific fields in SELECT and in WHERE — competitive visibility needs report_category_id + report_country_code + traffic_source, and top_merchant uniquely REQUIRES a date condition while FORBIDDING date in SELECT. An unknown view is refused by name with the list. NOT AVAILABLE ON MULTI-CLIENT (MCA) ACCOUNTS — pass a subaccount id. An empty result is often a normal state (price insights are only produced where Google predicts a substantial gain), and the note says which kind of empty it is. Read-only, free, no new permission.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Merchant Center competitive visibility, best sellers and price benchmarks
    • idempotentHint: true
  • meta_ad_rule_historyEvery run Meta recorded — for one rule (ruleId) or the whole ad account — with what each changed and the rule as it was at that run.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Every run Meta recorded — for one rule (ruleId) or the whole ad account — with what each changed and the rule as it was at that run. Filter by objectId, action (CHANGED_BUDGET, PAUSED, UNPAUSED, CHANGED_BID …) or hideNoChanges. Read-only. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: What Meta's automated rules did
  • meta_catalog_suggestionsMeta can show products from a catalog under a new ad by default (the product showcase).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Meta can show products from a catalog under a new ad by default (the product showcase). This previews what it would pick for an ad account before the ad is made: the catalog and product sets, each on by default or waiting for confirmation, or why there is none (no catalog, not enough context, not enabled). Pass adAccountId, objective (OUTCOME_SALES default, OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT or OUTCOME_LEADS) and adUrl and/or pageId; without either Meta cannot suggest. It applies to ads created from now on, and a creative’s product extensions cannot be changed after it is made. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Which catalog Meta would show under a new ad
  • meta_dataset_qualityHow well the brand’s Meta pixel is set up for the Conversions API, from Meta’s Dataset Quality API: event match quality (out of 10) per website event, which match keys arrive and h…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    How well the brand’s Meta pixel is set up for the Conversions API, from Meta’s Dataset Quality API: event match quality (out of 10) per website event, which match keys arrive and how often, Meta’s own list of problems with the fix for each, how much browser traffic the server also covers, deduplication key coverage, how fresh the uploads are and how many arrive late. Website events only: Meta scores nothing else. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Check a Meta pixel’s Conversions API health
  • meta_insightsUse this when the user asks how their Facebook or Instagram ads are doing.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

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

      Matched text

      description ends: "...thing unrecognised is refused by name here rather than 400ing at Meta. Read-only."

      What this check looks for
    Description, as the server wrote it
    Use this when the user asks how their Facebook or Instagram ads are doing. It reads performance insights for a connected Meta ad account, or a specific campaign / ad set / ad: spend, impressions, reach, clicks, CTR, CPC, CPM, frequency, and the conversions and video numbers Meta reports. Pass adAccountId (for auth); optionally objectId to scope to one object and level (campaign / adset / ad) for one named row per campaign, ad set or ad. EVERY ROW CARRIES `kpis`, the Ads Manager columns read out of Meta's arrays: purchases with purchaseValue, costPerPurchase (CPA) and purchaseRoas (purchase ROAS); addToCart (adds to cart), initiateCheckout (checkouts started), landingPageViews (landing page views) and costPerLandingPageView; linkClicks with linkCtr (link CTR) and linkCpc (link CPC); video3sPlays (3-second video plays), thruPlays (ThruPlay), videoP25 / P50 / P75 / P95 / P100 (plays to 25%, 50%, 75%, 95%, 100%) and videoAvgWatchSeconds (average watch time). A kpi that is null was not reported by Meta for that row: say "not reported", never zero. timeIncrement gives one row per day (1 or "daily"), per week (7) or "monthly" in ONE call. attributionSetting:"adset" counts conversions with each ad set's own attribution setting, as Ads Manager's columns do; attributionWindows (e.g. "7d_click,1d_view") adds each window's count beside the total. fields adds more of Meta's insights fields (e.g. "attribution_setting,quality_ranking,outbound_clicks"); an unknown name is refused, never dropped. Up to 500 rows a call: pass limit, and after:nextCursor for the next page. BREAKDOWNS are what make the numbers actionable — a flat total says an ad cost $X, never WHO it worked on: pass breakdowns:"age,gender", "publisher_platform,platform_position" (which placement), "country" / "region" / "comscore_market" (where — US metro; Meta retired "dma" for it, and "dma" is sent as comscore_market), "impression_device" / "device_platform" (what they held). Comma-separated; "placement", "device" and "geo" are accepted as aliases; an unknown value is REJECTED, never silently ignored. THREE breakdowns need an ad-account OPT-IN from 2026-08-06 — impression_device, hourly_stats_aggregated_by_audience_time_zone and frequency_value: Meta returns NO ROWS (not an error) for an account that has not opted in, so they are always ATTEMPTED, and if nothing comes back the report is re-run WITHOUT them and `droppedBreakdowns` + a note name the missing dimension and say an account admin can enable it in Ads Manager. A dropped dimension is ABSENT, never zero — never present the remaining total as if it were still split by it. Date window: datePreset OR since+until (YYYY-MM-DD). datePreset is Meta's OWN enum — today, yesterday, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, this_week_mon_today, this_week_sun_today, last_week_mon_sun, last_week_sun_sat, this_month, last_month, this_quarter, last_quarter, this_year, last_year, maximum, data_maximum. THERE IS NO "lifetime": Meta disabled it in Graph API v10.0 and replaced it with "maximum" (the last 37 months); anything unrecognised is refused by name here rather than 400ing at Meta. Read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Meta ad performance metrics
    • idempotentHint: true
  • microsoft_ads_auction_insightsWho ELSE is competing for the same Microsoft Advertising auctions — the other advertisers’ domains with their impression share, overlap rate, position-above rate, top-of-page rate …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Who ELSE is competing for the same Microsoft Advertising auctions — the other advertisers’ domains with their impression share, overlap rate, position-above rate, top-of-page rate and outranking share. microsoft_ads_report tells you what the account did; this tells you who it did it against, which is the input to a bid or a creative decision rather than a report. Scope it with entityType Account (default, the whole account) / Campaign / AdGroup / Keyword plus entityIds (max 200), and optionally segment by up to three of Day, DayOfWeek, Device. SAY THIS WHEN REPORTING: every figure is a share of the auctions YOUR ads entered, never a measure of a competitor’s whole account or budget — a competitor missing from the list did not necessarily not bid. An empty result means there was no delivery to compare in that window, which is MISSING data; never report it as "nobody is bidding against you". Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Who else is bidding on the same Microsoft auctions
    • idempotentHint: true
  • microsoft_ads_auto_applyWhether Microsoft is allowed to change this ad account BY ITSELF, unattended: the auto-apply opt-in status for each of the five recommendation types Microsoft supports.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Whether Microsoft is allowed to change this ad account BY ITSELF, unattended: the auto-apply opt-in status for each of the five recommendation types Microsoft supports. THIS IS THE READ THAT ANSWERS "is something changing my account when nobody is looking?", and it is worth running on any Microsoft account you inherit: an account can already be opted in without anyone at the brand having done it, and there is no other way to find out from here. A type Microsoft returns no status for is reported as UNKNOWN, never as off. TWO THINGS THAT CATCH PEOPLE OUT AND ARE STATED IN THE REPLY: these five type names are a DIFFERENT, case-sensitive vocabulary from the six microsoft_ads_recommendations uses (Microsoft cannot auto-apply a budget recommendation at all, there is no such type), and three of the five have no readable recommendation, so there is no way to preview what auto-apply would do for those. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Is Microsoft changing this ad account by itself?
    • idempotentHint: true
  • microsoft_ads_budget_opportunitiesWhere a Microsoft Advertising campaign is BUDGET-CONSTRAINED — Microsoft’s own recommended budget against the current one, the estimated WEEKLY click and impression gain from raisi…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Where a Microsoft Advertising campaign is BUDGET-CONSTRAINED — Microsoft’s own recommended budget against the current one, the estimated WEEKLY click and impression gain from raising it, and a budget/return curve. Omit campaignId for the whole account. SAY THIS WHEN REPORTING: these are Microsoft’s FORECASTS, never measurements — a projected increase has not happened — and acting on one spends real money, so it takes set_microsoft_ads_budget and an explicit yes from the user. Microsoft EXCLUDES user-paused campaigns from this analysis, so a paused campaign is absent by design rather than well-funded. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Where Microsoft says budget is capping delivery
    • idempotentHint: true
  • microsoft_ads_bulk_downloadExport a Microsoft Advertising account as a BULK FILE — one spreadsheet holding whatever slice of the account you ask for.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Export a Microsoft Advertising account as a BULK FILE — one spreadsheet holding whatever slice of the account you ask for. This is the ONLY way to read most of a Microsoft account: roughly 185 of Microsoft’s record types are reachable here and nowhere else in Hermoso — sitelink / callout / structured-snippet / image / logo / price / promotion ad extensions, labels, shared negative keyword lists, bid strategies, audiences and their associations, experiments, seasonality adjustments, conversion goals, asset groups and listing groups, feeds. Pass entities[] (default Campaigns, AdGroups, Ads, Keywords), campaignIds[] to narrow it, or since for a DELTA of what changed (Microsoft refuses anything older than 30 days). The reply carries the WHOLE FILE as a string in `file` — edit that and pass it straight to microsoft_ads_bulk_upload, which is the round trip this exists for. A bulk export is a SNAPSHOT of what Microsoft held when it ran, never a live view, so do not quote a status from it as current after a change. Microsoft builds it asynchronously: a large account can come back pending:true with a downloadRequestId — call again with that id rather than resubmitting, which would export the whole account a second time. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Export a Microsoft Advertising account as a bulk file
    • idempotentHint: true
  • microsoft_ads_editorial_reasonsWHY a Microsoft Advertising ad or keyword was DISAPPROVED: Microsoft's editorial reason codes, the word or phrase it objected to (term), where it appeared (location), the countries…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHY a Microsoft Advertising ad or keyword was DISAPPROVED: Microsoft's editorial reason codes, the word or phrase it objected to (term), where it appeared (location), the countries it applies to, and any appeal status, read live from Microsoft. Use it whenever a read-back shows editorialStatus Disapproved, or the user asks why a Bing ad is not running. Pass adGroupId plus adIds OR keywordIds (Microsoft will not mix ads and keywords in one request). The reply links Microsoft's table of what each code means. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Why a Microsoft ad or keyword was disapproved
  • microsoft_ads_keyword_ideasMicrosoft Advertising’s KEYWORD PLANNER — real monthly search volume, competition, suggested bid and ad impression share, expanded from seed keywords, a landing-page URL to mine, o…Reads text others writeCan send data outNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Microsoft Advertising’s KEYWORD PLANNER — real monthly search volume, competition, suggested bid and ad impression share, expanded from seed keywords, a landing-page URL to mine, or a category. Run it BEFORE choosing keywords for a Microsoft campaign. locationIds is REQUIRED and deliberately not defaulted: a search volume with no market attached is a number nobody can act on, and inventing a country would silently answer about the wrong market — use microsoft_ads_geo_search to resolve a country or city name to an id, free. SAY THIS WHEN REPORTING: Competition is Microsoft’s Low/Medium/High bucket, NOT a percentage; MonthlySearchCounts is a per-month series rather than one number; SuggestedBid is in the account currency. An empty result means Microsoft found no ideas for those seeds, never that nobody searches for them. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Microsoft Advertising keyword planner
    • idempotentHint: true
  • microsoft_ads_recommendationsWhat Microsoft Advertising ITSELF suggests changing on the account: budget raises, new keywords, broad-match widenings, conflicting negative keywords to remove, and responsive sear…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What Microsoft Advertising ITSELF suggests changing on the account: budget raises, new keywords, broad-match widenings, conflicting negative keywords to remove, and responsive search ads or extra headlines Microsoft has written. Each row carries the campaign and ad group it touches plus Microsoft’s OWN estimate of what applying it would add to clicks, impressions, conversions and COST; a budget recommendation states the current and the recommended daily amount, so the money is a vendor fact rather than a guess. SAY THIS WHEN REPORTING: every Microsoft recommendation INCREASES what the account buys, that is what they are for, so none of them is a free win, and an empty list means Microsoft has no ADVICE (usually too little delivery to compute any), never that the account is optimal. Dismissed recommendations are hidden unless you ask for them. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What Microsoft suggests changing on the account
    • idempotentHint: true
  • microsoft_ads_reportPerformance for a Microsoft Advertising account — impressions, clicks, CTR, average CPC, spend, conversions.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Performance for a Microsoft Advertising account — impressions, clicks, CTR, average CPC, spend, conversions. `reportType` picks WHICH report, and that is the whole Microsoft reporting surface, not just campaigns: AdGroupPerformance, AdPerformance, KeywordPerformance, SearchQueryPerformance (the actual search terms people typed), GeographicPerformance, UserLocationPerformance, AgeGenderAudience and ProfessionalDemographicsAudience (LinkedIn-sourced job function and industry, inside Bing), ConversionPerformance, DestinationUrlPerformance, ShareOfVoice, AssetPerformance, ProductDimensionPerformance, SearchCampaignChangeHistory ("what changed on Tuesday") and ~30 more — an unknown name is refused WITH the full list rather than forwarded. `aggregation` controls the row grain (Summary / Daily / Hourly / Weekly / Monthly / Yearly / HourOfDay / DayOfWeek). Two reports keep far less history than the usual 36 months — AssetPerformance 30 days, ShareOfVoice 6 — and the reply says so, because an empty short-retention report is a retention limit, not an absence of delivery. Window via timePeriod (Today | Yesterday | LastSevenDays | Last14Days | Last30Days | ThisWeek | LastWeek | LastFourWeeks | ThisMonth | LastMonth | LastThreeMonths | LastSixMonths | ThisYear | LastYear | ThisWeekStartingMonday | LastWeekStartingMonday | LastFourWeeksStartingMonday) or since+until (YYYY-MM-DD) — default Last30Days. An unrecognised timePeriod is REFUSED, never silently swapped for another window. Microsoft generates reports ASYNCHRONOUSLY: this can return pending:true with a reportRequestId, and you must call again rather than reporting any numbers. A report that succeeds with ZERO rows genuinely means there was no delivery in that window — say exactly that; never present zeros as measured performance. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Microsoft Advertising performance report
    • idempotentHint: true
  • microsoft_ads_traffic_estimatesWhat a set of keywords would DELIVER on Microsoft Advertising at a given bid — estimated impressions, clicks, CTR, average CPC, average position and total cost.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What a set of keywords would DELIVER on Microsoft Advertising at a given bid — estimated impressions, clicks, CTR, average CPC, average position and total cost. maxCpc is REQUIRED because a traffic estimate IS a function of the bid; estimating without one would be inventing the input. locationIds is REQUIRED for the same reason a search volume needs a market. SAY THIS WHEN REPORTING: Microsoft returns a MINIMUM and a MAXIMUM per keyword — quote the range, never average the two into a single figure — and every number here is a FORECAST, so never present it as measured performance. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Microsoft Advertising traffic estimates
    • idempotentHint: true
  • mixpanel_funnelA saved Mixpanel funnel.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    A saved Mixpanel funnel. Call with NO id to LIST the saved funnels and their ids; call with funnelId to read its conversion data. Warning: MIXPANEL HAS PUT THE FUNNELS QUERY API IN MAINTENANCE MODE — their words: "We recommend discontinuing new use of this endpoint. To get funnel data, build a Funnels report in-app and query it programmatically with the Insights Query API." So prefer mixpanel_insights with that report's bookmark id; this is offered because it still answers and because it is the only way to LIST a project's funnels. `length` IS BOUNDED AT 90 DAYS, WHICH IS NOT THE NUMBER 90: it counts lengthUnits, so 90 days is 2160 hours or 129600 minutes, and an over-long window is REFUSED BY NAME rather than trimmed — silently shortening it would answer a different question with nothing to show that it had happened. Omit both and Mixpanel uses whatever the funnel was saved with in its own UI, which is usually what you want. Dates are YYYY-MM-DD and BOTH ENDS ARE INCLUSIVE, resolved in the PROJECT's timezone (UTC unless its owner changed it) rather than in yours. 60 queries/hour across the whole Query API (5 concurrent) — the tightest budget of any connector here, so widen a range rather than looping over days. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a saved Mixpanel funnel (maintenance mode)
    • idempotentHint: true
  • mixpanel_profilesTHE PEOPLE in Mixpanel, with their profile properties.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE PEOPLE in Mixpanel, with their profile properties. Pass `cohortId` (from list_mixpanel_cohorts) for "who is in the Converted cohort and what do we know about them", or `where` for an ad-hoc filter over profile properties, or `distinctId` for one person. PASS `outputProperties` ALMOST ALWAYS: it cuts the payload to the properties you actually need, and Mixpanel says it "can drastically reduce the amount of data returned" and "can speed up queries significantly". RETURNS ONE PAGE AND DOES NOT PAGINATE FOR YOU — it hands back page, pageSize, total and a sessionId, and Mixpanel REQUIRES that sessionId alongside any page above 0, so a second page is a deliberate second call. DO NOT LOOP IT: Mixpanel allows 60 queries per hour across its ENTIRE Query API and each page spends one of them. REPORT `total` (the whole cohort) SEPARATELY FROM `count` (this page) — quoting only the page size understates the audience, which is the number a targeting decision gets made on. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the people in a Mixpanel cohort
    • idempotentHint: true
  • mixpanel_retentionMIXPANEL RETENTION — how many of the people who did a first thing came back and did another, cohorted by day / week / month.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    MIXPANEL RETENTION — how many of the people who did a first thing came back and did another, cohorted by day / week / month. This endpoint is FULLY SUPPORTED, unlike segmentation and funnels, which Mixpanel has put in maintenance mode — so it is the one typed Mixpanel report to reach for first. retentionType "birth" cohorts people by their FIRST occurrence of bornEvent (new-user retention, and Mixpanel's DEFAULT); "compounded" counts anyone active. Warning: MIXPANEL REQUIRES bornEvent WHENEVER retentionType IS "birth", AND BIRTH IS THE DEFAULT — so a call with neither is refused HERE, for free, rather than spending one of the sixty hourly queries on their 400; use list_mixpanel_events first to name a real event. TWO FILTERS, NOT ONE: bornWhere filters who ENTERS the cohort, where filters the RETURNING event. And interval is the WIDTH of each bucket while intervalCount is HOW MANY of them — different knobs. Dates are YYYY-MM-DD and BOTH ENDS ARE INCLUSIVE, resolved in the PROJECT's timezone (UTC unless its owner changed it) rather than in yours. 60 queries/hour across the whole Query API (5 concurrent) — the tightest budget of any connector here, so widen a range rather than looping over days. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Mixpanel retention cohorts
    • idempotentHint: true
  • mixpanel_segmentationOne Mixpanel event over time, optionally broken down by a property (`on`) and filtered (`where`).Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One Mixpanel event over time, optionally broken down by a property (`on`) and filtered (`where`). Warning: MIXPANEL HAS PUT THIS ENDPOINT IN MAINTENANCE MODE — their words: "We recommend discontinuing new use of this endpoint. To break down and filter event data, build an Insights report in-app and query it programmatically with the Insights Query API." It still answers today, which is why it is offered rather than withheld, but SAY SO when you use it and prefer mixpanel_insights whenever the user can build the report. It takes ONE event name and not an array (the /events endpoints take an array; this one does not — an easy and silent mistake). 60 queries/hour across the whole Query API. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Mixpanel event segmentation (maintenance mode)
    • idempotentHint: true
  • openai_ads_bulk_jobPoll a ChatGPT Ads bulk job and read the result of EVERY operation in it.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Poll a ChatGPT Ads bulk job and read the result of EVERY operation in it. Reports the job status (pending, in_progress, completed, partially_failed, failed — the last three are terminal) plus a per-operation verdict: created, updated, validated, failed or skipped, each with the new resource id or the error. THE VERDICT COMES FROM THE OPERATIONS, NEVER FROM THE JOB STATUS — "the job finished" and "your ad was created" are different questions, and a partially_failed job answers yes to one and no to the other. While a job is still running the results are an INCOMPLETE SNAPSHOT and there is no cursor to page with; once complete is true, page with `after` set to the last operation_id. A failed operation that reports retryable names retry_after_seconds — reuse the ORIGINAL create idempotency_key when resubmitting or the retry creates a duplicate. Free, read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Read a ChatGPT Ads bulk job
  • openai_ads_conversionsATTRIBUTED CONVERSIONS for ChatGPT Ads — the number the whole pixel + conversion-event setup exists to produce, beyond what openai_ads_report shows: that report carries conversions…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ATTRIBUTED CONVERSIONS for ChatGPT Ads — the number the whole pixel + conversion-event setup exists to produce, beyond what openai_ads_report shows: that report carries conversions and CPA for the account, a campaign, ad group or ad, while this tool adds the click-through / view-through split, totals per id across many ids, and the received-event sample. Pass entityIds — the campaign / ad group / ad ids to report on — with a matching level; the default window is the last 30 days. NEVER ADD viewThroughConversions TO conversions: since OpenAI’s 2026-09-30 change conversions already counts click-through PLUS view-through goal conversions within the chosen windows (their example: 3 click-through and 2 view-through give conversions 5), and the rows and totals carry clickThroughConversions and viewThroughConversions as its two parts. Post-click conversion rate stays click-through only. NO ROWS means no attributed conversion was recorded, not that data is missing — say exactly that, and check that an event setting exists (list_openai_ads_conversion_events) and that its pixel snippet is actually live on the site. RECEIVED EVENTS: pass recentEvents:true (no ids needed) to read a recent SAMPLE of the events OpenAI actually received on the pixel — type, event time, receive time, API channel and the event id — which answers "did OpenAI get the signup at all?" when a conversion is missing. It is a sample, not a complete log, and receiving an event is not the same as attributing it. BEYOND THE GOAL (on by default): each row and the reply carry attributedEvents, every event OpenAI attributed whether or not it is the campaign’s goal (e.g. purchases on a sign-up campaign), with count and value; totals.orderSales is attributed purchase value. An event count already includes goal activity: NEVER add it to conversions; a null value is unknown, not zero. A current day is not final until OpenAI’s daily processing runs. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: ChatGPT Ads attributed conversions
    • idempotentHint: true
  • openai_ads_hotel_reportDelivery per HOTEL PROPERTY for a ChatGPT Ads Hotel feed: impressions, clicks, spend, CTR, CPC and CPM per property (hotel id, name, brand, city, star rating), optionally per day o…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Delivery per HOTEL PROPERTY for a ChatGPT Ads Hotel feed: impressions, clicks, spend, CTR, CPC and CPM per property (hotel id, name, brand, city, star rating), optionally per day or month and broken down by campaign, ad group or ad; timeseries:true returns daily totals across the selected properties instead. Filter by campaignIds / adGroupIds / adIds, exact properties [{feedId, hotelId}], or filters on hotel_name / hotel_brand / hotel_category / hotel_city / hotel_region / hotel_country_code (IN) and impressions / clicks / spend / ctr / cpc / cpm (GREATER_THAN / LESS_THAN). OpenAI’s rules, said in every reply: impressions and clicks mix settled and estimated data, spend and cost rates are settled only, and the coverage block decides whether an empty or short answer is real. No conversions and no attribution windows exist here. Hotel Insights is an OpenAI limited beta for accounts enrolled in Hotel reporting; others are refused by OpenAI. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: ChatGPT Ads Hotel Insights (per property)
    • idempotentHint: true
  • openai_ads_reportPerformance for ChatGPT Ads — impressions, clicks, spend, CTR, CPC, CPM, and CONVERSIONS with CPA, post-click conversion rate and attributed order sales / ROAS.Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Info

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

      Matched text

      description ends: "...rsions. Read-only and free: run it FIRST after connecting to prove the key works."

      What this check looks for
    Description, as the server wrote it
    Performance for ChatGPT Ads — impressions, clicks, spend, CTR, CPC, CPM, and CONVERSIONS with CPA, post-click conversion rate and attributed order sales / ROAS. OpenAI returns conversions only with granularity none or daily and with no segment or a country/device segment (never platform or product), and CPA, conversion rate and sales only with no segment at all; the report adds every column OpenAI allows for the shape you asked and its note names any it left out, so a missing column is their limit, not a zero. Since OpenAI’s 2026-09-30 change these conversions count click-through PLUS view-through goal conversions within the reporting windows (default 30-day click, 1-day view, dated by the ad interaction); CPA uses them and post-click conversion rate uses click-through only. clickWindowDays (7, 14, 30), viewWindowDays (0 = clicks only, or 1) and attributionTimeBasis choose those windows for every conversion column and never change the campaign; match Ads Manager’s when comparing (the reply’s `attribution` names them). The scope follows the id you pass: none = the whole ad account, or campaignId / adGroupId / adId. PRODUCT-FEED CAMPAIGNS serving in the multi-product CAROUSEL unit also report per-card numbers: ask for them in `fields` — carousel_product_card_impressions / _clicks and the product_* fields (impressions, clicks, spend, ctr, cpc, cpm, title, price, feed_id); they come back under each row’s `fields`. A card impression is NOT billable; never add it to spend math. granularity is hourly, daily, monthly or none (default daily); the default window is the last 30 days; segment by country or device for a breakdown, and level rolls the rows up by campaign / ad group / ad. NO rows means NO delivery in that window; never present zeros as measured performance. attributedEvents:true adds every event OpenAI attributed beyond the campaign goal (purchases on a sign-up campaign) for the same scope and days; never add those counts to conversions. Read-only and free: run it FIRST after connecting to prove the key works.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: ChatGPT Ads performance report
    • idempotentHint: true
  • pinterest_ads_async_reportThe DEEP Pinterest ad report — Pinterest’s ASYNCHRONOUS lane, which reaches 914 DAYS back (2.5 years) where pinterest_ads_report stops at 90, and carries roughly three times the me…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The DEEP Pinterest ad report — Pinterest’s ASYNCHRONOUS lane, which reaches 914 DAYS back (2.5 years) where pinterest_ads_report stops at 90, and carries roughly three times the metric columns (conversion, ROAS and cross-device families the quick report does not have). Use it for anything older than three months, and for revenue questions. Levels: ADVERTISER / CAMPAIGN / AD_GROUP / PIN_PROMOTION / KEYWORD / PRODUCT_GROUP / PRODUCT_ITEM plus their *_TARGETING twins. Pinterest generates it asynchronously, so this may come back pending:true with a token — CALL AGAIN WITH THAT TOKEN to pick it up, and never re-submit without it (a second submit generates a second report). Pinterest’s own windows are enforced here with the reason rather than as an opaque 400: 914 days back over at most 186 days; at HOUR granularity 8 days back over 3; at a PRODUCT_ITEM level 92 back over 31. A finished report link is valid five minutes and the report one hour, so an EXPIRED status means run it again, not that anything failed. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest deep (async) ad report
    • idempotentHint: true
  • pinterest_ads_audience_sizeEstimate how many people a Pinterest ad group’s targeting can reach per month, before spending.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Estimate how many people a Pinterest ad group’s targeting can reach per month, before spending. Pass targetingSpec (e.g. {"GEO":["US"],"AGE_BUCKET":["25-34"]}), keywords and/or productGroupIds. A range from Pinterest’s historical data, not a promise. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest audience size
    • idempotentHint: true
  • pinterest_ads_keyword_ideasPinterest KEYWORD RESEARCH through the Pinterest Ads connection.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Pinterest KEYWORD RESEARCH through the Pinterest Ads connection. mode:"related" (default): terms related to each of your terms ("workout" -> "yoga workout", "workout motivation"); mode:"suggested": popular searches that BEGIN with the term; mode:"metrics": Pinterest-wide search volume for up to 2,000 keywords in one country. Feeds ad-group KEYWORD targeting and Pin titles. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest keyword ideas
    • idempotentHint: true
  • pinterest_ads_reportPerformance for a Pinterest ad account — spend, impressions, clicks, CTR, effective CPC and conversions — at ANY of Pinterest’s four levels: the whole ACCOUNT, by CAMPAIGN, by AD 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.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Performance for a Pinterest ad account — spend, impressions, clicks, CTR, effective CPC and conversions — at ANY of Pinterest’s four levels: the whole ACCOUNT, by CAMPAIGN, by AD GROUP, or by individual AD. Ad level is how you answer "WHICH AD IS WINNING". EVERY SUB-ACCOUNT LEVEL NEEDS ITS IDS — this was measured, not read: Pinterest refuses campaign level without campaignIds, ad-group level without adGroupIds, AND ad level without adIds ("Either ads id filter or both pin id and campaign id filters must be specified"), so there is NO account-wide per-ad call. Get the ids from list_pinterest_ads_campaigns (name a campaignId and it returns that campaign’s ad groups and ads), or use level:"account" for a whole-account total with no ids at all. At AD level Pinterest publishes one alternative its own refusal names: pinIds AND campaignIds TOGETHER, which reports every ad promoting those Pins — half of that pair is refused here naming the missing half. The level is inferred from whichever ids you pass, so naming campaignIds still reports by campaign. Default columns lead with that level’s OWN id and name, because a report whose rows cannot be told apart answers nothing. Window via since/until (YYYY-MM-DD) and granularity. Pinterest keeps only 90 days and refuses ranges longer than 90 days (at HOUR granularity: 8 days back, 3-day windows) — this refuses those up front with the reason rather than letting Pinterest return an opaque error. A report with ZERO rows genuinely means nothing delivered in that window; say exactly that and never present zeros as measured performance. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest ads performance report
    • idempotentHint: true
  • posthog_personsLook up PEOPLE in PostHog by distinct id, email or a free-text search, with their properties.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Look up PEOPLE in PostHog by distinct id, email or a free-text search, with their properties. Use it to resolve a specific customer, then use their distinct id inside posthog_query to see exactly what that one human did. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up people in PostHog
    • idempotentHint: true
  • posthog_survey_responsesTHE ANSWERS people gave a PostHog survey, with the QUESTION TEXT resolved beside each answer: who (distinct_id), when, country, device and the page they were on.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE ANSWERS people gave a PostHog survey, with the QUESTION TEXT resolved beside each answer: who (distinct_id), when, country, device and the page they were on. The customers' own words: the best raw input for ad hooks, angles and objections. questionId narrows to one question; with scoreLte / scoreGte on a rating question it pulls e.g. NPS detractors (scoreLte 6) or promoters (scoreGte 9). since / until are ISO timestamps. One page (limit 1-500, default 100) and the next offset when there is more. NEEDS THE OPTIONAL survey:read SCOPE on the PostHog personal API key (plus query:read, which every connection already has); without it this tool names the box to tick in PostHog, never a reconnect. Read-only, 0 credits. Needs PostHog connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: PostHog survey responses
    • idempotentHint: true
  • prereview_tiktok_ads_creativeAsk TikTok whether ad material would pass its ad review BEFORE you build the ad, so a rejection costs nothing.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
    Ask TikTok whether ad material would pass its ad review BEFORE you build the ad, so a rejection costs nothing. Submit up to 5 materials (videoIds and imageIds from upload_tiktok_ads_creative, adTexts, landingPageUrls) for ONE country the ad will run in. TikTok answers per material: APPROVED, REJECTED (with its reason and suggested fix), UNSURE or UNAVAILABLE. Submitting returns a taskId plus any verdicts already in, since short texts are often judged within seconds; a task usually finishes in about 5 minutes, so call again with taskId alone to read the rest. A material with no verdict yet is NOT approved. Results last 180 days and apply to the country reviewed only. Creates no ad and spends nothing.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Pre-review TikTok ad material
  • preview_pinterest_ads_adSee a Pinterest AD before spending — Pinterest renders a preview link (valid 7 days, iframe-able) from an existing promotable Pin (pinId), from an image not yet pinned (imageUrl + …Reads text others write1 finding

    Why it is in this group

    • The name "preview_pinterest_ads_ad" says "preview": 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 "url": it reads web pages, which anyone can write.

    Findings

    • Warn

      The server marks "preview_pinterest_ads_ad" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    See a Pinterest AD before spending — Pinterest renders a preview link (valid 7 days, iframe-able) from an existing promotable Pin (pinId), from an image not yet pinned (imageUrl + title), or from a catalog product group (productGroupId, for a shopping ad). Creates no ad, spends nothing, 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Preview a Pinterest ad
  • reddit_ads_bid_suggestionReddit’s own suggested bid for a given objective, bid type and targeting — a median, a sensible range, and the hard floor below which Reddit will not accept a bid.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Reddit’s own suggested bid for a given objective, bid type and targeting — a median, a sensible range, and the hard floor below which Reddit will not accept a bid. Amounts come back in the ad account’s currency. Free, creates nothing. Use it to pick bidAmount for create_reddit_ads_ad_group instead of guessing a number that either never wins an auction or overpays.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Ask Reddit what to bid
    • idempotentHint: true
  • reddit_ads_forecastAsk Reddit how big a targeting set is and roughly what a budget would buy — total reachable audience, the targeted slice, and estimated impressions, clicks and reach.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Ask Reddit how big a targeting set is and roughly what a budget would buy — total reachable audience, the targeted slice, and estimated impressions, clicks and reach. Free, creates nothing, spends nothing, so run it BEFORE building an ad group to sanity-check targeting that may be far too narrow or far too broad. Budget is an ordinary amount in the ad account’s currency. These are Reddit’s estimates, not a guarantee — say so when reporting them.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Forecast Reddit audience size and delivery
    • idempotentHint: true
  • reddit_ads_plan_forecastReddit Campaign Planner’s forecast for a proposed campaign: the audience, projected reach, impressions, clicks, frequency and CPM/CPC/CPV for this budget, and a curve of reach at t…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Reddit Campaign Planner’s forecast for a proposed campaign: the audience, projected reach, impressions, clicks, frequency and CPM/CPC/CPV for this budget, and a curve of reach at ten budgets to compare. Creates nothing and spends nothing. Use reddit_ads_forecast for a quick audience size. Reddit allows 30 of these a minute. These are Reddit’s estimates, not a guarantee, and they reserve nothing; say so, and keep each result beside the inputs that made it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Forecast a Reddit campaign plan
    • idempotentHint: true
  • reddit_ads_reportPerformance for a Reddit ad account — impressions, clicks, spend, CTR, CPC, eCPM, reach and any of Reddit’s ~450 metric fields, optionally broken down by campaign, ad group, ad, da…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Performance for a Reddit ad account — impressions, clicks, spend, CTR, CPC, eCPM, reach and any of Reddit’s ~450 metric fields, optionally broken down by campaign, ad group, ad, date, hour, community, country, gender, interest, keyword, placement and more. Money comes back in WHOLE UNITS of the ad account’s currency (Reddit reports micro-currency; the conversion is done for you) — and that currency is not necessarily dollars, so check the account. Reddit only accepts HOURLY window boundaries; plain YYYY-MM-DD dates are accepted here and snapped for you. A report with ZERO rows genuinely means nothing delivered in that window — say exactly that and never present zeros as measured performance. ONE DATED LIMIT WORTH PLANNING AROUND: from 2026-12-08 Reddit caps the HOUR breakdown at windows of 7 DAYS OR FEWER and answers 400 beyond that. Hermoso warns before that date and refuses after it rather than relaying a bare vendor 400 — for a longer stretch, run one report per <=7-day window, or use the DATE breakdown for a daily series over the whole period. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Reddit ads performance report
    • idempotentHint: true
  • register_merchant_developerONE-TIME SETUP, and the FIRST thing to run when Merchant Center calls are being refused.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-TIME SETUP, and the FIRST thing to run when Merchant Center calls are being refused. Google blocks every Merchant API call until Hermoso's Google Cloud project is registered against the merchant's account, and says so verbatim ("GCP project ... is not registered with the merchant account"). This performs that link. It is NOT a broken connection and reconnecting cannot fix it. Google asks for up to 5 minutes afterwards before the API starts answering.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Register Hermoso with a Merchant Center account
  • 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
  • rename_reddit_ads_assetChange a stored Reddit creative asset’s name — the ONLY field Reddit lets you edit on an asset (its PATCH takes {name} and nothing else).Reads text others writeNo findings

    Why it is in this group

    • The name "rename_reddit_ads_asset" says "rename": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Change a stored Reddit creative asset’s name — the ONLY field Reddit lets you edit on an asset (its PATCH takes {name} and nothing else). The reply is read back from the library. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Rename a Reddit creative asset
  • report_bugReport a bug in Hermoso to the team.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Report a bug in Hermoso to the team. Use this when something in Hermoso genuinely misbehaves — a tool errors unexpectedly, returns a wrong or malformed result, a render comes back broken, or documented behaviour doesn't match what happened. Include what you were trying to do, the exact tool call and arguments, and what came back. Do NOT use it for out-of-credits, a policy refusal, or a missing capability (use request_feature for that). Free, no credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Report a bug
  • request_featureAsk the Hermoso team for a capability that doesn't exist yet.Reads text others writeNo findings

    Why it is in this group

    • The name "request_feature" says "request": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Ask the Hermoso team for a capability that doesn't exist yet. Use this when you need something Hermoso genuinely can't do — an unsupported platform or channel, a missing model, an export format, a tool that would have completed the user's task but isn't available. Say what the user was trying to achieve, not just the feature name — the use case is what gets built. Free, no credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Request a feature
  • run_pinterest_ads_report_templateRun a saved Pinterest report template (pinterest_ads_account_data what:report_templates lists them) for an optional date range.Reads text others writeNo findings

    Why it is in this group

    • The name "run_pinterest_ads_report_template" says "run": 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
    Run a saved Pinterest report template (pinterest_ads_account_data what:report_templates lists them) for an optional date range. It runs in the background and answers a token; pinterest_ads_async_report with that token gives the rows. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Run a Pinterest report template
  • save_creatorAdd a portrait to this workspace’s reusable CAST so the SAME person can star in future ads.Reads text others writeNo findings

    Why it is in this group

    • The name "save_creator" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add a portrait to this workspace’s reusable CAST so the SAME person can star in future ads. Pass the portrait’s public url plus a name to call them by. Saving is FREE and renders nothing (the one paid option is makeSheet, which makes their 16:9 character sheet). LIKENESS: leave `source` "generated" for an AI-made person (free on every plan) and use "upload"/"social" for a REAL person. Using a real person’s face, likeness or voice confirms you are them or have their consent, take full, unlimited responsibility for its use and will cover any claim against Hermoso (hermoso.ai/terms). Paid plan only; recorded.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save a creator
  • save_locationSave a PLACE (a room, a set, a storefront) so any image, video or ad can be staged there by its @name.No findings

    Why it is in this group

    • The name "save_location" says "save": a word for a change.
    Description, as the server wrote it
    Save a PLACE (a room, a set, a storefront) so any image, video or ad can be staged there by its @name. FREE. A name and a public photo url of the empty place.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Save a place
  • save_playbookSave a reusable PLAYBOOK — the strategy takeaways worth re-running: the hooks that work, the angles, the formats, and the concrete plays.No findings

    Why it is in this group

    • The name "save_playbook" says "save": a word for a change.
    Description, as the server wrote it
    Save a reusable PLAYBOOK — the strategy takeaways worth re-running: the hooks that work, the angles, the formats, and the concrete plays. Lands in the same Playbooks library the web app lists, runs and manages. Distinct from save_skill (a directive applied to every ad) and from the swipefile (raw saved creative). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Save a playbook
  • save_skillSave a reusable custom SKILL — a named creative directive/playbook applied to future ads (a hook formula, a UGC recipe, a compliance rule, a named specialist persona like “our foun…No findings

    Why it is in this group

    • The name "save_skill" says "save": a word for a change.
    Description, as the server wrote it
    Save a reusable custom SKILL — a named creative directive/playbook applied to future ads (a hook formula, a UGC recipe, a compliance rule, a named specialist persona like “our founder-story style” or “short-form ad strategist”). Distill an imperative, self-contained directive. Merges into the workspace Skills library (list_skills shows built-ins + your custom skills).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
    • title: Save a skill
  • save_to_driveSave a Hermoso render — or ANY file — into the user’s connected Google Drive.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "save_to_drive" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Save a Hermoso render — or ANY file — into the user’s connected Google Drive. Pass a Hermoso render URL as url (or urls[] for several); for a local/external file, call upload_file first and pass the url it returns. Optional folder (created if new) + name. Returns the Drive file(s) with a webViewLink. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs). NOTE: Hermoso uses the drive.file scope, so it reaches ONLY the files it created plus any the user explicitly handed over with the Google file picker in the app — never their whole Drive.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save file(s) to Google Drive
  • save_to_notionSave to the user's Notion as a NEW page: a research report, competitor teardown or campaign report as `content` (markdown: headings, lists, links, and an image or video URL on its …Reads text others writeNo findings

    Why it is in this group

    • The name "save_to_notion" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Save to the user's Notion as a NEW page: a research report, competitor teardown or campaign report as `content` (markdown: headings, lists, links, and an image or video URL on its own line becomes the media), a swipefile collection (swipefileCollection: name or id; each ad with its creative, copy, run dates and link), the content calendar (includeSchedule:true), or a mix. Put it under parentPageId, as a row in databaseId, or omit both for a private page in their workspace. Long text is split across blocks, never cut. The answer is read back from Notion. Free; never overwrites anything.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save to Notion
  • save_to_onedriveSave a Hermoso render — or ANY file — into the user’s connected Microsoft OneDrive.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "save_to_onedrive" says "save": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Save a Hermoso render — or ANY file — into the user’s connected Microsoft OneDrive. Pass a Hermoso render URL as url (or urls[] for several); for a local/external file, call upload_file first and pass the url it returns. Optional folder (created if new) + name. Returns the OneDrive file(s) with a webViewLink. Needs OneDrive connected (Connectors > OneDrive).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Save file(s) to OneDrive
  • save_to_swipefileSave one or more ads/creatives to a named SWIPEFILE collection, creating the collection if it does not exist.No findings

    Why it is in this group

    • The name "save_to_swipefile" says "save": a word for a change.
    Description, as the server wrote it
    Save one or more ads/creatives to a named SWIPEFILE collection, creating the collection if it does not exist. Saved ads persist to the workspace board the web Swipefile tab shows, and feed the taste signal every future ad is planned against. De-dupes: re-saving the same ad (same key/link/media) MOVES it into the named collection instead of duplicating it. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Save ads to the swipefile
  • set_auto_reloadTurn automatic credit reloads on or off (admin only): when the balance drops below a threshold, the card on file is charged for a top-up pack — SERVER-SIDE, even with no app open.No findings

    Why it is in this group

    • The name "set_auto_reload" says "set": a word for a change.
    Description, as the server wrote it
    Turn automatic credit reloads on or off (admin only): when the balance drops below a threshold, the card on file is charged for a top-up pack — SERVER-SIDE, even with no app open. Requires a saved card, added once in the app at first checkout/top-up; if there's none the tool tells you exactly where to add it. After that one-time card setup, agents can manage auto-reload, top-ups and plan links fully. Members (read-only billing) get an 'ask an admin' message.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Set auto-reload
  • set_credit_limitSet, change or remove a monthly credit limit on one brand, or on one member of a shared brand (ACCOUNT OWNER ONLY: a brand’s admins and members are refused).No findings

    Why it is in this group

    • The name "set_credit_limit" says "set": a word for a change.
    Description, as the server wrote it
    Set, change or remove a monthly credit limit on one brand, or on one member of a shared brand (ACCOUNT OWNER ONLY: a brand’s admins and members are refused). When a brand or member would go over its limit this month, paid work there is refused with the numbers and the reset date; free work keeps going and other brands are unaffected. The month is the UTC calendar month. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Set a credit limit
  • set_hubspot_lead_syncSwitch the AUTOMATIC HubSpot lead sync on or off for this brand: enabled, everyMinutes (a whole number from 15 to 1440; default 60 — anything outside that is refused, not clamped),…Reads text others writeNo findings

    Why it is in this group

    • The name "set_hubspot_lead_sync" 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
    Switch the AUTOMATIC HubSpot lead sync on or off for this brand: enabled, everyMinutes (a whole number from 15 to 1440; default 60 — anything outside that is refused, not clamped), optional platforms (meta, linkedin, tiktok, x, snapchat, chatgpt, reddit; default every connected one). Each run is sync_leads_to_hubspot reading from the last successful run, so a new lead reaches the CRM within minutes and nothing is ever created twice. If HubSpot is disconnected a run records that and the schedule backs off to once a day — no emails. runNow:true runs the first one straight away. Answers with the stored setting and the armed run, read back. Free. Needs HubSpot connected to switch on.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Turn the automatic HubSpot lead sync on or off
  • set_microsoft_ads_account_propertiesChange a Microsoft Advertising ad account’s account-level settings (Microsoft’s SetAccountProperties).Reads text others writeNo findings

    Why it is in this group

    • The name "set_microsoft_ads_account_properties" 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
    Change a Microsoft Advertising ad account’s account-level settings (Microsoft’s SetAccountProperties). They apply to EVERY campaign in the account. Settable: TrackingUrlTemplate and FinalUrlSuffix ("" clears them), MSCLKIDAutoTaggingEnabled, AdClickParallelTracking (true only, Microsoft made it mandatory), IncludeViewThroughConversions, ProfileExpansionEnabled, AllowImageAutoRetrieve, BusinessAttributes (an array or a semicolon list of Microsoft’s attribute names, "" clears), AssetAIEnhancementOptout and AIDetectedContentWatermarkPolicy. Readable but refused here, by name: AutoApplyRecommendations (use set_microsoft_ads_auto_apply), the Nielsen and Netflix terms acceptances (a person accepts terms, not an agent), and properties whose values Microsoft does not document. confirm:true is required to turn ProfileExpansionEnabled ON (it widens reach and can raise spend), to turn AllowImageAutoRetrieve ON (it grants Microsoft a licence to your site images), and for ANY AIDetectedContentWatermarkPolicy value: Microsoft has not documented those values, so read the property first, tell the user that, and pass the value verbatim. Microsoft sets all or none. A value already in place is not sent. THE ANSWER IS THE READ-BACK: per property done / not done / could not tell, with the previous value and the call that restores it. Report that, never the fact that the call returned. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Change Microsoft Advertising account settings
  • set_openai_ads_negative_keywordsCURRENTLY UNAVAILABLE: OpenAI no longer serves account-level negative keywords.Reads text others writeNo findings

    Why it is in this group

    • The name "set_openai_ads_negative_keywords" 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
    CURRENTLY UNAVAILABLE: OpenAI no longer serves account-level negative keywords. The live API answers "Invalid URL" (measured 2026-09-13) and the endpoint left its published ChatGPT Ads spec the same week, so nothing can be set through Hermoso or any other API client. Tell the user that plainly instead of retrying. When it did work it REPLACED the whole account list, and the API never offered a way to read the current one.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Set ChatGPT Ads account negative keywords
    • idempotentHint: false
  • snapchat_ads_reportRead Snapchat ad performance — impressions, spend, swipes and video quartiles — at ad account, campaign, ad squad or ad level.Reads text others write1 finding

    Why it is in this group

    • The description's first verb is "read": 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 "snapchat_ads_report" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The description's first verb is "read": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Read Snapchat ad performance — impressions, spend, swipes and video quartiles — at ad account, campaign, ad squad or ad level. THREE THINGS TO KNOW BEFORE CALLING: granularity is required (TOTAL is the default); DAY and HOUR granularity REQUIRE startTime and endTime AND both must land exactly on the start of an hour, which Snapchat refuses otherwise and Hermoso refuses for free before spending the call; and SPEND COMES BACK IN MICRO-CURRENCY, so divide by 1,000,000 before quoting money to anyone. It changes nothing on the ad account; with async:true it starts a report file on Snapchat that is kept for seven days. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Snapchat ad performance
  • store_getRead one of this workspace’s data stores by key, for visibility into what the app holds — playbooks, swipefile, saved locations, avatars, creations, chats, brand, memory, skills.1 finding

    Why it is in this group

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    Read one of this workspace’s data stores by key, for visibility into what the app holds — playbooks, swipefile, saved locations, avatars, creations, chats, brand, memory, skills. Read-only, free. Allowed keys: heist.memory.v1, heist.skills.v1, heist.playbooks.v1, heist.avatars.v1, heist.locations.v1, heist.chats.v1, heist.creations.v1, heist.assets.v1, heist.brand.v1, adInspo.swipefile.v1. (The typed tools — list_memory / list_skills / get_brand — are friendlier for those; use store_get for the rest.)

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Read a workspace store
    • idempotentHint: true
  • stripe_balanceThe brand's Stripe balance (available and pending, per currency) and the most recent payouts with status and arrival date.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand's Stripe balance (available and pending, per currency) and the most recent payouts with status and arrival date. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: stripe balance
    • idempotentHint: true
  • stripe_reportRevenue from the brand's OWN Stripe account: gross, refunds, net and succeeded-charge count per day/week/month, new customers in the window, and active subscriptions + MRR where th…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Revenue from the brand's OWN Stripe account: gross, refunds, net and succeeded-charge count per day/week/month, new customers in the window, and active subscriptions + MRR where the key can read them. This is the money side of the loop — read an ad, a hook or a launch against real revenue instead of clicks. Default window is the last 30 days; a window with no charges answers a real zero, not a failed read. Read-only, never moves money, free. Needs Stripe connected (Connectors > Stripe, or connect_connector: paste a restricted key from Developers > Restricted keys).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Stripe revenue report
    • idempotentHint: true
  • submit_bing_webmaster_contentGive Bing a page's content DIRECTLY instead of waiting for it to crawl — for a page Bingbot renders badly or cannot reach.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "submit_bing_webmaster_content" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "crawl": 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.
    Description, as the server wrote it
    Give Bing a page's content DIRECTLY instead of waiting for it to crawl — for a page Bingbot renders badly or cannot reach. YOU PASS THE HTML AND NOTHING ELSE: Microsoft's httpMessage parameter is a base64 raw HTTP response whose status line and every header must end CRLF with exactly two CRLFs before the body, and an LF-only message is accepted with a 200 while indexing nothing useful — a silent wrong answer — so Hermoso builds that framing and computes Content-Length itself. Optional `structuredData` carries JSON-LD for non-HTML content such as images or PDFs; `dynamicServing` is left at "none" unless the site really does serve different content per device, because declaring otherwise is a claim about the customer's infrastructure. This spends the CONTENT submission budget, which is separate from the URL one and is read first — check both with bing_webmaster_submission_quota. Max 10MB per submission. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Hand Bing a page's content directly
    • idempotentHint: false
  • submit_bing_webmaster_sitemapRegister a sitemap with Bing so it discovers new and changed pages by itself — the durable twin of submit_bing_webmaster_urls, which spends a small per-site daily quota every time.Reads text others writeNo findings

    Why it is in this group

    • The name "submit_bing_webmaster_sitemap" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Register a sitemap with Bing so it discovers new and changed pages by itself — the durable twin of submit_bing_webmaster_urls, which spends a small per-site daily quota every time. Takes the sitemap's FULL URL, not a path. Bing accepts Sitemap, RSS 2.0, Atom 0.3, Atom 1.0 and plain text files (Microsoft's own list). A sitemap hosted on ANOTHER host is not refused — Bing allows that when the other host is also verified — but it is called out, because it is the likeliest reason one silently never crawls. SubmitFeed returns no body whatsoever, so the answer is read back from Bing's own feed list and reports what Bing says rather than that the call returned. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Register a sitemap with Bing
    • idempotentHint: false
  • submit_bing_webmaster_urlsSubmit URLs to Bing for indexing: asks Bing to crawl new or changed pages.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "submit_bing_webmaster_urls" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "crawl": it reads web pages, which anyone can write.
    • outboundThe input takes a URL (input.urls): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Submit URLs to Bing for indexing: asks Bing to crawl new or changed pages. THE SITE'S REMAINING DAILY QUOTA IS READ FIRST and a batch that would exceed it is refused with the real number rather than half-submitted, because Bing rejects an over-quota batch as a whole and a partial failure leaves you unable to say which URLs made it. Bing accepts at most 500 per batch (Microsoft's own limit) and the site's daily quota is usually far lower. THE CONFIRMATION IS BING'S QUOTA COUNTER MOVING: its submit methods return no body at all, so the answer reports the counter before and after rather than claiming success from a 200. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Submit URLs to Bing for indexing
    • idempotentHint: false
  • submit_indexnowPing the IndexNow search engines that pages were added, updated or deleted — Bing, Yandex, Naver, Seznam.cz and Yep, all reached by ONE submission.Reads text others writeCan send data out1 finding

    Why it is in this group

    • The name "submit_indexnow" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe input takes a URL (input.urls): a request to a URL can carry data to whoever runs it.

    Findings

    • Info

      The description mentions "credential".

      Matched text

      description: "...n. NO CONNECTION IS NEEDED, because the credential belongs to the USER: they generate a ke..."

      What this check looks for
    Description, as the server wrote it
    Ping the IndexNow search engines that pages were added, updated or deleted — Bing, Yandex, Naver, Seznam.cz and Yep, all reached by ONE submission. Important: GOOGLE DOES NOT PARTICIPATE IN INDEXNOW and never has, so say that plainly rather than letting anyone expect a Google effect; for Google use submit_search_console_sitemap and search_console_url_inspection. NO CONNECTION IS NEEDED, because the credential belongs to the USER: they generate a key, host it as a plain text file on their own web server, and any engine fetching that file is the whole ownership check. HERMOSO VERIFIES THAT FILE BEFORE SUBMITTING — that it is reachable and that its contents are exactly the key — and refuses with an explanation if not, because we have no write access to a customer's web root and cannot place it for them. If the key file is moved off the site root with `keyLocation`, it authorises ONLY URLs under that directory, and URLs outside it are refused before anything is sent (IndexNow rejects the whole batch for one out-of-scope URL). Up to 10,000 URLs per submission, all on the one host. HTTP 202 is a SUCCESS ("received, validation pending"), not a reason to retry. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Tell the IndexNow search engines a page changed
    • idempotentHint: false
  • submit_search_console_sitemapTell Google about a sitemap.Reads text others writeNo findings

    Why it is in this group

    • The name "submit_search_console_sitemap" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Tell Google about a sitemap. `feedpath` is the sitemap's COMPLETE URL ("https://example.com/sitemap.xml"), never a path — Google addresses a sitemap by its full url. Re-submitting one that is already registered is harmless and simply re-notifies Google. THE ANSWER IS READ BACK FROM GOOGLE, not echoed from the request: it reports whether the sitemap is now actually registered, whether Google has processed it yet, and what errors and warnings it already carries. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Submit a sitemap to Google
    • idempotentHint: false
  • submit_tiktok_ads_verificationSubmit a business or individual verification request for a TikTok ad account or Business Center.Reads text others writeNo findings

    Why it is in this group

    • The name "submit_tiktok_ads_verification" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Submit a business or individual verification request for a TikTok ad account or Business Center. IT DOES NOT UPLOAD ANY DOCUMENT AND HERMOSO NEVER HANDLES ONE: this sends the account details plus the ids of images the user already uploaded in TikTok Ads Manager, or the id of a document already on file that TikTok permits them to reuse; tiktok_ads_verification_status reports that id. A BUSINESS submission takes exactly one image id; an INDIVIDUAL one takes exactly two, the front and back of a single document. THE LEGAL NAME AND THE DOCUMENT NUMBER CANNOT BE CHANGED AFTERWARDS and must match the paperwork character for character, so this is confirm-gated: calling it without confirm sends nothing and returns a sentence naming exactly what would leave here. Submitting also needs real authority: TikTok requires admin or operator on an ad account, admin on a Business Center. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Submit a TikTok business or identity verification request
    • idempotentHint: false
  • sync_leads_to_salesforcePush the leads the brand's LEAD FORMS collected (Meta, LinkedIn, TikTok, X, Snapchat, ChatGPT Ads) into Salesforce as Leads.Reads text others writeNo findings

    Why it is in this group

    • The name "sync_leads_to_salesforce" says "sync": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Push the leads the brand's LEAD FORMS collected (Meta, LinkedIn, TikTok, X, Snapchat, ChatGPT Ads) into Salesforce as Leads. Someone already a contact or lead (matched by email) is left as they are; synced leads are remembered per brand, so a re-run or a second agent never makes twins. leadSource sets LeadSource (one of the org's picklist values); dryRun lists what would happen and writes nothing. Free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Push lead-form leads into Salesforce
    • idempotentHint: false
  • test_openai_ads_lead_formQueue an explicitly SYNTHETIC, signed test lead for a PUBLISHED lead form to the account’s lead-sync webhook, so the receiving system can be checked end to end.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
    Queue an explicitly SYNTHETIC, signed test lead for a PUBLISHED lead form to the account’s lead-sync webhook, so the receiving system can be checked end to end. expectedPublishedRevisionId is the form’s publishedRevisionId. The payload is marked synthetic; never count it as a lead.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Send a synthetic test lead
    • idempotentHint: false
  • tiktok_ads_audience_overlapHow much a TikTok audience overlaps with up to four others — the read that answers whether a new audience is genuinely new or is mostly the people you already target, which is what…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    How much a TikTok audience overlaps with up to four others — the read that answers whether a new audience is genuinely new or is mostly the people you already target, which is what stops two ad groups bidding against each other for the same person. TIKTOK SUPPRESSES ANY AUDIENCE SIZE UNDER 1,000, so a missing or blank size here means "fewer than 1,000", never "nobody" — reporting it as a zero would be a confidently wrong answer. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Compare how much two TikTok audiences share
    • idempotentHint: true
  • tiktok_ads_catalog_diagnosticsTikTok’s own diagnosis of a catalog — every detected issue at CRITICAL or WARNING level across product attributes, product review, catalog configuration, pixel/event problems and f…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    TikTok’s own diagnosis of a catalog — every detected issue at CRITICAL or WARNING level across product attributes, product review, catalog configuration, pixel/event problems and feed or file-upload failures, each carrying the reason AND TikTok’s suggested fix. This is the tool for "the feed ran and no products showed up" and for "my products were rejected and I do not know why". IT COVERS EVERY FEED IN THE CATALOG BY DEFAULT: naming a single feedId narrows it, and simply omitting the field at TikTok would silently report on the DEFAULT feed alone, so a multi-feed catalog with one broken feed would get a clean bill of health. Diagnostics regenerate once a day, so a fix made today may not clear until tomorrow’s run, and the reply says which day’s data it is. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Diagnose why a TikTok catalog is not working
    • idempotentHint: true
  • tiktok_ads_comment_threadThe conversation around a single comment on a TikTok ad: give it an ORIGINAL comment and you get that comment plus every reply to it; give it a REPLY and you get the reply plus the…Reads text others write1 finding

    Why it is in this group

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

    What it can reach

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

    Findings

    • Warn

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

      Matched text

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

      What this check looks for
    Description, as the server wrote it
    The conversation around a single comment on a TikTok ad: give it an ORIGINAL comment and you get that comment plus every reply to it; give it a REPLY and you get the reply plus the comment it answers. Use it before replying to a heated thread, so you answer what was actually said rather than the one line list_tiktok_ads_comments showed. Pages up to 1000 at a time, which is ten times what the list read allows. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read one TikTok ad comment with its replies
    • idempotentHint: true
  • tiktok_ads_creative_fatigueIs a creative WEARING OUT?Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Is a creative WEARING OUT? TikTok’s own creative-fatigue verdict per creative per day over the last 14 days, with spend and cost per conversion — the signal to make a fresh variation and swap it in. TikTok computes it for Upgraded Smart+ ad groups: pass the adgroupId and Hermoso reads every creative (ad material) in it, or name adMaterialIds. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok creative fatigue
    • idempotentHint: true
  • tiktok_ads_diagnosisTikTok’s issues-and-suggestions diagnosis for the ad groups on an ad account — its own read on why delivery is underperforming, in three categories: CREATIVE (no background music, …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    TikTok’s issues-and-suggestions diagnosis for the ad groups on an ad account — its own read on why delivery is underperforming, in three categories: CREATIVE (no background music, video too short, resolution too low), BID_AND_BUDGET (a suggested bid or budget, a recommendation to switch to Maximum Delivery, and the full Estimated Delivery Results tables pairing nine bid levels or fifteen budget levels with their estimated cost, conversions, CPA and impressions), and EVENT_TRACK (a pixel that has recorded nothing for seven days, which means the ad group is optimising toward an event nothing is firing). Every issue code comes back with a plain sentence saying what to DO about it. Warning: AN EMPTY ANSWER IS NOT A CLEAN BILL OF HEALTH: TikTok diagnoses ACTIVE ad groups only and omits any ad group it has no suggestions for, so a missing ad group is EITHER healthy OR not currently active and TikTok does not distinguish the two. At most 20 ad groups per call. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok’s own verdict on what is wrong with your ad groups
    • idempotentHint: true
  • tiktok_ads_pixel_statsEvent-level statistics for one TikTok pixel over a date range — how many times each event actually fired, which is how you tell a pixel that is installed and working from one that …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Event-level statistics for one TikTok pixel over a date range — how many times each event actually fired, which is how you tell a pixel that is installed and working from one that is installed and silent. Pass the pixelId or the pixelCode from list_tiktok_ads_pixels; default range is the last 7 days (UTC), at most 30. Counts are split into browser vs server per event. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read how often a TikTok pixel’s events fired
    • idempotentHint: true
  • tiktok_ads_reportUse this when the user asks how their TikTok ads performed.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Use this when the user asks how their TikTok ads performed. Performance for a TikTok advertiser account at campaign, ad group, ad or whole-advertiser level — spend, impressions, clicks, CTR, CPC, CPM and conversions by default, or whichever of TikTok’s metrics and grouping dimensions you name. `reportType` picks WHICH REPORT: BASIC is spend and performance (the default); AUDIENCE is the same money broken down by WHO SAW IT — pass an audience dimension such as age, gender, country_code or interest_category, which BASIC refuses outright. A report with ZERO rows genuinely means nothing delivered in that window — say exactly that, and never present zeros as measured performance. Read-only, free, spends nothing. NOTE: everything Hermoso creates on TikTok is created PAUSED, so a brand-new build reports nothing at all until somebody activates it with set_tiktok_ads_status(confirm:true) — check the statuses with list_tiktok_ads_campaigns before reading an empty report as bad performance.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok ads performance report
    • idempotentHint: true
  • tiktok_ads_review_infoTikTok’s own review verdict for up to 100 ads: approved everywhere (ALL_AVAILABLE), approved for only some of its targeting (PART_AVAILABLE — with the placements, locations, ages o…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    TikTok’s own review verdict for up to 100 ads: approved everywhere (ALL_AVAILABLE), approved for only some of its targeting (PART_AVAILABLE — with the placements, locations, ages or operating systems it is barred from), or rejected (UNAVAILABLE) — with TikTok’s REASONS and its SUGGESTED FIX per piece of content. Use it whenever an ad is not running or the user asks why it was rejected; fix it with update_tiktok_ads_ad. list_tiktok_ads_campaigns(includeReview:true) attaches the same verdict to every ad. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Why a TikTok ad was rejected
    • idempotentHint: true
  • tiktok_ads_rf_inventory_estimateReach & Frequency INVENTORY ESTIMATE — how many people TikTok can reach, for what budget, at what frequency, over a fixed window, before anything is booked.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Reach & Frequency INVENTORY ESTIMATE — how many people TikTok can reach, for what budget, at what frequency, over a fixed window, before anything is booked. THIS IS THE ONLY SANCTIONED SOURCE of the three numbers create_tiktok_ads_rf_ad_group needs (budget, purchasedImpression, purchasedReach), and that matters because TikTok does NOT refuse a reservation outside the range it estimated — it silently books its own maximum instead, so an invented number buys something nobody asked for. IMPRESSIONS AND REACH COME BACK IN THOUSANDS (110 means 110,000) and the create takes the same unit, so pass them back UNSCALED. Fix ONE of the three with rfPurchasedType (FIXED_BUDGET / FIXED_SHOW / FIXED_REACH) and TikTok predicts the other two; omit it to get the whole range. Reach & Frequency is ALLOWLIST-ONLY per ad account. Read-only, free, books nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Estimate TikTok Reach & Frequency inventory
    • idempotentHint: true
  • tiktok_ads_rule_resultsEVERY EXECUTION OF THE USER’S AUTOMATED RULES — when each ran, what it acted on and what it changed.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    EVERY EXECUTION OF THE USER’S AUTOMATED RULES — when each ran, what it acted on and what it changed. THIS IS THE ONLY PLACE THEY WILL SEE IT: TikTok routes rule notification emails to the developer address registered on the app rather than to the advertiser, so an armed rule can pause campaigns or raise budgets on their account and nothing reaches their inbox. Call it with no ids to list executions (optionally filtered by rule, action, dimension or a UTC time window); pass ruleId AND execId TOGETHER, both taken from one row of that list, for the detail of a single run — TikTok keys a result on the pair, so half of one is refused rather than answered about the wrong thing. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What TikTok’s automated rules actually did
    • idempotentHint: true
  • tiktok_ads_video_retentionPer-SECOND performance for TikTok ad videos — which second viewers swipe away on, the share still watching at 2s and 3s, and the biggest single drop: the hook read for the next var…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Per-SECOND performance for TikTok ad videos — which second viewers swipe away on, the share still watching at 2s and 3s, and the biggest single drop: the hook read for the next variation. reportType AD (default) reads ads by adIds, adgroupIds or campaignIds with per-second views, clicks, drop-offs, likes and shares; reportType VIDEO reads ONE video’s lifetime retain/drop-off curve by videoId. Covers the first 60 seconds; data lags about an hour; an ad that never served has none. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok per-second video retention
    • idempotentHint: true
  • tiktok_bid_protectionWhether TikTok's BID PROTECTION is covering a Smart+ campaign or ad group, and what it actually paid back.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Whether TikTok's BID PROTECTION is covering a Smart+ campaign or ad group, and what it actually paid back. Bid protection compensates in AD CREDITS when delivery misses the bid, so this answers two different questions from one tool: with no dates it returns today's coverage STATUS per id; with startDate and endDate it returns the day-by-day HISTORY, each row carrying the credit amount and currency. Smart+ objects ONLY — a classic TikTok campaign id does not resolve here. TikTok keeps 60 days, and the two endpoints size differently: status takes up to 200 ids, history allows 200 DIVIDED BY the day span (a 10-day window takes 20 ids), which is refused here with the arithmetic done rather than by TikTok with it left to you. An id TikTok says nothing about is NAMED in the reply, because a short list otherwise reads as 'those are unprotected'. Read-only, 0 credits.

    Annotations the server declares

    • destructiveHint: false
    • readOnlyHint: true
    • openWorldHint: true
    • title: TikTok bid protection status and credit history
    • idempotentHint: true
  • tiktok_creator_leaderboardThe creators ranking highest on TikTok’s own Creator Leaderboard for one category over one week or month; up to 100, best first, with how far each moved since the previous period.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The creators ranking highest on TikTok’s own Creator Leaderboard for one category over one week or month; up to 100, best first, with how far each moved since the previous period. US ONLY: TikTok publishes ranking data for no other country. labelId must MATCH rankingType: BRANDED_CONTENT takes an INDUSTRY label and ORGANIC_CONTENT takes a CONTENT label, both from list_tiktok_creator_labels(labelType:"RANKING"): and the mismatch is refused here rather than at TikTok, which reports it only as an invalid field. A leaderboard is a SNAPSHOT taken when the rank was generated, so TikTok warns a creator may still appear under a label they have since lost. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read TikTok’s Creator Leaderboard
    • idempotentHint: true
  • tiktok_lead_ads_termsTikTok’s Lead Generation Ads terms for an ad account — whether they are accepted, and the link to read them.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    TikTok’s Lead Generation Ads terms for an ad account — whether they are accepted, and the link to read them. TikTok refuses every Instant-Form lead ad (create_tiktok_ads_ad with pageId) until the ad account has accepted them. Without confirm this only READS and changes nothing. Accepting is the ADVERTISER’s legal act: show the user the terms link and pass confirm:true ONLY after they say they accept. The result is read back from TikTok. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: TikTok Lead Ads terms: check or accept
    • idempotentHint: false
  • tiktok_spark_recommendationsWhich organic TikTok posts are worth running as Spark Ads: TikTok rates the connected account’s posts HIGH / MEDIUM / LOW, optionally for an objective (REACH, TRAFFIC, VIDEO_VIEWS,…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Which organic TikTok posts are worth running as Spark Ads: TikTok rates the connected account’s posts HIGH / MEDIUM / LOW, optionally for an objective (REACH, TRAFFIC, VIDEO_VIEWS, ENGAGEMENT, APP_PROMOTION, LEAD_GENERATION, WEB_CONVERSIONS, PRODUCT_SALES) and period (PAST_ONE_MONTH / THREE / SIX). Pass ttoAccountId to rate TikTok One creator-marketplace posts instead. Run a HIGH one with create_tiktok_ads_ad(tiktokItemId). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Which TikTok posts to boost
    • idempotentHint: true
  • tiktok_tto_campaign_reportHow each creator video on a TikTok One campaign actually performed, with EVERY HEADLINE METRIC SPLIT ORGANIC VERSUS PAID: views, reach, engagement rate, likes, comments, shares, fa…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    How each creator video on a TikTok One campaign actually performed, with EVERY HEADLINE METRIC SPLIT ORGANIC VERSUS PAID: views, reach, engagement rate, likes, comments, shares, favourites, completion rate, average view time; plus audience breakdowns and any anchor clicks. That split is the question an influencer campaign exists to answer: did the creator’s own audience carry the video, or did the media spend. Give startDate and endDate TOGETHER to also get day-by-day figures; giving one without the other is refused, because TikTok requires each whenever the other is present. TikTok reports one country per call and will only accept one of the CAMPAIGN’s own countries, so it is read off the campaign rather than guessed. Two TikTok behaviours worth passing on: reporting is backfilled if a creator tags a video retroactively, and campaigns created through the API do NOT show their reporting on the TikTok One website, so this is the only place it appears. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Report on a TikTok One creator campaign
    • 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_apple_ads_assetUpload an image into the Apple Ads asset library for an APPLE MAPS brand creative.Reads text others writeNo findings

    Why it is in this group

    • The name "upload_apple_ads_asset" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Upload an image into the Apple Ads asset library for an APPLE MAPS brand creative. APPLE MAPS ONLY, and that is Apple’s rule rather than ours: it refuses uploads for App Store apps outright, because an App Store ad is rendered from the app’s product page in App Store Connect and not from an image anyone uploads. That refusal is stated up front instead of being sent and rejected, so if you want a different-looking App Store ad the answer is App Store Connect, not this tool. PNG, JPG or HEIC. Pass imageUrl (upload_file turns a local file into one) and mapsBrandId, which list_apple_ads_brands returns. Apple processes the upload asynchronously, so re-read it with list_apple_ads_assets until its eligibility says it is ready before referencing it in a creative. Uploading spends nothing. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Upload an Apple Ads image asset
    • idempotentHint: false
  • upload_applovin_ads_assetsUpload videos, images or an HTML playable to AppLovin from Hermoso render or Library urls or public files (mp4, mov, jpg, png, gif, html; up to 40).Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_applovin_ads_assets" 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.urls): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Upload videos, images or an HTML playable to AppLovin from Hermoso render or Library urls or public files (mp4, mov, jpg, png, gif, html; up to 40). Returns AppLovin asset ids once processed; pass uploadId to check a pending upload again. New assets go through AppLovin review. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload assets to AppLovin
  • 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 — but LinkedIn (posts and ad creatives), Pinterest, the YouTube thumbnail and upload_google_ads_asset upload the BYTES themselves and therefore refuse an external host, so run it through here first and pass the URL this returns. When in doubt, use this: its URL works everywhere. (Calling the underlying HTTP route directly? POST /api/upload takes the file's RAW BYTES as the request body with its own content-type — NOT multipart/form-data — or ?url=<link> with no body.) Returns {url, kind, bytes}.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a local file -> durable public URL
  • upload_google_ads_assetAdd a creative to a Google Ads account’s ASSET LIBRARY so it can be used in ads.Reads text others writeNo findings

    Why it is in this group

    • The name "upload_google_ads_asset" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add a creative to a Google Ads account’s ASSET LIBRARY so it can be used in ads. It does NOT have to be a Hermoso render — the user’s own creative is the normal case; the URL just has to be Hermoso-HOSTED because we fetch the bytes, so run any file of theirs through upload_file and pass the URL it returns. For an IMAGE, pass imageUrl (≤5MB); an arbitrary external/CDN URL is refused. For VIDEO, Google Ads uses YouTube-hosted videos — post the video to YouTube as UNLISTED first, then pass its youtubeVideoId here. For a PLAYABLE (App campaigns), pass playableUrl: an HTML5 zip with <!DOCTYPE html>, an ad.orientation meta tag and no outside files except Google's own (exitapi.js, Google Fonts); add appAdId to put it on an App ad. Returns the asset resource name. Pass customerId (from list_google_ads_campaigns).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a creative to Google Ads
  • upload_meta_assetUpload creative(s) — a finished Hermoso ad OR arbitrary user files (e.g.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_meta_asset" 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
    Upload creative(s) — a finished Hermoso ad OR arbitrary user files (e.g. A folder of media from the user’s desktop) — into a connected ad account’s ASSET LIBRARY so the user or a later ad-build step can use them in their OWN campaigns. Pass `url` for one file, or `urls` (up to 20) to BULK-upload in a single call. Each accepts a public https URL, a data: URI, or a Hermoso /generated path; for LOCAL files call upload_file first and pass the url(s) it returns. Image -> image hash; video -> video id.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload an asset to a Meta ad account
  • upload_meta_playableUpload a PLAYABLE ad (an interactive HTML game the advertiser already has) to a Meta ad account.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_meta_playable" 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
    Upload a PLAYABLE ad (an interactive HTML game the advertiser already has) to a Meta ad account. Pass url: ONE HTML file up to 2 MB, or a zip up to 5 MB (under 100 files) with index.html at the top; it must call FbPlayableAd.onCTAClick() and load nothing from outside. Hermoso checks those rules first and refuses a file Meta would reject. Returns playableAssetId: build the ad with create_meta_ad(playableAssetId, adSetId of an App Installs ad set, ONE lead-in video). Meta has no way to delete a playable once uploaded. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a playable ad to Meta
  • upload_microsoft_ads_videoUpload videos (a Hermoso render, or the user’s own clip: any direct-download https file or an upload_file URL) to Microsoft Advertising, or check ones already uploaded with videoId…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_microsoft_ads_video" 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.urls): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    Upload videos (a Hermoso render, or the user’s own clip: any direct-download https file or an upload_file URL) to Microsoft Advertising, or check ones already uploaded with videoIds: Draft (still processing), Active, or Failed with Microsoft’s reason. Microsoft enables video per account and refuses clips under 6 seconds. Use the ids in create_microsoft_ads_image_ad(videoIds). Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a video to Microsoft Advertising
  • upload_reddit_ads_assetsStore creatives in the Reddit Ads ASSET LIBRARY for a profile: images and videos (from a public https url — Reddit downloads it; a video may carry a posterUrl), HEADLINE text, and …Reads text others writeNo findings

    Why it is in this group

    • The name "upload_reddit_ads_assets" says "upload": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Store creatives in the Reddit Ads ASSET LIBRARY for a profile: images and videos (from a public https url — Reddit downloads it; a video may carry a posterUrl), HEADLINE text, and CTA labels from Reddit’s fixed list (Shop Now, Learn More, Sign Up, …). 1–20 per call. Processing is asynchronous: the reply is read back from the library after polling (up to ~20s) and says which assets are ACTIVE, which Reddit REJECTED and why, and which are still processing (finish those with get_reddit_ads_asset_uploads). A Reddit MAX campaign builds its ads from these assets: pass the ACTIVE ids to create_reddit_ads_max_campaign (at least 3 HEADLINE and 2 IMAGE or VIDEO). A standard post-based ad does not take an asset id. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload creatives to the Reddit asset library
  • upload_tiktok_ads_creativePut a finished creative onto the TikTok AD ACCOUNT so an ad can point at it — this is the bridge between making an ad and running one, and create_tiktok_ads_ad has no other source …Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_tiktok_ads_creative" 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
    Put a finished creative onto the TikTok AD ACCOUNT so an ad can point at it — this is the bridge between making an ad and running one, and create_tiktok_ads_ad has no other source for the ids it needs. Pass the public https url of a Hermoso render (every render already is one) or any other public https file; TikTok fetches it from its own servers, so a local path, a data: url or anything on http:// is refused here for free. A VIDEO UPLOAD ALSO UPLOADS ITS OWN COVER and hands back coverImageId — pass that straight to create_tiktok_ads_ad as imageIds, because TikTok requires a cover on a video ad and rejects any whose dimensions differ from the video. CHECK usableInAds BEFORE BUILDING THE AD: TikTok happily accepts a creative it will then refuse to build an ad from, and says so only in this flag — a 720x1280 render is fine and a 496x864 one is not, so a false here means re-render larger, and the note says so. Uploading the same file twice is fine; TikTok refuses a repeated file NAME, so leave fileName out unless you want a specific label in TikTok Ads Manager. Free — TikTok charges nothing for storage and Hermoso bills no credits for this.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Upload a video or image into a TikTok advertiser’s asset library
    • idempotentHint: false
  • upload_tiktok_ads_playableUpload a PLAYABLE ad (an interactive HTML game the advertiser already has) into a TikTok advertiser's Creative Library.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_tiktok_ads_playable" 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
    Upload a PLAYABLE ad (an interactive HTML game the advertiser already has) into a TikTok advertiser's Creative Library. Pass url: a zip with index.html and config.json ({"playable_orientation": 0|1|2}) at the top level. Hermoso checks it against TikTok's rules first (no MRAID, calls window.openAppStore(), loads TikTok's playable SDK, no other outside files, under 5 MB) and refuses a file TikTok would reject, then TikTok validates it and it is saved to the library. The reply carries playableUrl: pass it to create_tiktok_smart_ad as playableUrls. TikTok runs playables only in App Promotion Smart+ ads with a video, for advertisers it has allowlisted. Pass playableId instead of url to finish one TikTok was still checking. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • title: Upload a playable ad to TikTok
  • upload_x_ads_mediaUpload an image or video (any URL — a Hermoso render, an upload_file URL, a public file) to an X ad account and return its media_key, for create_x_ads_card or create_x_ads_post.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "upload_x_ads_media" 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
    Upload an image or video (any URL — a Hermoso render, an upload_file URL, a public file) to an X ad account and return its media_key, for create_x_ads_card or create_x_ads_post. Added to the ad account's Media Library and read back. A card image must be 1:1 ≥600×600, 1.91:1 ≥600×314, 16:9 ≥600×337, 9:16 ≥600×1066, 2:3 ≥600×900 or 4:5 ≥600×750. Free.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Upload media to an X ad account
    • idempotentHint: false
  • use_brandPin which profile this connection acts on.No findings

    Why it is in this group

    • The description's first verb is "pin": a word for a change.
    Description, as the server wrote it
    Pin which profile this connection acts on. Pass the profile id or exact name from list_brands. Works for your own profiles AND one another account SHARED with you (pass its name or the profile id list_brands prints); access is verified against your real membership before it is pinned. Persists for this API key until changed, on every surface (hosted connector included — no environment variables, no restart). On a signed-in connector it also moves every other Hermoso connector the same person signed in from the same app (e.g. all the Hermoso connectors in Claude), so they act on one profile.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Switch profile
  • vercel_event_analyticsVercel CUSTOM EVENTS, the CONVERSIONS on a Vercel-hosted site (signups, purchases, any track('Name') from @vercel/analytics): the count and unique visitors over a window, and with …Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Vercel CUSTOM EVENTS, the CONVERSIONS on a Vercel-hosted site (signups, purchases, any track('Name') from @vercel/analytics): the count and unique visitors over a window, and with `by` a breakdown by eventName, eventData/<property> (e.g. eventData/plan), utmSource / utmMedium / utmCampaign / utmContent / utmTerm (which ad or campaign drove the conversion), requestPath, country and the rest, or a time step. Up to TWO at once, e.g. by 'utmCampaign,eventName' or 'day,utmCampaign'. eventName narrows to one event. This is the conversion half of an ad report for a landing page on Vercel; vercel_web_analytics is the traffic half. Custom events need Web Analytics on and a Vercel Pro or Enterprise plan. Read-only, free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Vercel custom events (conversions)
  • vercel_web_analyticsVercel WEB ANALYTICS for one project: page views and unique visitors over a window (default the last 30 days, production traffic), and with `by` a breakdown by requestPath (which p…Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Vercel WEB ANALYTICS for one project: page views and unique visitors over a window (default the last 30 days, production traffic), and with `by` a breakdown by requestPath (which pages), referrerHostname (where visitors came from), country, deviceType, osName, browserName, route, utmSource / utmMedium / utmCampaign / utmContent / utmTerm (which campaigns and ads brought them), or a time step (day, week, month). Use it to see which landing pages and ad campaigns actually bring traffic. Needs Web Analytics turned on for the project in Vercel. Read-only, free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Vercel Web Analytics
  • verify_bing_webmaster_siteAsk Bing to CHECK the ownership proof for a site already on the account.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
    Ask Bing to CHECK the ownership proof for a site already on the account. IT DOES NOT PLACE THE PROOF — nothing can over an API. The user puts an XML file at the site root, a meta tag in the home page <head>, or a CNAME DNS record, and Bing Webmaster Tools shows the exact filename and value for each. A negative answer therefore means "the proof is not in place yet", never that Hermoso or the connection failed, and the reply says which three options exist. Bing refuses to verify a site that was never added, which is knowable for free, so that is refused here with add_bing_webmaster_site named as the fix. The verdict is read back from the site LIST rather than taken from the call's own return value — the two can disagree. 0 credits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
    • title: Ask Bing to verify site ownership
    • idempotentHint: false
  • x_ads_reportPerformance stats for X campaigns, line items or promoted posts.Reads text others writeNo findings

    Why it is in this group

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

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Performance stats for X campaigns, line items or promoted posts. `placement` here is SINGULAR and comes from a FOUR-value set (ALL_ON_TWITTER / PUBLISHER_NETWORK / SPOTLIGHT / TREND) — deliberately not the twelve placements a line item accepts; do not carry one across. THE TRAP THIS REPORTS: an entity id that does not exist on the account answers 200 with every metric null, which is indistinguishable from a real zero, so an all-null response is FLAGGED rather than narrated as zero performance. Max 20 ids per call. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: X ads performance report
    • idempotentHint: true
Only reads 265Show 265 read-only tools
  • amplitude_chartREAD BACK A SAVED AMPLITUDE CHART by its id — the chart the user already built in Amplitude's own UI, with whatever segments, filters and date range they configured there.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    READ BACK A SAVED AMPLITUDE CHART by its id — the chart the user already built in Amplitude's own UI, with whatever segments, filters and date range they configured there. This is the saved-chart read for Amplitude, and it is the right lane whenever the report already exists: you inherit their definitions instead of rebuilding them from a segmentation query, and it costs one call rather than several. THE CHART ID MUST COME FROM THE USER — Amplitude publishes no endpoint that lists a project's charts — and it is the segment after '/chart/' in the chart's URL (e.g. 'abc123' in https://analytics.amplitude.com/demo/chart/abc123); pasting the whole URL works too. THE RESPONSE SHAPE VARIES BY CHART TYPE, in Amplitude's own words, so read what comes back rather than assuming a series: it may be JSON or a text/CSV body, and BOTH are correct answers rather than one being an error. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a saved Amplitude chart
    • idempotentHint: true
  • apple_ads_search_term_popularityThe most-searched App Store terms in a genre and market — MARKET-WIDE DEMAND, not your own performance, so it works for finding terms to target before you have spent anything.Reads text others writeNo findings

    Why it is in this group

    • The name "apple_ads_search_term_popularity" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The most-searched App Store terms in a genre and market — MARKET-WIDE DEMAND, not your own performance, so it works for finding terms to target before you have spent anything. Cross-read it against apple_ads_impression_share: a term ranking high here where your impression share is low is exactly where budget or bid is leaving installs on the table. Rows carry rankInGenre, searchPopularityInGenre and searchPopularity1to100 (1–100, in genre / all genres) and searchPopularity1to5. granularity WEEKLY_SUN_SAT uses fixed Sunday–Saturday weeks generated Mondays at 07:00 UTC with 65 weeks of retention; MONTHLY uses calendar months refreshed on the 5th UTC with 15 months of retention — an empty result for a very recent window usually means Apple has not generated that period yet rather than that there is no demand. NOTE THE GRANULARITY SETS DIFFER between the two insights reports: DAILY exists on impression share and NOT here. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Apple Ads search term popularity
    • idempotentHint: true
  • 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
  • bing_webmaster_query_statsUse this when the user asks what people searched on Bing to reach their site, or which pages those searches landed on.Reads text others writeNo findings

    Why it is in this group

    • The name "bing_webmaster_query_stats" says "query": 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
    Use this when the user asks what people searched on Bing to reach their site, or which pages those searches landed on. Modes: "queries" (top search terms for the site, the default), "pages" (top pages), "pageQueries" (which queries brought traffic to one `page`), "queryPages" (which pages one `query` landed on), "queryPageDetail" (one query on one page, day by day). MICROSOFT UPDATES THIS DATA WEEKLY by their own statement, so it does not move day to day; do not report a flat week as a drop. An unknown mode is refused by name. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What people searched on Bing, and which pages they landed on
    • idempotentHint: true
  • check_tiktok_creator_statusWhether particular TikTok handles have joined TikTok One, up to 20 at a time, with each answered IN (can be invited), NOT_IN (a real account that has not joined) or INVALID (not a …Reads text others writeNo findings

    Why it is in this group

    • The name "check_tiktok_creator_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Whether particular TikTok handles have joined TikTok One, up to 20 at a time, with each answered IN (can be invited), NOT_IN (a real account that has not joined) or INVALID (not a handle TikTok knows). WORTH CALLING BEFORE INVITING ANYONE: a creator who has not joined cannot be invited, and TikTok reports that as a 200 with the handle in a failed list rather than as an error; so an unchecked invite looks like it worked and quietly reached nobody. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check whether TikTok handles have joined TikTok One
    • idempotentHint: true
  • describe_salesforce_objectEvery field a create or update can set on a Salesforce contact, lead, account or opportunity: API name, label, type, whether it is required, and each picklist's active values (lead…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "describe_salesforce_object" says "describe": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "contact": it reads contacts.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Every field a create or update can set on a Salesforce contact, lead, account or opportunity: API name, label, type, whether it is required, and each picklist's active values (lead status, lead source, industry), plus the opportunity stages with closed and won flags. search narrows by name or label. Read-only, free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Salesforce fields and picklists
    • idempotentHint: true
  • discover_tiktok_creatorsSearch TikTok One for creators, filtered by audience size, engagement rate, median and average views, starting price, language, content and industry category, and by their FOLLOWER…Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Search TikTok One for creators, filtered by audience size, engagement rate, median and average views, starting price, language, content and industry category, and by their FOLLOWERS’ country, gender split and age band. FOUR THINGS THAT ARE EASY TO GET WRONG AND ARE ALL REFUSED FOR FREE BEFORE THE CALL: countryCodes is required; every country in ONE search must come from the same regional category, which TikTok defines as the US, Europe (DE/ES/FR/GB/IT) and everywhere else, so a US+UK search has to be two searches; engagement rates are 0-1 rather than percentages, so 5% is 0.05; and stateProvinces works only when the country is exactly US. THIS IS NOT A TIKTOK SEARCH: it sees only creators who have JOINED the Creator Marketplace, so a narrow filter set empties fast and the fix is to widen the follower or engagement range rather than to conclude the category is empty. Profile image URLs carry their own expiry, so show them and do not store them. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search TikTok One for creators to work with
    • 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_google_ads_locationsLook up Google Ads location targets by name — turns "Toronto" / "California" / "United Kingdom" into the geo target ids Google needs, with each one's type (COUNTRY, STATE, CITY, PO…Reads text others writeNo findings

    Why it is in this group

    • The name "find_google_ads_locations" says "find": 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
    Look up Google Ads location targets by name — turns "Toronto" / "California" / "United Kingdom" into the geo target ids Google needs, with each one's type (COUNTRY, STATE, CITY, POSTAL_CODE…) and reach. Use it when a location name is ambiguous, or to show the user exactly which place you are about to target. Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up Google Ads locations
    • idempotentHint: true
  • find_meta_audiencesLook up the Meta targeting ids you need before building an ad set — interests, behaviours, cities/regions/zips/DMAs, languages, employers, job titles and schools.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "find_meta_audiences" says "find": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "dm": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "dm": it reads messages, which other people can write.
    Description, as the server wrote it
    Look up the Meta targeting ids you need before building an ad set — interests, behaviours, cities/regions/zips/DMAs, languages, employers, job titles and schools. type:"adinterest" (q:"yoga") returns interest ids + audience size; type:"adTargetingCategory" with class:"behaviors" returns behaviour ids; type:"adgeolocation" (q:"Toronto", optionally locationTypes:"city") returns the geo KEYS that go in targeting.geo.cities/regions/zips; type:"adlocale" (q:"french") returns language ids for targeting.locales. Read-only and free. Use it whenever the user names an audience in words — never guess an id.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Look up Meta targeting ids
    • idempotentHint: true
  • find_toolsSearch EVERY Hermoso tool — your starting list is deliberately short, and everything else in the product is here — by name, task or group.No findings

    Why it is in this group

    • The name "find_tools" says "find": a word for reading.
    Description, as the server wrote it
    Search EVERY Hermoso tool — your starting list is deliberately short, and everything else in the product is here — by name, task or group. Each row gives the tool's PARAMETERS in one line, its CREDIT COST (free means free on every plan; a tool that runs a model quotes the live per-model figure) and its recent HEALTH on this server (failure rate and typical duration, or "no recent calls", which means unseen and not broken). Use it the moment the user asks for something you do not see a tool for (a campaign, an ad set, a lead form, a click-to-WhatsApp ad, a report, keywords, audiences): a tool missing from your list is NEVER proof the feature is missing. Then RUN the tool you found with call_tool({name, args}): search, then run, two calls for any tool in the product. A tool that is failing or needs a connector this workspace has not made is ranked last and marked, never hidden — pass onlyHealthy:true if you want those left out. Free, read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Find a Hermoso tool by name or task
  • get_analytics_stream_setupTHE GTAG SNIPPET TO PASTE, plus what that web stream is actually set to collect.Reads text others writeNo findings

    Why it is in this group

    • The name "get_analytics_stream_setup" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "web": it reads web pages, which anyone can write.
    Description, as the server wrote it
    THE GTAG SNIPPET TO PASTE, plus what that web stream is actually set to collect. list_analytics_data_streams gives the measurement ID and stops one step short of what someone installing GA4 needs, which is the finished <script> block — Google returns it verbatim and marks it immutable. The same call answers the two questions that come next: whether ENHANCED MEASUREMENT is collecting scrolls, outbound clicks, site search, video, downloads, form interactions and single-page-app page views, and whether client-side REDACTION is stripping emails or query parameters out of recorded URLs. Read the master switch before believing a toggle: if enhanced measurement is off for the stream, every individual toggle is inert whatever it says. WEB STREAMS ONLY — all three resources are web-stream resources, and an app stream is refused by name with what it has instead. Any half that could not be read comes back null, which means unknown and not off. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: GA4 install tag and stream settings
  • get_apple_ads_ad_accountThe full record for an Apple Ads ad account — its name, currency, timezone, payment model, productFeatures and the advertiser resources delegated to it.Reads text others writeNo findings

    Why it is in this group

    • The name "get_apple_ads_ad_account" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The full record for an Apple Ads ad account — its name, currency, timezone, payment model, productFeatures and the advertiser resources delegated to it. Called with no id it returns the account this connection is pinned to. THE FIELD THAT DECIDES WHAT THIS ACCOUNT CAN DO IS productFeatures, and it is IMMUTABLE: APPSTORE_APP_MANUAL can never run Apple Maps ads and BUSINESS_BRAND_MANUAL can never run App Store ads, so an organization that needs both keeps a separate ad account for each. currency, timeZone and paymentModel are inherited from the organization and are immutable too — which is why a campaign’s amounts must be in this currency and cannot be mixed. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Get an Apple Ads ad account
    • idempotentHint: true
  • 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_hubspot_lead_syncWhether the brand's lead-form leads are pushed into HubSpot AUTOMATICALLY: on or off, how often (everyMinutes), which platforms, when it runs next, and what the last run did — coun…No findings

    Why it is in this group

    • The name "get_hubspot_lead_sync" says "get": a word for reading.
    Description, as the server wrote it
    Whether the brand's lead-form leads are pushed into HubSpot AUTOMATICALLY: on or off, how often (everyMinutes), which platforms, when it runs next, and what the last run did — counts per platform, or why it did not run (HubSpot disconnected, a platform not readable). Read-only, free. Needs HubSpot connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Read the automatic HubSpot lead sync
    • idempotentHint: true
  • get_instructionsFree.No findings

    Why it is in this group

    • The name "get_instructions" says "get": a word for reading.
    Description, as the server wrote it
    Free. Hermoso's instructions on demand: a topic (areas, instagram, capabilities, roster, safety, credits, setup, all) for the rest of the session instructions, any tool's name for its FULL rules, or "paid-calls" for get_cost, expected_credits, idempotency_key, revision and context.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Read Hermoso's full instructions
  • get_jobPoll a render job by id.No findings

    Why it is in this group

    • The name "get_job" says "get": a word for reading.
    Description, as the server wrote it
    Poll a render job by id. Returns status (queued|running|done|error), progress, and on done the served media URL. Renders take 1–3 minutes: keep calling this until done/error without asking the user — several calls is normal, not a stall. An id that does not exist on this account answers status "not_found" — that is FINAL: stop polling it, and do not re-fire the render (that double-charges).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Get render job
    • idempotentHint: true
  • get_linkedin_boostRead ONE existing LinkedIn boost back from LinkedIn: status, objective, total budget, schedule, audience, political declaration and forecast.Reads text others writeNo findings

    Why it is in this group

    • The name "get_linkedin_boost" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read ONE existing LinkedIn boost back from LinkedIn: status, objective, total budget, schedule, audience, political declaration and forecast. Name the boosted post (pass organization for a Page post). Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a LinkedIn boost
    • idempotentHint: true
  • get_meta_ad_accountRead a Meta AD ACCOUNT’s BILLING and DELIVERY state: account status in words (ACTIVE, DISABLED, UNSETTLED unpaid balance, IN_GRACE_PERIOD failed payment, PENDING_RISK_REVIEW, CLOSE…Reads text others writeNo findings

    Why it is in this group

    • The name "get_meta_ad_account" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "review": it reads comments, which other people can write.
    Description, as the server wrote it
    Read a Meta AD ACCOUNT’s BILLING and DELIVERY state: account status in words (ACTIVE, DISABLED, UNSETTLED unpaid balance, IN_GRACE_PERIOD failed payment, PENDING_RISK_REVIEW, CLOSED…) with the disable reason; currency and time zone; BALANCE (the bill amount due); AMOUNT SPENT; SPEND CAP and how much is left under it (none means no account spending limit); the minimum daily budget; whether it is a PREPAID account; and the PAYMENT METHOD / FUNDING SOURCE (card, PayPal, prepaid funds / stored balance, invoice, credit line). Every amount is converted from Meta’s minor units into the account currency. Use it for “what is my Meta ad balance”, “how much prepaid funds are left”, “which card pays for my ads”, “why are my ads not delivering”, and before activating anything. IT CANNOT ADD PREPAID FUNDS OR CHANGE THE PAYMENT METHOD — Meta publishes no API for either, so the reply links the account’s page in Meta Billing (Ads Manager > Billing & payments) where the user does it; say so rather than looking for another tool. If Meta refuses the billing fields to this connection (the connected person lacks the MANAGE role on the account), the reply says the funding source could not be read, which is not the same as having none. Meta fields read: account_status, the disable reason, balance, amount_spent, spend_cap, min_daily_budget, is_prepay_account, funding_source_details. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Meta ad account’s billing and status
    • idempotentHint: true
  • get_microsoft_ads_account_propertiesRead a Microsoft Advertising ad account’s account-level settings (Microsoft’s GetAccountProperties): TrackingUrlTemplate, FinalUrlSuffix, MSCLKIDAutoTaggingEnabled, AdClickParallel…Reads text others writeNo findings

    Why it is in this group

    • The name "get_microsoft_ads_account_properties" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Read a Microsoft Advertising ad account’s account-level settings (Microsoft’s GetAccountProperties): TrackingUrlTemplate, FinalUrlSuffix, MSCLKIDAutoTaggingEnabled, AdClickParallelTracking, IncludeViewThroughConversions, ProfileExpansionEnabled, AllowImageAutoRetrieve, BusinessAttributes, AssetAIEnhancementOptout, AIDetectedContentWatermarkPolicy and the rest Microsoft returns, each flagged settable or read-only here. A property Microsoft does not return is reported as UNREAD (often a feature that has not reached the account yet), never as off or empty. AIDetectedContentWatermarkPolicy is the account-level AI-detected content watermark policy; Microsoft has not documented its values, so report what the account stores verbatim and do not guess what it means. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read Microsoft Advertising account settings
    • 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_openai_ads_audienceRead one ChatGPT Ads custom audience: its processing status, how many users matched, what it can actually be USED for, and its membership revision.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_audience" 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 server marks it openWorldHint: true: it reaches things outside the server's own data.
    • 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 one ChatGPT Ads custom audience: its processing status, how many users matched, what it can actually be USED for, and its membership revision. Read-only, free. STATUS is not the same question as eligibility — "ready" only means processing succeeded. EXCLUSION (suppression) has NO minimum size, but INCLUSION and bid multipliers need roughly 25,000 matched users, so a small list used for inclusion simply never serves. The membershipRevision this returns is what update_openai_ads_audience_members REQUIRES for a replace.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read one ChatGPT Ads custom audience
    • idempotentHint: true
  • get_openai_ads_audience_operationPoll an add/remove/replace submitted by update_openai_ads_audience_members until it reports succeeded or failed.Reads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_audience_operation" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Poll an add/remove/replace submitted by update_openai_ads_audience_members until it reports succeeded or failed. Read-only, free. Until it succeeds the membership has NOT changed, so never report an audience update as done on the strength of the submission alone.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check a ChatGPT Ads audience membership operation
    • idempotentHint: true
  • get_openai_ads_business_agentOne Business Agent with its full configuration and publish state.Reads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_business_agent" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    One Business Agent with its full configuration and publish state. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a ChatGPT Ads Business Agent
    • idempotentHint: true
  • get_openai_ads_feed_settingsA product feed’s name, countries and whether its organic ChatGPT search listing respects each product’s is_eligible_search flag.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_feed_settings" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    A product feed’s name, countries and whether its organic ChatGPT search listing respects each product’s is_eligible_search flag. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a ChatGPT Ads feed’s settings
    • idempotentHint: true
  • get_openai_ads_feed_sftpWhether SFTP bulk delivery is enabled for a ChatGPT Ads product feed, its connection URI and authentication method.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_feed_sftp" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Whether SFTP bulk delivery is enabled for a ChatGPT Ads product feed, its connection URI and authentication method. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a feed’s SFTP delivery settings
    • idempotentHint: true
  • get_openai_ads_landing_page_crawlThe saved evidence from OpenAI’s landing-page crawler for an ad’s submitted version: crawl status and failure code, the requested and final URL (a redirect shows here), capture tim…Reads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_landing_page_crawl" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_openai_ads_landing_page_crawl" says "crawl": it reads web pages, which anyone can write.
    • untrusted-inputThe description's first sentence says "crawl": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The saved evidence from OpenAI’s landing-page crawler for an ad’s submitted version: crawl status and failure code, the requested and final URL (a redirect shows here), capture time, whether robots.txt allowed the crawler and its user agent, and a screenshot of what it saw. Read it when an ad is rejected or reports a landing-page crawl serving issue. The screenshot link expires within 24 hours. available:false with pending:true means the capture is still running; available:false otherwise means OpenAI holds no capture (or the ad id is not on this account). The status is the crawl job’s, not the page’s HTTP status. Reading never starts a crawl. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What ChatGPT Ads’ crawler saw on an ad’s landing page
    • idempotentHint: true
  • get_openai_ads_lead_formOne ChatGPT Ads lead form with its fields and revision ids (pass revisionId to read a specific revision).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_openai_ads_lead_form" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    One ChatGPT Ads lead form with its fields and revision ids (pass revisionId to read a specific revision). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a ChatGPT Ads lead form
    • idempotentHint: true
  • get_reddit_ads_assetOne stored Reddit creative asset by id — type, name, status, media dimensions and urls, or the headline/CTA text, plus any processing errors Reddit holds for it.Reads text others writeNo findings

    Why it is in this group

    • The name "get_reddit_ads_asset" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    One stored Reddit creative asset by id — type, name, status, media dimensions and urls, or the headline/CTA text, plus any processing errors Reddit holds for it. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read one Reddit creative asset
    • idempotentHint: true
  • get_reddit_ads_asset_uploadsThe processing state of one or more Reddit creative-asset uploads (ids from upload_reddit_ads_assets): PROCESSING, ACTIVE with the stored asset, or INVALID_MEDIA with Reddit’s reas…Reads text others writeNo findings

    Why it is in this group

    • The name "get_reddit_ads_asset_uploads" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The processing state of one or more Reddit creative-asset uploads (ids from upload_reddit_ads_assets): PROCESSING, ACTIVE with the stored asset, or INVALID_MEDIA with Reddit’s reasons. Ids Reddit no longer knows are listed as missing, never silently dropped. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Poll Reddit asset uploads
    • idempotentHint: true
  • get_reddit_ads_catalog_importSee how Reddit’s fetches of a catalog’s product feed went.Reads text others writeNo findings

    Why it is in this group

    • The name "get_reddit_ads_catalog_import" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    See how Reddit’s fetches of a catalog’s product feed went. Without importId: the catalog’s recent imports with their status (PENDING, PROCESSING, COMPLETED, FAILED, SKIPPED) and added / modified / deleted / invalid counts. With importId: that import’s issue rows (which products failed and why) plus a time-limited link to Reddit’s full import report. An import whose file did not change is SKIPPED and has no report. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check a Reddit catalog feed import
    • idempotentHint: true
  • get_reddit_ads_max_templateRead a Reddit Max template ad: its status, its assets, its destination and whether Reddit has finished generating ads from it (materialization SUCCESS, PARTIAL or FAILED with Reddi…Reads text others writeNo findings

    Why it is in this group

    • The name "get_reddit_ads_max_template" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read a Reddit Max template ad: its status, its assets, its destination and whether Reddit has finished generating ads from it (materialization SUCCESS, PARTIAL or FAILED with Reddit’s reasons, or still generating). Poll this after create_reddit_ads_max_campaign or update_reddit_ads_max_template. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Reddit Max template ad
    • idempotentHint: true
  • get_salesforce_recordONE Salesforce record by id (contact 003…, lead 00Q…, account 001…, opportunity 006…), with an opportunity's contact roles.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_salesforce_record" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "contact": it reads contacts.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    ONE Salesforce record by id (contact 003…, lead 00Q…, account 001…, opportunity 006…), with an opportunity's contact roles. fields adds any field by API name. Read-only, free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read one Salesforce record
    • 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_tiktok_ads_brand_safetyWhat content this TikTok ad account’s ads are allowed to appear next to — the inventory filter tier (EXPANDED / STANDARD / LIMITED / NO_BRAND_SAFETY) plus the suitability controls:…Reads text others writeNo findings

    Why it is in this group

    • The name "get_tiktok_ads_brand_safety" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    What content this TikTok ad account’s ads are allowed to appear next to — the inventory filter tier (EXPANDED / STANDARD / LIMITED / NO_BRAND_SAFETY) plus the suitability controls: which content categories are excluded and which vertical’s sensitive content is avoided. It also returns, free and in the same call, THE CATALOGUE of every category id you could set, because those ids are unguessable and there is otherwise no way to act on the setting. Warning: THE SCOPE IS THE THING TO KNOW: TikTok applies this to future Smart+ campaigns and, in their own words, "will not apply to future regular campaigns created using /campaign/create/" — which is the endpoint create_tiktok_ads_campaign uses. So this is the ad account default and the Ads Manager setting, NOT a guarantee inherited by a campaign Hermoso builds. A NULL vertical-sensitivity catalogue means this advertiser is not on TikTok’s allowlist for that feature, never that no vertical categories exist. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a TikTok ad account’s Brand Safety Hub settings
    • idempotentHint: true
  • get_tiktok_post_ad_authorizationRead the Spark-Ads authorization status of a post the authorized account owns — whether it is promotable, its authorization CODE, and the window the authorization runs for.Reads text others writeNo findings

    Why it is in this group

    • The name "get_tiktok_post_ad_authorization" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "get_tiktok_post_ad_authorization" says "get" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Read the Spark-Ads authorization status of a post the authorized account owns — whether it is promotable, its authorization CODE, and the window the authorization runs for. A SPARK AD CANNOT OUTLIVE ITS AUTHORIZATION, so check the end time before building a campaign around a post. TIKTOK ERRORS RATHER THAN ANSWERING when a post has no authorization code at all, so a not-found style refusal from here almost always means Ad authorization was never turned on (or the code was deleted) — turn it on with set_tiktok_post_ad_authorization — and not that anything is broken. NEEDS THE TIKTOK ACCOUNT AUTHORIZATION. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a post’s Spark-Ads authorization status
    • idempotentHint: true
  • get_tiktok_tto_spark_authorizationWhether a creator has approved Spark Ads authorization for their video, and if so the authorization CODE, the window it covers, and whether that code is already bound to an ad acco…Reads text others writeNo findings

    Why it is in this group

    • The name "get_tiktok_tto_spark_authorization" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Whether a creator has approved Spark Ads authorization for their video, and if so the authorization CODE, the window it covers, and whether that code is already bound to an ad account. The code is what authorize_tiktok_ads_spark_post takes. It appears only once the creator accepts: nothing on this side can produce one; and TikTok also reports how many further requests are left. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check a TikTok One Spark Ads authorization
    • idempotentHint: true
  • get_x_ads_leadsRead the leads submitted to an X lead form over a window (default the last 30 days) — each lead's answers keyed by field (EMAIL, FULL_NAME…).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_x_ads_leads" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Read the leads submitted to an X lead form over a window (default the last 30 days) — each lead's answers keyed by field (EMAIL, FULL_NAME…). X builds the export as a job; this waits up to ~45s and, if X is still working, returns an exportId to collect later with no new job. X lets only an ACCOUNT ADMIN export leads, and refuses an ARCHIVED form, so export before archiving. format csv/xlsx returns a download link instead. The result is personal information. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the leads from an X lead form
    • idempotentHint: true
  • hermoso_creditsReturn the credit balance, recent priced calls with their credits, and costModel (the one-sentence rule of what costs credits).No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    Return the credit balance, recent priced calls with their credits, and costModel (the one-sentence rule of what costs credits). THE RULE: only AI model runs and Ad Spy research spend credits; publishing, scheduling, ads management, analytics, comments, DMs and connectors cost no credits on any plan (X is the single per-call exception; xCost gives its exact credits per post, with and without a link). Check before kicking off paid generation; answer "does posting cost credits?" with NO. HOW MANY posts is set by the plan, not credits: the Free plan includes 5 posts a month on up to 3 channels, and a post counts once however many channels it goes to (`posting` says how many are used); every paid plan posts without a limit and runs autopilot (Basic $19.99/mo: Autopilot, plus unlimited posting and scheduling, no monthly credits; it includes the same 160+ free credits as the Free plan, and monthly credits start on Starter). Starter, Pro and Studio: media models at cost + 10% (memberRate); Basic and Free pay standard prices.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: Credit balance
    • idempotentHint: true
  • linkedin_audience_countHOW MANY LINKEDIN MEMBERS a targeting spec reaches, before any budget is committed.Reads text others writeNo findings

    Why it is in this group

    • The name "linkedin_audience_count" says "count": 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
    HOW MANY LINKEDIN MEMBERS a targeting spec reaches, before any budget is committed. It needs no ad account. Pass locations plus optional include:{titles, industries, seniorities, staffCountRanges, jobFunctions, skills, …}; search_linkedin_ads_targeting resolves any of those names to the URNs LinkedIn demands, free. THE CRITICAL THING TO SAY WHEN REPORTING: a returned total of 0 means the audience is UNDER 300 PEOPLE, not that it is empty — LinkedIn suppresses any count below 300 to protect member privacy, and 300 is also the minimum audience a campaign may run against, so a 0 means this targeting is too narrow to advertise to. The figure is a rounded approximation, so quote it as an estimate and never as a headcount. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: How many LinkedIn members a targeting spec reaches
    • idempotentHint: true
  • linkedin_boost_statusCan a LinkedIn post be BOOSTED (turned into an ad), or is it boosted already?Reads text others writeNo findings

    Why it is in this group

    • The name "linkedin_boost_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Can a LinkedIn post be BOOSTED (turned into an ad), or is it boosted already? Checks up to 50 posts: ELIGIBLE, INELIGIBLE (with LinkedIn’s reason), IN_REVIEW, SCHEDULED, CURRENTLY_BOOSTED or PREVIOUSLY_BOOSTED, plus the boost campaign and account of a boosted one. OMIT posts to list this brand’s recently published LinkedIn posts with their boost status (“which of my posts are boosted?”). Pass organization (Company Page id or name) for a Page post; omit it for the user’s own personal post. Read-only and free. Needs post boosting turned on for the LinkedIn connection; when it is off the reply carries the one-click link to turn it on.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Can a LinkedIn post be boosted?
    • idempotentHint: true
  • list_amplitude_annotationsThe markers already on this Amplitude project's charts — releases, campaigns, incidents — with their timestamps, labels and categories.Reads text others writeNo findings

    Why it is in this group

    • The name "list_amplitude_annotations" 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 markers already on this Amplitude project's charts — releases, campaigns, incidents — with their timestamps, labels and categories. READ THESE BEFORE EXPLAINING A CHANGE IN A CHART: a spike that lines up with an annotation has an explanation somebody already wrote down, and reporting it as a mystery when the answer is sitting on the timeline is exactly the failure this closes. Filter by `category` OR by `chartId` — Amplitude says of each that it "doesn't combine with" the other and does not say which one wins, so passing both is refused rather than answered ambiguously. `start` and `end` are ISO 8601 (e.g. '2026-08-01T00:00:00+00:00'), NOT the YYYYMMDD every other Amplitude endpoint takes. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Amplitude chart annotations
    • idempotentHint: true
  • list_amplitude_eventsThe Amplitude TAXONOMY — the project's declared events, event properties, user properties or group properties, so a query names something real instead of a guess.Reads text others writeNo findings

    Why it is in this group

    • The name "list_amplitude_events" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The Amplitude TAXONOMY — the project's declared events, event properties, user properties or group properties, so a query names something real instead of a guess. category is event (default) / category / event-property / user-property / group-property. IF AMPLITUDE REFUSES THIS, REPORT THEIR REFUSAL AND MOVE ON. The Taxonomy API is widely believed to require an enterprise/Govern entitlement, but Amplitude documents no such gating on either the taxonomy page or the Dashboard API page (both checked), so a 403 here is surfaced as AMPLITUDE'S OWN message and is never presented as a Hermoso plan rule, as a broken connection, or as a fact about the user's plan that we cannot actually know. Every other Amplitude tool is unaffected by that refusal. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Amplitude taxonomy (declared events and properties)
    • idempotentHint: true
  • list_analytics_audiencesThe GA4 audiences (remarketing lists) on a property, WITH whether they can actually be used in Google Ads — it reads the Google Ads link state alongside them, because an audience o…Reads text others writeNo findings

    Why it is in this group

    • The name "list_analytics_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The GA4 audiences (remarketing lists) on a property, WITH whether they can actually be used in Google Ads — it reads the Google Ads link state alongside them, because an audience on an unlinked property is a silent dead end that reports no error anywhere. ARCHIVED audiences are not listed, so absence here is not proof one never existed. GA4's PREDEFINED audiences ('All Users', 'Purchasers') ARE returned — verified live against a real property — and they come back with clauseCount 0, because Google defines them internally rather than with filter clauses; that is normal and is not a broken audience. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the GA4 audiences on a property
    • idempotentHint: true
  • list_analytics_data_streamsThe GA4 data streams on a property, with the measurement ID (G-...) each one carries and how many Measurement Protocol secrets it already has.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_analytics_data_streams" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "secret": it reads secrets.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The GA4 data streams on a property, with the measurement ID (G-...) each one carries and how many Measurement Protocol secrets it already has. THIS IS WHERE A GTAG OR GTM INSTALL GETS ITS ID, and it is the first call before sending any server-side event. A web stream has a measurementId; an app stream has none and uses its firebaseAppId instead, so do not report an app stream as broken for having no G- id. A stream whose secret count could not be read comes back as null, which means unknown and not zero. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: GA4 data streams
  • list_analytics_definitionsWhat a GA4 property already MEASURES — its key events (what GA4 counts as a conversion) and its custom dimensions, with each dimension's parameter name and scope.Reads text others writeNo findings

    Why it is in this group

    • The name "list_analytics_definitions" 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
    What a GA4 property already MEASURES — its key events (what GA4 counts as a conversion) and its custom dimensions, with each dimension's parameter name and scope. Two reasons to call it: to learn a property's own custom dimension names before using them in analytics_report, and to CHECK BEFORE CREATING — a custom dimension can never be deleted, only archived, and a property is capped at 50 event-scoped ones, so creating a duplicate permanently burns a slot. The property is the NUMERIC id from list_analytics_properties. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a GA4 property’s key events and custom dimensions
    • idempotentHint: true
  • list_analytics_metadataTHE VOCABULARY OF ONE PROPERTY — every dimension and metric analytics_report will accept on it, INCLUDING that property's own custom dimensions, each with its api name and its huma…Reads text others writeNo findings

    Why it is in this group

    • The name "list_analytics_metadata" 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 VOCABULARY OF ONE PROPERTY — every dimension and metric analytics_report will accept on it, INCLUDING that property's own custom dimensions, each with its api name and its human label. Use this instead of guessing an api name: GA4 publishes hundreds and they are not memorable (sessions broken down by landing page is `landingPage`, revenue is `totalRevenue`, the channel grouping is `sessionDefaultChannelGroup`), and a wrong name is an error mid-conversation rather than a suggestion. analytics_report deliberately forwards names AS GIVEN — it never validates against a copied list, because that list would go stale and start refusing names Google accepts — so THIS is where a name is checked. PASS `search` almost always: unfiltered this returns several hundred rows, and a search matches both the api name and the label ("revenue", "campaign", "device"). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: What a GA4 property can be asked
  • list_analytics_propertiesThe GA4 properties SHARED WITH THIS PROFILE, with their numeric property ids, display names and the Analytics account each sits under.Reads text others writeNo findings

    Why it is in this group

    • The name "list_analytics_properties" 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 GA4 properties SHARED WITH THIS PROFILE, with their numeric property ids, display names and the Analytics account each sits under. CALL THIS FIRST — every other Analytics tool needs a PROPERTY ID, which is NUMERIC (e.g. 123456789) and is NOT the "G-XXXXXXX" Measurement ID people usually know from their tracking snippet; the API accepts the numeric id and nothing else. Resolve the property yourself from this list instead of asking the user to go and find one, and only ask when two names are genuinely ambiguous. THIS IS NOT EVERY PROPERTY THE GOOGLE ACCOUNT CAN SEE, deliberately: Analytics access is handed out freely, so one login often has Viewer on many different clients' properties, and the user ticks which ones belong to THIS profile. Only ticked properties can be reported on, and any other one is refused by name. An empty list means nothing is ticked yet — say so and point the user at Connectors > Google Analytics > Manage accounts (or call list_connector_accounts / set_connector_accounts with provider "google_analytics"); never name or guess a property. Read-only, 0 credits. Needs Google Analytics connected (Connectors > Google Analytics).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the GA4 properties shared with this profile
    • idempotentHint: true
  • list_apple_ads_ad_groupsAd groups on the brand’s Apple Ads account — status, the system-computed displayStatus, pricing model, the bid off the ad group’s bidStrategy, and whether Search Match (Apple’s aut…Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_ad_groups" 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
    Ad groups on the brand’s Apple Ads account — status, the system-computed displayStatus, pricing model, the bid off the ad group’s bidStrategy, and whether Search Match (Apple’s automated keyword matching) is on. campaignId is OPTIONAL: with it, the ad groups of that one campaign; WITHOUT it, every ad group in the ad account, each row carrying its own campaignId. (Apple’s older API had no account-wide ad-group list and required the campaign id; its Platform API does, and this now uses it.) Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads ad groups
    • idempotentHint: true
  • list_apple_ads_adsThe ads on this Apple Ads account — the serving units that put a creative into an ad group.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_ads" 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 ads on this Apple Ads account — the serving units that put a creative into an ad group. Each row carries the advertiser status, the rolled-up displayStatus, Apple’s own systemStatus and, when an ad is not serving, systemStatusReasons saying exactly why: AD_APPROVAL_PENDING while Apple reviews it, CREATIVE_PENDING, CREATIVE_LOCALE_INCOMPATIBLE, PRODUCT_PAGE_HIDDEN, PAUSED_BY_USER and more. READ THAT FIELD BEFORE CONCLUDING ANYTHING IS BROKEN — a brand-new ad awaiting Apple’s review is NOT_RUNNING by design, and systemStatusLimitingReasons means it IS running but throttled. Filter by adGroupId, campaignId, creativeId or status, or pass id for one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads ads
    • idempotentHint: true
  • list_apple_ads_advertiser_resourcesThe brands and content providers this Apple Ads ORGANIZATION can delegate to an ad account — the ids create_apple_ads_ad_account and update_apple_ads_ad_account need.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_advertiser_resources" 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 brands and content providers this Apple Ads ORGANIZATION can delegate to an ad account — the ids create_apple_ads_ad_account and update_apple_ads_ad_account need. resourceType CONTENT_PROVIDER returns App Store Connect content providers, each identified by its CPID, which is what links an ad account to App Store advertising; BUSINESS_BRAND returns Apple Maps brands by Brand ID. resourceType is REQUIRED — Apple errors without it. This list is ORGANIZATION-WIDE and is deliberately not scoped to any one ad account, which is why a resource can appear here that no account has claimed yet. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads advertiser resources
    • idempotentHint: true
  • list_apple_ads_assetsImages in the Apple Ads asset library with format, orientation, dimensions and eligibility — use it to check whether an uploaded asset has finished processing before referencing it…Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_assets" 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
    Images in the Apple Ads asset library with format, orientation, dimensions and eligibility — use it to check whether an uploaded asset has finished processing before referencing it in a creative. Filter by mapsBrandId (Apple’s promotedObjectId), promotedObjectType or assetType, or pass id for one. CROPS AND OTHER VARIANTS NEVER APPEAR IN A LIST: Apple omits them from query results, so a variant has to be fetched by its own id. Querying covers both App Store apps and Apple Maps brands even though only Maps assets can be uploaded. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads image assets
    • idempotentHint: true
  • list_apple_ads_brandsThe Apple Maps brands on this Apple Ads account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_brands" 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 Apple Maps brands on this Apple Ads account. A BRAND IS THE ROOT OF EVERY ADS-ON-APPLE-MAPS CAMPAIGN and its id is what three other calls need: it is the promotedObjectId of a BUSINESS_BRAND campaign, the mapsBrandId upload_apple_ads_asset uploads against, and the mapsBrandId a LOCAL_ADS_SEARCH_CREATIVE carries. A brand must read eligibility ELIGIBLE before Apple will let a campaign use it. YOU CANNOT CREATE A BRAND HERE and that is Apple’s design, not a gap: brands come from Apple Business Connect, and Ads on Apple Maps additionally need the ad account to carry productFeatures BUSINESS_BRAND_MANUAL plus a BUSINESS_BRAND delegation, neither of which any API can grant. AN EMPTY LIST IS THE NORMAL ANSWER FOR AN APP STORE ADVERTISER and does not mean anything is broken — App Store campaigns need no brand at all. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Maps brands
    • idempotentHint: true
  • list_apple_ads_budget_ordersBudget orders on this Apple Ads account — a spend CEILING SHARED ACROSS CAMPAIGNS, which is how an agency caps a client for a quarter: total spend across every campaign assigned to…Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_budget_orders" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Budget orders on this Apple Ads account — a spend CEILING SHARED ACROSS CAMPAIGNS, which is how an agency caps a client for a quarter: total spend across every campaign assigned to one cannot exceed its value, however generous the individual daily budgets are. Each row carries the value, the active window, the systemStatus and, when it is blocking, the systemStatusReasons saying why (EXHAUSTED, EXPIRED, CANCELLED). Pass id for one. AN EMPTY LIST IS NORMAL: a budget order is optional, and without one each campaign is capped only by its own dailyBudget. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads budget orders
    • idempotentHint: true
  • list_apple_ads_campaignsRead the brand’s connected Apple Ads (Apple Search Ads) campaigns — App Store search ads, on Apple’s Platform API.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the brand’s connected Apple Ads (Apple Search Ads) campaigns — App Store search ads, on Apple’s Platform API. Each row carries status, the system-computed displayStatus, the daily budget, the bid strategy, the countries and placements it runs in and, when a campaign cannot run, systemStatusReasons stating exactly why. Read-only, free, zero spend risk. Needs Apple Ads connected (Connectors > Apple Ads, or connect_connector): there is no OAuth — Hermoso generates an EC signing key, the user pastes the public half into Apple Ads > Account Settings > API and pastes back clientId / teamId / keyId. To BUILD on this account, use create_apple_ads_campaign / create_apple_ads_ad_group / add_apple_ads_keywords: everything is created PAUSED and only set_apple_ads_status(confirm:true) can arm spend.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads campaigns
    • idempotentHint: true
  • list_apple_ads_creativesThe ad creatives on this Apple Ads account, each with its type, the app and product page it points at, its systemStatus (VALID / INVALID / PENDING) and its eligibility per ad place…Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_creatives" 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 ad creatives on this Apple Ads account, each with its type, the app and product page it points at, its systemStatus (VALID / INVALID / PENDING) and its eligibility per ad placement. A creative is reusable — one can back ads in several ad groups and campaigns. Filter by creativeType, systemStatus, a name prefix or eligibility, pass id for a single one, or includeDeleted:true to see deleted records (Apple excludes them by default). AN EMPTY LIST IS NORMAL on an account that only runs classic Search Results campaigns: those need no creative at all, because Apple renders the App Store product page itself. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads creatives
    • idempotentHint: true
  • list_apple_ads_keywordsTargeting or negative keywords with their match type, status and bid.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_keywords" 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
    Targeting or negative keywords with their match type, status and bid. THE TWO RESOURCES SCOPE DIFFERENTLY and Apple enforces it: TARGETING keywords (the default) need campaignId OR adGroupId — campaignId alone now returns every targeting keyword in the campaign, which Apple’s older API had no way to ask for. NEGATIVE keywords (negative:true) always need one of the two as well, and Apple splits them by LEVEL: campaignId alone returns the CAMPAIGN-level negatives that suppress the whole campaign (scope ‘campaign’, the default), scope ‘adgroup’ returns every AD-GROUP-level negative across that campaign in one call, and naming an adGroupId returns just that ad group’s. The reply states which level it counted, because the row shapes are identical and the number means different things. There is no account-wide keyword list. Apple allows up to 5000 keywords per ad group. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads targeting or negative keywords
    • idempotentHint: true
  • list_apple_ads_location_groupsThe location groups on this Apple Ads account — named sets of a brand’s shops that an ad group targets.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_location_groups" 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 location groups on this Apple Ads account — named sets of a brand’s shops that an ad group targets. Each row carries its type (STATIC or DYNAMIC), Apple’s systemStatus and groupTotal, the number of locations currently in it. READ groupTotal BEFORE TARGETING A GROUP: a DYNAMIC group sits at PENDING while Apple evaluates its rules, and a group that evaluated to ZERO is Apple’s one silent failure here — it reports no error, so a rule spelled "CA" instead of "California" builds an empty group that looks fine. Soft-deleted groups are excluded unless you pass includeDeleted. There is no filter for "which groups contain this location": query by mapsBrandId and inspect membership. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Maps location groups
    • idempotentHint: true
  • list_apple_ads_locationsThe physical business locations behind an Apple Maps brand — the shops, restaurants or service centres an Ads-on-Apple-Maps campaign promotes.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_locations" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The physical business locations behind an Apple Maps brand — the shops, restaurants or service centres an Ads-on-Apple-Maps campaign promotes. Filter by mapsBrandId (do: without it Apple returns every location across every brand, which can be a very large page), plus status, eligibility or address. LOCATIONS ARE READ-ONLY THROUGH THIS API BY APPLE’S DESIGN: Apple Business Connect creates and maintains them, so a missing shop, a wrong address or a closure is fixed there and appears here afterwards — there is no create, update or delete to look for. Only a location with status OPEN and eligibility ELIGIBLE is targetable. You do not target locations directly: collect the ids you want, put them in a location group with create_apple_ads_location_group, then point an ad group at that group. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Maps business locations
    • idempotentHint: true
  • list_apple_ads_orgsThe Apple Ads ad accounts these credentials can act as, with the roles held on each, plus the organization’s currency, time zone and payment model.Reads private dataReads text others write1 finding

    Why it is in this group

    • The name "list_apple_ads_orgs" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "credential": it reads secrets.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "The Apple Ads ad accounts these credentials can act as, with the roles held on each..."

      What this check looks for
    Description, as the server wrote it
    The Apple Ads ad accounts these credentials can act as, with the roles held on each, plus the organization’s currency, time zone and payment model. NAMING: Apple’s older API called these “organizations” (campaign groups) and its Platform API calls them AD ACCOUNTS — the id is the same number, and `orgId` and `adAccountId` on each row are equal. One login can cover several: an agency managing multiple clients has one per client. Reading this does NOT switch account: Apple Ads is pinned to the ONE chosen when the connection was made, so an agent can never act as another client’s. To use a different one, pick it in Connectors > Apple Ads > Manage accounts, with set_connector_accounts, or by reconnecting. A payment model of null is worth reporting: Apple states that without one, campaigns cannot run. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads organizations
    • idempotentHint: true
  • list_apple_ads_product_pagesThe App Store product pages this ad account can advertise — the post-tap destination a creative points at.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_product_pages" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The App Store product pages this ad account can advertise — the post-tap destination a creative points at. Every app has exactly one DEFAULT product page (its standard listing, needing no setup) plus any CUSTOM PRODUCT PAGES the developer built in App Store Connect, each with its own productPageId (a UUID, not an integer) that a CUSTOM_PRODUCT_PAGE creative requires. Filter by adamId. Pass localeDetails:true to read the per-language content instead — appName, subtitle, promotional text and the screenshots and preview videos by device class — for a custom page (productPageId) or for the app’s default listing (adamId); Hermoso picks the right one of Apple’s two endpoints for you. READ-ONLY BY DESIGN: product pages are authored in App Store Connect, not through any API, and a page you just published appears here only after a short propagation delay. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List App Store product pages
    • idempotentHint: true
  • list_apple_ads_recommendationsApple’s own optimisation engine for this account: campaigns it thinks are budget-capped, and campaigns whose target CPA it thinks should move.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_recommendations" 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
    Apple’s own optimisation engine for this account: campaigns it thinks are budget-capped, and campaigns whose target CPA it thinks should move. type:"daily_budget" returns DAILYCAP recommendations, each carrying the current and suggested budget plus the historical installs/taps/spend behind it AND Apple’s projection if you raise it; type:"target_cpa" returns TCPA recommendations, which Apple produces ONLY for campaigns on a Maximize Conversions bid strategy — a MANUAL_CPT campaign will never have one. Defaults to state AVAILABLE because that is the only actionable state: APPLIED and DISMISSED are terminal and can never be re-actioned (pass state:"ALL" to see the history). Apple names only two recommendation categories with endpoints; its enum also mentions keyword and bid categories but this API version publishes no way to query or act on those. Read-only, free — reading changes nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads recommendations
    • idempotentHint: true
  • list_apple_ads_supported_languagesEvery country and region Apple Ads serves, with the languages supported in each market.Reads text others writeNo findings

    Why it is in this group

    • The name "list_apple_ads_supported_languages" 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
    Every country and region Apple Ads serves, with the languages supported in each market. Use it to VALIDATE A LOCALE BEFORE setting it on an Apple Maps creative’s localizedText or defaultLocale, or on an ad group — a locale a market does not support makes the creative INVALID after it is built, which surfaces as a serving failure long after the mistake was made. Also the definitive answer to "can we advertise in this market and in what language" when expanding a campaign. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Apple Ads supported languages
    • idempotentHint: true
  • list_applovin_ads_assetsAssets on the AppLovin account: id, type (VID_LONG_P, VID_SHORT_P, IMG_INTER_P, IMG_BANNER, HOSTED_HTML), review status and rejection reasons.Reads text others writeNo findings

    Why it is in this group

    • The name "list_applovin_ads_assets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "html": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Assets on the AppLovin account: id, type (VID_LONG_P, VID_SHORT_P, IMG_INTER_P, IMG_BANNER, HOSTED_HTML), review status and rejection reasons. Read-only, free. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List AppLovin assets
    • idempotentHint: true
  • list_applovin_ads_campaignsThe brand’s AppLovin Ads campaigns: id, name, LIVE/PAUSED, daily budget, goal, countries, landing page.Reads text others writeNo findings

    Why it is in this group

    • The name "list_applovin_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The brand’s AppLovin Ads campaigns: id, name, LIVE/PAUSED, daily budget, goal, countries, landing page. Rename or edit one with update_applovin_ads_campaign; pause or go live with set_applovin_ads_status. Read-only, free. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List AppLovin Ads campaigns
    • idempotentHint: true
  • list_applovin_ads_catalogsThe AppLovin account’s product catalogs and their variant sets: the catalogId and variantSetId a dynamic-ads campaign (create_applovin_ads_campaign) needs.Reads text others writeNo findings

    Why it is in this group

    • The name "list_applovin_ads_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The AppLovin account’s product catalogs and their variant sets: the catalogId and variantSetId a dynamic-ads campaign (create_applovin_ads_campaign) needs. Website accounts. Read-only, free. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List AppLovin catalogs
    • idempotentHint: true
  • list_applovin_ads_creative_setsAppLovin creative sets with their assets and review status, for one campaign (campaignId) or the whole account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_applovin_ads_creative_sets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    AppLovin creative sets with their assets and review status, for one campaign (campaignId) or the whole account. Read-only, free. Needs the Campaign Management key, which exists once AppLovin enables API access on the account; without it the answer says how to get it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List AppLovin creative sets
    • idempotentHint: true
  • list_bing_webmaster_fetched_urlsThe URLs fetched on demand as Bingbot for this site, or one of them in detail (pass `url`) including what Bingbot actually received.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "list_bing_webmaster_fetched_urls" 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_bing_webmaster_fetched_urls" says "list" and "url": it reads web pages, which anyone can write.
    • untrusted-inputThe description's first sentence says "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
    The URLs fetched on demand as Bingbot for this site, or one of them in detail (pass `url`) including what Bingbot actually received. This is how you see a page through the CRAWLER's eyes rather than a browser's — a robots block, a redirect chain or a JS-only page all look fine in a browser and wrong here. An empty list means nothing has been fetched on demand yet, which is a real answer and not a failure. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What Bingbot fetched on demand
    • idempotentHint: true
  • list_bing_webmaster_sitemapsThe sitemaps registered for this site — Bing calls them FEEDS — with the status, URL count, file size and last-crawled date Bing holds for each.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_bing_webmaster_sitemaps" says "list": a word for reading.

    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 "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The sitemaps registered for this site — Bing calls them FEEDS — with the status, URL count, file size and last-crawled date Bing holds for each. This is the read to make BEFORE submitting or removing one, because both of those are addressed by the sitemap's full URL exactly as Bing stores it. Pass `feedUrl` to expand a sitemap INDEX into its child sitemaps (Microsoft's GetFeedDetails); an empty answer for a plain non-index sitemap is a real answer, not a failure. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: The sitemaps Bing has for this site
    • idempotentHint: true
  • list_bing_webmaster_sitesThe Bing Webmaster Tools sites SHARED WITH THIS PROFILE, each exactly as Bing holds it (e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "list_bing_webmaster_sites" 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 Bing Webmaster Tools sites SHARED WITH THIS PROFILE, each exactly as Bing holds it (e.g. "https://example.com"). CALL THIS FIRST — every other Bing tool takes that exact string. THIS IS NOT EVERY SITE THE CONNECTION CAN REACH: Microsoft issues one key per USER covering every site that Bing account verified, so the user ticks which belong to THIS profile and any other one is refused by name. An empty list means nothing is ticked yet — point the user at Connectors > Bing Webmaster Tools > Manage accounts (or call set_connector_accounts with provider "bing_webmaster") and never name or guess a site. A site flagged not verified will refuse every later call. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Bing Webmaster sites shared with this profile
    • 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. That casts them for the whole spot. THE PORTRAIT URL IS THE REUSE HANDLE for the raw lanes. CALL THIS BEFORE OFFERING TO GENERATE A NEW PERSON: re-casting somebody the workspace already has keeps the SAME face across every ad, while a fresh person costs credits and breaks that continuity. An empty answer means the workspace genuinely has no cast yet.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List saved creators
    • idempotentHint: true
  • list_drive_filesList the Google Drive files & folders Hermoso can reach: the ones it created plus any the user picked with the Google file picker in the app (drive.file, never their whole Drive).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_drive_files" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_drive_files" says "list" and "drive": it reads files.
    • private-dataThe description's first sentence says "list" and "drive": it reads files.
    • private-dataThe input names a folder (input.folderId), and the tool reads: it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the Google Drive files & folders Hermoso can reach: the ones it created plus any the user picked with the Google file picker in the app (drive.file, never their whole Drive). This is how you find a picked file's id. Filter by query (name contains …), folderId, or onlyFolders:true; paginate with pageToken. Read-only. A FOLDER: picking a folder hands over the folder alone, not its files, so a folder can list empty or partly; the reply then carries `pickUrl`, an app link that opens the picker inside that folder (Cmd+A / Ctrl+A selects every file and subfolder). Give the user that exact link, then list again. recursive:true walks every subfolder Hermoso can see (each row has its `path`) and reports picked files whose folder it cannot see.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Google Drive files
    • idempotentHint: true
  • list_elementsSaved people, places and products, each with an @name.No findings

    Why it is in this group

    • The name "list_elements" says "list": a word for reading.
    Description, as the server wrote it
    Saved people, places and products, each with an @name. FREE. An @name in an image or video prompt or an ad brief ("@Sarah in @Kitchen") uses that saved picture as the reference.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List saved elements
    • idempotentHint: true
  • list_errorsThe errors actually recorded against this workspace, GROUPED by fingerprint — the same failure at the same call site is one row with a hit count and first/last seen, sorted defects…No findings

    Why it is in this group

    • The name "list_errors" says "list": a word for reading.
    Description, as the server wrote it
    The errors actually recorded against this workspace, GROUPED by fingerprint — the same failure at the same call site is one row with a hit count and first/last seen, sorted defects-first. Each row says whose side it is: `ours` (a defect worth fixing), `user` (a refusal we deliberately authored, e.g. not-connected or out-of-credits), or `unknown` (a vendor 4xx we cannot attribute — never guessed). Free text, tokens, emails and creative are redacted before anything is stored, so an input echo shows shapes and lengths, not content. Filter by surface (http/mcp/agent/job/client) or kind. Read-only, 0 credits. Scoped to your own workspace; an operator whose client carries the admin key sees every account.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
    • title: List errors users hit
    • idempotentHint: true
  • list_google_ads_campaignsRead the connected Google Ads account(s).Reads text others writeNo findings

    Why it is in this group

    • The name "list_google_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the connected Google Ads account(s). Call with NO customerId to list the accessible accounts (customerId + name + currency) — do this first to pick a target. Call WITH customerId to list that account’s campaigns (id, name, status, daily budget, channel) plus performance metrics (impressions, clicks, CTR, avg CPC, cost, conversions). Date window: datePreset (LAST_7_DAYS | LAST_30_DAYS | TODAY | THIS_MONTH | LAST_90_DAYS …) or since+until (YYYY-MM-DD). Read-only, free. Needs Google Ads connected (Connectors > Google Ads).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Google Ads accounts / campaigns
    • idempotentHint: true
  • list_google_ads_conversion_actionsList the conversion actions on a Google Ads account and say plainly whether smart bidding can work there.Reads text others writeNo findings

    Why it is in this group

    • The name "list_google_ads_conversion_actions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the conversion actions on a Google Ads account and say plainly whether smart bidding can work there. Call this BEFORE proposing MAXIMIZE_CONVERSIONS / MAXIMIZE_CONVERSION_VALUE / TARGET_CPA / TARGET_ROAS or any Performance Max campaign: an account with no ENABLED conversion action that counts toward "conversions" cannot optimise on any of them, and the campaign would spend its budget without ever learning. Shows each action’s status, type, category, counting type, and whether it counts toward "conversions". Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Google Ads conversion actions
  • list_google_ads_lead_submissionsThe people who filled in a Google Ads lead form: each submission’s time, the answers (name, email, phone and any custom questions), the Google click id, and the campaign, ad group …Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_google_ads_lead_submissions" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The people who filled in a Google Ads lead form: each submission’s time, the answers (name, email, phone and any custom questions), the Google click id, and the campaign, ad group and lead form it came from, newest first. Filter by campaignId, adGroupId, assetId (the lead form asset) and since / until (YYYY-MM-DD); limit up to 1,000 (default 100). An empty answer means none that Google still holds for this account and filter, not proof that no form was ever submitted. These are the advertiser’s own leads and contain personal details: show them to the user who asked and do not copy them anywhere else unless asked. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read Google Ads lead form submissions
    • idempotentHint: true
  • list_google_ads_rulesThe Google Ads rules Hermoso runs for this brand, each with a one-sentence summary, ON/OFF, last run and outcome, next run, whether it CAN RAISE SPEND, and its scopeToken; plus eac…No findings

    Why it is in this group

    • The name "list_google_ads_rules" says "list": a word for reading.
    Description, as the server wrote it
    The Google Ads rules Hermoso runs for this brand, each with a one-sentence summary, ON/OFF, last run and outcome, next run, whether it CAN RAISE SPEND, and its scopeToken; plus each account's caps. Rules made in the Google Ads web UI are not listed: Google exposes them to no API. Read-only. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List Google Ads automated rules
  • list_hubspot_companiesCOMPANIES (accounts) from the brand's OWN HubSpot CRM, newest first: name, domain, website, LinkedIn company page, industry, employees, annual revenue, lifecycle stage, lead status…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_hubspot_companies" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "contact": it reads contacts.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "website": it reads web pages, which anyone can write.
    Description, as the server wrote it
    COMPANIES (accounts) from the brand's OWN HubSpot CRM, newest first: name, domain, website, LinkedIn company page, industry, employees, annual revenue, lifecycle stage, lead status, country/city, owner (rep name), original source + drill-downs, associated contacts and deals, total revenue — plus a de-duplicated `domains` list, which is what LinkedIn company targeting and account-based (ABM) audiences are built from. search matches name / domain / website / phone; filters lifecycleStage (e.g. customer, opportunity, salesqualifiedlead), industry (HubSpot's internal value, e.g. COMPUTER_SOFTWARE), hubspotOwnerId, createdSince (YYYY-MM-DD). Read-only, free. Needs HubSpot connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List or search HubSpot companies
    • idempotentHint: true
  • list_hubspot_contactsContacts from the brand's OWN HubSpot CRM, newest first — email, name, lifecycle stage, lead status, created date, original source — or a search by email / first name / last name (…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_hubspot_contacts" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_hubspot_contacts" says "list" 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 "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Contacts from the brand's OWN HubSpot CRM, newest first — email, name, lifecycle stage, lead status, created date, original source — or a search by email / first name / last name (whole-token match, wildcards allowed). Read-only, free. Needs HubSpot connected (Connectors > HubSpot).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List or search HubSpot contacts
    • idempotentHint: true
  • list_hubspot_ownersThe sales reps (OWNERS) in the brand's HubSpot: id, name, email, teams.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_hubspot_owners" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The sales reps (OWNERS) in the brand's HubSpot: id, name, email, teams. An owner's id is what create_hubspot_contact's hubspotOwnerId assigns a lead to, and what list_hubspot_companies filters by. search narrows by name or email; archived:true lists DEACTIVATED owners instead. Read-only, free. Needs HubSpot connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List HubSpot owners (sales reps)
    • 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, a TITLE (headline, concept or file name), kind, a video's length, pixel size, model and age. An ad named by its headline ("the Afternoon fix ad"): pass `query`. Free, read-only.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: List library
  • list_linkedin_ads_campaignsRead the LinkedIn ad accounts this connection can reach, and — with adAccountId — that account’s campaign groups and campaigns: name, status, objective, budgets, and LinkedIn’s own…Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the LinkedIn ad accounts this connection can reach, and — with adAccountId — that account’s campaign groups and campaigns: name, status, objective, budgets, and LinkedIn’s own servingStatuses, which explain WHY something is not delivering (billing hold, start-date hold, parent-status hold). LinkedIn’s Advertising API is an approval-gated product, and on its Development tier each ad account must ALSO be mapped to the app in LinkedIn’s Developer Portal — so if nothing is reachable, say that rather than implying the user has no ad account. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List LinkedIn ad accounts / campaigns
    • idempotentHint: true
  • list_linkedin_boost_audiencesThe SAVED boost audiences on a LinkedIn ad account (reusable as boost_linkedin_post audienceId), most recently used first, with their criteria.Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_boost_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The SAVED boost audiences on a LinkedIn ad account (reusable as boost_linkedin_post audienceId), most recently used first, with their criteria. Uses the ad account this brand ticked (adAccountId when several are). Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Saved LinkedIn boost audiences
    • idempotentHint: true
  • list_linkedin_conversion_rulesList the conversion rules on a LinkedIn ad account, including ones SHARED from other accounts in the same Business Manager.Reads text others writeNo findings

    Why it is in this group

    • The name "list_linkedin_conversion_rules" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the conversion rules on a LinkedIn ad account, including ones SHARED from other accounts in the same Business Manager. Use it to find the conversionId send_linkedin_conversions needs, and to check whether a rule can actually receive API events — only a rule whose conversionMethod is CONVERSIONS_API and which is enabled can, and a rule built for the Insight Tag cannot. Zero rules genuinely means none exist; say that rather than implying a failure. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List LinkedIn conversion rules
  • 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_merchant_accountsList the Google Merchant Center accounts this brand's connected Google account can reach.Reads text others writeNo findings

    Why it is in this group

    • The name "list_merchant_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
    List the Google Merchant Center accounts this brand's connected Google account can reach. EVERY other Merchant tool needs the merchantCenterId this returns, and an agency often has several, so never guess one — ask the user which store. Read-only and free. If it is refused, the Merchant Center permission has not been granted yet; that is not a broken connection and reconnecting will not change it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Merchant Center accounts
    • idempotentHint: true
  • list_merchant_data_sourcesList the data sources (feeds) on a Merchant Center account and say which of them can actually take a product write.Reads text others writeNo findings

    Why it is in this group

    • The name "list_merchant_data_sources" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the data sources (feeds) on a Merchant Center account and say which of them can actually take a product write. Do this BEFORE creating or deleting a product: writes go into a data source, and Google only accepts them into an API-input product feed — a file feed, the feed Merchant Center's own UI creates, and an autofeed all list here and all REFUSE writes, so picking the first row would pick a feed that cannot be written to. Needs merchantCenterId from list_merchant_accounts. Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Merchant Center product feeds
    • idempotentHint: true
  • list_merchant_inventoryThe per-store and per-region price and availability overrides on one Shopping product.Reads text others writeNo findings

    Why it is in this group

    • The name "list_merchant_inventory" 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 per-store and per-region price and availability overrides on one Shopping product. An override REPLACES the product's own price and availability for that store or region; where there is no override the product-level values apply, so an empty result is the normal answer and does NOT mean the product is missing. Needs the product's offerId plus its contentLanguage and feedLabel, because in the Merchant API those three together ARE the product's address rather than optional filters. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Merchant store and region overrides
  • list_merchant_issuesRead the account-level issues Google reports on a Merchant Center — the answer to "why is this product not showing?".Reads text others writeNo findings

    Why it is in this group

    • The name "list_merchant_issues" 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_merchant_issues" says "list" and "issue": it reads issues, which other people can write.
    • untrusted-inputThe description's first sentence says "read" and "issue": it reads issues, which other people can write.
    Description, as the server wrote it
    Read the account-level issues Google reports on a Merchant Center — the answer to "why is this product not showing?". Needs merchantCenterId from list_merchant_accounts. Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Merchant Center account issues
    • idempotentHint: true
  • list_merchant_productsRead the products in a Merchant Center feed — what the merchant actually offers, which is what Shopping and retail Performance Max campaigns serve.Reads text others writeNo findings

    Why it is in this group

    • The name "list_merchant_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the products in a Merchant Center feed — what the merchant actually offers, which is what Shopping and retail Performance Max campaigns serve. Needs merchantCenterId from list_merchant_accounts. Read-only and free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Merchant Center products
    • idempotentHint: true
  • list_merchant_promotionsThe sale and discount promotions on a Merchant Center account, with each one's PER-DESTINATION status and any issues Google has raised against it.Reads text others writeNo findings

    Why it is in this group

    • The name "list_merchant_promotions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "issue": it reads issues, which other people can write.
    Description, as the server wrote it
    The sale and discount promotions on a Merchant Center account, with each one's PER-DESTINATION status and any issues Google has raised against it. GOOGLE VALIDATES PROMOTIONS ASYNCHRONOUSLY, so 'created' and 'running' are different states and only destinationStatuses tells them apart — never report a sale as live off a successful create. Read-only, 0 credits. Needs Google Ads connected (Merchant Center rides the same connection).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Merchant Center promotions
    • idempotentHint: true
  • list_meta_ad_rulesThe automated rules on a Meta ad account — including ones made in Ads Manager — each with what it does in one sentence, whether it is ON, whether it CAN RAISE SPEND (canSpend, armi…Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_ad_rules" 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 automated rules on a Meta ad account — including ones made in Ads Manager — each with what it does in one sentence, whether it is ON, whether it CAN RAISE SPEND (canSpend, armingActions), whether its reach grows, and its scopeToken (what set_meta_ad_rule_status wants echoed back to switch on a rule that can raise spend). Also returns the ad account's caps on rules. Pass ruleId for one rule. Read-only. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Meta automated rules, and which can raise spend
  • list_meta_adsRead the EXISTING campaigns, ad sets, or ads on a connected Meta ad account — id, name, status, budget, objective, and at level ad WHY Meta rejected or flagged an ad (its review fe…Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_ads" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "review": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the EXISTING campaigns, ad sets, or ads on a connected Meta ad account — id, name, status, budget, objective, and at level ad WHY Meta rejected or flagged an ad (its review feedback, in Meta’s words). Pass adAccountId and level (campaign|adset|ad). Scope to a parent with campaignId (-> its ad sets/ads) or adsetId (-> its ads), and filter by status (ACTIVE/PAUSED/…). Read-only — use it to inspect an account before editing/deleting, or to answer "what’s running?".

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Meta campaigns / ad sets / ads
    • idempotentHint: true
  • list_meta_audiencesList the custom audiences and lookalikes on a connected Meta ad account — id, name, type, approximate size, and whether Meta says it is ready to target.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the custom audiences and lookalikes on a connected Meta ad account — id, name, type, approximate size, and whether Meta says it is ready to target. Call it before create_meta_audience (so you never build a duplicate) and before targeting one: the ids go straight into create_meta_ad’s targeting.customAudiences / excludedCustomAudiences. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Meta custom audiences + lookalikes
    • idempotentHint: true
  • list_meta_lead_formsList the INSTANT LEAD FORMS on a connected Facebook Page — id, name, status, how many leads each has collected and what each one asks.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_lead_forms" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the INSTANT LEAD FORMS on a connected Facebook Page — id, name, status, how many leads each has collected and what each one asks. This is where the formId every other lead tool needs comes from, and calling it before create_meta_lead_form is how you avoid building a duplicate. Read-only, free. NEEDS the pages_manage_ads permission, which Hermoso’s Meta consent screen asks for. If Meta answers "Requires pages_manage_ads", the user must RECONNECT Meta under Connectors > Meta — a connection made before that permission was added cannot gain it by retrying. Call the tool rather than pre-refusing: any refusal comes from Meta and names the one thing that fixes it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Meta instant (lead) forms
    • idempotentHint: true
  • list_meta_pixelsList the META PIXELS on one of the brand’s ad accounts — id, name, when it was created, and WHEN IT LAST FIRED.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_pixels" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the META PIXELS on one of the brand’s ad accounts — id, name, when it was created, and WHEN IT LAST FIRED. This is where the pixelId every conversion tool needs comes from: create_meta_ad takes it (with conversionEvent) to optimise an ad set for OFFSITE_CONVERSIONS instead of link clicks, and create_meta_audience needs it to build a website retargeting audience. READ lastFiredAt BEFORE YOU TRUST A PIXEL: one that has NEVER FIRED is not installed on the site, so an ad optimising against it will spend and never learn. Pass includeCode:true to get the <script> snippet for installation (it is long, so it is off by default). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Meta Pixels on an ad account
    • idempotentHint: true
  • list_meta_playablesList the playables uploaded to a Meta ad account (id and name), for create_meta_ad's playableAssetId.Reads text others writeNo findings

    Why it is in this group

    • The name "list_meta_playables" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the playables uploaded to a Meta ad account (id and name), for create_meta_ad's playableAssetId. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Meta playables
  • list_microsoft_ads_audience_targetingThe audiences (customer lists, remarketing, in-market, custom, similar, combined, product) targeted on — or EXCLUDED from — a Microsoft Advertising campaign or ad group, with each …Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_audience_targeting" 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 audiences (customer lists, remarketing, in-market, custom, similar, combined, product) targeted on — or EXCLUDED from — a Microsoft Advertising campaign or ad group, with each one’s bid adjustment and criterion id. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Audiences on a Microsoft campaign or ad group
  • list_microsoft_ads_audiencesList a Microsoft Advertising account's audiences — by default the CUSTOMER LISTS (Customer Match), with each row's membership duration and its current Search and Audience-network s…Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List a Microsoft Advertising account's audiences — by default the CUSTOMER LISTS (Customer Match), with each row's membership duration and its current Search and Audience-network sizes. TWO MICROSOFT CAVEATS THAT LOOK LIKE FAILURES AND ARE NOT: a size is nil or empty for UP TO 48 HOURS while a list is being built, and Microsoft will not use an audience of fewer than 300 people at all — so never report a fresh list's 0 as a failed upload. Pass types[] to ask for other audience types. Read-only, free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Microsoft Advertising audiences (Customer Match lists)
  • list_microsoft_ads_campaignsRead the brand’s connected Microsoft Advertising (Bing Ads) account(s).Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the brand’s connected Microsoft Advertising (Bing Ads) account(s). Call with NO adAccountId to list the accounts shared with this profile — do this first to pick a target. Call WITH adAccountId to list that account’s campaigns (id, name, status, daily budget, campaign type, and whether the budget is SHARED). Microsoft statuses are Active / Paused — never Google’s ENABLED — and Microsoft also sets BudgetPaused, BudgetAndManualPaused and Suspended on its own, so report the status you read rather than assuming a paused campaign was paused by a person. Read-only, free. Needs Microsoft Advertising connected (Connectors > Microsoft Advertising).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Microsoft Advertising accounts / campaigns
    • idempotentHint: true
  • list_microsoft_ads_conversion_goalsThe conversion goals on a Microsoft Advertising account — what the account COUNTS as a conversion, and therefore what every conversion-optimised bid strategy on it is optimising to…Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_conversion_goals" 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 conversion goals on a Microsoft Advertising account — what the account COUNTS as a conversion, and therefore what every conversion-optimised bid strategy on it is optimising toward. Flags which ones are OFFLINE goals: those are the only goals send_microsoft_ads_offline_conversions can post to, and its conversionName must match one of their names EXACTLY, including case and spacing. An account with no goals at all has no conversion tracking — say that plainly rather than reporting an empty list, because it means smart bidding there has nothing to aim at. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Microsoft Advertising conversion goals
    • idempotentHint: true
  • list_microsoft_ads_negative_keywordsThe NEGATIVE keywords (excluded searches) on a Microsoft Advertising campaign (campaignId) or ad group (adGroupId) with their ids and match types; with no id, the account’s SHARED …Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_negative_keywords" 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 NEGATIVE keywords (excluded searches) on a Microsoft Advertising campaign (campaignId) or ad group (adGroupId) with their ids and match types; with no id, the account’s SHARED negative keyword lists; with listId, the keywords in one list. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Microsoft Advertising negative keywords
  • list_microsoft_ads_profile_targetingRead the LinkedIn profile targeting on a Microsoft Advertising campaign: every company, industry, job function, seniority and job title criterion with its bid adjustment and criter…Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_profile_targeting" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the LinkedIn profile targeting on a Microsoft Advertising campaign: every company, industry, job function, seniority and job title criterion with its bid adjustment and criterion id, read from Microsoft. A profile type Microsoft would not read is named as unread, never reported as none. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a Microsoft Advertising campaign’s LinkedIn profile targeting
    • idempotentHint: true
  • list_microsoft_ads_uet_tagsThe UET tags (Microsoft’s site tracking pixel) on this Microsoft Advertising customer: id, name, status (Active / Inactive / Unverified) and each tag’s install snippet.Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_ads_uet_tags" 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 UET tags (Microsoft’s site tracking pixel) on this Microsoft Advertising customer: id, name, status (Active / Inactive / Unverified) and each tag’s install snippet. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Microsoft Advertising UET tags
  • list_microsoft_merchant_catalogsList the catalogs inside a Microsoft Merchant Center store.Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_merchant_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the catalogs inside a Microsoft Merchant Center store. Catalogs logically group products, and a Shopping campaign's product scope points at them. Each row says whether publishing is ENABLED — products in a catalog with publishing off do not serve at all, which is a common and invisible reason a feed appears healthy and delivers nothing. Products go into the store's default catalog unless a call names catalogId. Read-only, free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Microsoft Merchant Center catalogs
  • list_microsoft_merchant_issuesWhy a Microsoft Merchant Center store's products are NOT serving — the approved / disapproved / expiring counts plus the per-offer disapprovals and warnings with Microsoft's own is…Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_merchant_issues" 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_microsoft_merchant_issues" says "list" and "issue": it reads issues, which other people can write.
    • untrusted-inputThe description's first sentence says "issue": it reads issues, which other people can write.
    Description, as the server wrote it
    Why a Microsoft Merchant Center store's products are NOT serving — the approved / disapproved / expiring counts plus the per-offer disapprovals and warnings with Microsoft's own issue codes. This is the tool to reach for when a Microsoft Shopping campaign is live and showing nothing. TWO CAVEATS THAT LOOK LIKE FAILURES AND ARE NOT, both repeated in the note: Microsoft returns detail rows ONLY for offers that are Disapproved or in Warning, so an EMPTY detail list is the healthy state; and a status change takes up to two hours to reach the summary, so a fresh upload legitimately shows as nothing yet. Read-only, free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Why Microsoft Merchant Center products are not serving
  • list_microsoft_merchant_productsRead the product offers in a Microsoft Merchant Center store — the feed a Microsoft Shopping campaign serves from.Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_merchant_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the product offers in a Microsoft Merchant Center store — the feed a Microsoft Shopping campaign serves from. Pass productId to fetch ONE offer, or omit it to page the store (limit up to 250, then pass the returned pageToken). MICROSOFT'S PRODUCT IDS ARE COMPOSED AND CASE SENSITIVE: the id is channel:contentLanguage:targetCountry:offerId (e.g. Online:en:US:Sku123), not the bare offerId, and a re-cased id addresses nothing — always use the id this tool returned. Read-only, free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Microsoft Merchant Center product offers
  • list_microsoft_merchant_storesList the brand's MICROSOFT MERCHANT CENTER stores, the product-feed side of Microsoft Advertising.Reads text others writeNo findings

    Why it is in this group

    • The name "list_microsoft_merchant_stores" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the brand's MICROSOFT MERCHANT CENTER stores, the product-feed side of Microsoft Advertising. THIS IS WHERE THE merchantId COMES FROM: every other Microsoft Merchant tool needs it. Each row carries the store name, its URL, and whether it is active, has a catalog and has product ads enabled. Microsoft's own caveat, which the note repeats: those flags are set inside Merchant Center and are read-only here — an inactive store can still be referenced by a Shopping campaign. An account with NO store has no product feed at all, and a store cannot be created through the API. Read-only, free, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Microsoft Merchant Center stores
  • list_mixpanel_annotationsThe markers already on this Mixpanel project's charts (launches, campaigns, incidents) with their date, text, tags and who wrote them.Reads text others writeNo findings

    Why it is in this group

    • The name "list_mixpanel_annotations" 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 markers already on this Mixpanel project's charts (launches, campaigns, incidents) with their date, text, tags and who wrote them. READ THESE BEFORE EXPLAINING A CHANGE IN A CHART: an annotation is an explanation somebody already wrote down. fromDate / toDate (YYYY-MM-DD, both inclusive) narrow the window. Read-only, 0 credits. Needs Mixpanel connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Mixpanel annotations
    • idempotentHint: true
  • list_mixpanel_cohortsTHE SAVED COHORTS in the Mixpanel project — each with its id, name, description and CURRENT MEMBER COUNT.Reads text others writeNo findings

    Why it is in this group

    • The name "list_mixpanel_cohorts" 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 SAVED COHORTS in the Mixpanel project — each with its id, name, description and CURRENT MEMBER COUNT. Two uses, and both matter for advertising: the counts alone answer "how big is our converted audience", and the id is what mixpanel_profiles needs to read the PEOPLE in one. A cohort hidden in Mixpanel's UI is still listed and flagged rather than dropped, because hidden is a display choice and it is still queryable by id. ONE CALL, and the cheapest thing on this connector — worth calling before mixpanel_profiles rather than guessing an id. Remember Mixpanel allows only 60 QUERIES PER HOUR across its entire Query API (5 concurrent), the tightest budget of any connector here, and this shares it with every other Mixpanel tool. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List saved Mixpanel cohorts
    • idempotentHint: true
  • list_mixpanel_eventsThe EVENT VOCABULARY of the Mixpanel project — the most common event names over THE LAST 31 DAYS, so a query names something the project actually records rather than a guess.Reads text others writeNo findings

    Why it is in this group

    • The name "list_mixpanel_events" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The EVENT VOCABULARY of the Mixpanel project — the most common event names over THE LAST 31 DAYS, so a query names something the project actually records rather than a guess. Start here before any other Mixpanel call. Pass `event` to list THAT event's top property names instead; the two are different questions with different answers, and a failure to read properties is reported AS a failure and never as "this event has no properties". Pass window "today" for Mixpanel's separate today-only endpoint, which carries counts and the percent change from yesterday — that is a DIFFERENT and far narrower question, and on a quiet project (or simply early in the project's own timezone day) it legitimately returns nothing while the project still records dozens of event types, so NEVER read an empty today answer as "this project has no events". 60 queries/hour across the whole Query API (5 concurrent) — the tightest budget of any connector here, so widen a range rather than looping over days. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Mixpanel events (or one event’s properties)
    • 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_openai_ads_audience_operationsList the membership operations (add, remove, replace) ChatGPT Ads has accepted on one custom audience, each with its status.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_audience_operations" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "list" and "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    List the membership operations (add, remove, replace) ChatGPT Ads has accepted on one custom audience, each with its status. Use it to find an operation whose id was lost, or to see what is still pending, before get_openai_ads_audience_operation, cancel_openai_ads_audience_operation or resume_openai_ads_audience_operation. Read-only, free. Pages with limit (1-100, default 25) and cursor.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads audience membership operations
    • idempotentHint: true
  • list_openai_ads_audiencesList the custom audiences on the connected ChatGPT Ads account.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_audiences" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "list" and "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    List the custom audiences on the connected ChatGPT Ads account. Pass intendedUse to see only the ones eligible for exclusion, inclusion or a bid multiplier (inclusion and bid multipliers need roughly 25,000 matched users). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads custom audiences
    • idempotentHint: true
  • list_openai_ads_audit_logsWho changed what on the ChatGPT Ads account and when: each create/update with its actor and every changed field’s before and after value.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_audit_logs" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Who changed what on the ChatGPT Ads account and when: each create/update with its actor and every changed field’s before and after value. Read it first when a campaign starts or stops spending unexpectedly. Filter by campaignId (includes its ad groups and ads), adGroupId, adId, actorId, since/until (date, ISO time or unix seconds). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: ChatGPT Ads change history (audit log)
    • idempotentHint: true
  • list_openai_ads_business_agent_toolsThe eligible TOOLS installed for this ChatGPT Ads account that a Business Agent can be given (pass their ids as toolIds to create_openai_ads_business_agent).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_business_agent_tools" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The eligible TOOLS installed for this ChatGPT Ads account that a Business Agent can be given (pass their ids as toolIds to create_openai_ads_business_agent). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List tools a Business Agent may use
    • idempotentHint: true
  • list_openai_ads_business_agentsThe BUSINESS AGENTS on this ChatGPT Ads account — a Business Agent is a branded assistant ChatGPT serves inside an ad (mode business_agent on the campaign): instructions, conversat…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_business_agents" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The BUSINESS AGENTS on this ChatGPT Ads account — a Business Agent is a branded assistant ChatGPT serves inside an ad (mode business_agent on the campaign): instructions, conversation starters, optional product feeds, tools and a lead form. Shows draft/published status and pending changes. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads Business Agents
    • idempotentHint: true
  • list_openai_ads_campaignsRead the brand’s connected ChatGPT Ads account — the ads that appear below ChatGPT answers.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_campaigns" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Read the brand’s connected ChatGPT Ads account — the ads that appear below ChatGPT answers. Every campaign, ad group and ad row carries servingIssues, OpenAI’s own list of what is blocking delivery (payment method, brand review, budget spent, ad in review, landing page not crawlable, country policy…) with a plain meaning each: null means OpenAI was not asked, [] means it reports no blocker, which is still not a promise of impressions. Call with NO ids to get the ad account itself (its three names: brandName shown in ads, accountName internal to Ads Manager, legalName; currency, status, brand review and business review state) plus its campaigns; with campaignId to list that campaign’s ad groups; with adGroupId to list that ad group’s ads, including each ad’s REVIEW status, which is what decides whether it can ever show. Statuses here are active / paused / archived. Read-only, free, zero spend risk. Needs ChatGPT Ads connected under Connectors > ChatGPT Ads in the Hermoso app; one connection covers one ad account.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads account / campaigns / ad groups / ads
    • idempotentHint: true
  • list_openai_ads_conversion_eventsList the conversion event settings on the connected ChatGPT Ads account.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_conversion_events" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "list" and "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    List the conversion event settings on the connected ChatGPT Ads account. Their ids are what a campaign points at (conversionEventSettingIds) so it optimises for CONVERSIONS rather than raw clicks — without one, conversion-optimised bidding has nothing to optimise toward. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads conversion events
    • idempotentHint: true
  • list_openai_ads_feed_uploadsRecent product-feed UPLOADS across the account with per-upload status, rows accepted / rejected / ads-eligible and OpenAI’s DIAGNOSTICS (code, severity, field and rows affected, e.…Reads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_feed_uploads" 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
    Recent product-feed UPLOADS across the account with per-upload status, rows accepted / rejected / ads-eligible and OpenAI’s DIAGNOSTICS (code, severity, field and rows affected, e.g. invalid_value on price) — the way to learn why products are not serving. Per-product review status (why ONE product was rejected) is shown only in ChatGPT Ads Manager > Products: OpenAI does not expose it through the API, so say that rather than guessing. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads feed uploads
    • idempotentHint: true
  • list_openai_ads_feedsThe PRODUCT FEEDS on this ChatGPT Ads account (id, name, countries, currencies, the count of ingested products eligible for ads, and campaign count).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_feeds" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The PRODUCT FEEDS on this ChatGPT Ads account (id, name, countries, currencies, the count of ingested products eligible for ads, and campaign count). A product-feed campaign (mode product_feed) advertises products from one of these; update_openai_ads_feed_products fills one. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads product feeds
    • idempotentHint: true
  • list_openai_ads_lead_formsThe ChatGPT Ads LEAD FORMS on this ad account — id, status (draft/published/archived), draft and published revision ids, fields.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_lead_forms" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The ChatGPT Ads LEAD FORMS on this ad account — id, status (draft/published/archived), draft and published revision ids, fields. A lead form is what a Business Agent uses to collect a name/email/choice inside the chat; it only collects once PUBLISHED, and leads only arrive somewhere once a lead-sync subscription exists (list_openai_ads_lead_sync). Read-only, 0 credits. Needs ChatGPT Ads connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads lead forms
    • idempotentHint: true
  • list_openai_ads_lead_syncThe lead-sync subscription(s) on this ChatGPT Ads account — the webhook that receives every lead a lead form collects.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_lead_sync" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The lead-sync subscription(s) on this ChatGPT Ads account — the webhook that receives every lead a lead form collects. With none, leads have nowhere to go. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads lead-sync subscriptions
    • idempotentHint: true
  • list_openai_ads_leadsThe ChatGPT Ads leads delivered to Hermoso for this brand, newest first: each lead's answers keyed by the form's question labels (and by email / phone / full_name), the form id, th…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_leads" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    The ChatGPT Ads leads delivered to Hermoso for this brand, newest first: each lead's answers keyed by the form's question labels (and by email / phone / full_name), the form id, the campaign / ad group / ad ids, submittedAt. ChatGPT Ads has no endpoint that LISTS leads — they exist here only after set_openai_ads_lead_sync was called WITHOUT a destinationUrl, and only from then on. Synthetic test submissions are hidden unless includeSynthetic. These are real people's contact details. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: ChatGPT Ads leads received
  • list_openai_ads_spend_windowsAccount-level SPENDING LIMITS on ChatGPT Ads, both kinds: the date-range SPEND-LIMIT WINDOWS (a ceiling on what the whole account may spend between an inclusive start date and an e…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_openai_ads_spend_windows" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Account-level SPENDING LIMITS on ChatGPT Ads, both kinds: the date-range SPEND-LIMIT WINDOWS (a ceiling on what the whole account may spend between an inclusive start date and an exclusive end date, with amount and spent so far) and the DAILY LIMIT (a per-day ceiling that renews at midnight in the account timezone, with what is spent and left today). Also returns the configuration `revision` that set_openai_ads_daily_spend_limit and remove_openai_ads_daily_spend_limit need as expectedRevision, and the earliest date a new daily limit may start. A limit caps spend; it never makes anything spend. OpenAI serves account spending limits only to ad accounts on postpaid INVOICE billing, and every spending-limit request, reads included, needs billing-management permission: a card-billed account is refused (a 403 that says only admins can do it) from any key, including one its own admin created. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List ChatGPT Ads account spending limits
    • idempotentHint: true
  • list_pinterest_ads_audiencesList the Pinterest AUDIENCES on the ad account (what:"audiences", default) or its CUSTOMER LISTS (what:"customer_lists"), or read one by audienceId / customerListId.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_ads_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the Pinterest AUDIENCES on the ad account (what:"audiences", default) or its CUSTOMER LISTS (what:"customer_lists"), or read one by audienceId / customerListId. An audience id is what an ad group’s targetingSpec takes as {"AUDIENCE_INCLUDE":[id]} (retarget) or AUDIENCE_EXCLUDE (suppress). READY delivers; TOO_SMALL (under 100 people) never does. ownership:"RECEIVED" lists audiences shared with this account. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest audiences and customer lists
    • idempotentHint: true
  • list_pinterest_ads_campaignsRead the brand’s connected Pinterest AD account(s).Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the brand’s connected Pinterest AD account(s). Call with NO adAccountId to list the ad accounts shared with this profile — do this first to pick a target. Call WITH adAccountId to list that account’s campaigns (id, name, status, objective, budget, and Pinterest’s own summary status). Add campaignId to get that ONE campaign’s whole tree — its AD GROUPS and ADS with their ids, statuses and review status. That is the only way to enumerate them, and it matters: Pinterest has no delete, so an ad group you cannot see is one you cannot even archive. All money is in the AD ACCOUNT’S currency, which is not necessarily dollars. Pinterest’s own list default hides DRAFT and ARCHIVED objects; this asks for all four statuses so nothing is silently missing. Read-only, free. Needs Pinterest connected (Connectors > Pinterest) and the ad account ticked under Manage accounts (or call list_connector_accounts with provider pinterest_ads, then set_connector_accounts).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest ad accounts / campaigns
    • idempotentHint: true
  • list_pinterest_ads_conversion_tagsRead the brand’s Pinterest CONVERSION TAGS — the Pinterest tag a WEB_CONVERSION or SALES campaign optimises on.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_ads_conversion_tags" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "web": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Read the brand’s Pinterest CONVERSION TAGS — the Pinterest tag a WEB_CONVERSION or SALES campaign optimises on. view:"all" (default) lists every tag with status, when it last fired (a tag that has NEVER fired is not installed) and its code snippet; conversionTagId reads one tag in full; view:"ocpm_eligible" lists the (tag, event) pairs a conversion ad group can OPTIMISE for — put one in create_pinterest_ads_ad_group’s optimizationGoalMetadata as {"conversion_tag_v3_goal_metadata":{"conversion_event":…,"conversion_tag_id":…}}; view:"page_visit" lists page-visit events. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest conversion tags
    • idempotentHint: true
  • list_pinterest_ads_keywordsRead the KEYWORDS on a Pinterest ad group or campaign: the searches a SEARCH placement serves on, each with its match type.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_ads_keywords" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the KEYWORDS on a Pinterest ad group or campaign: the searches a SEARCH placement serves on, each with its match type. Pass adGroupId or campaignId (neither lists the account’s own negative keywords). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest ad keywords
    • idempotentHint: true
  • list_pinterest_ads_product_group_promotionsList the PRODUCT GROUPS being promoted in one Pinterest Shopping ad group — Pinterest lists them per ad group, so adGroupId is required — with status and bid.Reads text others writeNo findings

    Why it is in this group

    • The name "list_pinterest_ads_product_group_promotions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the PRODUCT GROUPS being promoted in one Pinterest Shopping ad group — Pinterest lists them per ad group, so adGroupId is required — with status and bid. A CATALOG_SALES ad group with none has no products to serve. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Pinterest product-group promotions
    • 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_posthog_annotationsThe markers already on this PostHog project's charts — releases, experiments, incidents — with their timestamps, scopes and who wrote them.Reads text others writeNo findings

    Why it is in this group

    • The name "list_posthog_annotations" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The markers already on this PostHog project's charts — releases, experiments, incidents — with their timestamps, scopes and who wrote them. READ THESE BEFORE EXPLAINING A CHANGE IN A CHART: an annotation is an explanation somebody already wrote down. NEEDS THE `annotation:read` SCOPE on the personal API key, and a key created before Hermoso supported annotations will not have it — PostHog's own refusal NAMES the scope, and that is a scope to add in PostHog > Settings > Personal API keys, NOT a broken connection and NOT a reason to reconnect. Returns ONE page and hands back the next offset rather than paging for you, because PostHog's policy is that a third-party connector is not an exporter. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List PostHog annotations
    • idempotentHint: true
  • list_posthog_session_recordingsSESSION REPLAYS.Reads text others writeNo findings

    Why it is in this group

    • The name "list_posthog_session_recordings" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    SESSION REPLAYS. Lists recent recordings with who they belong to, how long they ran, how many clicks / keypresses / CONSOLE ERRORS each had, the URL they started on, and a link that opens the replay in PostHog. USE THE SIGNALS RATHER THAN JUST LISTING THEM: a session with console errors and a high keypress count on a checkout page is a bug report with a video attached, and that is the insight worth surfacing. THE RAW REPLAY IS NOT AVAILABLE OVER THE API — PostHog's words: "This endpoint does not provide the raw JSON of the replays. To get the raw JSON, you need to click Export as JSON in the replay options menu in-app." So describe and link; never promise a download and never claim to have watched one. Links need the user's own PostHog login. A publicly shareable link is minted in the PostHog UI and deliberately not by an agent, because it publishes a real person's session and PostHog themselves say they "make no guarantees about sensitive information contained in the recording". Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List PostHog session replays
    • idempotentHint: true
  • list_reddit_ads_assetsThe IMAGE and VIDEO assets stored on a Reddit profile, with status, dimensions and media urls; filter by type and name, paginate with pageToken.Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_assets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The IMAGE and VIDEO assets stored on a Reddit profile, with status, dimensions and media urls; filter by type and name, paginate with pageToken. Reddit’s list is media-only: HEADLINE and CTA assets are stored but never listed here — read those by id with get_reddit_ads_asset (ids come from upload_reddit_ads_assets). OR pass postId (t3_…) to list the assets ONE POST uses, every type, each with its role (HEADLINE, IMAGE, VIDEO, CTA, THUMBNAIL, CAROUSEL_ITEM, HERO, SECONDARY_IMAGE) and image crop: those asset ids are what reddit_ads_report’s ASSET_ID breakdown reports on. Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Reddit asset library
    • idempotentHint: true
  • list_reddit_ads_audiencesList the CUSTOM AUDIENCES (uploaded customer lists) on a Reddit ad account, with each one’s match-size range and status.Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the CUSTOM AUDIENCES (uploaded customer lists) on a Reddit ad account, with each one’s match-size range and status. Reddit will not deliver to an audience under about 1,000 matched redditors, and the reply says which ones fall short — an audience that is too small silently reaches nobody rather than erroring. Use an id here as customAudienceIds in ad-group targeting to retarget it, or as excludedCustomAudienceIds to suppress existing customers from a prospecting campaign. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit custom audiences
    • idempotentHint: true
  • list_reddit_ads_campaignsRead the brand’s connected Reddit AD account(s).Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the brand’s connected Reddit AD account(s). Call with NO adAccountId to list the ad accounts shared with this profile — do this first to pick a target. Call WITH adAccountId to read that account’s whole tree at once: campaigns, ad groups and ads, each with its configured status and Reddit’s own effective status (the effective one is what says whether it could actually serve — PENDING_APPROVAL, CAMPAIGN_PAUSED, REJECTED and so on). Read-only, free. Needs Reddit Ads connected (Connectors > Reddit Ads) and the ad account ticked under Manage accounts (or call list_connector_accounts with provider reddit_ads, then set_connector_accounts).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit ad accounts / campaigns
    • idempotentHint: true
  • list_reddit_ads_catalogsRead the Reddit PRODUCT CATALOGS behind a shared ad account — what a catalog SALES campaign (create_reddit_ads_campaign objective SALES + useCatalog:true) advertises.Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the Reddit PRODUCT CATALOGS behind a shared ad account — what a catalog SALES campaign (create_reddit_ads_campaign objective SALES + useCatalog:true) advertises. With no catalogId: every catalog on the ad account’s business, with its product counts (total / approved / rejected / invalid), currency, language and attached pixels. With catalogId: that catalog’s linked FEEDS (url, REPLACE/UPDATE mode, schedule, next import), its PRODUCT SETS (id, name, filter, how many products match) and its recent IMPORTS — the product set id is the productSetId create_reddit_ads_ad_group needs. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit product catalogs, feeds and product sets
    • idempotentHint: true
  • list_reddit_ads_funding_instrumentsList the funding instruments (cards, credit lines, insertion orders) on a Reddit ad account and whether each can pay for delivery — Reddit’s own is_servable flag plus its reasons w…Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_funding_instruments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the funding instruments (cards, credit lines, insertion orders) on a Reddit ad account and whether each can pay for delivery — Reddit’s own is_servable flag plus its reasons when not (outside its dates, credit line used up, card not approved, not active, test). This is the answer to "why isn’t my Reddit campaign spending?" when everything is ACTIVE, and the source of the fundingInstrumentId create_reddit_ads_campaign accepts. mode: ALL (default), ACTIVE, INACTIVE, UPCOMING or SELECTABLE. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit funding instruments (can this account pay?)
    • idempotentHint: true
  • list_reddit_ads_lead_formsTHERE IS NO CREATE: Reddit retired onsite lead forms (the create call answers 410 Gone since 2026-09-30 and ads still using one were paused), so Hermoso offers no tool that makes o…Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_lead_forms" 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
    THERE IS NO CREATE: Reddit retired onsite lead forms (the create call answers 410 Gone since 2026-09-30 and ads still using one were paused), so Hermoso offers no tool that makes one. For new leads from Reddit, use a form on the advertiser’s own landing page inside a LEAD_GENERATION campaign (create_reddit_ads_campaign), measured with list_reddit_ads_pixels / send_reddit_ads_conversions. Listing and reading forms KEEPS WORKING past the 2026-09-21 sunset so advertisers can retain their records, but Reddit marked these reads deprecated too on 2026-11-05 (existing forms only, gone from later API versions, no end date yet): use this to EXPORT what exists. Reddit exposes no API for the LEADS a form collected; those are downloaded from Ads Manager, and existing onsite-form ads are paused on 2026-09-30. List the lead generation forms on a Reddit ad account, with the fields each one asks for. Reddit publishes NO endpoint for reading the leads a form has collected — the user downloads those from Reddit’s Ads Manager. Say that plainly if asked for the leads themselves; do not imply they can be fetched. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit lead generation forms
    • idempotentHint: true
  • list_reddit_ads_pixelsList the conversion pixels on a Reddit ad account, each with the LAST TIME IT FIRED — which is the difference between "a pixel exists" and "conversion tracking works".Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_pixels" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the conversion pixels on a Reddit ad account, each with the LAST TIME IT FIRED — which is the difference between "a pixel exists" and "conversion tracking works". Call this before building anything: since 13 July 2026 Reddit REQUIRES a pixel on every ad group and every CBO campaign, so an account with none cannot run ads at all. IMPORTANT: the Reddit API has no operation that creates a pixel — if the account has none, the only fix is for the user to add it in Reddit’s Events Manager (ads.reddit.com > Events Manager); never claim you can create one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit conversion pixels (and whether they are firing)
    • idempotentHint: true
  • list_reddit_ads_postsList the POSTS on a Reddit profile — these are the creatives Reddit ads promote.Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_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_reddit_ads_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the POSTS on a Reddit profile — these are the creatives Reddit ads promote. Use it to find an existing post to advertise rather than creating a near-duplicate. Call list_reddit_ads_profiles first for redditProfileId. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a Reddit profile’s ad posts
    • idempotentHint: true
  • list_reddit_ads_productsRead the products in a Reddit catalog (catalogId) or in one product set (productSetId), each with its title, price, availability, link, image and Reddit’s own review state and issu…Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "review": it reads comments, which other people can write.
    Description, as the server wrote it
    Read the products in a Reddit catalog (catalogId) or in one product set (productSetId), each with its title, price, availability, link, image and Reddit’s own review state and issues (the "reddit" block). Filter by approvalDecision (PENDING / APPROVED / REJECTED — REJECTED is how to find out why products are not serving), a search term, or specific ids. Paginated: pass the returned nextPageToken as pageToken. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List products in a Reddit catalog or product set
    • idempotentHint: true
  • list_reddit_ads_profilesList the Reddit PROFILES attached to an ad account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_profiles" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the Reddit PROFILES attached to an ad account. A Reddit ad promotes a POST, and every post is published AS one of these profiles — so this is the first call in any Reddit creative build, and its id is what create_reddit_ads_post needs. If it comes back empty, the ad account has no profile attached and nothing can be advertised from it yet. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Reddit profiles an ad account can publish as
    • idempotentHint: true
  • list_reddit_ads_saved_audiencesList the SAVED AUDIENCES on a Reddit ad account — named, reusable targeting definitions (communities, interests, geos, devices and so on) that an ad group can point at instead of r…Reads text others writeNo findings

    Why it is in this group

    • The name "list_reddit_ads_saved_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the SAVED AUDIENCES on a Reddit ad account — named, reusable targeting definitions (communities, interests, geos, devices and so on) that an ad group can point at instead of repeating the whole block. The reply says how many live ad groups each one is attached to, which is what makes editing one a decision rather than a formality. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Reddit saved audiences
    • idempotentHint: true
  • list_salesforce_ownersThe active Salesforce users records can be assigned to: id, name, email, username, title.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_salesforce_owners" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The active Salesforce users records can be assigned to: id, name, email, username, title. An id is what salesforceOwnerId takes. search narrows by name or email. Read-only, free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Salesforce users
    • idempotentHint: true
  • list_salesforce_recordsContacts, leads, accounts or opportunities from the brand's OWN Salesforce org, most recently changed first, or a search through Salesforce's own index (phone matches however the o…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_salesforce_records" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "contact": it reads contacts.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Contacts, leads, accounts or opportunities from the brand's OWN Salesforce org, most recently changed first, or a search through Salesforce's own index (phone matches however the org typed it). Filters: email (exact, never lags), phone, stage and open (opportunities), status (leads), salesforceOwnerId, salesforceAccountId, updatedSince; converted leads are left out unless includeConverted. fields adds any field by API name; offset pages up to 2,000. Read-only, free. Needs Salesforce connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List or search Salesforce records
    • idempotentHint: true
  • list_search_console_sitemapsThe sitemaps registered on a Search Console property: when each was last submitted and last downloaded by Google, whether Google has processed it yet, its error and warning counts,…Reads text others writeNo findings

    Why it is in this group

    • The name "list_search_console_sitemaps" 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 sitemaps registered on a Search Console property: when each was last submitted and last downloaded by Google, whether Google has processed it yet, its error and warning counts, and per content type how many URLs it SUBMITTED against how many are INDEXED. That last pair is the fastest read on whether a site has an indexing problem rather than a ranking one. Pass `feedpath` for one sitemap instead of the list, or `sitemapIndex` to list the sitemaps inside an index file. An empty list is a real answer — the property has no sitemap registered — and is not a failure. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a property’s sitemaps, with submitted-vs-indexed counts
    • idempotentHint: true
  • list_search_console_sitesThe Google Search Console properties SHARED WITH THIS PROFILE, each with the exact property string every other Search Console tool takes and the connected account's permission leve…Reads text others writeNo findings

    Why it is in this group

    • The name "list_search_console_sites" 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 Google Search Console properties SHARED WITH THIS PROFILE, each with the exact property string every other Search Console tool takes and the connected account's permission level on it. CALL THIS FIRST. A property is EITHER "sc-domain:example.com" (a Domain property, covering every scheme and subdomain) OR the full URL-prefix form "https://example.com/" including scheme and trailing slash — Google treats those as different properties and one of them will 403, so resolve it here rather than guessing, and never pass a bare domain. THIS IS NOT EVERY PROPERTY THE GOOGLE ACCOUNT CAN SEE, deliberately: one login commonly holds a dozen clients' properties, so the user ticks which belong to THIS profile and any other one is refused by name. An empty list means nothing is ticked yet — say so and point the user at Connectors > Google Search Console > Manage accounts (or call list_connector_accounts / set_connector_accounts with provider "google_search_console"); never name or guess a property. A row whose permissionLevel is siteUnverifiedUser will refuse every later call. Read-only, 0 credits. Needs Google Search Console connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Search Console properties shared with this profile
    • 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_shopify_marketing_activitiesThe marketing activities recorded in the merchant's Shopify > Marketing by Hermoso (and other apps): title, tactic, channel, status, UTM, budget, ad spend, dates and the remoteId e…Reads text others writeNo findings

    Why it is in this group

    • The name "list_shopify_marketing_activities" 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 marketing activities recorded in the merchant's Shopify > Marketing by Hermoso (and other apps): title, tactic, channel, status, UTM, budget, ad spend, dates and the remoteId each was recorded under. Filter by remoteId or a Shopify search query (e.g. Title:summer). Newest first; pass cursor for more. Read-only, free. Needs the store to have approved Hermoso's marketing permission. Works for the Shopify store connected to this brand or the store this account was installed on.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Shopify marketing activities
    • 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_snapchat_ads_accountsList the Snapchat AD ACCOUNTS SHARED WITH THIS PROFILE — the ones it may actually build on and spend from, which is NOT everything the Snapchat login can reach — id, name, currency…Reads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_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
    List the Snapchat AD ACCOUNTS SHARED WITH THIS PROFILE — the ones it may actually build on and spend from, which is NOT everything the Snapchat login can reach — id, name, currency, timezone and status. Every other Snapchat Ads tool needs an adAccountId and this is where it comes from. One call returns both tiers, because Snap nests ad accounts inside their organization. An account flagged as a TEST account is marked as such — those cannot serve real ads. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Snapchat organizations and ad accounts
    • idempotentHint: true
  • list_snapchat_ads_audiencesThe custom AUDIENCES on a Snapchat ad account — customer lists, lookalikes, website-event (pixel) and engagement audiences — with approximate size, upload status and whether each c…Reads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "website": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The custom AUDIENCES on a Snapchat ad account — customer lists, lookalikes, website-event (pixel) and engagement audiences — with approximate size, upload status and whether each can be targeted yet (READY, TOO_FEW_USERS, NOT_READY). Pass audienceId for one. Target them with create_snapchat_ads_ad_squad(audiences / excludeAudiences). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Snapchat audiences
    • idempotentHint: true
  • list_snapchat_ads_campaignsRead the whole Snapchat ad tree for an ad account — campaigns, ad squads and ads with their statuses.Reads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the whole Snapchat ad tree for an ad account — campaigns, ad squads and ads with their statuses. The three tiers are fetched separately so one failure cannot take the tree down, and a tier that FAILED to read is reported in `partial` rather than as an empty list: an empty list here means an empty account, never a failed read. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the Snapchat ad tree
    • idempotentHint: true
  • list_snapchat_ads_lead_formsThe LEAD FORMS on a Snapchat ad account — id, name, title and questions — or one form with formId.Reads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_lead_forms" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The LEAD FORMS on a Snapchat ad account — id, name, title and questions — or one form with formId. A Snapchat lead ad opens one of these: build the LEAD_GENERATION creative with upload_snapchat_ads_creative(leadGenerationFormId), then create_snapchat_ads_ad. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Snapchat lead forms
    • idempotentHint: true
  • list_snapchat_ads_leadsThe Snapchat leads Snapchat has delivered to Hermoso for this brand, newest first: leadId, createdAt, email, firstName, lastName, phone, postalCode, address, birthday, jobTitle, co…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_leads" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    The Snapchat leads Snapchat has delivered to Hermoso for this brand, newest first: leadId, createdAt, email, firstName, lastName, phone, postalCode, address, birthday, jobTitle, companyName, the custom answers and consents, and the form / campaign / ad squad / ad they came from. Only leads that arrived after manage_snapchat_ads_lead_webhook subscribed their form exist — an empty list means none ARRIVED, not that nobody signed up before delivery was on. Snapchat's sample leads (action:'test') are hidden unless includeTest. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • title: Snapchat leads received
  • list_snapchat_ads_pixelsThe Snap Pixels on a Snapchat ad account — id, name and status.Reads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_pixels" 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 Snap Pixels on a Snapchat ad account — id, name and status. A conversion ad squad (optimizationGoal PIXEL_PAGE_VIEW, PIXEL_ADD_TO_CART, PIXEL_PURCHASE or PIXEL_SIGNUP) optimises toward a pixel, so call this first and pass the pixelId to create_snapchat_ads_ad_squad. A pixel is made in Snapchat Ads Manager (Events Manager) and installed on the site; Snapchat publishes no API that creates one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Snap Pixels on a Snapchat ad account
    • idempotentHint: true
  • list_snapchat_ads_profilesFIND THE PUBLIC PROFILE ID EVERY SNAPCHAT AD CREATIVE REQUIRES.Reads text others writeNo findings

    Why it is in this group

    • The name "list_snapchat_ads_profiles" 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
    FIND THE PUBLIC PROFILE ID EVERY SNAPCHAT AD CREATIVE REQUIRES. Snapchat has required profile_properties on every creative since 2024-02-26, so without one upload_snapchat_ads_creative cannot build anything — this is where the id comes from. Snapchat publishes no clean list-profiles endpoint, so this reads the ad account SHARING POLICIES (the documented mechanism by which a profile reaches an ad account) and reports which resource-type token Snapchat accepted. IT CAN LEGITIMATELY FAIL: the Public Profile API is on a different host and documents its own OAuth scope which this connection does not hold, and a failure is reported as "could not tell" with the manual way out — NEVER as "you have no profiles", because an empty list there would look like a real answer. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Snapchat Public Profiles for an ad account
    • idempotentHint: true
  • list_stripe_chargesRecent charges on the brand's OWN Stripe account — amount, currency, status, refunds, customer email, description — newest first, optionally for one customer.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_stripe_charges" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Recent charges on the brand's OWN Stripe account — amount, currency, status, refunds, customer email, description — newest first, optionally for one customer. Read-only, free. Needs Stripe connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Stripe charges
    • idempotentHint: true
  • list_stripe_couponsCoupons on the brand's Stripe account: percent or amount off, duration, validity and redemptions.Reads text others writeNo findings

    Why it is in this group

    • The name "list_stripe_coupons" 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
    Coupons on the brand's Stripe account: percent or amount off, duration, validity and redemptions. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: list stripe coupons
    • idempotentHint: true
  • list_stripe_customersRecent customers on the brand's OWN Stripe account — email, name, created, currency, delinquent — newest first, or one customer by exact email.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_stripe_customers" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Recent customers on the brand's OWN Stripe account — email, name, created, currency, delinquent — newest first, or one customer by exact email. Read-only, free. Needs Stripe connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List Stripe customers
    • idempotentHint: true
  • list_stripe_invoicesInvoices on the brand's Stripe account, newest first: number, status (draft, open, paid, uncollectible, void), amount due and paid, customer email, dates and the hosted invoice lin…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_stripe_invoices" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "email": it reads mail.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Invoices on the brand's Stripe account, newest first: number, status (draft, open, paid, uncollectible, void), amount due and paid, customer email, dates and the hosted invoice link; filter by status or customer. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: list stripe invoices
    • idempotentHint: true
  • list_stripe_productsProducts on the brand's Stripe account with their active prices (amount, currency, one-time or recurring interval), which is what create_stripe_payment_link and create_stripe_subsc…Reads text others writeNo findings

    Why it is in this group

    • The name "list_stripe_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Products on the brand's Stripe account with their active prices (amount, currency, one-time or recurring interval), which is what create_stripe_payment_link and create_stripe_subscription take. active:false lists archived products too. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: list stripe products
    • idempotentHint: true
  • list_stripe_subscriptionsSubscriptions on the brand's OWN Stripe account with each item's price in MAJOR units (19.00 means $19.00), interval and quantity, and the MRR each contributes.Reads text others writeNo findings

    Why it is in this group

    • The name "list_stripe_subscriptions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Subscriptions on the brand's OWN Stripe account with each item's price in MAJOR units (19.00 means $19.00), interval and quantity, and the MRR each contributes. With NO status it returns everything that counts toward MRR — active + trialing + past_due — and says so; pass status all, canceled, unpaid, incomplete, incomplete_expired or paused for the rest, or filter by customer or price. Read-only, free. Needs Stripe connected (Connectors > Stripe, or connect_connector).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: list stripe subscriptions
    • idempotentHint: true
  • 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_tag_manager_containersThe Google Tag Manager containers SHARED WITH THIS PROFILE, with the exact containerPath every other Tag Manager tool needs.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tag_manager_containers" 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 Google Tag Manager containers SHARED WITH THIS PROFILE, with the exact containerPath every other Tag Manager tool needs. CALL THIS FIRST. A container is addressed by PATH, "accounts/<id>/containers/<id>", never by the GTM-XXXXXX public id a human reads off the snippet: no Tag Manager method accepts the public id, so passing one is refused. Each row carries the public id beside the path so you can match what the user says to what the API wants. THIS IS NOT EVERY CONTAINER THE GOOGLE ACCOUNT CAN SEE: one agency login routinely administers every client's container, and a container is not data about a client, it is control of what runs on their website, so the user ticks which containers belong to THIS profile and only those are reachable. An empty list means nothing is ticked yet: say so and point the user at Connectors, Google Tag Manager, Manage accounts (or call list_connector_accounts with provider google_tag_manager, then set_connector_accounts). Never name or guess a container. Read-only, free. Read-only, 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the Tag Manager containers shared with this profile
    • idempotentHint: true
  • list_tag_manager_tagsWHAT IS ACTUALLY FIRING ON THE SITE.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tag_manager_tags" 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
    WHAT IS ACTUALLY FIRING ON THE SITE. Every tag in the container's workspace with its type, whether it is paused, which triggers fire it by name, and the one field that matters most: whether each tag is LIVE on the website or only STAGED in a draft. Also returns the container's triggers so you can reuse one instead of creating a duplicate. USE THIS TO ANSWER "is conversion tracking actually working": a Google Ads conversion action created by create_google_ads_conversion_action records nothing until a tag in this container fires it, and this is the only way to see whether that tag exists, whether it is paused, and whether it has been published. THREE VALUES FOR live, AND THEY ARE DIFFERENT ANSWERS: true means it is in the published container version and running, false means it is staged and NOT running yet, and null means the published version could not be read so you cannot tell. Never report null as false. If the response says the container has never been published, nothing in it is running at all. Read-only, free. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What is actually firing on the site
    • idempotentHint: true
  • list_tag_manager_versionsTHE CONTAINER'S VERSION HISTORY, and the thing to read before proposing to publish or to roll one back.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tag_manager_versions" 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 CONTAINER'S VERSION HISTORY, and the thing to read before proposing to publish or to roll one back. Every version with its id, its name, how many tags, triggers and variables it holds, whether it is archived, and which one is LIVE on the site right now. This is what makes a publish reversible: pass a row's path as publish_tag_manager_container's versionPath to put that version back on the site. The live flag is three-valued — true, false, or null when Google would not tell us which version is live, and null must never be read as false. Read-only. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Tag Manager version history
    • 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_tiktok_ads_accountsList the TikTok ADVERTISER accounts this profile can act on — id, name, currency, timezone and status.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_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
    List the TikTok ADVERTISER accounts this profile can act on — id, name, currency, timezone and status. Every other TikTok Ads tool needs an advertiserId, and this is where it comes from: call this first and let the USER pick when there is more than one. Read-only, free, spends nothing. Needs TikTok ADS connected (Connectors > TikTok Ads). When nothing is shared and the user's TikTok login has no ad account at all, the reply says so: offer to create one with create_tiktok_ads_account.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok advertiser accounts
    • idempotentHint: true
  • list_tiktok_ads_app_eventsThe conversion events an APP campaign may actually optimise toward on one app — the app twin of list_tiktok_ads_pixels, and the same distinction between "an event exists" and "an a…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_app_events" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The conversion events an APP campaign may actually optimise toward on one app — the app twin of list_tiktok_ads_pixels, and the same distinction between "an event exists" and "an ad group can optimise for it". An event reporting INSUFFICIENT_POSTBACK is NOT broken and NOT misconfigured: TikTok needs more measured conversions before it will optimise toward it, and unlockThreshold says how many against conversions in the last 30 days. Only an event with usableForOptimization:true can be used today. A brand-new app with no measured conversions legitimately returns none. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List which app conversion events TikTok can optimise toward
    • idempotentHint: true
  • list_tiktok_ads_appsThe mobile apps registered on a TikTok ad account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_apps" 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 mobile apps registered on a TikTok ad account. An APP_INSTALL campaign cannot be built without one, and an APP-activity audience uses these ids as its event sources — so this is the missing lookup that made APP_INSTALL offerable and undeliverable in the same product, exactly as conversion campaigns were before pixels. Registering a NEW app is deliberately not offered here: it needs the store listing and the attribution provider, and it belongs in TikTok Ads Manager rather than being set on a user’s behalf. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the mobile apps on a TikTok ad account
    • idempotentHint: true
  • list_tiktok_ads_audiencesThe custom audiences on a TikTok ad account — retargeting pools built from real behaviour (website pixel, app activity, ad engagement, organic posts, leads, shop activity) plus any…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "website": it reads web pages, which anyone can write.
    Description, as the server wrote it
    The custom audiences on a TikTok ad account — retargeting pools built from real behaviour (website pixel, app activity, ad engagement, organic posts, leads, shop activity) plus any lookalike grown from them. Until this existed, TikTok targeting through Hermoso was interests-and-geo only. THE FIELD THAT DECIDES EVERYTHING IS usableInAdGroups: TikTok takes up to 48 HOURS to process a new audience, so isValid:false immediately after creation is the normal processing window rather than a failure, and only a valid audience changes delivery. ownership tells you whether this advertiser owns the audience or another one shared it. detail:true with audienceIds reads /dmp/custom_audience/get/ instead — adding the rule, the auto-refresh setting and any error message TikTok recorded. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a TikTok advertiser’s custom audiences
    • idempotentHint: true
  • list_tiktok_ads_blocked_wordsThe ad account’s blocked-word list — a standing filter that hides ANY comment containing one of these words, automatically, across every ad on the account, before a human ever sees…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_blocked_words" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    The ad account’s blocked-word list — a standing filter that hides ANY comment containing one of these words, automatically, across every ad on the account, before a human ever sees it. TikTok caps the list at 500 words per ad account and the reply says how many slots are left. Pass `check` with words to ask TikTok directly whether each one is already blocked — that answer is authoritative across the whole list rather than across the page you happened to fetch. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: The words TikTok auto-hides in comments on this ad account
    • idempotentHint: true
  • list_tiktok_ads_business_centersThe TikTok Business Centers reachable on this connection.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_business_centers" 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 TikTok Business Centers reachable on this connection. THIS IS THE ONE PIECE OF STRUCTURE THAT MAKES THE CATALOG TOOLS DIFFERENT FROM EVERY OTHER TIKTOK TOOL: a product catalog belongs to a Business Center, not to an ad account, so the catalog tools take a bcId from here and an advertiserId will not work. With exactly one Business Center reachable the catalog tools resolve it themselves; with several they refuse and name them rather than guessing, because a catalog created under the wrong Business Center is invisible to the ad account that needed it and nothing in the reply would say so. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the TikTok Business Centers this login administers
    • idempotentHint: true
  • list_tiktok_ads_campaignsRead a TikTok advertiser account’s whole tree in one call — campaigns, ad groups and ads, each with the operation status that says whether it is enabled at all.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read a TikTok advertiser account’s whole tree in one call — campaigns, ad groups and ads, each with the operation status that says whether it is enabled at all. Omit advertiserId when the brand reaches exactly one account; with several, the call names the choices rather than picking for you. THE THREE TIERS ARE READ SEPARATELY AND A TIER THAT FAILED IS REPORTED AS FAILED, never as empty — if the result carries a `partial` note, say which tier could not be read instead of telling the user they have no ads. Read-only, free. TikTok’s QPS is 1, so a big account reads back slowly: that is the throttle working, not a fault.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok campaigns, ad groups and ads
    • idempotentHint: true
  • list_tiktok_ads_catalog_productsThe products inside a TikTok catalog, each with whether it can ACTUALLY be advertised and — when it cannot — TikTok’s own rejection reason together with its suggested fix and which…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_catalog_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The products inside a TikTok catalog, each with whether it can ACTUALLY be advertised and — when it cannot — TikTok’s own rejection reason together with its suggested fix and which placements and countries were affected. usableInAds is true only when all three of audit approved, active status ACTIVATED and availability IN_STOCK / AVAILABLE_FOR_ORDER / PREORDER hold, so a catalog full of "approved" products can still be entirely unadvertisable and the raw audit status alone would not say so. Narrow with productIds, skuIds or productSetIds; productIds and skuIds cannot be used together (TikTok’s own rule), and TikTok returns at most 10,000 rows in total so page x pageSize is capped rather than paged into a 400. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the products in a TikTok catalog, with why any are unadvertisable
    • idempotentHint: true
  • list_tiktok_ads_catalog_setsThe product SETS in a TikTok catalog — the slices an ad group can target instead of the whole catalog — each with its filter conditions and how many products it holds.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_catalog_sets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The product SETS in a TikTok catalog — the slices an ad group can target instead of the whole catalog — each with its filter conditions and how many products it holds. Product sets are built in TikTok Ads Manager rather than here, and this reads what exists. On a very large set pass productCount:false, because counting products can time the call out at TikTok’s end — that is TikTok’s own caveat, not a guess. A null productCount means it was not requested or not returned, not that the set is empty. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the product sets in a TikTok catalog
    • idempotentHint: true
  • list_tiktok_ads_catalogsThe product catalogs in a TikTok Business Center — the containers Dynamic Product Ads sell from — each with HOW MANY OF ITS PRODUCTS ARE APPROVED, REJECTED OR STILL PROCESSING, whi…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_catalogs" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The product catalogs in a TikTok Business Center — the containers Dynamic Product Ads sell from — each with HOW MANY OF ITS PRODUCTS ARE APPROVED, REJECTED OR STILL PROCESSING, which is the difference between "the feed ran" and "the feed worked". A products:null on a row means those counts COULD NOT BE READ for that catalog, which is not the same as a catalog with no products. Pass regions:true to also get the regions a new catalog may target — worth doing BEFORE creating one, because a catalog’s region and currency are set once and can never be changed. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the product catalogs in a TikTok Business Center
    • idempotentHint: true
  • list_tiktok_ads_commentsThe public comments people have left on your TikTok ads — the read that finally makes TikTok comment moderation possible through Hermoso, where Meta and YouTube moderation already …Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_comments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_ads_comments" says "list" and "comment": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "comment": it reads comments, which other people can write.
    Description, as the server wrote it
    The public comments people have left on your TikTok ads — the read that finally makes TikTok comment moderation possible through Hermoso, where Meta and YouTube moderation already shipped. Covers both paid-impression ads and Spark Ads. TWO THINGS ARE NOT NEGOTIABLE AND BOTH COME FROM TIKTOK: comments are scoped to an AD GROUP and to nothing else (their search_field accepts the single value ADGROUP_ID, so there is no way to ask for one ad or a whole campaign — get ad group ids from list_tiktok_ads_campaigns), and startTime->endTime may span AT MOST 30 DAYS. That 30-day cap is not in TikTok’s parameter table; it was measured, and asking for more answers an opaque "The maximum allowed time span is 30 days" — so an empty result means "none in these 30 days", never "none ever", and covering a longer period means one call per slice. Every row carries what the other tools need: commentId, adId, tiktokItemId, identityId and identityType, plus hitBlockedWord (caught by your blocked-word list), isPinned, likes, replies, and canDelete — TikTok’s own per-comment answer to whether YOU may delete it, which is false for anything a member of the public wrote. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read the comments on a TikTok ad group’s ads
    • idempotentHint: true
  • list_tiktok_ads_crm_event_setsThe CRM Event sets on a TikTok ad account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_crm_event_sets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The CRM Event sets on a TikTok ad account. A CRM Event Set is where LEAD-LIFECYCLE events go — a lead that became qualified, booked a demo, or closed — and sending those back with send_tiktok_ads_events (eventSource "crm", eventSourceId = the set’s id) is what lets TikTok optimise a LEAD_GENERATION campaign toward leads that actually convert rather than toward form fills. An advertiser is capped at fifty sets. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok CRM Event sets
    • idempotentHint: true
  • list_tiktok_ads_custom_conversionsList the Custom Conversions defined on a TikTok EVENT SOURCE — narrower, rule-based conversions built on top of a pixel event (for example "Purchase, but only on /checkout/premium"…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_custom_conversions" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the Custom Conversions defined on a TikTok EVENT SOURCE — narrower, rule-based conversions built on top of a pixel event (for example "Purchase, but only on /checkout/premium"). A Custom Conversion belongs to an event source, NOT to an advertiser, so TikTok requires eventSourceType and eventSourceId; with none given this resolves the single pixel on the advertiser when there is exactly one and otherwise asks which. Pass a Custom Conversion to create_tiktok_ads_ad_group as customConversionId to optimise toward the narrow rule instead of the broad standard event. TikTok accepts it ONLY alongside a pixel and only when optimizationGoal is CONVERT or IN_APP_EVENT, and only when its own optimizationEvent matches the one on the ad group; usableForAds reports whether its activity status allows it. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok Custom Conversions
    • idempotentHint: true
  • list_tiktok_ads_identitiesList the IDENTITIES on a TikTok advertiser account — the TikTok accounts an ad is allowed to appear as.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_identities" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the IDENTITIES on a TikTok advertiser account — the TikTok accounts an ad is allowed to appear as. THIS IS A HARD PREREQUISITE, not a convenience: a TikTok ad carries no identity of its own and there is NO DEFAULT, so create_tiktok_ads_ad refuses without an id from here. Call it, show the user the list, and let them CHOOSE — an ad runs publicly under whichever account is named, so picking one for them is a public mistake on somebody else’s profile. If it comes back empty, no TikTok account has been authorised on this advertiser yet and nothing can be advertised from it; say that rather than guessing an id. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the TikTok identities an ad can post as
    • idempotentHint: true
  • list_tiktok_ads_identity_postsList the real ORGANIC TikTok posts published by one identity — the account itself, not the ad library.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_identity_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_ads_identity_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 real ORGANIC TikTok posts published by one identity — the account itself, not the ad library. THIS IS WHERE A SPARK AD STARTS: pass an itemId from here to create_tiktok_ads_ad as tiktokItemId and the ad IS that post, with its own comments, likes and shares, running under the account that made it. Use this for an account the brand controls or has been granted (identityType TT_USER or BC_AUTH_TT); for a CREATOR’s post they authorised with a code, use list_tiktok_ads_spark_posts instead. identityId and identityType both come from list_tiktok_ads_identities, and a BC_AUTH_TT identity ALSO needs the identityAuthorizedBcId reported next to it — TikTok refuses the call without it. TikTok defaults to VIDEO posts only, so pass itemType:"CAROUSEL" to see photo posts; an account that posts only photos otherwise looks empty. Paginated by CURSOR, not page: pass back the cursor while hasMore is true. posterUrl and previewUrl EXPIRE AFTER AN HOUR — show them, never store them. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the organic TikTok posts under an identity
    • idempotentHint: true
  • list_tiktok_ads_lead_fieldsThe questions a TikTok Instant Form asks — which is exactly the set of columns download_tiktok_ads_leads will return.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_lead_fields" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The questions a TikTok Instant Form asks — which is exactly the set of columns download_tiktok_ads_leads will return. It is NOT a fixed schema: it is whatever that form was built to ask, so read it before promising a user which fields their leads carry. leadSource DIRECT_MESSAGE reads the fields collected in the associated Business Account’s direct messages instead, and takes no pageId (TikTok says it is "not supported" there). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What one TikTok Instant Form asks
    • idempotentHint: true
  • list_tiktok_ads_lead_formsThe Instant Forms (lead forms) on a TikTok ad account — this is where the pageId every other lead tool needs comes from.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_lead_forms" 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 Instant Forms (lead forms) on a TikTok ad account — this is where the pageId every other lead tool needs comes from. A form whose status is EDITED is a DRAFT and has never been able to collect anything, which is a different thing from "a form with no leads". THERE IS NO API THAT CREATES AN INSTANT FORM: they are built in TikTok Ads Manager, so an advertiser with none needs one made there (or a LEAD_GENERATION campaign using promotionTargetType EXTERNAL_WEBSITE, which collects on your own site and has no form here). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a TikTok advertiser’s Instant Forms
    • idempotentHint: true
  • list_tiktok_ads_musicTikTok’s ad-cleared music for the ad account — the sound a CAROUSEL ad needs (musicId on create_tiktok_ads_ad with adFormat CAROUSEL_ADS).Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_music" 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
    TikTok’s ad-cleared music for the ad account — the sound a CAROUSEL ad needs (musicId on create_tiktok_ads_ad with adFormat CAROUSEL_ADS). Search by keyword, get recommendations for 2-35 already-uploaded carousel images (imageUrls), look up musicIds, or read the liked / history / your-uploads lists (searchType); scene CREATIVE_ASSET lists the creative-tools library instead. Preview URLs last 12 hours. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find TikTok ad music
    • idempotentHint: true
  • list_tiktok_ads_offline_event_setsThe Offline Event sets on a TikTok ad account — the containers real-world conversions are reported into: an in-store purchase, a phone booking, a signed contract, a call-centre sal…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_offline_event_sets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The Offline Event sets on a TikTok ad account — the containers real-world conversions are reported into: an in-store purchase, a phone booking, a signed contract, a call-centre sale. An id here is what send_tiktok_ads_offline_events reports into, and what send_tiktok_ads_events wants as eventSourceId when eventSource is "offline". The reply also counts how many are AUTO-TRACKING, which matters because an auto-tracking set is attached to every campaign created afterwards and TikTok caps an advertiser at ten of them. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok Offline Event sets
    • idempotentHint: true
  • list_tiktok_ads_pixelsList the conversion pixels on a TikTok ad account, each with the EVENTS it can optimise toward — which is the difference between "a pixel exists" and "this campaign can actually op…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_pixels" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the conversion pixels on a TikTok ad account, each with the EVENTS it can optimise toward — which is the difference between "a pixel exists" and "this campaign can actually optimise". Call it before building any conversion campaign (WEB_CONVERSIONS, CONVERSIONS, PRODUCT_SALES, LEAD_GENERATION): those need optimizationGoal CONVERT, which TikTok refuses without a pixel. Only an event reported under optimizationEvent can be used — TikTok returns none for PAGE_VIEW because it "cannot be used for optimization". An EMPTY event list is not proof a pixel is idle: TikTok refreshes pixel event data every 2-4 hours, so a pixel that started firing recently still reports []. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List a TikTok advertiser’s conversion pixels
    • idempotentHint: true
  • list_tiktok_ads_playablesList the playables in a TikTok advertiser's Creative Library: id, name, playable_url, orientation, and TikTok's check / review status (VALIDATE_SUCCESS can be saved; only AUDIT_SUC…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_playables" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    List the playables in a TikTok advertiser's Creative Library: id, name, playable_url, orientation, and TikTok's check / review status (VALIDATE_SUCCESS can be saved; only AUDIT_SUCCESS delivers). Free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List TikTok playables
  • list_tiktok_ads_rulesTHE AUTOMATED RULES RUNNING ON A TIKTOK AD ACCOUNT, and — the part that matters — which of them can move money.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_rules" 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 AUTOMATED RULES RUNNING ON A TIKTOK AD ACCOUNT, and — the part that matters — which of them can move money. Every row carries canSpend, the specific actions that put it there (armingActions), whether its reach is UNBOUNDED (a rule targeting "all active campaigns" re-resolves that set at every run, so it covers campaigns created after it was written), and a scopeToken. That token is what set_tiktok_ads_rule_status wants echoed back before it will arm a spending rule, and it is computed from the rule AS TIKTOK STORES IT — so it also detects a rule that has been edited in TikTok Ads Manager since it was read. The reply leads with the rules that are armed AND able to spend, because "what is running on my account that I am not watching" is the actual question. Pass ruleIds for specific rules, or filter by status / dimension / name. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok automated rules, classified by whether they can spend
    • idempotentHint: true
  • list_tiktok_ads_spark_postsList the TikTok posts a post OWNER has authorised this ad account to promote — the creator-collaboration half of Spark Ads.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_spark_posts" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "list_tiktok_ads_spark_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 TikTok posts a post OWNER has authorised this ad account to promote — the creator-collaboration half of Spark Ads. These are posts from accounts the brand does NOT control: the owner generates an authorization code in the TikTok app and authorize_tiktok_ads_spark_post applies it, after which the post appears here with the itemId create_tiktok_ads_ad needs as tiktokItemId. AN EMPTY LIST IS A NORMAL STARTING STATE, not a failure — it means nobody has authorised a post yet, and the fix is to ask a creator for a code, not to retry. Each row carries the authorization WINDOW (authStartTime / authEndTime): a Spark Ad cannot outlive its authorization, so check the end time before building a campaign around one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok posts authorised to this ad account
    • idempotentHint: true
  • list_tiktok_ads_store_productsThe products inside a TikTok Shop, with titles, images, price ranges, currency and historical sales.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_store_products" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The products inside a TikTok Shop, with titles, images, price ranges, currency and historical sales. Pass adCreationEligible to also learn which of them may ACTUALLY be advertised; CUSTOM_SHOP_ADS for Shopping Ads, GMV_MAX for a Product GMV Max campaign; and note that WITHOUT it TikTok does not report eligibility at all, so an absent flag means unknown rather than yes. That filter additionally requires an advertiserId, because eligibility is a fact about a product AND an ad account rather than about a product alone. This call is keyed on a BUSINESS CENTER, which list_tiktok_ads_stores reports on each store row. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the products in a TikTok Shop
    • idempotentHint: true
  • list_tiktok_ads_storesThe TikTok Shops granted to a TikTok ad account; what Shopping Ads and GMV Max campaigns sell from.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_stores" 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 TikTok Shops granted to a TikTok ad account; what Shopping Ads and GMV Max campaigns sell from. Each row also names the BUSINESS CENTER that can reach the shop, and that is what list_tiktok_ads_store_products needs, because the product endpoint is keyed on a Business Center rather than on this ad account. An empty result is a real answer rather than an error: a shop has to be created in TikTok Shop Seller Center and granted to the ad account, and this reads that grant rather than creating one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the TikTok Shops on a TikTok ad account
    • idempotentHint: true
  • list_tiktok_ads_verification_documentsWhich identity or business documents TikTok accepts for verification in a given country; the list differs everywhere, so there is no useful default and the country is required.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_ads_verification_documents" says "list": a word for reading.

    What it can reach

    • private-dataThe name "list_tiktok_ads_verification_documents" says "list" and "document": it reads documents.
    • private-dataThe description's first sentence says "document": it reads documents.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Which identity or business documents TikTok accepts for verification in a given country; the list differs everywhere, so there is no useful default and the country is required. Returns each document’s name and the code submit_tiktok_ads_verification needs. business_type BUSINESS asks about company paperwork (an EIN letter, a certificate of incorporation); INDIVIDUAL asks about personal identification (passport, driver’s licence, residence card). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the verification documents TikTok accepts in a country
    • idempotentHint: true
  • list_tiktok_creator_labelsTikTok’s creator category labels, in two sets that are NOT interchangeable.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_creator_labels" 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
    TikTok’s creator category labels, in two sets that are NOT interchangeable. labelType "SEARCH" gives the tags discover_tiktok_creators filters on: contentLabelIds is what a creator POSTS about, industryLabelIds the commercial categories they have actually worked in. labelType "RANKING" gives the labels tiktok_creator_leaderboard needs, and there the pairing is strict: BRANDED_CONTENT ranks by an INDUSTRY label, ORGANIC_CONTENT by a CONTENT label. Both arrive as bare numeric ids that look identical, and TikTok reports a mismatch as an invalid field rather than as the wrong kind of label, so read this first rather than guessing. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok creator category labels
    • idempotentHint: true
  • list_tiktok_smart_campaignsRead the Smart+ campaigns on a TikTok advertiser, or with level "adgroup" its Smart+ ad groups, filtered by campaignIds, adGroupIds, name, statuses, and modifiedAfter / createdAfte…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_smart_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the Smart+ campaigns on a TikTok advertiser, or with level "adgroup" its Smart+ ad groups, filtered by campaignIds, adGroupIds, name, statuses, and modifiedAfter / createdAfter / createdBefore (UTC). TikTok’s reads LAG its writes, so something created seconds ago can be missing here and still exist — the reply says so rather than reporting an empty account.

    Annotations the server declares

    • destructiveHint: false
    • readOnlyHint: true
    • openWorldHint: true
    • title: List TikTok Smart+ campaigns or ad groups
    • idempotentHint: true
  • list_tiktok_tto_accountsThe TikTok One accounts this TikTok connection can act on.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_tto_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
    The TikTok One accounts this TikTok connection can act on. TikTok One is TikTok’s influencer marketplace: find creators, invite them to a campaign, get their videos tagged to it, read organic-versus-paid performance on those videos, and ask them for Spark Ads authorization so the brand can put money behind their post. THIS IS THE ONE PIECE OF STRUCTURE THAT MAKES THE CREATOR TOOLS DIFFERENT: a TikTok One account id is a THIRD id space beside an advertiser id and a Business Center id, and every creator-marketplace tool needs one from here. With exactly one reachable the other tools resolve it themselves; with several they refuse and name them. It rides the SAME connection and the SAME OAuth flow as TikTok Ads and there is nothing extra to apply for; but a connection authorized before 2026-08-19 does not carry the TikTok One permission and its owner has to reconnect. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the TikTok One (Creator Marketplace) accounts on this connection
    • idempotentHint: true
  • list_tiktok_tto_brand_profilesThe Brand Profiles on a TikTok One account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_tto_brand_profiles" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The Brand Profiles on a TikTok One account. A Brand Profile is what a creator sees when they open an invite link; name, industry, logo, website and optionally the brand’s own TikTok account; and a brand-level campaign cannot exist without one. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok One brand profiles
    • idempotentHint: true
  • list_tiktok_tto_campaignsThe TikTok One creator campaigns on this account, each with its invite link, the creators invited, the videos linked so far, the ad accounts that automatically receive Spark Ads ri…Reads text others writeNo findings

    Why it is in this group

    • The name "list_tiktok_tto_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The TikTok One creator campaigns on this account, each with its invite link, the creators invited, the videos linked so far, the ad accounts that automatically receive Spark Ads rights, and the COUNTRY CODES that tiktok_tto_campaign_report needs. TWO TIKTOK BEHAVIOURS WORTH KNOWING: it pages five at a time, which is its own maximum rather than ours, and it defaults to campaignType CAMPAIGN: so a brand-level campaign is invisible here unless you ask for BRAND_LINK explicitly. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List TikTok One creator campaigns
    • idempotentHint: true
  • list_tracking_tagsWHICH PIXELS ARE ON THE WEBSITE RIGHT NOW, read from the live page (url, default the brand's website) the way a browser loads it: every Meta, TikTok, Google, LinkedIn, Reddit, Pint…Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "list_tracking_tags" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "website": 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
    WHICH PIXELS ARE ON THE WEBSITE RIGHT NOW, read from the live page (url, default the brand's website) the way a browser loads it: every Meta, TikTok, Google, LinkedIn, Reddit, Pinterest, X and Snap pixel and every Tag Manager container Hermoso recognises there, with its id. Also the tags Hermoso installed through Tag Manager (live or only staged) and the site's Wix marketing tags, when those are connected. Use it to check a pixel someone pasted by hand, or to answer "is my pixel installed". page.read false means the page could not be read, which is not the same as no pixels. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Which pixels are on the website
  • list_vercel_deploymentsDeployments on the brand's Vercel account, newest first: URL, state (READY, BUILDING, QUEUED, ERROR, CANCELED...), target (production or preview), when it was created and became re…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_vercel_deployments" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "commit": it reads repositories.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Deployments on the brand's Vercel account, newest first: URL, state (READY, BUILDING, QUEUED, ERROR, CANCELED...), target (production or preview), when it was created and became ready, the commit message and Vercel's inspector link. Filter by projectId, target or state, or pass deploymentId (an id or a deployment URL) to read one, e.g. to see whether a page you just deployed is READY. Read-only, free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Vercel deployments
  • list_vercel_domainsThe domains on the brand's Vercel account (verified or not, when they expire), or with projectId the domains assigned to one project (and any redirect or git branch on them).Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_vercel_domains" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "branch": it reads repositories.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    The domains on the brand's Vercel account (verified or not, when they expire), or with projectId the domains assigned to one project (and any redirect or git branch on them). Read-only, free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Vercel domains
  • list_vercel_projectsThe brand's Vercel projects (its websites): name, id, framework, production URL and state, the latest deployment (URL, state, target, when), the linked git repo, and whether Web An…Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "list_vercel_projects" says "list": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "repo": it reads repositories.
    • 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 brand's Vercel projects (its websites): name, id, framework, production URL and state, the latest deployment (URL, state, target, when), the linked git repo, and whether Web Analytics and Speed Insights are on. search filters by project name. Read-only, free. Needs Vercel connected (Connectors > Vercel, or connect_connector with an access token).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: List Vercel projects
  • list_x_ads_accountsList the X (Twitter) ad accounts this profile can act on, with the PERMISSION LEVEL held on each so you can tell an admin grant from a read-only one before attempting a write.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_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
    List the X (Twitter) ad accounts this profile can act on, with the PERMISSION LEVEL held on each so you can tell an admin grant from a read-only one before attempting a write. X grants API access PER AD ACCOUNT, not per app: the customer adds Hermoso’s X user to their ad account at business.x.com -> Account access, and it appears here. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X ad accounts
    • idempotentHint: true
  • list_x_ads_audiencesList the custom audiences (customer lists) on an X ad account — size, whether each can be targeted yet and why not.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_audiences" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the custom audiences (customer lists) on an X ad account — size, whether each can be targeted yet and why not. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X custom audiences
    • idempotentHint: true
  • list_x_ads_campaignsList campaigns on an X ad account — status, budgets, and whether X considers each servable.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_campaigns" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List campaigns on an X ad account — status, budgets, and whether X considers each servable. Omit adAccountId when only one account is reachable and it resolves itself. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X ads campaigns
    • idempotentHint: true
  • list_x_ads_cardsList the cards on an X ad account with their card_uri and destination.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_cards" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "uri": it reads web pages, which anyone can write.
    Description, as the server wrote it
    List the cards on an X ad account with their card_uri and destination. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X ad cards
    • idempotentHint: true
  • list_x_ads_funding_instrumentsList the funding instruments (payment methods) on an X ad account — type, currency, credit limit, credit remaining, and whether each can currently fund a campaign.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_funding_instruments" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the funding instruments (payment methods) on an X ad account — type, currency, credit limit, credit remaining, and whether each can currently fund a campaign. THIS IS THE ANSWER TO “why is my X campaign not delivering?” whenever the cause is a cancelled card or an exhausted credit line, which is invisible from the campaign itself, and it shows what a campaign will spend against BEFORE anyone activates it. Hermoso cannot add a payment method — that is done at ads.x.com. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X ad account payment methods
    • idempotentHint: true
  • list_x_ads_lead_formsList the lead forms on an X ad account (or one, with leadFormId) — fields, privacy policy, and the customer-list audience X builds from each form's leads.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_lead_forms" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the lead forms on an X ad account (or one, with leadFormId) — fields, privacy policy, and the customer-list audience X builds from each form's leads. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X lead forms
    • idempotentHint: true
  • list_x_ads_line_itemsList the line items on an X ad account — X's name for an ad group, and the level that carries the objective, the placements, the bid, the targeting and the creatives.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_line_items" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the line items on an X ad account — X's name for an ad group, and the level that carries the objective, the placements, the bid, the targeting and the creatives. Pass campaignId to scope it to one campaign. `servable` is X's own verdict on whether the line item could run. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X ads line items
    • idempotentHint: true
  • list_x_ads_mediaList the X ad account's Media Library — media keys usable in cards and promoted-only posts.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_media" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the X ad account's Media Library — media keys usable in cards and promoted-only posts. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List an X ad account’s Media Library
    • idempotentHint: true
  • list_x_ads_postsList the posts an X ad account can promote — promoted-only ones by default (timeline NULLCAST), or ORGANIC / ALL.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_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_x_ads_posts" says "list" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "list" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    List the posts an X ad account can promote — promoted-only ones by default (timeline NULLCAST), or ORGANIC / ALL. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the posts an X ad account can promote
    • idempotentHint: true
  • list_x_ads_promotable_usersThe X accounts this ad account may promote — FULL (can be promoted for followers with create_x_ads_promoted_account and have its posts promoted) or RETWEETS_ONLY (posts only).Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_promotable_users" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    The X accounts this ad account may promote — FULL (can be promoted for followers with create_x_ads_promoted_account and have its posts promoted) or RETWEETS_ONLY (posts only). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List the X accounts an ad account may promote
    • idempotentHint: true
  • list_x_ads_promoted_tweetsList the promoted posts (the CREATIVES) attached to an X line item, or across the whole ad account.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_promoted_tweets" 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_x_ads_promoted_tweets" says "list" and "tweet": 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 promoted posts (the CREATIVES) attached to an X line item, or across the whole ad account. Two things only this can tell you: each post's APPROVAL STATUS, so an ad X rejected — which can never serve however the statuses are set — is visible rather than mysterious; and the promoted-tweet ID, which is the only way to remove one. NOTE a promoted post cannot be PAUSED on X (its PUT accepts only an approval appeal), so the reversible way to stop it is to pause its LINE ITEM. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List X promoted posts
    • idempotentHint: true
  • list_x_ads_targetingList every targeting criterion an X line item carries, WITH THE ID of each — the id needed to remove one with delete_x_ads_object.Reads text others writeNo findings

    Why it is in this group

    • The name "list_x_ads_targeting" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List every targeting criterion an X line item carries, WITH THE ID of each — the id needed to remove one with delete_x_ads_object. READ THE EMPTY CASE CORRECTLY: no targeting criteria on X means the line item is UNRESTRICTED and will reach the broadest possible audience once ACTIVE — it does NOT mean it cannot serve. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: List an X line item’s targeting
    • idempotentHint: true
  • merchant_account_statusWHY THE MERCHANT CENTER ACCOUNT IS OR IS NOT SERVING, in one read.Reads text others writeNo findings

    Why it is in this group

    • The name "merchant_account_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHY THE MERCHANT CENTER ACCOUNT IS OR IS NOT SERVING, in one read. Do not trust the program state on its own: an account can report Shopping ads and free listings as ENABLED and serve in ZERO countries, because Google counts a region as active only where every requirement for that program is met. This reports the active regions, the unmet requirements Google names with its own help link for each, and then the eight account settings that explain them — whether the homepage is CLAIMED (unclaimed stops the whole account serving), whether business info has an address, a verified phone and a customer service contact, whether any active shipping service covers the countries you sell to, the return policies, whether the Merchant Center terms have been accepted, plus autofeed and automatic improvements. An account with no shipping settings at all is reported as not configured, which is an account state and not a failed read. Anything that genuinely could not be read comes back null with a warning, which means unknown rather than missing. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Merchant Center serving status
  • mixpanel_insightsREAD BACK A SAVED MIXPANEL REPORT by its bookmark id — and this is the PREFERRED Mixpanel lane, not a fallback.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    READ BACK A SAVED MIXPANEL REPORT by its bookmark id — and this is the PREFERRED Mixpanel lane, not a fallback. Mixpanel has put BOTH its Segmentation and its Funnels query APIs in maintenance mode and recommends in their place that the report is built in the Mixpanel UI and read programmatically through Insights, which is exactly what this does. THE BOOKMARK ID MUST COME FROM THE USER: Mixpanel publishes no endpoint that lists saved reports, so ask them to open the report in Mixpanel and copy the id out of its URL (the part after "report-"). Remember Mixpanel allows only 60 QUERIES PER HOUR across its entire Query API — the tightest budget of any connector here — so reuse an answer rather than re-asking. READ BACK dateRange, do not assume the window: a saved report's date range is configured in Mixpanel's own UI and not by this call, and it comes back stamped with the PROJECT's UTC offset — the only place this connector can observe that timezone at all. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a saved Mixpanel report
    • idempotentHint: true
  • pinterest_ads_account_dataRead Pinterest ad-account data.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read Pinterest ad-account data. what: conversion_eqs (Event Quality Score of the conversion signals; lookback 1d or 14d, optional sourcePlatform, ingestionSource), metrics_ready_state (whether a date’s numbers are final; date YYYY-MM-DD), report_templates, promotions, targeting_templates. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Pinterest ad-account data
    • idempotentHint: true
  • posthog_insightRead back an insight the user already BUILT in their PostHog UI — funnels, retention curves, trends and paths.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "post": it reads posts, which other people can write.
    Description, as the server wrote it
    Read back an insight the user already BUILT in their PostHog UI — funnels, retention curves, trends and paths. Call with NO id to LIST the saved insights with their names and ids; call with insightId for that insight's definition and computed result. THIS IS THE RIGHT WAY TO ANSWER A FUNNEL OR RETENTION QUESTION when the report already exists, and the reason is a documentation fact rather than a preference: PostHog's typed query kinds (FunnelsQuery, RetentionQuery, PathsQuery) are undocumented — their own docs say those "are mostly used to power PostHog internally and are not useful for you" and publish no request payload, no field table and no example for any of them, so building on them would be a private API that can change without notice. The two supported routes are HogQL (posthog_query) and a saved insight (this). Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read a saved PostHog insight (funnel / retention / trend)
    • idempotentHint: true
  • posthog_queryASK POSTHOG A QUESTION IN HogQL — their SQL dialect over the `events`, `persons` and `sessions` tables.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "posthog_query" says "query": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "sql": 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
    ASK POSTHOG A QUESTION IN HogQL — their SQL dialect over the `events`, `persons` and `sessions` tables. Use it for per-user funnels, retention and custom breakdowns, e.g. `SELECT properties.$current_url, count() FROM events WHERE event = '$pageview' AND timestamp > now() - INTERVAL 7 DAY GROUP BY 1 ORDER BY 2 DESC`. IT IS NOT AN EXPORTER AND MUST NEVER BE LOOPED — PostHog's own policy, verbatim: "Third-party connectors must use batch exports, not /query. Connectors built on /query are not supported and will be rate-limited or rejected." Ask ONE bounded question. Do not paginate it, do not schedule it, and do not call it repeatedly to assemble a whole table; if the user genuinely needs bulk data, tell them to set up a PostHog batch export. Every query is capped at 1000 rows, and OFFSET is refused outright because PostHog returns HTTP 400 for it on API keys — use keyset pagination on `timestamp` (events) or `id` (persons) if a second page is truly needed. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Ask PostHog a question in HogQL
    • idempotentHint: true
  • preview_google_ads_adA shareable Google preview link (viewable with no Google Ads login, good for client approval) for a Performance Max asset group, or for a YouTube video ad.Reads text others writeNo findings

    Why it is in this group

    • The name "preview_google_ads_ad" says "preview": 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
    A shareable Google preview link (viewable with no Google Ads login, good for client approval) for a Performance Max asset group, or for a YouTube video ad. Google cannot preview Search or Display ads (RSA/RDA), and that is refused by name for free. Links expire and cannot be embedded in an iframe. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Shareable Google Ads preview link
  • preview_linkedin_adSee a LinkedIn ad exactly as LinkedIn renders it: desktop and mobile feed preview links straight from LinkedIn (they expire after ~3 hours — ask again for fresh ones), plus the ad’…Reads text others writeNo findings

    Why it is in this group

    • The name "preview_linkedin_ad" says "preview": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    See a LinkedIn ad exactly as LinkedIn renders it: desktop and mobile feed preview links straight from LinkedIn (they expire after ~3 hours — ask again for fresh ones), plus the ad’s REVIEW status and, if LinkedIn rejected it, its rejection reasons and serving holds. Works for single-image, carousel, video, job and event ads; LinkedIn’s Ad Preview API renders none for text-only or document ads, and the reply says so. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Preview a LinkedIn ad + its review status
  • preview_meta_adRender a REAL preview of a Meta ad, per placement — Meta returns a link that shows exactly what a person scrolling Facebook or Instagram would see.Reads text others writeNo findings

    Why it is in this group

    • The name "preview_meta_ad" says "preview": 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
    Render a REAL preview of a Meta ad, per placement — Meta returns a link that shows exactly what a person scrolling Facebook or Instagram would see. Pass adAccountId + adId (from list_meta_ads), or creativeId. Optional placements (comma-separated): facebook_feed, facebook_feed_desktop, facebook_story, facebook_reels, facebook_profile_feed, facebook_marketplace, facebook_right_column, facebook_video_feed, instagram_feed, instagram_story, instagram_reels, instagram_explore, instagram_profile_feed, messenger_inbox, messenger_story, audience_network — default facebook_feed + instagram_feed + instagram_story + instagram_reels. Short words are read too and the reply says how: feed means facebook_feed, story/stories means facebook_story, reels means facebook_reels, instagram/ig means instagram_feed, ig_story, ig_reels. Free, read-only, spends nothing. THE LINKS EXPIRE AFTER 24 HOURS — always say so when handing them to a user. Use it straight after create_meta_ad, and whenever someone wants to approve an ad before it runs.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Preview a Meta ad exactly as it will appear
    • idempotentHint: true
  • preview_openai_ads_adRender a real preview of an existing ChatGPT Ads ad, so a human can LOOK at what will run instead of reading a list of ids back.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "preview_openai_ads_ad" says "preview": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "chat": it reads messages.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "chat": it reads messages, which other people can write.
    Description, as the server wrote it
    Render a real preview of an existing ChatGPT Ads ad, so a human can LOOK at what will run instead of reading a list of ids back. Returns a hosted preview URL. THE LINK EXPIRES 24 HOURS AFTER IT IS CREATED — state that whenever you hand it to anyone, and generate a fresh one rather than re-sending an old one, because a dead link given to a client is worse than no link. Changes nothing about the ad; free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Preview a ChatGPT Ads ad
    • idempotentHint: true
  • preview_snapchat_ads_creativeSee a Snapchat ad before it spends: a Snap-hosted preview page of the creative (no login, live for 90 days), its type and its review status.Reads text others writeNo findings

    Why it is in this group

    • The name "preview_snapchat_ads_creative" says "preview": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    See a Snapchat ad before it spends: a Snap-hosted preview page of the creative (no login, live for 90 days), its type and its review status. snapcode:true adds a Snapcode image to scan with the Snapchat app (its expiry is printed). Pass creativeId, or adId to preview the creative that ad uses. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Preview a Snapchat ad
    • idempotentHint: true
  • preview_tag_manager_publishWHAT WOULD HAPPEN IF YOU PUBLISHED — free, read-only, and it publishes nothing.Reads text others writeNo findings

    Why it is in this group

    • The name "preview_tag_manager_publish" says "preview": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    WHAT WOULD HAPPEN IF YOU PUBLISHED — free, read-only, and it publishes nothing. Returns the container, the version live on the site right now and what it holds, the exact list of staged changes (added, updated, deleted) as Tag Manager itself reports them, any merge conflicts, and the one sentence to show a user before asking them to agree. Use it to answer 'what is waiting to go live?' without going anywhere near the publish call. publish_tag_manager_container without confirm returns the same facts, so this is for when you want them with no chance of a publish at all. 0 credits. Needs Google Tag Manager connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What would go live
    • idempotentHint: true
  • preview_tiktok_ads_adSee a TikTok ad the way it renders on TikTok: pass adId for an EXISTING ad (the link works for 30 days), or a videoId with displayName and adText to preview a video BEFORE any ad i…Reads text others writeNo findings

    Why it is in this group

    • The name "preview_tiktok_ads_ad" says "preview": 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
    See a TikTok ad the way it renders on TikTok: pass adId for an EXISTING ad (the link works for 30 days), or a videoId with displayName and adText to preview a video BEFORE any ad is built (24 hours). TikTok also returns its own fix-it tips per placement (for example a resolution that is too low) — relay them. Read-only, free, spends nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Preview a TikTok ad
    • idempotentHint: true
  • preview_tiktok_smart_adSee a Smart+ ad as it renders on TikTok, before or after it exists.Reads text others writeNo findings

    Why it is in this group

    • The name "preview_tiktok_smart_ad" says "preview": 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
    See a Smart+ ad as it renders on TikTok, before or after it exists. Pass smartPlusAdId for an existing Smart+ ad, OR the fields create_tiktok_smart_ad takes to preview one you have not created yet: creatives (each with identity_type and identity_id from list_tiktok_ads_identities, which TikTok requires here), adTexts, callToActions, adConfiguration (the catalog_tag_list of an inventory card goes inside its product info object), interactiveAddOnCardId, and disclaimerText or disclaimerLinks. For a catalog ad add catalogEnabled, catalogId and catalogAuthorizedBcId. Up to 31 creatives. Returns a preview link TikTok keeps for 30 days. Creates nothing and spends nothing.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
    • title: Preview a TikTok Smart+ ad
  • preview_x_ads_postSee X posts exactly as the ad will render — X returns a preview page per post (works for promoted-only posts).Reads text others writeNo findings

    Why it is in this group

    • The name "preview_x_ads_post" says "preview": 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 "preview_x_ads_post" says "preview" and "post": it reads posts, which other people can write.
    • untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
    Description, as the server wrote it
    See X posts exactly as the ad will render — X returns a preview page per post (works for promoted-only posts). Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Preview an X ad post
    • idempotentHint: true
  • 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
  • query_openai_ads_feed_productsList the products in a feed that match filters ({field, operator in|not_in|gt|gte|lt|lte|contains|not_contains|starts_with, values[]}) — the SAME filter shape an ad group’s product…Reads text others writeNo findings

    Why it is in this group

    • The name "query_openai_ads_feed_products" says "query": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the products in a feed that match filters ({field, operator in|not_in|gt|gte|lt|lte|contains|not_contains|starts_with, values[]}) — the SAME filter shape an ad group’s productSet takes, so this previews exactly which products that ad group would advertise. Each product carries its price and filter values. It does not carry a per-product review status: that is only in ChatGPT Ads Manager > Products. Paginate with after. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Query products in a ChatGPT Ads feed
    • 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_meta_leadsRead the LEADS a form (formId) or a single ad (adId) has collected — the real answers people submitted, fetched live from Meta.Reads text others writeNo findings

    Why it is in this group

    • The name "read_meta_leads" 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 the LEADS a form (formId) or a single ad (adId) has collected — the real answers people submitted, fetched live from Meta. THIS RETURNS REAL PEOPLE’S CONTACT DETAILS (names, emails, phone numbers). Treat it as the user’s own customer data: show only what they asked for, never post a lead list anywhere public, and do not copy it into an unrelated document. Hermoso PULLS these on demand and keeps no copy — nothing here watches, polls or files leads anywhere, so if the user wants this batch kept, put it somewhere THEY own in the same turn (a Google Sheet with create_sheet / append_to_sheet, a doc, or their own CRM). Meta makes each lead available for 90 days after it is submitted; anything older is handled in Meta’s own Leads Center and CRM integrations. Narrow with since/until (ISO dates), page with cursor, or pass redact:true to see counts, timestamps and which ad produced each lead WITHOUT the personal details. NEEDS leads_retrieval — see list_meta_lead_forms for what to do if Meta refuses it.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Read Meta lead-ad submissions
    • 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
  • reddit_ads_historyRead the CHANGELOG for a Reddit ad account — what was changed, from what to what, by which member, and when.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read the CHANGELOG for a Reddit ad account — what was changed, from what to what, by which member, and when. This is the tool for "performance fell off a cliff on Tuesday, what changed?" and for auditing what an agent or a teammate actually did. Call it with nothing but the ad account to get every change; narrow it with a date window, change types (BUDGET, BID, STATUS, TARGETING…) or specific campaign / ad group / ad ids. An empty result genuinely means nothing was changed in that window — say that, do not read it as missing data. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Reddit ad account changelog
    • idempotentHint: true
  • search_apple_ads_appsFind the App Store app to advertise and its adamId — the id every other Apple Ads tool needs (create_apple_ads_campaign’s appAdamId, a creative’s destination, an eligibility check)…Reads text others writeNo findings

    Why it is in this group

    • The name "search_apple_ads_apps" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Find the App Store app to advertise and its adamId — the id every other Apple Ads tool needs (create_apple_ads_campaign’s appAdamId, a creative’s destination, an eligibility check). Call it with NO arguments to list the apps THIS Apple Ads organization owns, which is what a first-time advertiser wants: only an app you own can be promoted, so a public app you merely found by name cannot be used as promotedObjectId. Pass query to search the App Store catalogue by name or developer, or adamId to fetch one app’s full details — including availableStorefronts, the definitive list of countries the app can be advertised in and the set a campaign’s countries must be a subset of. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find an App Store app to advertise
    • idempotentHint: true
  • search_apple_ads_geoResolve a place NAME into the geo id an Apple Ads ad group actually targets.Reads text others writeNo findings

    Why it is in this group

    • The name "search_apple_ads_geo" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Resolve a place NAME into the geo id an Apple Ads ad group actually targets. THIS IS THE ONLY WAY TO GET THOSE IDS: an ad group’s targeting takes adminAreaIds / localityIds / postalCodeIds / countryIds, it does NOT accept place names, and nothing else in Hermoso produces one — so without this tool those targeting fields cannot be used at all. (A campaign’s own `countries` field is a different thing and takes plain ISO country codes.) supplySource is REQUIRED and is not a formality: APPSTORE has NO PostalCode entity (postal codes are a Maps-level geo), and MAPS has NO Country entity and covers only the US and Canada — both are refused for free with the reason. Pass query with at least 2 characters, or "*" to list everything at an entity level. Rows flagged soft-blocked (low search volume, sparse coverage) are still targetable — Apple returns them by default with their eligibility attached. To go the other way and look UP ids you already have, pass geos:[{id|legacyId, entity}] instead of query. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Search Apple Ads geo locations
    • idempotentHint: true
  • search_console_performanceTHE REAL SEARCH TERMS — Google Search Console's performance report, and the most useful research tool here for writing copy.Reads text others writeNo findings

    Why it is in this group

    • The name "search_console_performance" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE REAL SEARCH TERMS — Google Search Console's performance report, and the most useful research tool here for writing copy. `dimensions:["query"]` returns the literal words people typed to reach this brand, with impressions, clicks, CTR and average position; `dimensions:["page","query"]` answers "which landing page already wins this demand", i.e. Where paid traffic should point. Every other dimension is available too: country, device, searchAppearance, date, hour. This is first-party MEASURED demand language, not a competitor's guess (an ad library) and not a model (a keyword planner), and it exists nowhere else: organic search terms left Google Analytics with "not provided" years ago. StartDate and endDate are REQUIRED and are exact YYYY-MM-DD in Pacific time — Google Analytics' relative forms like "28daysAgo" are NOT accepted anywhere in Search Console. THREE THINGS TO REPEAT WHENEVER YOU REPORT THESE NUMBERS: (1) rows are the TOP ones, not all of them, by Google's own statement; (2) anonymised queries are WITHHELD, so clicks summed per query will not equal the property total and that gap is not an error; (3) the default dataState "final" lags roughly 2-3 days, and "all" returns fresh partial data that will still change. Search Console keeps 16 months of history. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: What people searched for on Google, and what they clicked
    • idempotentHint: true
  • search_console_url_inspectionTHE LIVE INDEX STATUS OF ONE PAGE, straight from Google: the index verdict, coverage state, whether robots.txt allows it, which URL Google picked as canonical versus the one the pa…Reads text others writeNo findings

    Why it is in this group

    • The name "search_console_url_inspection" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe name "search_console_url_inspection" says "search" and "url": it reads web pages, which anyone can write.
    • untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    THE LIVE INDEX STATUS OF ONE PAGE, straight from Google: the index verdict, coverage state, whether robots.txt allows it, which URL Google picked as canonical versus the one the page itself declares, when it was last crawled and as which crawler, plus rich-result and mobile-usability verdicts. This is the tool for "why is this page getting no traffic" — a page Google cannot crawl, or whose canonical Google has reassigned to a different URL, will never rank however good the copy is. THE URL MUST SIT INSIDE THE PROPERTY: a URL-prefix property covers only its own prefix, while an "sc-domain:" property covers every scheme and subdomain. Important: QUOTA — Google allows 2,000 inspections per DAY and 600 per minute PER SITE, and that is the CUSTOMER'S property quota, not ours: inspect the handful of URLs the question is actually about and NEVER loop this over a sitemap, a page list or a crawl. Read-only, 0 credits.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Is this page actually in Google?
    • idempotentHint: true
  • search_linkedin_ads_targetingLook up LinkedIn TARGETING entities by name and get their URNs — locations, job titles, industries, seniorities, company sizes, skills, job functions, interests, employers, degrees…Reads text others writeNo findings

    Why it is in this group

    • The name "search_linkedin_ads_targeting" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Look up LinkedIn TARGETING entities by name and get their URNs — locations, job titles, industries, seniorities, company sizes, skills, job functions, interests, employers, degrees, fields of study, member behaviours. LinkedIn’s targeting values are opaque URNs (urn:li:geo:103644278 is the United States) with no guessable form, so ALWAYS resolve an audience here before passing it to create_linkedin_ads_campaign, and NEVER invent a URN — a made-up one either 400s or, worse, targets somebody else. If nothing matches, say so plainly. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find LinkedIn targeting URNs
    • idempotentHint: true
  • search_microsoft_ads_profilesFind the LinkedIn profile ids Microsoft Advertising can target: a company (CompanyName), an Industry or a JobFunction.Reads text others writeNo findings

    Why it is in this group

    • The name "search_microsoft_ads_profiles" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Find the LinkedIn profile ids Microsoft Advertising can target: a company (CompanyName), an Industry or a JobFunction. A company is found with Microsoft’s own company search (3+ characters); industries and job functions are matched against the profile list Microsoft publishes for them. Microsoft publishes no lookup for JobTitle or JobSeniority ids, so those cannot be searched here; an id you already have can still be targeted. Read-only, free. Pass the ids to set_microsoft_ads_profile_targeting.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find Microsoft Advertising LinkedIn profile ids
    • idempotentHint: true
  • search_pinterest_ads_targetingTHE IDS AN AD GROUP’S targetingSpec NEEDS.Reads text others writeNo findings

    Why it is in this group

    • The name "search_pinterest_ads_targeting" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    THE IDS AN AD GROUP’S targetingSpec NEEDS. create_pinterest_ads_campaign and create_pinterest_ads_ad_group accept interests, locales, locations, age buckets and keywords — this is where those values come from, and guessing one is the worst option available: Pinterest ACCEPTS a well-formed but wrong interest id and the campaign then quietly targets the wrong people. Pass targetingType (INTEREST, GEO, LOCATION, LOCALE, AGE_BUCKET, GENDER, APPTYPE, KEYWORD, AUDIENCE_INCLUDE, AUDIENCE_EXCLUDE) and optionally `query` to narrow the list. INTERESTS ARE A TREE: pass interestId instead to drill into one and get its children, which is how you get from "Food" to something specific enough to target. Pinterest publishes no search parameter of its own, so `query` filters the full list HERE — the note says so, because a filter we applied is not a filter the vendor applied. Read-only, 0 credits, no new permission (it uses ads:read, already granted).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Find Pinterest ad targeting options
    • idempotentHint: true
  • search_reddit_ads_targetingLook up the exact values Reddit ad-group targeting expects, so none of them has to be guessed.Reads text others writeNo findings

    Why it is in this group

    • The name "search_reddit_ads_targeting" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Look up the exact values Reddit ad-group targeting expects, so none of them has to be guessed. kind:"communities" searches subreddits by keyword and returns each one’s NAME plus its subscriber count — targeting wants the bare name ("running"), NOT the t5_ id and NOT "r/running". kind:"community_suggestions" asks Reddit which communities fit some topics (query, comma-separated) and/or a websiteUrl — the best way to widen reach. kind:"keywords" turns seed terms (keywords, or query comma-separated) into Reddit’s keyword suggestions WITH MONTHLY VIEWS, sorted biggest first — also a quick read on what Reddit is talking about. kind:"keyword_check" asks Reddit whether keywords are targetable under its brand-safety rules; leave the unsafe ones out of targeting.keywords. kind:"geolocations" lists targetable places (pass country like US, or a city search) — targeting accepts a country code or one of the returned ids. kind:"interests" lists Reddit’s interest taxonomy — targeting wants the id ("pets_v3"). kind:"devices" / "carriers" / "languages" list what targeting.devices / carriers (e.g. VERIZON_US) / languages (e.g. EN) take; "third_party_audiences" lists partner data segments with their size and CPM data cost. Read-only, free. Use this before create_reddit_ads_ad_group rather than inventing a value.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Resolve Reddit targeting: communities, keywords, geos, interests, devices, carriers, languages
    • idempotentHint: true
  • search_snapchat_ads_targetingResolve Snapchat targeting options to the ids an ad squad needs — countries (REQUIRED: an ad squad cannot be created without at least one), regions, metros, age groups, genders, la…Reads text others writeNo findings

    Why it is in this group

    • The name "search_snapchat_ads_targeting" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Resolve Snapchat targeting options to the ids an ad squad needs — countries (REQUIRED: an ad squad cannot be created without at least one), regions, metros, age groups, genders, languages, device OS or interests. NEVER invent one of these ids: invented targeting is silent and spends money on the wrong people. Region and metro lookups need a countryCode because Snapchat scopes those lists per country. Interests live in SEVERAL taxonomies at different paths (scls, vac, shp) which are not interchangeable, so name one rather than assuming. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Resolve Snapchat targeting ids
    • idempotentHint: true
  • search_tiktok_ads_targetingLook up the exact ids TikTok ad-group targeting expects, so none of them has to be invented.Reads text others writeNo findings

    Why it is in this group

    • The name "search_tiktok_ads_targeting" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Look up the exact ids TikTok ad-group targeting expects, so none of them has to be invented. kind:"location" resolves TikTok’s targetable regions — an ad group CANNOT be created without location ids, TikTok refuses it in its own words ("‘location_ids’ or ‘zipcode_ids’ must be specified"). kind:"interest" resolves the interest categories and kind:"interest_keyword" the additional interest KEYWORDS (both attach to an ad group). kind:"hashtag" resolves real targeting HASHTAGS — until 2026-08-11 this kind pointed at TikTok’s interest-keyword endpoint and quietly returned interest categories instead; note that hashtag ids feed TikTok’s actions[] field, which Hermoso does not send yet, so treat hashtag results as RESEARCH rather than targeting you can apply. kind:"language" the language codes. A made-up id either fails the create or, worse, targets somebody else and spends money silently, so always resolve here first and never guess. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Resolve TikTok locations / interests / hashtags / languages
    • idempotentHint: true
  • tiktok_ads_verification_statusWhether a TikTok ad account or Business Center has passed business verification, when it was reviewed, and if it failed, TikTok’s own reason.Reads text others writeNo findings

    Why it is in this group

    • The name "tiktok_ads_verification_status" says "status": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Whether a TikTok ad account or Business Center has passed business verification, when it was reviewed, and if it failed, TikTok’s own reason. AN AD ACCOUNT AND A BUSINESS CENTER ARE VERIFIED SEPARATELY and carry different statuses, so pass one or the other and never both; a verified Business Center does not verify the ad accounts inside it. Worth reading during onboarding: an unverified account meets limits that otherwise get diagnosed as something else entirely. It also reports the qualification id of any document already on file, which submit_tiktok_ads_verification can reuse. Read-only, free.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
    • title: Check a TikTok account’s business verification
    • idempotentHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

2527855 paths in this server alone from private data, through text someone else wrote, to a way out. Denying 55 private-data tools breaks every one.

deny to break every path
{
  "permissions": {
    "deny": [
      "mcp__hermoso-ads-manager__billing_status",
      "mcp__hermoso-ads-manager__describe_salesforce_object",
      "mcp__hermoso-ads-manager__find_meta_audiences",
      "mcp__hermoso-ads-manager__get_drive_file",
      "mcp__hermoso-ads-manager__get_onedrive_file",
      "mcp__hermoso-ads-manager__get_openai_ads_audience",
      "mcp__hermoso-ads-manager__get_openai_ads_feed_settings",
      "mcp__hermoso-ads-manager__get_openai_ads_feed_sftp",
      "mcp__hermoso-ads-manager__get_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__get_salesforce_record",
      "mcp__hermoso-ads-manager__get_settings",
      "mcp__hermoso-ads-manager__get_x_ads_leads",
      "mcp__hermoso-ads-manager__list_analytics_data_streams",
      "mcp__hermoso-ads-manager__list_apple_ads_orgs",
      "mcp__hermoso-ads-manager__list_bing_webmaster_sitemaps",
      "mcp__hermoso-ads-manager__list_connectors",
      "mcp__hermoso-ads-manager__list_drive_files",
      "mcp__hermoso-ads-manager__list_google_ads_lead_submissions",
      "mcp__hermoso-ads-manager__list_hubspot_companies",
      "mcp__hermoso-ads-manager__list_hubspot_contacts",
      "mcp__hermoso-ads-manager__list_hubspot_owners",
      "mcp__hermoso-ads-manager__list_notion_pages",
      "mcp__hermoso-ads-manager__list_onedrive_files",
      "mcp__hermoso-ads-manager__list_openai_ads_audience_operations",
      "mcp__hermoso-ads-manager__list_openai_ads_audiences",
      "mcp__hermoso-ads-manager__list_openai_ads_audit_logs",
      "mcp__hermoso-ads-manager__list_openai_ads_business_agent_tools",
      "mcp__hermoso-ads-manager__list_openai_ads_business_agents",
      "mcp__hermoso-ads-manager__list_openai_ads_campaigns",
      "mcp__hermoso-ads-manager__list_openai_ads_conversion_events",
      "mcp__hermoso-ads-manager__list_openai_ads_feeds",
      "mcp__hermoso-ads-manager__list_openai_ads_lead_forms",
      "mcp__hermoso-ads-manager__list_openai_ads_lead_sync",
      "mcp__hermoso-ads-manager__list_openai_ads_leads",
      "mcp__hermoso-ads-manager__list_openai_ads_spend_windows",
      "mcp__hermoso-ads-manager__list_salesforce_owners",
      "mcp__hermoso-ads-manager__list_salesforce_records",
      "mcp__hermoso-ads-manager__list_snapchat_ads_leads",
      "mcp__hermoso-ads-manager__list_stripe_charges",
      "mcp__hermoso-ads-manager__list_stripe_customers",
      "mcp__hermoso-ads-manager__list_stripe_invoices",
      "mcp__hermoso-ads-manager__list_team",
      "mcp__hermoso-ads-manager__list_tiktok_ads_verification_documents",
      "mcp__hermoso-ads-manager__list_vercel_deployments",
      "mcp__hermoso-ads-manager__list_vercel_domains",
      "mcp__hermoso-ads-manager__list_vercel_projects",
      "mcp__hermoso-ads-manager__log_salesforce_activity",
      "mcp__hermoso-ads-manager__openai_ads_geo_search",
      "mcp__hermoso-ads-manager__posthog_query",
      "mcp__hermoso-ads-manager__preview_openai_ads_ad",
      "mcp__hermoso-ads-manager__preview_openai_ads_business_agent",
      "mcp__hermoso-ads-manager__query_notion_database",
      "mcp__hermoso-ads-manager__read_doc",
      "mcp__hermoso-ads-manager__read_sheet",
      "mcp__hermoso-ads-manager__x_ads_targeting_search"
    ]
  }
}

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Tools listed without sign-in

Looked at Nov 14, 2026, 12: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
536
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 536 tools that change things (293 destructive, 8 irreversible, 235 write). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://app.hermoso.ai/mcp?tools=app-ads&src=registry: tools/list returned 793 tools to an anonymous client, including call_tool (destructive), delete_brand (destructive), create_meta_campaign (destructive), set_meta_campaign_status (destructive), create_meta_ad (destructive) and 531 more

    What this check looks for

Posture changes

  1. Nov 14, 2026
    • Tools that change things, listed without credentials: 510 to 536

Findings

Matches of fixed checks, with the text they matched.

2 high26 warn21 info
  • The description contains "without telling the user", an instruction to keep something from the user.

    Matched text

    description: "...nds nothing; it is NOT safe to activate without telling the user, so relay the warning. Nothing is creat..."

    What this check looks for
  • The description contains "never tell a user", an instruction to keep something from the user.

    Matched text

    description: "...run that VALIDATES AND SAVES NOTHING — never tell a user a validate-only run was measured. If th..."

    What this check looks for
  • The description contains "Every other tool", wording about other tools or servers.

    Matched text

    description: "...few that make the connection drivable. Every other tool is held out of the LIST on SIZE alone —..."

    What this check looks for
  • The server marks "analyze_campaigns" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

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

    What this check looks for
  • The server marks "manage_google_ads_negative_list" destructive (destructiveHint: true), and its name says "list", a word for reading.

    Matched text

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

    What this check looks for
  • The server marks "generate_dns_record" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
Show 43 more findings
  • The server marks "bing_webmaster_links" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "fetch_bing_webmaster_url" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

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

    What this check looks for
  • The server marks "list_posthog_projects" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "list_posthog_surveys" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "list_stripe_refunds" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

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

    What this check looks for
  • The server marks "list_stripe_promotion_codes" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "list_stripe_payment_links" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "revenue_by_source" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "post" and "email": it sends a message, which cannot be taken back.

    What this check looks for
  • The server marks "log_salesforce_activity" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

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

    What this check looks for
  • The server marks "manage_microsoft_ads_negative_keyword_list" destructive (destructiveHint: true), and its name says "list", a word for reading.

    Matched text

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

    What this check looks for
  • The description contains "EVERY OTHER TOOL", wording about other tools or servers.

    Matched text

    description: "...field. THE SPEND GATE, AND IT IS UNLIKE EVERY OTHER TOOL HERE. A bulk file carries a Status colu..."

    What this check looks for
  • The server marks "microsoft_ads_auto_apply" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "preview_openai_ads_business_agent" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

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

    What this check looks for
  • The server marks "preview_pinterest_ads_ad" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

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

    What this check looks for
  • The server marks "tiktok_ads_comment_thread" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

    What this check looks for
  • The server marks "list_tiktok_ads_payment_portfolios" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

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

    What this check looks for
  • The server marks "snapchat_ads_report" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The description's first verb is "read": a word for reading.

    What this check looks for
  • The server marks "store_get" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

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

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

    Matched text

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

    What this check looks for
  • The server marks "list_product_photos" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

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

    What this check looks for
  • The server marks "posting_insights" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

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

    What this check looks for
  • The server marks "inbox_stats" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

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

    What this check looks for
  • The description mentions "CREDENTIAL".

    Matched text

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

    What this check looks for
  • The description is 2,305 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...(Meta refuses to boost a post carrying licensed music or an interactive element)."

    What this check looks for
  • The description is 2,009 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...in any ad account and spends no ad money; it bills one model call over the table."

    What this check looks for
  • The description is 3,159 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...thing unrecognised is refused by name here rather than 400ing at Meta. Read-only."

    What this check looks for
  • The description is 2,007 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...efused by name, so a caller can never believe they narrowed it when they did not."

    What this check looks for
  • The description is 2,018 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...rmission, not a broken connection. 0 credits. Needs Google Tag Manager connected."

    What this check looks for
  • The description mentions "credential".

    Matched text

    description: "...n. NO CONNECTION IS NEEDED, because the credential belongs to the USER: they generate a ke..."

    What this check looks for
  • The description mentions "credential".

    Matched text

    description: "...after connecting because it proves the credential with no setup. metric is "active" or "n..."

    What this check looks for
  • The description is 2,047 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...rsions. Read-only and free: run it FIRST after connecting to prove the key works."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...first after connecting — it proves the credentials work with zero spend risk."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "The Apple Ads ad accounts these credentials can act as, with the roles held on each..."

    What this check looks for
  • The description is 2,024 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...ersion, give them the SAME id so OpenAI deduplicates it. Free — costs no credits."

    What this check looks for
  • The description mentions "credential".

    Matched text

    description: "...a ChatGPT Ads Conversions API key — the credential a SERVER uses to send conversion events..."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...ult): create or REPLACE the feed's SFTP credentials — authenticationMethod "password" (Open..."

    What this check looks for
  • The input schema at properties.action.description mentions "credentials".

    Matched text

    inputSchema.properties.action.description: "create (default) sets up or rotates credentials; activate or pause switches delivery on..."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...d they must be of different types. Feed credentials (username/password) go to Reddit and ar..."

    What this check looks for
  • The description mentions "credentials".

    Matched text

    description: "...uct FEED (kind "feed": url, mode, name, credentials or its schedule, including pausing it w..."

    What this check looks for
  • The description is 2,004 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...is enabled — print that verbatim and act on it before touching anything above it."

    What this check looks for
  • The description mentions "credentials".

    Matched text

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

    What this check looks for
  • The description is 2,443 characters long, over the 2,000 this check looks for.

    Matched text

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

    What this check looks for
  • The description mentions "credential".

    Matched text

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

    What this check looks for

History

Changes to its tool definitions and to its remote endpoint, newest first.

  1. Tools72 added, 1 removed, 133 changed.+72 added−1 removed~133 changedView diff
  2. PostureRemote posture changed. Tools that change things, listed without credentials: 510 -> 536.View diff
    • Tools that change things, listed without credentials: 510 to 536

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http hermoso-ads-manager https://app.hermoso.ai/mcp?tools=app-ads&src=registry
claude mcp add --transport http hermoso-ads-manager https://app.hermoso.ai/mcp?tools=app-ads&src=registry

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__hermoso-ads-manager__get_instructions",
      "mcp__hermoso-ads-manager__find_tools",
      "mcp__hermoso-ads-manager__hermoso_credits",
      "mcp__hermoso-ads-manager__billing_status",
      "mcp__hermoso-ads-manager__list_brands",
      "mcp__hermoso-ads-manager__search_pinterest_ads_targeting",
      "mcp__hermoso-ads-manager__list_meta_playables",
      "mcp__hermoso-ads-manager__find_meta_audiences",
      "mcp__hermoso-ads-manager__list_meta_ads",
      "mcp__hermoso-ads-manager__preview_meta_ad",
      "mcp__hermoso-ads-manager__list_meta_audiences",
      "mcp__hermoso-ads-manager__list_meta_pixels",
      "mcp__hermoso-ads-manager__get_meta_ad_account",
      "mcp__hermoso-ads-manager__list_meta_lead_forms",
      "mcp__hermoso-ads-manager__read_meta_leads",
      "mcp__hermoso-ads-manager__list_merchant_accounts",
      "mcp__hermoso-ads-manager__list_merchant_products",
      "mcp__hermoso-ads-manager__list_shopify_marketing_activities",
      "mcp__hermoso-ads-manager__list_merchant_issues",
      "mcp__hermoso-ads-manager__list_merchant_promotions",
      "mcp__hermoso-ads-manager__list_merchant_inventory",
      "mcp__hermoso-ads-manager__merchant_account_status",
      "mcp__hermoso-ads-manager__list_merchant_data_sources",
      "mcp__hermoso-ads-manager__list_google_ads_campaigns",
      "mcp__hermoso-ads-manager__find_google_ads_locations",
      "mcp__hermoso-ads-manager__list_google_ads_conversion_actions",
      "mcp__hermoso-ads-manager__preview_google_ads_ad",
      "mcp__hermoso-ads-manager__list_google_ads_lead_submissions",
      "mcp__hermoso-ads-manager__list_analytics_properties",
      "mcp__hermoso-ads-manager__list_analytics_definitions",
      "mcp__hermoso-ads-manager__list_analytics_metadata",
      "mcp__hermoso-ads-manager__list_analytics_google_ads_links",
      "mcp__hermoso-ads-manager__list_analytics_audiences",
      "mcp__hermoso-ads-manager__list_analytics_data_streams",
      "mcp__hermoso-ads-manager__get_analytics_stream_setup",
      "mcp__hermoso-ads-manager__list_tag_manager_containers",
      "mcp__hermoso-ads-manager__list_tag_manager_tags",
      "mcp__hermoso-ads-manager__list_tag_manager_versions",
      "mcp__hermoso-ads-manager__preview_tag_manager_publish",
      "mcp__hermoso-ads-manager__list_search_console_sites",
      "mcp__hermoso-ads-manager__search_console_performance",
      "mcp__hermoso-ads-manager__search_console_url_inspection",
      "mcp__hermoso-ads-manager__list_search_console_sitemaps",
      "mcp__hermoso-ads-manager__list_bing_webmaster_sites",
      "mcp__hermoso-ads-manager__bing_webmaster_query_stats",
      "mcp__hermoso-ads-manager__list_bing_webmaster_sitemaps",
      "mcp__hermoso-ads-manager__posthog_query",
      "mcp__hermoso-ads-manager__posthog_insight",
      "mcp__hermoso-ads-manager__list_posthog_session_recordings",
      "mcp__hermoso-ads-manager__mixpanel_insights",
      "mcp__hermoso-ads-manager__list_mixpanel_events",
      "mcp__hermoso-ads-manager__list_amplitude_events",
      "mcp__hermoso-ads-manager__amplitude_chart",
      "mcp__hermoso-ads-manager__list_amplitude_annotations",
      "mcp__hermoso-ads-manager__list_posthog_annotations",
      "mcp__hermoso-ads-manager__list_mixpanel_annotations",
      "mcp__hermoso-ads-manager__list_mixpanel_cohorts",
      "mcp__hermoso-ads-manager__list_vercel_projects",
      "mcp__hermoso-ads-manager__list_vercel_deployments",
      "mcp__hermoso-ads-manager__list_vercel_domains",
      "mcp__hermoso-ads-manager__list_stripe_customers",
      "mcp__hermoso-ads-manager__list_stripe_charges",
      "mcp__hermoso-ads-manager__list_stripe_subscriptions",
      "mcp__hermoso-ads-manager__list_stripe_invoices",
      "mcp__hermoso-ads-manager__list_stripe_products",
      "mcp__hermoso-ads-manager__list_stripe_coupons",
      "mcp__hermoso-ads-manager__get_stripe_payment_link_revenue",
      "mcp__hermoso-ads-manager__list_hubspot_contacts",
      "mcp__hermoso-ads-manager__list_hubspot_companies",
      "mcp__hermoso-ads-manager__list_hubspot_owners",
      "mcp__hermoso-ads-manager__get_hubspot_lead_sync",
      "mcp__hermoso-ads-manager__list_salesforce_records",
      "mcp__hermoso-ads-manager__get_salesforce_record",
      "mcp__hermoso-ads-manager__describe_salesforce_object",
      "mcp__hermoso-ads-manager__list_salesforce_owners",
      "mcp__hermoso-ads-manager__list_microsoft_ads_campaigns",
      "mcp__hermoso-ads-manager__microsoft_ads_geo_search",
      "mcp__hermoso-ads-manager__search_microsoft_ads_profiles",
      "mcp__hermoso-ads-manager__list_microsoft_ads_profile_targeting",
      "mcp__hermoso-ads-manager__list_microsoft_merchant_stores",
      "mcp__hermoso-ads-manager__list_microsoft_merchant_products",
      "mcp__hermoso-ads-manager__list_microsoft_merchant_issues",
      "mcp__hermoso-ads-manager__list_microsoft_merchant_catalogs",
      "mcp__hermoso-ads-manager__list_microsoft_ads_negative_keywords",
      "mcp__hermoso-ads-manager__list_microsoft_ads_uet_tags",
      "mcp__hermoso-ads-manager__list_microsoft_ads_audience_targeting",
      "mcp__hermoso-ads-manager__list_microsoft_ads_audiences",
      "mcp__hermoso-ads-manager__list_applovin_ads_campaigns",
      "mcp__hermoso-ads-manager__list_applovin_ads_creative_sets",
      "mcp__hermoso-ads-manager__list_applovin_ads_catalogs",
      "mcp__hermoso-ads-manager__list_applovin_ads_assets",
      "mcp__hermoso-ads-manager__list_openai_ads_campaigns",
      "mcp__hermoso-ads-manager__openai_ads_geo_search",
      "mcp__hermoso-ads-manager__list_x_ads_accounts",
      "mcp__hermoso-ads-manager__list_x_ads_campaigns",
      "mcp__hermoso-ads-manager__list_microsoft_ads_conversion_goals",
      "mcp__hermoso-ads-manager__get_microsoft_ads_account_properties",
      "mcp__hermoso-ads-manager__list_apple_ads_campaigns",
      "mcp__hermoso-ads-manager__list_apple_ads_ad_groups",
      "mcp__hermoso-ads-manager__list_apple_ads_keywords",
      "mcp__hermoso-ads-manager__list_apple_ads_orgs",
      "mcp__hermoso-ads-manager__search_apple_ads_apps",
      "mcp__hermoso-ads-manager__list_apple_ads_product_pages",
      "mcp__hermoso-ads-manager__list_apple_ads_creatives",
      "mcp__hermoso-ads-manager__list_apple_ads_ads",
      "mcp__hermoso-ads-manager__list_apple_ads_assets",
      "mcp__hermoso-ads-manager__list_apple_ads_brands",
      "mcp__hermoso-ads-manager__list_apple_ads_locations",
      "mcp__hermoso-ads-manager__list_apple_ads_location_groups",
      "mcp__hermoso-ads-manager__list_apple_ads_recommendations",
      "mcp__hermoso-ads-manager__apple_ads_search_term_popularity",
      "mcp__hermoso-ads-manager__list_apple_ads_budget_orders",
      "mcp__hermoso-ads-manager__search_apple_ads_geo",
      "mcp__hermoso-ads-manager__list_apple_ads_supported_languages",
      "mcp__hermoso-ads-manager__get_apple_ads_ad_account",
      "mcp__hermoso-ads-manager__list_apple_ads_advertiser_resources",
      "mcp__hermoso-ads-manager__list_x_ads_promoted_tweets",
      "mcp__hermoso-ads-manager__list_x_ads_targeting",
      "mcp__hermoso-ads-manager__list_x_ads_funding_instruments",
      "mcp__hermoso-ads-manager__x_ads_targeting_search",
      "mcp__hermoso-ads-manager__list_x_ads_line_items",
      "mcp__hermoso-ads-manager__list_x_ads_promotable_users",
      "mcp__hermoso-ads-manager__list_x_ads_lead_forms",
      "mcp__hermoso-ads-manager__get_x_ads_leads",
      "mcp__hermoso-ads-manager__list_x_ads_media",
      "mcp__hermoso-ads-manager__list_x_ads_cards",
      "mcp__hermoso-ads-manager__list_x_ads_posts",
      "mcp__hermoso-ads-manager__preview_x_ads_post",
      "mcp__hermoso-ads-manager__list_x_ads_audiences",
      "mcp__hermoso-ads-manager__x_ads_geo_search",
      "mcp__hermoso-ads-manager__list_openai_ads_conversion_events",
      "mcp__hermoso-ads-manager__list_openai_ads_audiences",
      "mcp__hermoso-ads-manager__get_openai_ads_audience",
      "mcp__hermoso-ads-manager__list_openai_ads_audience_operations",
      "mcp__hermoso-ads-manager__get_openai_ads_audience_operation",
      "mcp__hermoso-ads-manager__preview_openai_ads_ad",
      "mcp__hermoso-ads-manager__list_openai_ads_lead_forms",
      "mcp__hermoso-ads-manager__get_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__list_openai_ads_lead_sync",
      "mcp__hermoso-ads-manager__list_openai_ads_leads",
      "mcp__hermoso-ads-manager__list_openai_ads_business_agents",
      "mcp__hermoso-ads-manager__list_openai_ads_business_agent_tools",
      "mcp__hermoso-ads-manager__get_openai_ads_business_agent",
      "mcp__hermoso-ads-manager__list_openai_ads_spend_windows",
      "mcp__hermoso-ads-manager__list_openai_ads_feeds",
      "mcp__hermoso-ads-manager__list_openai_ads_feed_uploads",
      "mcp__hermoso-ads-manager__query_openai_ads_feed_products",
      "mcp__hermoso-ads-manager__get_openai_ads_feed_sftp",
      "mcp__hermoso-ads-manager__get_openai_ads_feed_settings",
      "mcp__hermoso-ads-manager__list_openai_ads_audit_logs",
      "mcp__hermoso-ads-manager__get_openai_ads_landing_page_crawl",
      "mcp__hermoso-ads-manager__list_pinterest_ads_campaigns",
      "mcp__hermoso-ads-manager__list_pinterest_ads_conversion_tags",
      "mcp__hermoso-ads-manager__list_pinterest_ads_audiences",
      "mcp__hermoso-ads-manager__list_pinterest_ads_keywords",
      "mcp__hermoso-ads-manager__pinterest_ads_account_data",
      "mcp__hermoso-ads-manager__list_pinterest_ads_product_group_promotions",
      "mcp__hermoso-ads-manager__list_reddit_ads_campaigns",
      "mcp__hermoso-ads-manager__list_reddit_ads_profiles",
      "mcp__hermoso-ads-manager__search_reddit_ads_targeting",
      "mcp__hermoso-ads-manager__list_reddit_ads_posts",
      "mcp__hermoso-ads-manager__get_reddit_ads_max_template",
      "mcp__hermoso-ads-manager__list_reddit_ads_pixels",
      "mcp__hermoso-ads-manager__list_reddit_ads_catalogs",
      "mcp__hermoso-ads-manager__list_reddit_ads_products",
      "mcp__hermoso-ads-manager__get_reddit_ads_catalog_import",
      "mcp__hermoso-ads-manager__list_reddit_ads_funding_instruments",
      "mcp__hermoso-ads-manager__get_reddit_ads_asset_uploads",
      "mcp__hermoso-ads-manager__list_reddit_ads_assets",
      "mcp__hermoso-ads-manager__get_reddit_ads_asset",
      "mcp__hermoso-ads-manager__list_reddit_ads_audiences",
      "mcp__hermoso-ads-manager__list_reddit_ads_saved_audiences",
      "mcp__hermoso-ads-manager__list_reddit_ads_lead_forms",
      "mcp__hermoso-ads-manager__reddit_ads_history",
      "mcp__hermoso-ads-manager__list_tiktok_ads_accounts",
      "mcp__hermoso-ads-manager__list_tiktok_ads_campaigns",
      "mcp__hermoso-ads-manager__list_tiktok_ads_identities",
      "mcp__hermoso-ads-manager__list_tiktok_ads_identity_posts",
      "mcp__hermoso-ads-manager__list_tiktok_ads_spark_posts",
      "mcp__hermoso-ads-manager__get_tiktok_post_ad_authorization",
      "mcp__hermoso-ads-manager__search_tiktok_ads_targeting",
      "mcp__hermoso-ads-manager__list_tiktok_smart_campaigns",
      "mcp__hermoso-ads-manager__preview_tiktok_smart_ad",
      "mcp__hermoso-ads-manager__list_tiktok_ads_pixels",
      "mcp__hermoso-ads-manager__list_tiktok_ads_custom_conversions",
      "mcp__hermoso-ads-manager__list_tiktok_ads_lead_forms",
      "mcp__hermoso-ads-manager__list_tiktok_ads_lead_fields",
      "mcp__hermoso-ads-manager__list_tiktok_ads_audiences",
      "mcp__hermoso-ads-manager__list_tiktok_ads_business_centers",
      "mcp__hermoso-ads-manager__list_tiktok_ads_catalogs",
      "mcp__hermoso-ads-manager__list_tiktok_ads_catalog_products",
      "mcp__hermoso-ads-manager__list_tiktok_ads_catalog_sets",
      "mcp__hermoso-ads-manager__list_tiktok_ads_apps",
      "mcp__hermoso-ads-manager__list_tiktok_ads_app_events",
      "mcp__hermoso-ads-manager__list_tiktok_ads_comments",
      "mcp__hermoso-ads-manager__list_tiktok_ads_blocked_words",
      "mcp__hermoso-ads-manager__get_tiktok_ads_brand_safety",
      "mcp__hermoso-ads-manager__list_tiktok_ads_playables",
      "mcp__hermoso-ads-manager__preview_tiktok_ads_ad",
      "mcp__hermoso-ads-manager__list_tiktok_ads_music",
      "mcp__hermoso-ads-manager__list_tiktok_ads_rules",
      "mcp__hermoso-ads-manager__list_meta_ad_rules",
      "mcp__hermoso-ads-manager__list_google_ads_rules",
      "mcp__hermoso-ads-manager__list_tiktok_ads_offline_event_sets",
      "mcp__hermoso-ads-manager__list_tiktok_ads_crm_event_sets",
      "mcp__hermoso-ads-manager__list_tiktok_tto_accounts",
      "mcp__hermoso-ads-manager__list_tiktok_creator_labels",
      "mcp__hermoso-ads-manager__discover_tiktok_creators",
      "mcp__hermoso-ads-manager__check_tiktok_creator_status",
      "mcp__hermoso-ads-manager__list_tiktok_tto_brand_profiles",
      "mcp__hermoso-ads-manager__list_tiktok_tto_campaigns",
      "mcp__hermoso-ads-manager__list_tiktok_tto_link_requests",
      "mcp__hermoso-ads-manager__get_tiktok_tto_spark_authorization",
      "mcp__hermoso-ads-manager__list_tiktok_ads_stores",
      "mcp__hermoso-ads-manager__list_tiktok_ads_store_products",
      "mcp__hermoso-ads-manager__tiktok_ads_verification_status",
      "mcp__hermoso-ads-manager__list_tiktok_ads_verification_documents",
      "mcp__hermoso-ads-manager__list_tiktok_ads_payment_portfolio_links",
      "mcp__hermoso-ads-manager__list_snapchat_ads_accounts",
      "mcp__hermoso-ads-manager__list_snapchat_ads_campaigns",
      "mcp__hermoso-ads-manager__search_snapchat_ads_targeting",
      "mcp__hermoso-ads-manager__list_snapchat_ads_profiles",
      "mcp__hermoso-ads-manager__list_snapchat_ads_pixels",
      "mcp__hermoso-ads-manager__list_snapchat_ads_lead_forms",
      "mcp__hermoso-ads-manager__list_snapchat_ads_leads",
      "mcp__hermoso-ads-manager__preview_snapchat_ads_creative",
      "mcp__hermoso-ads-manager__list_snapchat_ads_audiences",
      "mcp__hermoso-ads-manager__list_linkedin_ads_campaigns",
      "mcp__hermoso-ads-manager__linkedin_audience_count",
      "mcp__hermoso-ads-manager__linkedin_boost_status",
      "mcp__hermoso-ads-manager__get_linkedin_boost",
      "mcp__hermoso-ads-manager__list_linkedin_boost_audiences",
      "mcp__hermoso-ads-manager__search_linkedin_ads_targeting",
      "mcp__hermoso-ads-manager__preview_linkedin_ad",
      "mcp__hermoso-ads-manager__list_linkedin_conversion_rules",
      "mcp__hermoso-ads-manager__list_drive_files",
      "mcp__hermoso-ads-manager__get_drive_file",
      "mcp__hermoso-ads-manager__read_sheet",
      "mcp__hermoso-ads-manager__list_notion_pages",
      "mcp__hermoso-ads-manager__read_notion_page",
      "mcp__hermoso-ads-manager__query_notion_database",
      "mcp__hermoso-ads-manager__read_doc",
      "mcp__hermoso-ads-manager__list_sheet_tabs",
      "mcp__hermoso-ads-manager__list_onedrive_files",
      "mcp__hermoso-ads-manager__get_onedrive_file",
      "mcp__hermoso-ads-manager__get_job",
      "mcp__hermoso-ads-manager__list_skills",
      "mcp__hermoso-ads-manager__get_skill",
      "mcp__hermoso-ads-manager__list_memory",
      "mcp__hermoso-ads-manager__list_swipefile",
      "mcp__hermoso-ads-manager__list_playbooks",
      "mcp__hermoso-ads-manager__list_creators",
      "mcp__hermoso-ads-manager__list_elements",
      "mcp__hermoso-ads-manager__get_settings",
      "mcp__hermoso-ads-manager__list_connectors",
      "mcp__hermoso-ads-manager__list_connector_accounts",
      "mcp__hermoso-ads-manager__list_team",
      "mcp__hermoso-ads-manager__get_credit_limits",
      "mcp__hermoso-ads-manager__list_jobs",
      "mcp__hermoso-ads-manager__list_errors",
      "mcp__hermoso-ads-manager__get_brand",
      "mcp__hermoso-ads-manager__list_library"
    ],
    "ask": [
      "mcp__hermoso-ads-manager__enable_tools",
      "mcp__hermoso-ads-manager__hermoso_capabilities",
      "mcp__hermoso-ads-manager__hermoso_other_capabilities",
      "mcp__hermoso-ads-manager__buy_credits",
      "mcp__hermoso-ads-manager__report_bug",
      "mcp__hermoso-ads-manager__request_feature",
      "mcp__hermoso-ads-manager__contact_support",
      "mcp__hermoso-ads-manager__upgrade_plan",
      "mcp__hermoso-ads-manager__set_auto_reload",
      "mcp__hermoso-ads-manager__use_brand",
      "mcp__hermoso-ads-manager__create_brand",
      "mcp__hermoso-ads-manager__upload_file",
      "mcp__hermoso-ads-manager__pinterest_ads_async_report",
      "mcp__hermoso-ads-manager__upload_meta_asset",
      "mcp__hermoso-ads-manager__upload_meta_playable",
      "mcp__hermoso-ads-manager__analyze_campaigns",
      "mcp__hermoso-ads-manager__meta_insights",
      "mcp__hermoso-ads-manager__meta_catalog_suggestions",
      "mcp__hermoso-ads-manager__estimate_meta_reach",
      "mcp__hermoso-ads-manager__create_meta_audience",
      "mcp__hermoso-ads-manager__meta_dataset_quality",
      "mcp__hermoso-ads-manager__create_meta_lead_form",
      "mcp__hermoso-ads-manager__register_merchant_developer",
      "mcp__hermoso-ads-manager__record_shopify_marketing_activity",
      "mcp__hermoso-ads-manager__merchant_report",
      "mcp__hermoso-ads-manager__create_merchant_promotion",
      "mcp__hermoso-ads-manager__merchant_issue_help",
      "mcp__hermoso-ads-manager__merchant_quota",
      "mcp__hermoso-ads-manager__create_merchant_data_source",
      "mcp__hermoso-ads-manager__google_ads_report",
      "mcp__hermoso-ads-manager__google_ads_change_history",
      "mcp__hermoso-ads-manager__add_google_ads_keywords",
      "mcp__hermoso-ads-manager__google_ads_local_services_eligibility",
      "mcp__hermoso-ads-manager__duplicate_google_ads_campaign",
      "mcp__hermoso-ads-manager__upload_google_ads_asset",
      "mcp__hermoso-ads-manager__create_google_ads_conversion_action",
      "mcp__hermoso-ads-manager__add_google_ads_assets",
      "mcp__hermoso-ads-manager__google_ads_recommendations",
      "mcp__hermoso-ads-manager__google_ads_policy_issues",
      "mcp__hermoso-ads-manager__google_ads_keyword_ideas",
      "mcp__hermoso-ads-manager__check_email_address",
      "mcp__hermoso-ads-manager__check_domain_email_health",
      "mcp__hermoso-ads-manager__generate_dns_record",
      "mcp__hermoso-ads-manager__check_spam_words",
      "mcp__hermoso-ads-manager__analytics_report",
      "mcp__hermoso-ads-manager__analytics_realtime",
      "mcp__hermoso-ads-manager__create_analytics_key_event",
      "mcp__hermoso-ads-manager__create_analytics_custom_metric",
      "mcp__hermoso-ads-manager__check_analytics_compatibility",
      "mcp__hermoso-ads-manager__link_google_ads_to_analytics",
      "mcp__hermoso-ads-manager__create_analytics_audience",
      "mcp__hermoso-ads-manager__create_tag_manager_tag",
      "mcp__hermoso-ads-manager__create_tag_manager_trigger",
      "mcp__hermoso-ads-manager__list_tracking_tags",
      "mcp__hermoso-ads-manager__submit_search_console_sitemap",
      "mcp__hermoso-ads-manager__add_search_console_site",
      "mcp__hermoso-ads-manager__bing_webmaster_traffic",
      "mcp__hermoso-ads-manager__bing_webmaster_keywords",
      "mcp__hermoso-ads-manager__bing_webmaster_crawl",
      "mcp__hermoso-ads-manager__bing_webmaster_links",
      "mcp__hermoso-ads-manager__bing_webmaster_submission_quota",
      "mcp__hermoso-ads-manager__submit_bing_webmaster_urls",
      "mcp__hermoso-ads-manager__submit_bing_webmaster_sitemap",
      "mcp__hermoso-ads-manager__list_bing_webmaster_fetched_urls",
      "mcp__hermoso-ads-manager__fetch_bing_webmaster_url",
      "mcp__hermoso-ads-manager__submit_bing_webmaster_content",
      "mcp__hermoso-ads-manager__add_bing_webmaster_site",
      "mcp__hermoso-ads-manager__verify_bing_webmaster_site",
      "mcp__hermoso-ads-manager__submit_indexnow",
      "mcp__hermoso-ads-manager__list_posthog_projects",
      "mcp__hermoso-ads-manager__posthog_persons",
      "mcp__hermoso-ads-manager__mixpanel_retention",
      "mcp__hermoso-ads-manager__mixpanel_segmentation",
      "mcp__hermoso-ads-manager__mixpanel_funnel",
      "mcp__hermoso-ads-manager__amplitude_segmentation",
      "mcp__hermoso-ads-manager__amplitude_funnel",
      "mcp__hermoso-ads-manager__amplitude_retention",
      "mcp__hermoso-ads-manager__amplitude_active_users",
      "mcp__hermoso-ads-manager__amplitude_user_activity",
      "mcp__hermoso-ads-manager__create_amplitude_annotation",
      "mcp__hermoso-ads-manager__create_posthog_annotation",
      "mcp__hermoso-ads-manager__create_mixpanel_annotation",
      "mcp__hermoso-ads-manager__list_posthog_surveys",
      "mcp__hermoso-ads-manager__posthog_survey_responses",
      "mcp__hermoso-ads-manager__mixpanel_profiles",
      "mcp__hermoso-ads-manager__vercel_web_analytics",
      "mcp__hermoso-ads-manager__vercel_event_analytics",
      "mcp__hermoso-ads-manager__stripe_report",
      "mcp__hermoso-ads-manager__stripe_balance",
      "mcp__hermoso-ads-manager__list_stripe_refunds",
      "mcp__hermoso-ads-manager__create_stripe_product",
      "mcp__hermoso-ads-manager__create_stripe_price",
      "mcp__hermoso-ads-manager__create_stripe_payment_link",
      "mcp__hermoso-ads-manager__create_stripe_coupon",
      "mcp__hermoso-ads-manager__create_stripe_customer",
      "mcp__hermoso-ads-manager__list_stripe_promotion_codes",
      "mcp__hermoso-ads-manager__create_stripe_promotion_code",
      "mcp__hermoso-ads-manager__list_stripe_payment_links",
      "mcp__hermoso-ads-manager__revenue_by_source",
      "mcp__hermoso-ads-manager__set_tracking_links",
      "mcp__hermoso-ads-manager__hubspot_deals_report",
      "mcp__hermoso-ads-manager__set_hubspot_lead_sync",
      "mcp__hermoso-ads-manager__create_salesforce_record",
      "mcp__hermoso-ads-manager__log_salesforce_activity",
      "mcp__hermoso-ads-manager__sync_leads_to_salesforce",
      "mcp__hermoso-ads-manager__microsoft_ads_report",
      "mcp__hermoso-ads-manager__microsoft_ads_keyword_ideas",
      "mcp__hermoso-ads-manager__microsoft_ads_traffic_estimates",
      "mcp__hermoso-ads-manager__microsoft_ads_budget_opportunities",
      "mcp__hermoso-ads-manager__add_microsoft_ads_keywords",
      "mcp__hermoso-ads-manager__microsoft_ads_editorial_reasons",
      "mcp__hermoso-ads-manager__add_microsoft_ads_negative_keywords",
      "mcp__hermoso-ads-manager__create_microsoft_ads_uet_tag",
      "mcp__hermoso-ads-manager__create_microsoft_ads_conversion_goal",
      "mcp__hermoso-ads-manager__upload_microsoft_ads_video",
      "mcp__hermoso-ads-manager__create_microsoft_ads_customer_list",
      "mcp__hermoso-ads-manager__applovin_ads_change_history",
      "mcp__hermoso-ads-manager__upload_applovin_ads_assets",
      "mcp__hermoso-ads-manager__applovin_ads_report",
      "mcp__hermoso-ads-manager__applovin_ads_pixel",
      "mcp__hermoso-ads-manager__openai_ads_report",
      "mcp__hermoso-ads-manager__microsoft_ads_bulk_download",
      "mcp__hermoso-ads-manager__microsoft_ads_auction_insights",
      "mcp__hermoso-ads-manager__microsoft_ads_recommendations",
      "mcp__hermoso-ads-manager__dismiss_microsoft_ads_recommendations",
      "mcp__hermoso-ads-manager__microsoft_ads_auto_apply",
      "mcp__hermoso-ads-manager__set_microsoft_ads_account_properties",
      "mcp__hermoso-ads-manager__apple_ads_report",
      "mcp__hermoso-ads-manager__add_apple_ads_keywords",
      "mcp__hermoso-ads-manager__add_apple_ads_negative_keywords",
      "mcp__hermoso-ads-manager__check_apple_ads_app_eligibility",
      "mcp__hermoso-ads-manager__upload_apple_ads_asset",
      "mcp__hermoso-ads-manager__create_apple_ads_location_group",
      "mcp__hermoso-ads-manager__apple_ads_keyword_suggestions",
      "mcp__hermoso-ads-manager__apple_ads_target_cpa_suggestion",
      "mcp__hermoso-ads-manager__dismiss_apple_ads_recommendation",
      "mcp__hermoso-ads-manager__apple_ads_impression_share",
      "mcp__hermoso-ads-manager__apple_ads_rejection_reasons",
      "mcp__hermoso-ads-manager__apple_ads_change_history",
      "mcp__hermoso-ads-manager__create_apple_ads_ad_account",
      "mcp__hermoso-ads-manager__create_x_ads_lead_form",
      "mcp__hermoso-ads-manager__upload_x_ads_media",
      "mcp__hermoso-ads-manager__create_x_ads_card",
      "mcp__hermoso-ads-manager__create_x_ads_post",
      "mcp__hermoso-ads-manager__create_x_ads_audience",
      "mcp__hermoso-ads-manager__manage_x_ads_conversion_events",
      "mcp__hermoso-ads-manager__add_x_ads_targeting",
      "mcp__hermoso-ads-manager__x_ads_report",
      "mcp__hermoso-ads-manager__create_openai_ads_pixel",
      "mcp__hermoso-ads-manager__create_openai_ads_conversion_event",
      "mcp__hermoso-ads-manager__create_openai_ads_audience",
      "mcp__hermoso-ads-manager__merge_openai_ads_audiences",
      "mcp__hermoso-ads-manager__openai_ads_bulk_job",
      "mcp__hermoso-ads-manager__openai_ads_conversions",
      "mcp__hermoso-ads-manager__create_openai_ads_conversion_api_key",
      "mcp__hermoso-ads-manager__create_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__test_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__preview_openai_ads_business_agent",
      "mcp__hermoso-ads-manager__set_openai_ads_negative_keywords",
      "mcp__hermoso-ads-manager__create_openai_ads_feed",
      "mcp__hermoso-ads-manager__openai_ads_hotel_report",
      "mcp__hermoso-ads-manager__pinterest_ads_report",
      "mcp__hermoso-ads-manager__create_pinterest_ads_conversion_tag",
      "mcp__hermoso-ads-manager__create_pinterest_ads_audience",
      "mcp__hermoso-ads-manager__create_pinterest_ads_customer_list",
      "mcp__hermoso-ads-manager__pinterest_ads_audience_size",
      "mcp__hermoso-ads-manager__run_pinterest_ads_report_template",
      "mcp__hermoso-ads-manager__pinterest_ads_keyword_ideas",
      "mcp__hermoso-ads-manager__preview_pinterest_ads_ad",
      "mcp__hermoso-ads-manager__reddit_ads_report",
      "mcp__hermoso-ads-manager__reddit_ads_forecast",
      "mcp__hermoso-ads-manager__reddit_ads_plan_forecast",
      "mcp__hermoso-ads-manager__reddit_ads_bid_suggestion",
      "mcp__hermoso-ads-manager__check_reddit_ads_target_cost_eligibility",
      "mcp__hermoso-ads-manager__create_reddit_ads_post",
      "mcp__hermoso-ads-manager__create_reddit_ads_catalog",
      "mcp__hermoso-ads-manager__create_reddit_ads_product_set",
      "mcp__hermoso-ads-manager__upload_reddit_ads_assets",
      "mcp__hermoso-ads-manager__rename_reddit_ads_asset",
      "mcp__hermoso-ads-manager__create_reddit_ads_audience",
      "mcp__hermoso-ads-manager__create_reddit_ads_saved_audience",
      "mcp__hermoso-ads-manager__authorize_tiktok_ads_spark_post",
      "mcp__hermoso-ads-manager__extend_tiktok_post_ad_authorization",
      "mcp__hermoso-ads-manager__tiktok_ads_report",
      "mcp__hermoso-ads-manager__tiktok_bid_protection",
      "mcp__hermoso-ads-manager__prereview_tiktok_ads_creative",
      "mcp__hermoso-ads-manager__create_tiktok_ads_pixel",
      "mcp__hermoso-ads-manager__tiktok_ads_pixel_stats",
      "mcp__hermoso-ads-manager__tiktok_ads_rf_inventory_estimate",
      "mcp__hermoso-ads-manager__tiktok_lead_ads_terms",
      "mcp__hermoso-ads-manager__download_tiktok_ads_leads",
      "mcp__hermoso-ads-manager__create_tiktok_ads_audience",
      "mcp__hermoso-ads-manager__create_tiktok_ads_lookalike_audience",
      "mcp__hermoso-ads-manager__tiktok_ads_audience_overlap",
      "mcp__hermoso-ads-manager__create_tiktok_ads_catalog",
      "mcp__hermoso-ads-manager__create_tiktok_ads_business_center",
      "mcp__hermoso-ads-manager__create_tiktok_ads_account",
      "mcp__hermoso-ads-manager__tiktok_ads_catalog_diagnostics",
      "mcp__hermoso-ads-manager__tiktok_ads_comment_thread",
      "mcp__hermoso-ads-manager__tiktok_ads_diagnosis",
      "mcp__hermoso-ads-manager__upload_tiktok_ads_creative",
      "mcp__hermoso-ads-manager__upload_tiktok_ads_playable",
      "mcp__hermoso-ads-manager__tiktok_ads_review_info",
      "mcp__hermoso-ads-manager__tiktok_ads_creative_fatigue",
      "mcp__hermoso-ads-manager__tiktok_ads_video_retention",
      "mcp__hermoso-ads-manager__tiktok_ads_trending_hashtags",
      "mcp__hermoso-ads-manager__tiktok_trends",
      "mcp__hermoso-ads-manager__tiktok_spark_recommendations",
      "mcp__hermoso-ads-manager__create_tiktok_ads_rule",
      "mcp__hermoso-ads-manager__tiktok_ads_rule_results",
      "mcp__hermoso-ads-manager__bind_tiktok_ads_rule",
      "mcp__hermoso-ads-manager__create_meta_ad_rule",
      "mcp__hermoso-ads-manager__meta_ad_rule_history",
      "mcp__hermoso-ads-manager__create_google_ads_rule",
      "mcp__hermoso-ads-manager__google_ads_rule_history",
      "mcp__hermoso-ads-manager__create_tiktok_ads_crm_event_set",
      "mcp__hermoso-ads-manager__tiktok_creator_leaderboard",
      "mcp__hermoso-ads-manager__create_tiktok_tto_brand_profile",
      "mcp__hermoso-ads-manager__tiktok_tto_campaign_report",
      "mcp__hermoso-ads-manager__submit_tiktok_ads_verification",
      "mcp__hermoso-ads-manager__list_tiktok_ads_payment_portfolios",
      "mcp__hermoso-ads-manager__snapchat_ads_report",
      "mcp__hermoso-ads-manager__create_snapchat_ads_lead_form",
      "mcp__hermoso-ads-manager__create_snapchat_ads_audience",
      "mcp__hermoso-ads-manager__linkedin_ads_report",
      "mcp__hermoso-ads-manager__linkedin_bid_pricing",
      "mcp__hermoso-ads-manager__linkedin_boost_analytics",
      "mcp__hermoso-ads-manager__create_linkedin_ads_campaign_group",
      "mcp__hermoso-ads-manager__create_linkedin_lead_form",
      "mcp__hermoso-ads-manager__create_linkedin_conversion_rule",
      "mcp__hermoso-ads-manager__duplicate_meta_object",
      "mcp__hermoso-ads-manager__save_to_drive",
      "mcp__hermoso-ads-manager__import_from_cloud",
      "mcp__hermoso-ads-manager__create_drive_folder",
      "mcp__hermoso-ads-manager__create_sheet",
      "mcp__hermoso-ads-manager__append_to_sheet",
      "mcp__hermoso-ads-manager__export_swipefile_deck",
      "mcp__hermoso-ads-manager__save_to_notion",
      "mcp__hermoso-ads-manager__append_to_notion_page",
      "mcp__hermoso-ads-manager__export_schedule_to_notion",
      "mcp__hermoso-ads-manager__create_doc",
      "mcp__hermoso-ads-manager__append_to_doc",
      "mcp__hermoso-ads-manager__save_to_onedrive",
      "mcp__hermoso-ads-manager__convert_onedrive_file",
      "mcp__hermoso-ads-manager__create_onedrive_folder",
      "mcp__hermoso-ads-manager__save_skill",
      "mcp__hermoso-ads-manager__remember",
      "mcp__hermoso-ads-manager__save_to_swipefile",
      "mcp__hermoso-ads-manager__save_playbook",
      "mcp__hermoso-ads-manager__save_creator",
      "mcp__hermoso-ads-manager__save_location",
      "mcp__hermoso-ads-manager__store_get",
      "mcp__hermoso-ads-manager__set_credit_limit",
      "mcp__hermoso-ads-manager__error_detail",
      "mcp__hermoso-ads-manager__fetch_asset",
      "mcp__hermoso-ads-manager__list_product_photos",
      "mcp__hermoso-ads-manager__posting_insights",
      "mcp__hermoso-ads-manager__inbox_stats"
    ],
    "deny": [
      "mcp__hermoso-ads-manager__call_tool",
      "mcp__hermoso-ads-manager__delete_brand",
      "mcp__hermoso-ads-manager__create_meta_campaign",
      "mcp__hermoso-ads-manager__set_meta_campaign_status",
      "mcp__hermoso-ads-manager__create_meta_ad",
      "mcp__hermoso-ads-manager__create_meta_adset",
      "mcp__hermoso-ads-manager__create_meta_pixel",
      "mcp__hermoso-ads-manager__send_meta_conversions",
      "mcp__hermoso-ads-manager__set_meta_conversions_auto",
      "mcp__hermoso-ads-manager__archive_meta_lead_form",
      "mcp__hermoso-ads-manager__delete_meta_audience",
      "mcp__hermoso-ads-manager__delete_shopify_marketing_activity",
      "mcp__hermoso-ads-manager__trigger_merchant_issue_action",
      "mcp__hermoso-ads-manager__set_merchant_inventory",
      "mcp__hermoso-ads-manager__manage_merchant_settings",
      "mcp__hermoso-ads-manager__manage_merchant_notifications",
      "mcp__hermoso-ads-manager__manage_merchant_conversion_source",
      "mcp__hermoso-ads-manager__upsert_merchant_product",
      "mcp__hermoso-ads-manager__delete_merchant_product",
      "mcp__hermoso-ads-manager__update_merchant_product",
      "mcp__hermoso-ads-manager__delete_merchant_data_source",
      "mcp__hermoso-ads-manager__create_google_ads_campaign",
      "mcp__hermoso-ads-manager__create_google_ads_ad_group",
      "mcp__hermoso-ads-manager__create_google_ads_ad",
      "mcp__hermoso-ads-manager__set_google_ads_targeting",
      "mcp__hermoso-ads-manager__set_google_ads_bidding",
      "mcp__hermoso-ads-manager__set_google_ads_budget",
      "mcp__hermoso-ads-manager__set_google_ads_status",
      "mcp__hermoso-ads-manager__manage_google_ads_budget_networks",
      "mcp__hermoso-ads-manager__set_google_ads_networks",
      "mcp__hermoso-ads-manager__set_google_ads_schedule_and_bids",
      "mcp__hermoso-ads-manager__manage_google_ads_negative_list",
      "mcp__hermoso-ads-manager__manage_google_ads_asset_groups",
      "mcp__hermoso-ads-manager__update_google_ads_ad",
      "mcp__hermoso-ads-manager__manage_google_ads_labels",
      "mcp__hermoso-ads-manager__manage_google_ads_bid_strategy",
      "mcp__hermoso-ads-manager__set_google_ads_conversion_goals",
      "mcp__hermoso-ads-manager__delete_google_ads_object",
      "mcp__hermoso-ads-manager__manage_google_ads_recommendations",
      "mcp__hermoso-ads-manager__manage_google_ads_assets",
      "mcp__hermoso-ads-manager__set_google_ads_tracking",
      "mcp__hermoso-ads-manager__manage_google_ads_audience",
      "mcp__hermoso-ads-manager__set_google_ads_audiences",
      "mcp__hermoso-ads-manager__upload_google_ads_video",
      "mcp__hermoso-ads-manager__create_google_ads_demand_gen_campaign",
      "mcp__hermoso-ads-manager__set_google_ads_asset_automation",
      "mcp__hermoso-ads-manager__manage_google_ads_seasonality",
      "mcp__hermoso-ads-manager__create_google_ads_performance_max_campaign",
      "mcp__hermoso-ads-manager__create_analytics_custom_dimension",
      "mcp__hermoso-ads-manager__archive_analytics_custom_dimension",
      "mcp__hermoso-ads-manager__delete_analytics_key_event",
      "mcp__hermoso-ads-manager__archive_analytics_custom_metric",
      "mcp__hermoso-ads-manager__unlink_google_ads_from_analytics",
      "mcp__hermoso-ads-manager__manage_analytics_measurement_protocol_secret",
      "mcp__hermoso-ads-manager__archive_analytics_audience",
      "mcp__hermoso-ads-manager__manage_analytics_channel_group",
      "mcp__hermoso-ads-manager__manage_analytics_calculated_metric",
      "mcp__hermoso-ads-manager__manage_analytics_annotations",
      "mcp__hermoso-ads-manager__analytics_data_retention",
      "mcp__hermoso-ads-manager__update_tag_manager_tag",
      "mcp__hermoso-ads-manager__publish_tag_manager_container",
      "mcp__hermoso-ads-manager__install_tracking_tag",
      "mcp__hermoso-ads-manager__remove_tracking_tag",
      "mcp__hermoso-ads-manager__delete_search_console_sitemap",
      "mcp__hermoso-ads-manager__delete_search_console_site",
      "mcp__hermoso-ads-manager__remove_bing_webmaster_sitemap",
      "mcp__hermoso-ads-manager__remove_bing_webmaster_site",
      "mcp__hermoso-ads-manager__update_mixpanel_annotation",
      "mcp__hermoso-ads-manager__delete_mixpanel_annotation",
      "mcp__hermoso-ads-manager__deploy_vercel_page",
      "mcp__hermoso-ads-manager__delete_vercel_deployment",
      "mcp__hermoso-ads-manager__create_stripe_subscription",
      "mcp__hermoso-ads-manager__cancel_stripe_subscription",
      "mcp__hermoso-ads-manager__refund_stripe_charge",
      "mcp__hermoso-ads-manager__update_stripe_promotion_code",
      "mcp__hermoso-ads-manager__update_stripe_payment_link",
      "mcp__hermoso-ads-manager__create_hubspot_contact",
      "mcp__hermoso-ads-manager__sync_leads_to_hubspot",
      "mcp__hermoso-ads-manager__update_salesforce_record",
      "mcp__hermoso-ads-manager__delete_salesforce_record",
      "mcp__hermoso-ads-manager__create_microsoft_ads_campaign",
      "mcp__hermoso-ads-manager__create_microsoft_ads_ad_group",
      "mcp__hermoso-ads-manager__create_microsoft_ads_ad",
      "mcp__hermoso-ads-manager__set_microsoft_ads_profile_targeting",
      "mcp__hermoso-ads-manager__set_microsoft_ads_budget",
      "mcp__hermoso-ads-manager__set_microsoft_ads_status",
      "mcp__hermoso-ads-manager__delete_microsoft_ads_object",
      "mcp__hermoso-ads-manager__upsert_microsoft_merchant_product",
      "mcp__hermoso-ads-manager__delete_microsoft_merchant_product",
      "mcp__hermoso-ads-manager__manage_microsoft_merchant_catalog",
      "mcp__hermoso-ads-manager__remove_microsoft_ads_negative_keywords",
      "mcp__hermoso-ads-manager__manage_microsoft_ads_negative_keyword_list",
      "mcp__hermoso-ads-manager__set_microsoft_ads_bidding",
      "mcp__hermoso-ads-manager__set_microsoft_ads_audience_targeting",
      "mcp__hermoso-ads-manager__create_microsoft_ads_image_ad",
      "mcp__hermoso-ads-manager__apply_microsoft_ads_customer_list",
      "mcp__hermoso-ads-manager__create_applovin_ads_campaign",
      "mcp__hermoso-ads-manager__update_applovin_ads_campaign",
      "mcp__hermoso-ads-manager__set_applovin_ads_status",
      "mcp__hermoso-ads-manager__create_applovin_ads_creative_set",
      "mcp__hermoso-ads-manager__remove_applovin_ads_creative_set",
      "mcp__hermoso-ads-manager__update_applovin_ads_creative_set",
      "mcp__hermoso-ads-manager__clone_applovin_ads_creative_set",
      "mcp__hermoso-ads-manager__send_applovin_ads_events",
      "mcp__hermoso-ads-manager__create_x_ads_campaign",
      "mcp__hermoso-ads-manager__set_x_ads_status",
      "mcp__hermoso-ads-manager__microsoft_ads_bulk_upload",
      "mcp__hermoso-ads-manager__send_microsoft_ads_offline_conversions",
      "mcp__hermoso-ads-manager__apply_microsoft_ads_recommendations",
      "mcp__hermoso-ads-manager__set_microsoft_ads_auto_apply",
      "mcp__hermoso-ads-manager__create_apple_ads_campaign",
      "mcp__hermoso-ads-manager__create_apple_ads_ad_group",
      "mcp__hermoso-ads-manager__update_apple_ads_object",
      "mcp__hermoso-ads-manager__set_apple_ads_status",
      "mcp__hermoso-ads-manager__delete_apple_ads_object",
      "mcp__hermoso-ads-manager__create_apple_ads_creative",
      "mcp__hermoso-ads-manager__create_apple_ads_ad",
      "mcp__hermoso-ads-manager__apply_apple_ads_recommendation",
      "mcp__hermoso-ads-manager__create_apple_ads_budget_order",
      "mcp__hermoso-ads-manager__update_apple_ads_budget_order",
      "mcp__hermoso-ads-manager__bulk_apple_ads_keywords",
      "mcp__hermoso-ads-manager__update_apple_ads_ad_account",
      "mcp__hermoso-ads-manager__update_x_ads_campaign",
      "mcp__hermoso-ads-manager__update_x_ads_line_item",
      "mcp__hermoso-ads-manager__delete_x_ads_object",
      "mcp__hermoso-ads-manager__create_x_ads_line_item",
      "mcp__hermoso-ads-manager__create_x_ads_promoted_account",
      "mcp__hermoso-ads-manager__update_x_ads_lead_form",
      "mcp__hermoso-ads-manager__update_x_ads_audience",
      "mcp__hermoso-ads-manager__send_x_ads_conversions",
      "mcp__hermoso-ads-manager__create_x_ads_promoted_tweet",
      "mcp__hermoso-ads-manager__update_openai_ads_audience_members",
      "mcp__hermoso-ads-manager__cancel_openai_ads_audience_operation",
      "mcp__hermoso-ads-manager__resume_openai_ads_audience_operation",
      "mcp__hermoso-ads-manager__archive_openai_ads_audience",
      "mcp__hermoso-ads-manager__create_openai_ads_campaign",
      "mcp__hermoso-ads-manager__create_openai_ads_ad_group",
      "mcp__hermoso-ads-manager__create_openai_ads_ad",
      "mcp__hermoso-ads-manager__openai_ads_bulk",
      "mcp__hermoso-ads-manager__update_openai_ads_feed_products",
      "mcp__hermoso-ads-manager__update_openai_ads_object",
      "mcp__hermoso-ads-manager__set_openai_ads_budget",
      "mcp__hermoso-ads-manager__send_openai_ads_conversions",
      "mcp__hermoso-ads-manager__update_openai_ads_account",
      "mcp__hermoso-ads-manager__set_openai_ads_status",
      "mcp__hermoso-ads-manager__delete_openai_ads_object",
      "mcp__hermoso-ads-manager__update_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__publish_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__archive_openai_ads_lead_form",
      "mcp__hermoso-ads-manager__set_openai_ads_lead_sync",
      "mcp__hermoso-ads-manager__delete_openai_ads_lead_sync",
      "mcp__hermoso-ads-manager__create_openai_ads_business_agent",
      "mcp__hermoso-ads-manager__publish_openai_ads_business_agent",
      "mcp__hermoso-ads-manager__set_openai_ads_spend_window",
      "mcp__hermoso-ads-manager__delete_openai_ads_spend_window",
      "mcp__hermoso-ads-manager__set_openai_ads_daily_spend_limit",
      "mcp__hermoso-ads-manager__remove_openai_ads_daily_spend_limit",
      "mcp__hermoso-ads-manager__archive_openai_ads_feed",
      "mcp__hermoso-ads-manager__set_openai_ads_feed_sftp",
      "mcp__hermoso-ads-manager__update_openai_ads_feed_settings",
      "mcp__hermoso-ads-manager__create_pinterest_ads_campaign",
      "mcp__hermoso-ads-manager__create_pinterest_ads_ad_group",
      "mcp__hermoso-ads-manager__create_pinterest_ads_ad",
      "mcp__hermoso-ads-manager__update_pinterest_ads_ad_group",
      "mcp__hermoso-ads-manager__update_pinterest_ads_ad",
      "mcp__hermoso-ads-manager__set_pinterest_ads_budget",
      "mcp__hermoso-ads-manager__set_pinterest_ads_status",
      "mcp__hermoso-ads-manager__delete_pinterest_ads_object",
      "mcp__hermoso-ads-manager__send_pinterest_ads_conversions",
      "mcp__hermoso-ads-manager__update_pinterest_ads_audience",
      "mcp__hermoso-ads-manager__update_pinterest_ads_customer_list",
      "mcp__hermoso-ads-manager__manage_pinterest_ads_keywords",
      "mcp__hermoso-ads-manager__pinterest_ads_bulk",
      "mcp__hermoso-ads-manager__manage_pinterest_ads_targeting_template",
      "mcp__hermoso-ads-manager__manage_pinterest_ads_promotion",
      "mcp__hermoso-ads-manager__create_pinterest_ads_product_group_promotion",
      "mcp__hermoso-ads-manager__update_pinterest_ads_product_group_promotion",
      "mcp__hermoso-ads-manager__update_reddit_ads_post",
      "mcp__hermoso-ads-manager__create_reddit_ads_campaign",
      "mcp__hermoso-ads-manager__create_reddit_ads_ad_group",
      "mcp__hermoso-ads-manager__update_reddit_ads_ad_group",
      "mcp__hermoso-ads-manager__create_reddit_ads_ad",
      "mcp__hermoso-ads-manager__create_reddit_ads_max_campaign",
      "mcp__hermoso-ads-manager__update_reddit_ads_max_template",
      "mcp__hermoso-ads-manager__update_reddit_ads_ad",
      "mcp__hermoso-ads-manager__update_reddit_ads_campaign",
      "mcp__hermoso-ads-manager__set_reddit_ads_status",
      "mcp__hermoso-ads-manager__delete_reddit_ads_object",
      "mcp__hermoso-ads-manager__create_reddit_ads_product_feed",
      "mcp__hermoso-ads-manager__update_reddit_ads_catalog_object",
      "mcp__hermoso-ads-manager__delete_reddit_ads_catalog_object",
      "mcp__hermoso-ads-manager__upsert_reddit_ads_products",
      "mcp__hermoso-ads-manager__delete_reddit_ads_products",
      "mcp__hermoso-ads-manager__reddit_ads_data_deletion",
      "mcp__hermoso-ads-manager__delete_reddit_ads_asset",
      "mcp__hermoso-ads-manager__send_reddit_ads_conversions",
      "mcp__hermoso-ads-manager__update_reddit_ads_audience_users",
      "mcp__hermoso-ads-manager__delete_reddit_ads_audience",
      "mcp__hermoso-ads-manager__update_reddit_ads_saved_audience",
      "mcp__hermoso-ads-manager__delete_reddit_ads_saved_audience",
      "mcp__hermoso-ads-manager__unbind_tiktok_ads_spark_post",
      "mcp__hermoso-ads-manager__set_tiktok_post_ad_authorization",
      "mcp__hermoso-ads-manager__delete_tiktok_post_ad_authorization",
      "mcp__hermoso-ads-manager__create_tiktok_smart_campaign",
      "mcp__hermoso-ads-manager__create_tiktok_smart_ad_group",
      "mcp__hermoso-ads-manager__create_tiktok_smart_ad",
      "mcp__hermoso-ads-manager__manage_tiktok_ads_negative_keywords",
      "mcp__hermoso-ads-manager__set_tiktok_smart_status",
      "mcp__hermoso-ads-manager__create_tiktok_ads_campaign",
      "mcp__hermoso-ads-manager__create_tiktok_ads_ad_group",
      "mcp__hermoso-ads-manager__create_tiktok_ads_rf_ad_group",
      "mcp__hermoso-ads-manager__manage_tiktok_ads_test_lead",
      "mcp__hermoso-ads-manager__send_tiktok_ads_events",
      "mcp__hermoso-ads-manager__update_tiktok_ads_audience",
      "mcp__hermoso-ads-manager__apply_tiktok_ads_audience",
      "mcp__hermoso-ads-manager__delete_tiktok_ads_audience",
      "mcp__hermoso-ads-manager__manage_tiktok_ads_catalog_feed",
      "mcp__hermoso-ads-manager__moderate_tiktok_ads_comment",
      "mcp__hermoso-ads-manager__reply_to_tiktok_ads_comment",
      "mcp__hermoso-ads-manager__delete_tiktok_ads_comment",
      "mcp__hermoso-ads-manager__manage_tiktok_ads_blocked_words",
      "mcp__hermoso-ads-manager__set_tiktok_ads_brand_safety",
      "mcp__hermoso-ads-manager__delete_tiktok_ads_playable",
      "mcp__hermoso-ads-manager__create_tiktok_ads_ad",
      "mcp__hermoso-ads-manager__update_tiktok_ads_ad",
      "mcp__hermoso-ads-manager__update_tiktok_ads_rule",
      "mcp__hermoso-ads-manager__set_tiktok_ads_rule_status",
      "mcp__hermoso-ads-manager__update_meta_ad_rule",
      "mcp__hermoso-ads-manager__set_meta_ad_rule_status",
      "mcp__hermoso-ads-manager__delete_meta_ad_rule",
      "mcp__hermoso-ads-manager__run_meta_ad_rule",
      "mcp__hermoso-ads-manager__set_meta_ad_rule_limits",
      "mcp__hermoso-ads-manager__update_google_ads_rule",
      "mcp__hermoso-ads-manager__set_google_ads_rule_status",
      "mcp__hermoso-ads-manager__delete_google_ads_rule",
      "mcp__hermoso-ads-manager__run_google_ads_rule",
      "mcp__hermoso-ads-manager__undo_google_ads_rule_action",
      "mcp__hermoso-ads-manager__set_google_ads_rule_limits",
      "mcp__hermoso-ads-manager__manage_tiktok_ads_offline_event_set",
      "mcp__hermoso-ads-manager__send_tiktok_ads_offline_events",
      "mcp__hermoso-ads-manager__set_tiktok_ads_status",
      "mcp__hermoso-ads-manager__set_tiktok_ads_budget",
      "mcp__hermoso-ads-manager__update_tiktok_ads_ad_group",
      "mcp__hermoso-ads-manager__delete_tiktok_ads_object",
      "mcp__hermoso-ads-manager__create_tiktok_tto_campaign",
      "mcp__hermoso-ads-manager__update_tiktok_tto_campaign",
      "mcp__hermoso-ads-manager__link_tiktok_tto_video",
      "mcp__hermoso-ads-manager__request_tiktok_tto_spark_authorization",
      "mcp__hermoso-ads-manager__manage_tiktok_tto_anchor",
      "mcp__hermoso-ads-manager__upload_snapchat_ads_creative",
      "mcp__hermoso-ads-manager__set_snapchat_ads_ai_declaration",
      "mcp__hermoso-ads-manager__create_snapchat_ads_campaign",
      "mcp__hermoso-ads-manager__create_snapchat_ads_ad_squad",
      "mcp__hermoso-ads-manager__create_snapchat_ads_ad",
      "mcp__hermoso-ads-manager__set_snapchat_ads_budget",
      "mcp__hermoso-ads-manager__set_snapchat_ads_status",
      "mcp__hermoso-ads-manager__delete_snapchat_ads_object",
      "mcp__hermoso-ads-manager__manage_snapchat_ads_lead_webhook",
      "mcp__hermoso-ads-manager__update_snapchat_ads_object",
      "mcp__hermoso-ads-manager__update_snapchat_ads_audience_users",
      "mcp__hermoso-ads-manager__delete_snapchat_ads_audience",
      "mcp__hermoso-ads-manager__send_snapchat_ads_conversions",
      "mcp__hermoso-ads-manager__boost_linkedin_post",
      "mcp__hermoso-ads-manager__end_linkedin_boost",
      "mcp__hermoso-ads-manager__update_linkedin_boost",
      "mcp__hermoso-ads-manager__manage_linkedin_boost_audience",
      "mcp__hermoso-ads-manager__create_linkedin_ads_campaign",
      "mcp__hermoso-ads-manager__update_linkedin_ads_campaign",
      "mcp__hermoso-ads-manager__set_linkedin_ads_budget",
      "mcp__hermoso-ads-manager__set_linkedin_ads_status",
      "mcp__hermoso-ads-manager__create_linkedin_ads_creative",
      "mcp__hermoso-ads-manager__update_linkedin_lead_form",
      "mcp__hermoso-ads-manager__update_linkedin_ads_creative",
      "mcp__hermoso-ads-manager__set_linkedin_ads_tracking",
      "mcp__hermoso-ads-manager__delete_linkedin_ads_object",
      "mcp__hermoso-ads-manager__update_linkedin_conversion_rule",
      "mcp__hermoso-ads-manager__associate_linkedin_conversion_campaigns",
      "mcp__hermoso-ads-manager__send_linkedin_conversions",
      "mcp__hermoso-ads-manager__update_meta_object",
      "mcp__hermoso-ads-manager__delete_meta_object",
      "mcp__hermoso-ads-manager__update_drive_file",
      "mcp__hermoso-ads-manager__delete_drive_file",
      "mcp__hermoso-ads-manager__update_notion_row",
      "mcp__hermoso-ads-manager__update_sheet",
      "mcp__hermoso-ads-manager__clear_sheet_range",
      "mcp__hermoso-ads-manager__manage_sheet_tabs",
      "mcp__hermoso-ads-manager__format_sheet",
      "mcp__hermoso-ads-manager__update_doc",
      "mcp__hermoso-ads-manager__update_onedrive_file",
      "mcp__hermoso-ads-manager__delete_onedrive_file",
      "mcp__hermoso-ads-manager__share_onedrive_file",
      "mcp__hermoso-ads-manager__onedrive_file_permissions",
      "mcp__hermoso-ads-manager__delete_skill",
      "mcp__hermoso-ads-manager__forget",
      "mcp__hermoso-ads-manager__tidy_memory",
      "mcp__hermoso-ads-manager__update_saved_creator",
      "mcp__hermoso-ads-manager__delete_playbook",
      "mcp__hermoso-ads-manager__delete_creator",
      "mcp__hermoso-ads-manager__delete_location",
      "mcp__hermoso-ads-manager__update_brand",
      "mcp__hermoso-ads-manager__update_settings",
      "mcp__hermoso-ads-manager__set_connector_accounts",
      "mcp__hermoso-ads-manager__disconnect_connector",
      "mcp__hermoso-ads-manager__connect_connector",
      "mcp__hermoso-ads-manager__leave_connector",
      "mcp__hermoso-ads-manager__invite_member",
      "mcp__hermoso-ads-manager__remove_member",
      "mcp__hermoso-ads-manager__set_role",
      "mcp__hermoso-ads-manager__draft_brand",
      "mcp__hermoso-ads-manager__delete_library_item",
      "mcp__hermoso-ads-manager__list_products"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as hermoso-ads-manager. Review it before you use it.

Capability tags behind 783 rules
  • mcp__hermoso-ads-manager__call_tool untrusted-input
  • mcp__hermoso-ads-manager__buy_credits untrusted-input
  • mcp__hermoso-ads-manager__report_bug untrusted-input
  • mcp__hermoso-ads-manager__request_feature untrusted-input
  • mcp__hermoso-ads-manager__contact_support untrusted-input
  • mcp__hermoso-ads-manager__billing_status private-data
  • mcp__hermoso-ads-manager__upgrade_plan untrusted-input
  • mcp__hermoso-ads-manager__delete_brand untrusted-input
  • mcp__hermoso-ads-manager__upload_file untrusted-input, outbound
  • mcp__hermoso-ads-manager__pinterest_ads_async_report untrusted-input
  • mcp__hermoso-ads-manager__search_pinterest_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__upload_meta_asset untrusted-input, outbound
  • mcp__hermoso-ads-manager__create_meta_campaign untrusted-input
  • mcp__hermoso-ads-manager__set_meta_campaign_status untrusted-input
  • mcp__hermoso-ads-manager__upload_meta_playable untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_meta_playables untrusted-input
  • mcp__hermoso-ads-manager__create_meta_ad untrusted-input
  • mcp__hermoso-ads-manager__create_meta_adset untrusted-input
  • mcp__hermoso-ads-manager__find_meta_audiences private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_meta_ads untrusted-input
  • mcp__hermoso-ads-manager__analyze_campaigns untrusted-input
  • mcp__hermoso-ads-manager__meta_insights untrusted-input
  • mcp__hermoso-ads-manager__preview_meta_ad untrusted-input
  • mcp__hermoso-ads-manager__meta_catalog_suggestions untrusted-input
  • mcp__hermoso-ads-manager__estimate_meta_reach untrusted-input
  • mcp__hermoso-ads-manager__list_meta_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_meta_audience untrusted-input
  • mcp__hermoso-ads-manager__list_meta_pixels untrusted-input
  • mcp__hermoso-ads-manager__get_meta_ad_account untrusted-input
  • mcp__hermoso-ads-manager__create_meta_pixel untrusted-input
  • mcp__hermoso-ads-manager__send_meta_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__meta_dataset_quality untrusted-input
  • mcp__hermoso-ads-manager__set_meta_conversions_auto untrusted-input
  • mcp__hermoso-ads-manager__list_meta_lead_forms untrusted-input
  • mcp__hermoso-ads-manager__create_meta_lead_form untrusted-input
  • mcp__hermoso-ads-manager__archive_meta_lead_form untrusted-input
  • mcp__hermoso-ads-manager__read_meta_leads untrusted-input
  • mcp__hermoso-ads-manager__delete_meta_audience untrusted-input
  • mcp__hermoso-ads-manager__register_merchant_developer untrusted-input
  • mcp__hermoso-ads-manager__list_merchant_accounts untrusted-input
  • mcp__hermoso-ads-manager__list_merchant_products untrusted-input
  • mcp__hermoso-ads-manager__record_shopify_marketing_activity untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_shopify_marketing_activities untrusted-input
  • mcp__hermoso-ads-manager__delete_shopify_marketing_activity untrusted-input
  • mcp__hermoso-ads-manager__merchant_report untrusted-input
  • mcp__hermoso-ads-manager__list_merchant_issues untrusted-input
  • mcp__hermoso-ads-manager__list_merchant_promotions untrusted-input
  • mcp__hermoso-ads-manager__create_merchant_promotion untrusted-input
  • mcp__hermoso-ads-manager__merchant_issue_help untrusted-input
  • mcp__hermoso-ads-manager__trigger_merchant_issue_action untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_merchant_inventory untrusted-input
  • mcp__hermoso-ads-manager__set_merchant_inventory untrusted-input
  • mcp__hermoso-ads-manager__merchant_account_status untrusted-input
  • mcp__hermoso-ads-manager__manage_merchant_settings untrusted-input
  • mcp__hermoso-ads-manager__merchant_quota untrusted-input
  • mcp__hermoso-ads-manager__manage_merchant_notifications untrusted-input
  • mcp__hermoso-ads-manager__manage_merchant_conversion_source untrusted-input
  • mcp__hermoso-ads-manager__list_merchant_data_sources untrusted-input
  • mcp__hermoso-ads-manager__create_merchant_data_source untrusted-input
  • mcp__hermoso-ads-manager__upsert_merchant_product untrusted-input
  • mcp__hermoso-ads-manager__delete_merchant_product untrusted-input
  • mcp__hermoso-ads-manager__update_merchant_product untrusted-input
  • mcp__hermoso-ads-manager__delete_merchant_data_source untrusted-input
  • mcp__hermoso-ads-manager__list_google_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__google_ads_report untrusted-input
  • mcp__hermoso-ads-manager__google_ads_change_history untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__add_google_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_bidding untrusted-input
  • mcp__hermoso-ads-manager__find_google_ads_locations untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_status untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_budget_networks untrusted-input
  • mcp__hermoso-ads-manager__google_ads_local_services_eligibility untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_networks untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_schedule_and_bids untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_negative_list untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_asset_groups untrusted-input
  • mcp__hermoso-ads-manager__update_google_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__duplicate_google_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_labels untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_bid_strategy untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_conversion_goals untrusted-input
  • mcp__hermoso-ads-manager__delete_google_ads_object untrusted-input
  • mcp__hermoso-ads-manager__upload_google_ads_asset untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_conversion_action untrusted-input
  • mcp__hermoso-ads-manager__list_google_ads_conversion_actions untrusted-input
  • mcp__hermoso-ads-manager__add_google_ads_assets untrusted-input
  • mcp__hermoso-ads-manager__google_ads_recommendations untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_recommendations untrusted-input
  • mcp__hermoso-ads-manager__preview_google_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__google_ads_policy_issues untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_assets untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_tracking untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__upload_google_ads_video untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_demand_gen_campaign untrusted-input
  • mcp__hermoso-ads-manager__set_google_ads_asset_automation untrusted-input
  • mcp__hermoso-ads-manager__manage_google_ads_seasonality untrusted-input
  • mcp__hermoso-ads-manager__list_google_ads_lead_submissions private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_performance_max_campaign untrusted-input
  • mcp__hermoso-ads-manager__google_ads_keyword_ideas untrusted-input, outbound
  • mcp__hermoso-ads-manager__check_email_address untrusted-input
  • mcp__hermoso-ads-manager__check_domain_email_health untrusted-input
  • mcp__hermoso-ads-manager__generate_dns_record untrusted-input
  • mcp__hermoso-ads-manager__list_analytics_properties untrusted-input
  • mcp__hermoso-ads-manager__analytics_report untrusted-input
  • mcp__hermoso-ads-manager__analytics_realtime untrusted-input
  • mcp__hermoso-ads-manager__list_analytics_definitions untrusted-input
  • mcp__hermoso-ads-manager__create_analytics_key_event untrusted-input
  • mcp__hermoso-ads-manager__create_analytics_custom_dimension untrusted-input
  • mcp__hermoso-ads-manager__list_analytics_metadata untrusted-input
  • mcp__hermoso-ads-manager__archive_analytics_custom_dimension untrusted-input
  • mcp__hermoso-ads-manager__delete_analytics_key_event untrusted-input
  • mcp__hermoso-ads-manager__create_analytics_custom_metric untrusted-input
  • mcp__hermoso-ads-manager__archive_analytics_custom_metric untrusted-input
  • mcp__hermoso-ads-manager__check_analytics_compatibility untrusted-input
  • mcp__hermoso-ads-manager__list_analytics_google_ads_links untrusted-input
  • mcp__hermoso-ads-manager__link_google_ads_to_analytics untrusted-input
  • mcp__hermoso-ads-manager__unlink_google_ads_from_analytics untrusted-input
  • mcp__hermoso-ads-manager__list_analytics_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_analytics_audience untrusted-input
  • mcp__hermoso-ads-manager__list_analytics_data_streams private-data, untrusted-input
  • mcp__hermoso-ads-manager__get_analytics_stream_setup untrusted-input
  • mcp__hermoso-ads-manager__manage_analytics_measurement_protocol_secret untrusted-input
  • mcp__hermoso-ads-manager__archive_analytics_audience untrusted-input
  • mcp__hermoso-ads-manager__manage_analytics_channel_group untrusted-input
  • mcp__hermoso-ads-manager__manage_analytics_calculated_metric untrusted-input
  • mcp__hermoso-ads-manager__manage_analytics_annotations untrusted-input
  • mcp__hermoso-ads-manager__analytics_data_retention untrusted-input
  • mcp__hermoso-ads-manager__list_tag_manager_containers untrusted-input
  • mcp__hermoso-ads-manager__list_tag_manager_tags untrusted-input
  • mcp__hermoso-ads-manager__create_tag_manager_tag untrusted-input
  • mcp__hermoso-ads-manager__update_tag_manager_tag untrusted-input
  • mcp__hermoso-ads-manager__create_tag_manager_trigger untrusted-input
  • mcp__hermoso-ads-manager__list_tag_manager_versions untrusted-input
  • mcp__hermoso-ads-manager__preview_tag_manager_publish untrusted-input
  • mcp__hermoso-ads-manager__publish_tag_manager_container untrusted-input, outbound
  • mcp__hermoso-ads-manager__install_tracking_tag untrusted-input
  • mcp__hermoso-ads-manager__list_tracking_tags untrusted-input, outbound
  • mcp__hermoso-ads-manager__remove_tracking_tag untrusted-input
  • mcp__hermoso-ads-manager__list_search_console_sites untrusted-input
  • mcp__hermoso-ads-manager__search_console_performance untrusted-input
  • mcp__hermoso-ads-manager__search_console_url_inspection untrusted-input
  • mcp__hermoso-ads-manager__list_search_console_sitemaps untrusted-input
  • mcp__hermoso-ads-manager__submit_search_console_sitemap untrusted-input
  • mcp__hermoso-ads-manager__delete_search_console_sitemap untrusted-input
  • mcp__hermoso-ads-manager__add_search_console_site untrusted-input
  • mcp__hermoso-ads-manager__delete_search_console_site untrusted-input
  • mcp__hermoso-ads-manager__list_bing_webmaster_sites untrusted-input
  • mcp__hermoso-ads-manager__bing_webmaster_traffic untrusted-input, outbound
  • mcp__hermoso-ads-manager__bing_webmaster_query_stats untrusted-input
  • mcp__hermoso-ads-manager__bing_webmaster_keywords untrusted-input
  • mcp__hermoso-ads-manager__bing_webmaster_crawl untrusted-input, outbound
  • mcp__hermoso-ads-manager__bing_webmaster_links untrusted-input, outbound
  • mcp__hermoso-ads-manager__bing_webmaster_submission_quota untrusted-input
  • mcp__hermoso-ads-manager__submit_bing_webmaster_urls untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_bing_webmaster_sitemaps private-data, untrusted-input
  • mcp__hermoso-ads-manager__submit_bing_webmaster_sitemap untrusted-input
  • mcp__hermoso-ads-manager__remove_bing_webmaster_sitemap untrusted-input
  • mcp__hermoso-ads-manager__list_bing_webmaster_fetched_urls untrusted-input, outbound
  • mcp__hermoso-ads-manager__fetch_bing_webmaster_url untrusted-input, outbound
  • mcp__hermoso-ads-manager__submit_bing_webmaster_content untrusted-input, outbound
  • mcp__hermoso-ads-manager__add_bing_webmaster_site untrusted-input
  • mcp__hermoso-ads-manager__verify_bing_webmaster_site untrusted-input
  • mcp__hermoso-ads-manager__remove_bing_webmaster_site untrusted-input
  • mcp__hermoso-ads-manager__submit_indexnow untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_posthog_projects untrusted-input
  • mcp__hermoso-ads-manager__posthog_query private-data, untrusted-input
  • mcp__hermoso-ads-manager__posthog_insight untrusted-input
  • mcp__hermoso-ads-manager__list_posthog_session_recordings untrusted-input
  • mcp__hermoso-ads-manager__posthog_persons untrusted-input
  • mcp__hermoso-ads-manager__mixpanel_insights untrusted-input
  • mcp__hermoso-ads-manager__mixpanel_retention untrusted-input
  • mcp__hermoso-ads-manager__mixpanel_segmentation untrusted-input
  • mcp__hermoso-ads-manager__mixpanel_funnel untrusted-input
  • mcp__hermoso-ads-manager__list_mixpanel_events untrusted-input
  • mcp__hermoso-ads-manager__amplitude_segmentation untrusted-input
  • mcp__hermoso-ads-manager__amplitude_funnel untrusted-input
  • mcp__hermoso-ads-manager__amplitude_retention untrusted-input
  • mcp__hermoso-ads-manager__amplitude_active_users untrusted-input
  • mcp__hermoso-ads-manager__amplitude_user_activity untrusted-input
  • mcp__hermoso-ads-manager__list_amplitude_events untrusted-input
  • mcp__hermoso-ads-manager__amplitude_chart untrusted-input
  • mcp__hermoso-ads-manager__list_amplitude_annotations untrusted-input
  • mcp__hermoso-ads-manager__create_amplitude_annotation untrusted-input
  • mcp__hermoso-ads-manager__list_posthog_annotations untrusted-input
  • mcp__hermoso-ads-manager__create_posthog_annotation untrusted-input
  • mcp__hermoso-ads-manager__list_mixpanel_annotations untrusted-input
  • mcp__hermoso-ads-manager__create_mixpanel_annotation untrusted-input
  • mcp__hermoso-ads-manager__update_mixpanel_annotation untrusted-input
  • mcp__hermoso-ads-manager__delete_mixpanel_annotation untrusted-input
  • mcp__hermoso-ads-manager__list_posthog_surveys untrusted-input
  • mcp__hermoso-ads-manager__posthog_survey_responses untrusted-input
  • mcp__hermoso-ads-manager__list_mixpanel_cohorts untrusted-input
  • mcp__hermoso-ads-manager__mixpanel_profiles untrusted-input
  • mcp__hermoso-ads-manager__list_vercel_projects private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_vercel_deployments private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_vercel_domains private-data, untrusted-input
  • mcp__hermoso-ads-manager__vercel_web_analytics untrusted-input
  • mcp__hermoso-ads-manager__vercel_event_analytics untrusted-input
  • mcp__hermoso-ads-manager__deploy_vercel_page untrusted-input
  • mcp__hermoso-ads-manager__delete_vercel_deployment untrusted-input
  • mcp__hermoso-ads-manager__stripe_report untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_customers private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_charges private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_subscriptions untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_invoices private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_products untrusted-input
  • mcp__hermoso-ads-manager__stripe_balance untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_refunds untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_coupons untrusted-input
  • mcp__hermoso-ads-manager__create_stripe_product untrusted-input
  • mcp__hermoso-ads-manager__create_stripe_price untrusted-input
  • mcp__hermoso-ads-manager__create_stripe_payment_link untrusted-input
  • mcp__hermoso-ads-manager__create_stripe_coupon untrusted-input
  • mcp__hermoso-ads-manager__create_stripe_customer untrusted-input, outbound
  • mcp__hermoso-ads-manager__create_stripe_subscription untrusted-input
  • mcp__hermoso-ads-manager__cancel_stripe_subscription untrusted-input
  • mcp__hermoso-ads-manager__refund_stripe_charge untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_promotion_codes untrusted-input
  • mcp__hermoso-ads-manager__create_stripe_promotion_code untrusted-input
  • mcp__hermoso-ads-manager__update_stripe_promotion_code untrusted-input
  • mcp__hermoso-ads-manager__list_stripe_payment_links untrusted-input
  • mcp__hermoso-ads-manager__update_stripe_payment_link untrusted-input
  • mcp__hermoso-ads-manager__get_stripe_payment_link_revenue untrusted-input
  • mcp__hermoso-ads-manager__revenue_by_source untrusted-input, outbound
  • mcp__hermoso-ads-manager__set_tracking_links outbound
  • mcp__hermoso-ads-manager__list_hubspot_contacts private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_hubspot_contact untrusted-input
  • mcp__hermoso-ads-manager__sync_leads_to_hubspot untrusted-input
  • mcp__hermoso-ads-manager__hubspot_deals_report untrusted-input
  • mcp__hermoso-ads-manager__list_hubspot_companies private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_hubspot_owners private-data, untrusted-input
  • mcp__hermoso-ads-manager__set_hubspot_lead_sync untrusted-input
  • mcp__hermoso-ads-manager__list_salesforce_records private-data, untrusted-input
  • mcp__hermoso-ads-manager__get_salesforce_record private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_salesforce_record untrusted-input, outbound
  • mcp__hermoso-ads-manager__update_salesforce_record untrusted-input
  • mcp__hermoso-ads-manager__delete_salesforce_record untrusted-input
  • mcp__hermoso-ads-manager__describe_salesforce_object private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_salesforce_owners private-data, untrusted-input
  • mcp__hermoso-ads-manager__log_salesforce_activity private-data, untrusted-input, outbound
  • mcp__hermoso-ads-manager__sync_leads_to_salesforce untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_report untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_keyword_ideas untrusted-input, outbound
  • mcp__hermoso-ads-manager__microsoft_ads_traffic_estimates untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_budget_opportunities untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_geo_search untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__add_microsoft_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__search_microsoft_ads_profiles untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_ads_profile_targeting untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_profile_targeting untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_status untrusted-input
  • mcp__hermoso-ads-manager__delete_microsoft_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_merchant_stores untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_merchant_products untrusted-input
  • mcp__hermoso-ads-manager__upsert_microsoft_merchant_product untrusted-input
  • mcp__hermoso-ads-manager__delete_microsoft_merchant_product untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_merchant_issues untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_merchant_catalogs untrusted-input
  • mcp__hermoso-ads-manager__manage_microsoft_merchant_catalog untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_editorial_reasons untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_ads_negative_keywords untrusted-input
  • mcp__hermoso-ads-manager__add_microsoft_ads_negative_keywords untrusted-input
  • mcp__hermoso-ads-manager__remove_microsoft_ads_negative_keywords untrusted-input
  • mcp__hermoso-ads-manager__manage_microsoft_ads_negative_keyword_list untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_bidding untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_ads_uet_tags untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_uet_tag untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_conversion_goal untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_ads_audience_targeting untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_audience_targeting untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_image_ad untrusted-input
  • mcp__hermoso-ads-manager__upload_microsoft_ads_video untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_microsoft_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_microsoft_ads_customer_list untrusted-input
  • mcp__hermoso-ads-manager__apply_microsoft_ads_customer_list untrusted-input
  • mcp__hermoso-ads-manager__list_applovin_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__create_applovin_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__update_applovin_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__set_applovin_ads_status untrusted-input
  • mcp__hermoso-ads-manager__list_applovin_ads_creative_sets untrusted-input
  • mcp__hermoso-ads-manager__create_applovin_ads_creative_set untrusted-input
  • mcp__hermoso-ads-manager__remove_applovin_ads_creative_set untrusted-input
  • mcp__hermoso-ads-manager__update_applovin_ads_creative_set untrusted-input
  • mcp__hermoso-ads-manager__clone_applovin_ads_creative_set untrusted-input
  • mcp__hermoso-ads-manager__applovin_ads_change_history untrusted-input
  • mcp__hermoso-ads-manager__list_applovin_ads_catalogs untrusted-input
  • mcp__hermoso-ads-manager__list_applovin_ads_assets untrusted-input
  • mcp__hermoso-ads-manager__upload_applovin_ads_assets untrusted-input, outbound
  • mcp__hermoso-ads-manager__applovin_ads_report untrusted-input
  • mcp__hermoso-ads-manager__send_applovin_ads_events untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_openai_ads_campaigns private-data, untrusted-input
  • mcp__hermoso-ads-manager__openai_ads_report untrusted-input
  • mcp__hermoso-ads-manager__openai_ads_geo_search private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_accounts untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__set_x_ads_status untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_bulk_download untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_bulk_upload untrusted-input
  • mcp__hermoso-ads-manager__list_microsoft_ads_conversion_goals untrusted-input
  • mcp__hermoso-ads-manager__send_microsoft_ads_offline_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__microsoft_ads_auction_insights untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_recommendations untrusted-input
  • mcp__hermoso-ads-manager__apply_microsoft_ads_recommendations untrusted-input
  • mcp__hermoso-ads-manager__dismiss_microsoft_ads_recommendations untrusted-input
  • mcp__hermoso-ads-manager__microsoft_ads_auto_apply untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_auto_apply untrusted-input
  • mcp__hermoso-ads-manager__get_microsoft_ads_account_properties untrusted-input
  • mcp__hermoso-ads-manager__set_microsoft_ads_account_properties untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_ad_groups untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_report untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_orgs private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__add_apple_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__add_apple_ads_negative_keywords untrusted-input
  • mcp__hermoso-ads-manager__update_apple_ads_object untrusted-input
  • mcp__hermoso-ads-manager__set_apple_ads_status untrusted-input
  • mcp__hermoso-ads-manager__delete_apple_ads_object untrusted-input
  • mcp__hermoso-ads-manager__search_apple_ads_apps untrusted-input
  • mcp__hermoso-ads-manager__check_apple_ads_app_eligibility untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_product_pages untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_creatives untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_creative untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_ads untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__upload_apple_ads_asset untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_assets untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_brands untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_locations untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_location_groups untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_location_group untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_keyword_suggestions untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_target_cpa_suggestion untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_recommendations untrusted-input
  • mcp__hermoso-ads-manager__apply_apple_ads_recommendation untrusted-input
  • mcp__hermoso-ads-manager__dismiss_apple_ads_recommendation untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_impression_share untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_search_term_popularity untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_rejection_reasons untrusted-input
  • mcp__hermoso-ads-manager__apple_ads_change_history untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_budget_orders untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_budget_order untrusted-input
  • mcp__hermoso-ads-manager__update_apple_ads_budget_order untrusted-input
  • mcp__hermoso-ads-manager__bulk_apple_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__search_apple_ads_geo untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_supported_languages untrusted-input
  • mcp__hermoso-ads-manager__get_apple_ads_ad_account untrusted-input
  • mcp__hermoso-ads-manager__list_apple_ads_advertiser_resources untrusted-input
  • mcp__hermoso-ads-manager__create_apple_ads_ad_account untrusted-input
  • mcp__hermoso-ads-manager__update_apple_ads_ad_account untrusted-input
  • mcp__hermoso-ads-manager__update_x_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__update_x_ads_line_item untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_promoted_tweets untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_funding_instruments untrusted-input
  • mcp__hermoso-ads-manager__x_ads_targeting_search private-data, untrusted-input
  • mcp__hermoso-ads-manager__delete_x_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_line_items untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_line_item untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_promoted_account untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_promotable_users untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_lead_forms untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_lead_form untrusted-input
  • mcp__hermoso-ads-manager__update_x_ads_lead_form untrusted-input
  • mcp__hermoso-ads-manager__get_x_ads_leads private-data, untrusted-input
  • mcp__hermoso-ads-manager__upload_x_ads_media untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_x_ads_media untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_card untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_cards untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_post untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_x_ads_posts untrusted-input
  • mcp__hermoso-ads-manager__preview_x_ads_post untrusted-input
  • mcp__hermoso-ads-manager__list_x_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_x_ads_audience untrusted-input, outbound
  • mcp__hermoso-ads-manager__update_x_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__manage_x_ads_conversion_events untrusted-input
  • mcp__hermoso-ads-manager__send_x_ads_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__create_x_ads_promoted_tweet untrusted-input, outbound
  • mcp__hermoso-ads-manager__add_x_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__x_ads_geo_search untrusted-input
  • mcp__hermoso-ads-manager__x_ads_report untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_conversion_events private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_pixel untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_conversion_event untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_audiences private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_audience private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_openai_ads_audience_members untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_audience_operations private-data, untrusted-input
  • mcp__hermoso-ads-manager__cancel_openai_ads_audience_operation untrusted-input
  • mcp__hermoso-ads-manager__resume_openai_ads_audience_operation untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_audience_operation untrusted-input
  • mcp__hermoso-ads-manager__merge_openai_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__archive_openai_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__openai_ads_bulk untrusted-input
  • mcp__hermoso-ads-manager__openai_ads_bulk_job untrusted-input
  • mcp__hermoso-ads-manager__update_openai_ads_feed_products untrusted-input
  • mcp__hermoso-ads-manager__update_openai_ads_object untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__openai_ads_conversions untrusted-input
  • mcp__hermoso-ads-manager__preview_openai_ads_ad private-data, untrusted-input
  • mcp__hermoso-ads-manager__send_openai_ads_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__create_openai_ads_conversion_api_key untrusted-input
  • mcp__hermoso-ads-manager__update_openai_ads_account untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_status untrusted-input
  • mcp__hermoso-ads-manager__delete_openai_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_lead_forms private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_lead_form untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_lead_form private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_openai_ads_lead_form untrusted-input
  • mcp__hermoso-ads-manager__publish_openai_ads_lead_form untrusted-input, outbound
  • mcp__hermoso-ads-manager__archive_openai_ads_lead_form untrusted-input
  • mcp__hermoso-ads-manager__test_openai_ads_lead_form untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_lead_sync private-data, untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_lead_sync untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_leads private-data, untrusted-input
  • mcp__hermoso-ads-manager__delete_openai_ads_lead_sync untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_business_agents private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_business_agent_tools private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_business_agent untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_business_agent untrusted-input
  • mcp__hermoso-ads-manager__preview_openai_ads_business_agent private-data, untrusted-input
  • mcp__hermoso-ads-manager__publish_openai_ads_business_agent untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_openai_ads_spend_windows private-data, untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_spend_window untrusted-input
  • mcp__hermoso-ads-manager__delete_openai_ads_spend_window untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_daily_spend_limit untrusted-input
  • mcp__hermoso-ads-manager__remove_openai_ads_daily_spend_limit untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_negative_keywords untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_feeds private-data, untrusted-input
  • mcp__hermoso-ads-manager__create_openai_ads_feed untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_feed_uploads untrusted-input
  • mcp__hermoso-ads-manager__archive_openai_ads_feed untrusted-input
  • mcp__hermoso-ads-manager__query_openai_ads_feed_products untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_feed_sftp private-data, untrusted-input
  • mcp__hermoso-ads-manager__set_openai_ads_feed_sftp untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_feed_settings private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_openai_ads_feed_settings untrusted-input
  • mcp__hermoso-ads-manager__list_openai_ads_audit_logs private-data, untrusted-input
  • mcp__hermoso-ads-manager__get_openai_ads_landing_page_crawl untrusted-input
  • mcp__hermoso-ads-manager__openai_ads_hotel_report untrusted-input
  • mcp__hermoso-ads-manager__list_pinterest_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__pinterest_ads_report untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__update_pinterest_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__update_pinterest_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__set_pinterest_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__set_pinterest_ads_status untrusted-input
  • mcp__hermoso-ads-manager__delete_pinterest_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_pinterest_ads_conversion_tags untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_conversion_tag untrusted-input
  • mcp__hermoso-ads-manager__send_pinterest_ads_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_pinterest_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__update_pinterest_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_customer_list untrusted-input
  • mcp__hermoso-ads-manager__update_pinterest_ads_customer_list untrusted-input
  • mcp__hermoso-ads-manager__list_pinterest_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__manage_pinterest_ads_keywords untrusted-input
  • mcp__hermoso-ads-manager__pinterest_ads_audience_size untrusted-input
  • mcp__hermoso-ads-manager__pinterest_ads_bulk untrusted-input
  • mcp__hermoso-ads-manager__pinterest_ads_account_data untrusted-input
  • mcp__hermoso-ads-manager__manage_pinterest_ads_targeting_template untrusted-input
  • mcp__hermoso-ads-manager__manage_pinterest_ads_promotion untrusted-input
  • mcp__hermoso-ads-manager__run_pinterest_ads_report_template untrusted-input
  • mcp__hermoso-ads-manager__pinterest_ads_keyword_ideas untrusted-input
  • mcp__hermoso-ads-manager__list_pinterest_ads_product_group_promotions untrusted-input
  • mcp__hermoso-ads-manager__create_pinterest_ads_product_group_promotion untrusted-input
  • mcp__hermoso-ads-manager__update_pinterest_ads_product_group_promotion untrusted-input
  • mcp__hermoso-ads-manager__preview_pinterest_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__reddit_ads_report untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_profiles untrusted-input
  • mcp__hermoso-ads-manager__search_reddit_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__reddit_ads_forecast untrusted-input
  • mcp__hermoso-ads-manager__reddit_ads_plan_forecast untrusted-input
  • mcp__hermoso-ads-manager__reddit_ads_bid_suggestion untrusted-input
  • mcp__hermoso-ads-manager__check_reddit_ads_target_cost_eligibility untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_posts untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_post untrusted-input, outbound
  • mcp__hermoso-ads-manager__update_reddit_ads_post untrusted-input, outbound
  • mcp__hermoso-ads-manager__create_reddit_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_max_campaign untrusted-input
  • mcp__hermoso-ads-manager__get_reddit_ads_max_template untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_max_template untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__set_reddit_ads_status untrusted-input
  • mcp__hermoso-ads-manager__delete_reddit_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_pixels untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_catalogs untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_catalog untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_product_feed untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_product_set untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_catalog_object untrusted-input
  • mcp__hermoso-ads-manager__delete_reddit_ads_catalog_object untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_products untrusted-input
  • mcp__hermoso-ads-manager__upsert_reddit_ads_products untrusted-input
  • mcp__hermoso-ads-manager__delete_reddit_ads_products untrusted-input
  • mcp__hermoso-ads-manager__get_reddit_ads_catalog_import untrusted-input
  • mcp__hermoso-ads-manager__reddit_ads_data_deletion untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_funding_instruments untrusted-input
  • mcp__hermoso-ads-manager__upload_reddit_ads_assets untrusted-input
  • mcp__hermoso-ads-manager__get_reddit_ads_asset_uploads untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_assets untrusted-input
  • mcp__hermoso-ads-manager__get_reddit_ads_asset untrusted-input
  • mcp__hermoso-ads-manager__rename_reddit_ads_asset untrusted-input
  • mcp__hermoso-ads-manager__delete_reddit_ads_asset untrusted-input
  • mcp__hermoso-ads-manager__send_reddit_ads_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_reddit_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_audience_users untrusted-input
  • mcp__hermoso-ads-manager__delete_reddit_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_saved_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_reddit_ads_saved_audience untrusted-input
  • mcp__hermoso-ads-manager__update_reddit_ads_saved_audience untrusted-input
  • mcp__hermoso-ads-manager__delete_reddit_ads_saved_audience untrusted-input
  • mcp__hermoso-ads-manager__list_reddit_ads_lead_forms untrusted-input
  • mcp__hermoso-ads-manager__reddit_ads_history untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_accounts untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_identities untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_identity_posts untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_spark_posts untrusted-input
  • mcp__hermoso-ads-manager__authorize_tiktok_ads_spark_post untrusted-input, outbound
  • mcp__hermoso-ads-manager__unbind_tiktok_ads_spark_post untrusted-input, outbound
  • mcp__hermoso-ads-manager__set_tiktok_post_ad_authorization untrusted-input, outbound
  • mcp__hermoso-ads-manager__get_tiktok_post_ad_authorization untrusted-input
  • mcp__hermoso-ads-manager__extend_tiktok_post_ad_authorization untrusted-input, outbound
  • mcp__hermoso-ads-manager__delete_tiktok_post_ad_authorization untrusted-input
  • mcp__hermoso-ads-manager__search_tiktok_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_report untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_smart_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_smart_ad_group untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_smart_ad untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_smart_campaigns untrusted-input
  • mcp__hermoso-ads-manager__manage_tiktok_ads_negative_keywords untrusted-input
  • mcp__hermoso-ads-manager__tiktok_bid_protection untrusted-input
  • mcp__hermoso-ads-manager__preview_tiktok_smart_ad untrusted-input
  • mcp__hermoso-ads-manager__prereview_tiktok_ads_creative untrusted-input
  • mcp__hermoso-ads-manager__set_tiktok_smart_status untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_pixels untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_pixel untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_pixel_stats untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_custom_conversions untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_rf_inventory_estimate untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_rf_ad_group untrusted-input
  • mcp__hermoso-ads-manager__tiktok_lead_ads_terms untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_lead_forms untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_lead_fields untrusted-input
  • mcp__hermoso-ads-manager__download_tiktok_ads_leads untrusted-input
  • mcp__hermoso-ads-manager__manage_tiktok_ads_test_lead untrusted-input
  • mcp__hermoso-ads-manager__send_tiktok_ads_events untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_tiktok_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_lookalike_audience untrusted-input
  • mcp__hermoso-ads-manager__update_tiktok_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__apply_tiktok_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__delete_tiktok_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_audience_overlap untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_business_centers untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_catalogs untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_catalog untrusted-input, outbound
  • mcp__hermoso-ads-manager__create_tiktok_ads_business_center untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_account untrusted-input
  • mcp__hermoso-ads-manager__manage_tiktok_ads_catalog_feed untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_catalog_products untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_catalog_sets untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_catalog_diagnostics untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_apps untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_app_events untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_comments untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_comment_thread untrusted-input
  • mcp__hermoso-ads-manager__moderate_tiktok_ads_comment untrusted-input
  • mcp__hermoso-ads-manager__reply_to_tiktok_ads_comment untrusted-input, outbound
  • mcp__hermoso-ads-manager__delete_tiktok_ads_comment untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_blocked_words untrusted-input
  • mcp__hermoso-ads-manager__manage_tiktok_ads_blocked_words untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_diagnosis untrusted-input
  • mcp__hermoso-ads-manager__get_tiktok_ads_brand_safety untrusted-input
  • mcp__hermoso-ads-manager__set_tiktok_ads_brand_safety untrusted-input
  • mcp__hermoso-ads-manager__upload_tiktok_ads_creative untrusted-input, outbound
  • mcp__hermoso-ads-manager__upload_tiktok_ads_playable untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_tiktok_ads_playables untrusted-input
  • mcp__hermoso-ads-manager__delete_tiktok_ads_playable untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__update_tiktok_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__preview_tiktok_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_review_info untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_creative_fatigue untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_video_retention untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_music untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_trending_hashtags untrusted-input
  • mcp__hermoso-ads-manager__tiktok_trends untrusted-input
  • mcp__hermoso-ads-manager__tiktok_spark_recommendations untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_rule untrusted-input
  • mcp__hermoso-ads-manager__update_tiktok_ads_rule untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_rules untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_rule_results untrusted-input
  • mcp__hermoso-ads-manager__set_tiktok_ads_rule_status untrusted-input
  • mcp__hermoso-ads-manager__bind_tiktok_ads_rule untrusted-input
  • mcp__hermoso-ads-manager__create_meta_ad_rule untrusted-input
  • mcp__hermoso-ads-manager__list_meta_ad_rules untrusted-input
  • mcp__hermoso-ads-manager__update_meta_ad_rule untrusted-input
  • mcp__hermoso-ads-manager__set_meta_ad_rule_status untrusted-input
  • mcp__hermoso-ads-manager__delete_meta_ad_rule untrusted-input
  • mcp__hermoso-ads-manager__run_meta_ad_rule untrusted-input
  • mcp__hermoso-ads-manager__meta_ad_rule_history untrusted-input
  • mcp__hermoso-ads-manager__set_meta_ad_rule_limits untrusted-input
  • mcp__hermoso-ads-manager__create_google_ads_rule untrusted-input
  • mcp__hermoso-ads-manager__run_google_ads_rule untrusted-input
  • mcp__hermoso-ads-manager__undo_google_ads_rule_action untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_offline_event_sets untrusted-input
  • mcp__hermoso-ads-manager__manage_tiktok_ads_offline_event_set untrusted-input
  • mcp__hermoso-ads-manager__send_tiktok_ads_offline_events untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_tiktok_ads_crm_event_sets untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_ads_crm_event_set untrusted-input
  • mcp__hermoso-ads-manager__set_tiktok_ads_status untrusted-input
  • mcp__hermoso-ads-manager__set_tiktok_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__update_tiktok_ads_ad_group untrusted-input
  • mcp__hermoso-ads-manager__delete_tiktok_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_tto_accounts untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_creator_labels untrusted-input
  • mcp__hermoso-ads-manager__discover_tiktok_creators untrusted-input
  • mcp__hermoso-ads-manager__tiktok_creator_leaderboard untrusted-input
  • mcp__hermoso-ads-manager__check_tiktok_creator_status untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_tto_brand_profiles untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_tto_brand_profile untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_tto_campaigns untrusted-input
  • mcp__hermoso-ads-manager__create_tiktok_tto_campaign untrusted-input
  • mcp__hermoso-ads-manager__update_tiktok_tto_campaign untrusted-input
  • mcp__hermoso-ads-manager__link_tiktok_tto_video untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_tto_link_requests untrusted-input
  • mcp__hermoso-ads-manager__tiktok_tto_campaign_report untrusted-input
  • mcp__hermoso-ads-manager__request_tiktok_tto_spark_authorization untrusted-input
  • mcp__hermoso-ads-manager__get_tiktok_tto_spark_authorization untrusted-input
  • mcp__hermoso-ads-manager__manage_tiktok_tto_anchor untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_stores untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_store_products untrusted-input
  • mcp__hermoso-ads-manager__tiktok_ads_verification_status untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_verification_documents private-data, untrusted-input
  • mcp__hermoso-ads-manager__submit_tiktok_ads_verification untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_payment_portfolios untrusted-input
  • mcp__hermoso-ads-manager__list_tiktok_ads_payment_portfolio_links untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_accounts untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__snapchat_ads_report untrusted-input
  • mcp__hermoso-ads-manager__search_snapchat_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_profiles untrusted-input
  • mcp__hermoso-ads-manager__upload_snapchat_ads_creative untrusted-input
  • mcp__hermoso-ads-manager__set_snapchat_ads_ai_declaration untrusted-input
  • mcp__hermoso-ads-manager__create_snapchat_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_pixels untrusted-input
  • mcp__hermoso-ads-manager__create_snapchat_ads_ad_squad untrusted-input
  • mcp__hermoso-ads-manager__create_snapchat_ads_ad untrusted-input
  • mcp__hermoso-ads-manager__set_snapchat_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__set_snapchat_ads_status untrusted-input
  • mcp__hermoso-ads-manager__delete_snapchat_ads_object untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_lead_forms untrusted-input
  • mcp__hermoso-ads-manager__create_snapchat_ads_lead_form untrusted-input, outbound
  • mcp__hermoso-ads-manager__manage_snapchat_ads_lead_webhook untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_leads private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_snapchat_ads_object untrusted-input
  • mcp__hermoso-ads-manager__preview_snapchat_ads_creative untrusted-input
  • mcp__hermoso-ads-manager__list_snapchat_ads_audiences untrusted-input
  • mcp__hermoso-ads-manager__create_snapchat_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__update_snapchat_ads_audience_users untrusted-input
  • mcp__hermoso-ads-manager__delete_snapchat_ads_audience untrusted-input
  • mcp__hermoso-ads-manager__send_snapchat_ads_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_linkedin_ads_campaigns untrusted-input
  • mcp__hermoso-ads-manager__linkedin_ads_report untrusted-input
  • mcp__hermoso-ads-manager__linkedin_audience_count untrusted-input
  • mcp__hermoso-ads-manager__linkedin_bid_pricing untrusted-input
  • mcp__hermoso-ads-manager__linkedin_boost_status untrusted-input
  • mcp__hermoso-ads-manager__boost_linkedin_post untrusted-input, outbound
  • mcp__hermoso-ads-manager__end_linkedin_boost untrusted-input
  • mcp__hermoso-ads-manager__get_linkedin_boost untrusted-input
  • mcp__hermoso-ads-manager__update_linkedin_boost untrusted-input
  • mcp__hermoso-ads-manager__list_linkedin_boost_audiences untrusted-input
  • mcp__hermoso-ads-manager__manage_linkedin_boost_audience untrusted-input
  • mcp__hermoso-ads-manager__linkedin_boost_analytics untrusted-input
  • mcp__hermoso-ads-manager__create_linkedin_ads_campaign_group untrusted-input
  • mcp__hermoso-ads-manager__create_linkedin_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__update_linkedin_ads_campaign untrusted-input
  • mcp__hermoso-ads-manager__set_linkedin_ads_budget untrusted-input
  • mcp__hermoso-ads-manager__set_linkedin_ads_status untrusted-input
  • mcp__hermoso-ads-manager__search_linkedin_ads_targeting untrusted-input
  • mcp__hermoso-ads-manager__create_linkedin_ads_creative untrusted-input
  • mcp__hermoso-ads-manager__create_linkedin_lead_form untrusted-input
  • mcp__hermoso-ads-manager__update_linkedin_lead_form untrusted-input
  • mcp__hermoso-ads-manager__update_linkedin_ads_creative untrusted-input
  • mcp__hermoso-ads-manager__preview_linkedin_ad untrusted-input
  • mcp__hermoso-ads-manager__set_linkedin_ads_tracking untrusted-input
  • mcp__hermoso-ads-manager__delete_linkedin_ads_object untrusted-input
  • mcp__hermoso-ads-manager__create_linkedin_conversion_rule untrusted-input
  • mcp__hermoso-ads-manager__list_linkedin_conversion_rules untrusted-input
  • mcp__hermoso-ads-manager__update_linkedin_conversion_rule untrusted-input
  • mcp__hermoso-ads-manager__associate_linkedin_conversion_campaigns untrusted-input
  • mcp__hermoso-ads-manager__send_linkedin_conversions untrusted-input, outbound
  • mcp__hermoso-ads-manager__update_meta_object untrusted-input
  • mcp__hermoso-ads-manager__duplicate_meta_object untrusted-input
  • mcp__hermoso-ads-manager__delete_meta_object untrusted-input
  • mcp__hermoso-ads-manager__save_to_drive untrusted-input, outbound
  • mcp__hermoso-ads-manager__import_from_cloud untrusted-input
  • mcp__hermoso-ads-manager__list_drive_files private-data, untrusted-input
  • mcp__hermoso-ads-manager__get_drive_file private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_drive_file untrusted-input
  • mcp__hermoso-ads-manager__delete_drive_file untrusted-input
  • mcp__hermoso-ads-manager__create_drive_folder untrusted-input
  • mcp__hermoso-ads-manager__create_sheet untrusted-input
  • mcp__hermoso-ads-manager__append_to_sheet untrusted-input
  • mcp__hermoso-ads-manager__read_sheet private-data, untrusted-input
  • mcp__hermoso-ads-manager__export_swipefile_deck untrusted-input
  • mcp__hermoso-ads-manager__list_notion_pages private-data, untrusted-input
  • mcp__hermoso-ads-manager__save_to_notion untrusted-input
  • mcp__hermoso-ads-manager__append_to_notion_page untrusted-input
  • mcp__hermoso-ads-manager__read_notion_page untrusted-input
  • mcp__hermoso-ads-manager__export_schedule_to_notion untrusted-input
  • mcp__hermoso-ads-manager__query_notion_database private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_notion_row untrusted-input
  • mcp__hermoso-ads-manager__create_doc untrusted-input
  • mcp__hermoso-ads-manager__append_to_doc untrusted-input
  • mcp__hermoso-ads-manager__read_doc private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_sheet_tabs untrusted-input
  • mcp__hermoso-ads-manager__update_sheet untrusted-input
  • mcp__hermoso-ads-manager__clear_sheet_range untrusted-input
  • mcp__hermoso-ads-manager__manage_sheet_tabs untrusted-input
  • mcp__hermoso-ads-manager__format_sheet untrusted-input
  • mcp__hermoso-ads-manager__update_doc untrusted-input
  • mcp__hermoso-ads-manager__save_to_onedrive untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_onedrive_files private-data, untrusted-input
  • mcp__hermoso-ads-manager__get_onedrive_file private-data, untrusted-input
  • mcp__hermoso-ads-manager__update_onedrive_file untrusted-input
  • mcp__hermoso-ads-manager__delete_onedrive_file untrusted-input
  • mcp__hermoso-ads-manager__share_onedrive_file untrusted-input
  • mcp__hermoso-ads-manager__onedrive_file_permissions untrusted-input
  • mcp__hermoso-ads-manager__convert_onedrive_file untrusted-input
  • mcp__hermoso-ads-manager__create_onedrive_folder untrusted-input
  • mcp__hermoso-ads-manager__list_memory untrusted-input
  • mcp__hermoso-ads-manager__list_swipefile untrusted-input
  • mcp__hermoso-ads-manager__save_creator untrusted-input
  • mcp__hermoso-ads-manager__get_settings private-data, untrusted-input
  • mcp__hermoso-ads-manager__list_connectors private-data
  • mcp__hermoso-ads-manager__list_connector_accounts untrusted-input
  • mcp__hermoso-ads-manager__set_connector_accounts untrusted-input
  • mcp__hermoso-ads-manager__disconnect_connector untrusted-input
  • mcp__hermoso-ads-manager__connect_connector untrusted-input
  • mcp__hermoso-ads-manager__leave_connector untrusted-input
  • mcp__hermoso-ads-manager__list_team private-data, untrusted-input
  • mcp__hermoso-ads-manager__invite_member untrusted-input, outbound
  • mcp__hermoso-ads-manager__remove_member untrusted-input
  • mcp__hermoso-ads-manager__get_brand untrusted-input
  • mcp__hermoso-ads-manager__draft_brand untrusted-input
  • mcp__hermoso-ads-manager__delete_library_item untrusted-input
  • mcp__hermoso-ads-manager__fetch_asset untrusted-input, outbound
  • mcp__hermoso-ads-manager__list_products untrusted-input
  • mcp__hermoso-ads-manager__posting_insights outbound
  • mcp__hermoso-ads-manager__inbox_stats 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-ads-manager/verify?hash=d8e6d58bbff669607b54d08332bc06f2ff59bcb370461e92ab2eb49272cf512f" | jq -e '.changed == false'

Pinned hash d8e6d58bbff6, 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-ads-manager/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

Anlyon Radar badge for io.github.hermoso-ai/hermoso-ads-manager
[![Anlyon Radar](https://radar.anlyon.com/badge/io.github.hermoso-ai/hermoso-ads-manager.svg)](https://radar.anlyon.com/servers/io.github.hermoso-ai/hermoso-ads-manager)

Source: MCP Registry · repository. Synced Nov 6, 2026, 22:17 UTC.

Hermoso: Ads Manager MCP server: questions and answers

Answered from the scan above, not from the publisher's description.

Is the Hermoso: Ads Manager MCP server safe?

No scan can promise that. What its definitions show: 831 tools, 566 of which can change, send or delete something, and 49 findings (2 high) from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.

Can the Hermoso: Ads Manager MCP server delete data?

Yes. 311 tools can delete, cancel or revoke something: call_tool, delete_brand, create_meta_campaign, set_meta_campaign_status, create_meta_ad, create_meta_adset and 305 more.

Can the Hermoso: Ads Manager MCP server do things that cannot be undone?

Yes. 10 tools can send, pay, publish or merge: record_shopify_marketing_activity, list_stripe_refunds, create_stripe_product, create_stripe_price, revenue_by_source, merge_openai_ads_audiences and 4 more.

What tools does the Hermoso: Ads Manager MCP server have?

831 tools: 311 destructive, 10 irreversible, 245 write, 265 read. call_tool, delete_brand, create_meta_campaign, set_meta_campaign_status, create_meta_ad, create_meta_adset, create_meta_pixel, send_meta_conversions and 823 more.

Does the Hermoso: Ads Manager MCP server need sign-in or OAuth?

Its remote endpoint listed its tools to an anonymous client, without sign-in.

Does the Hermoso: Ads Manager MCP server send data to outside services?

59 tools can carry data out (it sends, posts or publishes, or takes a recipient, channel or URL): upload_file, upload_meta_asset, upload_meta_playable, send_meta_conversions, record_shopify_marketing_activity, trigger_merchant_issue_action and 53 more.

Has the Hermoso: Ads Manager MCP server changed its tools?

Yes, once since Anlyon Radar started tracking it, most recently on Nov 21, 2026. Every change is on this page and in its Atom feed.