# Hermoso Ai Hermoso Ads Manager MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.hermoso-ai%2Fhermoso-ads-manager
Registry id: `mcp-registry/io.github.hermoso-ai/hermoso-ads-manager`
Status: live (checked 2026-11-22T15:42:38.042Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 829
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "hermoso-ai-hermoso-ads-manager-mcp-serve": {
      "type": "http",
      "url": "https://app.hermoso.ai/mcp?tools=app-ads&src=registry"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http hermoso-ai-hermoso-ads-manager-mcp-serve https://app.hermoso.ai/mcp?tools=app-ads&src=registry
```

## Tools (300)

- `add_apple_ads_keywords`: Add targeting keywords to an Apple Ads ad group. keywords is [{text, matchType, bid}] — matchType EXACT (default), BROAD, PHRASE or CATEGORY, and bid optionally
- `add_apple_ads_negative_keywords`: 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 adGroupI
- `add_bing_webmaster_site`: 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 
- `add_google_ads_assets`: 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 assetT
- `add_google_ads_keywords`: 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) 
- `add_microsoft_ads_keywords`: 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 unl
- `add_microsoft_ads_negative_keywords`: EXCLUDE searches from a Microsoft Advertising campaign or ad group with negative keywords — Exact or Phrase only (Microsoft has no broad negative; default Phras
- `add_search_console_site`: 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 arri
- `add_x_ads_targeting`: 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 w
- `amplitude_active_users`: 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 connect
- `amplitude_chart`: 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 config
- `amplitude_funnel`: AMPLITUDE FUNNELS: conversion and drop-off across ordered steps. Pass `events` as an ORDERED array of at least two steps. mode is ordered / unordered / sequenti
- `amplitude_retention`: 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"
- `amplitude_segmentation`: AMPLITUDE EVENT SEGMENTATION — an event over time, with filters and group-bys. metric is uniques / totals / pct_dau / average / histogram / sums / value_avg / f
- `amplitude_user_activity`: 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 r
- `analytics_data_retention`: 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 report
- `analytics_realtime`: 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. I
- `analytics_report`: 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 pa
- `analyze_campaigns`: 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 plat
- `append_to_doc`: 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
- `append_to_notion_page`: Add to the END of an existing Notion page (pageId or its link, from list_notion_pages): markdown content, a swipefileCollection, or includeSchedule:true. Nothin
- `append_to_sheet`: 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 pic
- `apple_ads_change_history`: 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 to
- `apple_ads_impression_share`: 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 rep
- `apple_ads_keyword_suggestions`: 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 SHA
- `apple_ads_rejection_reasons`: 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 o
- `apple_ads_report`: Apple Ads performance — impressions, taps, installs, spend, TTR, CPT, CPA. level is campaign / adgroup / ad / keyword / searchterm; promotedObjectType is apps (
- `apple_ads_search_term_popularity`: 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 
- `apple_ads_target_cpa_suggestion`: 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 eligibl
- `applovin_ads_change_history`: Who changed what on the brand’s AppLovin campaigns, and when: creation, edits (field by field, before and after), status changes and ARCHIVING — including archi
- `applovin_ads_pixel`: 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 Ta
- `applovin_ads_report`: AppLovin Ads performance: impressions, clicks, CTR, spend, sales, ROAS and checkout revenue by day, campaign, creative set or country. Works with the Reporting 
- `apply_apple_ads_recommendation`: 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-budg
- `apply_microsoft_ads_customer_list`: Upload customer emails into a Microsoft Advertising Customer Match list so campaigns can target or exclude them. YOU PASS PLAIN EMAIL ADDRESSES — Hermoso normal
- `apply_microsoft_ads_recommendations`: Apply Microsoft Advertising recommendations by id. THIS SPENDS REAL MONEY AND HAS NO UNDO. It raises daily budgets, adds keywords, widens keywords to broad matc
- `apply_tiktok_ads_audience`: 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 do
- `archive_analytics_audience`: 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 
- `archive_analytics_custom_dimension`: 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
- `archive_analytics_custom_metric`: 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 
- `archive_meta_lead_form`: 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
- `archive_openai_ads_audience`: 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 a
- `archive_openai_ads_feed`: Archive a product feed — its products leave every campaign using it. confirm:true required.
- `archive_openai_ads_lead_form`: 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 requ
- `associate_linkedin_conversion_campaigns`: Associate LinkedIn campaigns with a conversion rule — or detach them with remove:true. THIS IS WHAT MAKES A CONVERSION COUNT: LinkedIn only attributes a convers
- `authorize_tiktok_ads_spark_post`: 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 gener
- `backtest_google_ads_rule`: Backtest a Google Ads automated rule: what it WOULD have done on each of the last N days (1-30, default 7), replayed on Google's daily metrics with the same pla
- `billing_status`: 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 fil
- `bind_tiktok_ads_rule`: 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 
- `bing_webmaster_crawl`: 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 
- `bing_webmaster_keywords`: Bing search impressions for any term. Modes: "keyword" (impressions for exactly this term over a date range), "related" (the same for terms Bing considers relat
- `bing_webmaster_links`: Inbound links according to Bing: counts per page (mode "counts", the default), the inbound links pointing at one page (mode "page", needs `url`), or the pages t
- `bing_webmaster_query_stats`: 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 th
- `bing_webmaster_submission_quota`: 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 — Micr
- `bing_webmaster_traffic`: 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 dire
- `boost_linkedin_post`: 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 nati
- `bulk_apple_ads_keywords`: 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, o
- `buy_credits`: 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 hav
- `call_tool`: Run a Hermoso tool that is not in this session's starting list (paid campaigns, analytics, channel admin and more), using the exact `name` and `args` that find_
- `campaign_profit`: Profit per campaign across every connected ad platform: each campaign’s spend read live from the platform, joined to the brand’s own sales. Revenue per campaign
- `cancel_openai_ads_audience_operation`: 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 applyin
- `cancel_stripe_subscription`: 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 need
- `check_analytics_compatibility`: 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 f
- `check_apple_ads_app_eligibility`: 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. Ea
- `check_domain_email_health`: 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 l
- `check_email_address`: 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 throwaw
- `check_reddit_ads_target_cost_eligibility`: Does this Reddit ad account qualify for Target Cost (bidStrategy TARGET_CPX)? Reddit retires Cost Cap (MAXIMIZE_VOLUME) on SALES, CONVERSIONS, LEAD_GENERATION, 
- `check_spam_words`: 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) 
- `check_tiktok_creator_status`: 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
- `clear_sheet_range`: 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
- `clone_applovin_ads_creative_set`: 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 Campaig
- `connect_connector`: 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, Sendblue, 
- `contact_support`: 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 answe
- `conversion_destinations`: The ad platform conversions APIs send_conversion_event sends to, per brand. action list (default) shows them plus what each platform needs; add saves one: platf
- `conversion_events`: The conversion events send_conversion_event stored for this brand, newest first, with each one’s delivery per platform (sent, failed or skipped, and why). actio
- `conversion_insights`: Read the brand’s stored conversion events as: journey — ONE customer’s every touch and conversion in order, with lifetime value (pass email, phone, externalId, 
- `convert_onedrive_file`: 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 
- `create_amplitude_annotation`: 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. TH
- `create_analytics_audience`: 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 US
- `create_analytics_custom_dimension`: 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 T
- `create_analytics_custom_metric`: 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 DIMENS
- `create_analytics_key_event`: 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 spell
- `create_apple_ads_ad`: 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 
- `create_apple_ads_ad_account`: 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 St
- `create_apple_ads_ad_group`: 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 
- `create_apple_ads_budget_order`: 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
- `create_apple_ads_campaign`: 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 
- `create_apple_ads_creative`: 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 
- `create_apple_ads_location_group`: 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_
- `create_applovin_ads_campaign`: 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
- `create_applovin_ads_creative_set`: 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 (IM
- `create_brand`: 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
- `create_doc`: 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 + UR
- `create_drive_folder`: 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 updat
- `create_google_ads_account`: Create a new Google Ads client account under a manager (MCC) account shared with this brand: name, currency (ISO, permanent) and timeZone (IANA, permanent); opt
- `create_google_ads_ad`: 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 campai
- `create_google_ads_ad_group`: 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. Opt
- `create_google_ads_campaign`: 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). Goog
- `create_google_ads_conversion_action`: 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, MA
- `create_google_ads_demand_gen_campaign`: 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, 
- `create_google_ads_performance_max_campaign`: Build a PERFORMANCE MAX campaign — Google’s cross-surface campaign type (Search, YouTube, Display, Discover, Gmail, Maps). ALWAYS created PAUSED; it spends NOTH

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
