{"id":"io.github.hermoso-ai/hermoso-ads-manager","slug":"io-github-hermoso-ai-hermoso-ads-manager","title":"Hermoso: Ads Manager","description":"AI marketing agent for paid ads: run campaigns on 11 ad networks and read your web analytics.","version":"1.0.0","publisher":{"kind":"github","id":"hermoso-ai","label":"@hermoso-ai on GitHub","url":"https://github.com/hermoso-ai"},"website":"https://hermoso.ai/mcp/","repository":"https://github.com/hermoso-ai/hermoso","remotes":[{"type":"streamable-http","url":"https://app.hermoso.ai/mcp?tools=app-ads&src=registry"}],"packages":[],"published":"2026-11-06","updated":"2026-11-06","status":"online","auth":"","latency_ms":1010,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"enable_tools","title":"Turn on more Hermoso tools","description":"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","read_only":false},{"name":"get_instructions","title":"Read Hermoso's full instructions","description":"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.","read_only":true},{"name":"find_tools","title":"Find a Hermoso tool by name or task","description":"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 mea","read_only":true},{"name":"call_tool","title":"Run any Hermoso tool by name","description":"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_tool","read_only":false},{"name":"hermoso_capabilities","title":"Hermoso models, options and credit costs","description":"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.","read_only":true},{"name":"hermoso_credits","title":"Credit balance","description":"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","read_only":true},{"name":"buy_credits","title":"Buy credits","description":"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 ","read_only":false},{"name":"report_bug","title":"Report a bug","description":"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 cap","read_only":false},{"name":"request_feature","title":"Request a feature","description":"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.","read_only":false},{"name":"contact_support","title":"Contact Hermoso support","description":"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.","read_only":false},{"name":"billing_status","title":"Billing status","description":"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 AN","read_only":true},{"name":"upgrade_plan","title":"Upgrade plan","description":"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 (Fr","read_only":false},{"name":"set_auto_reload","title":"Set auto-reload","description":"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 ful","read_only":false},{"name":"list_brands","title":"List profiles","description":"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 ","read_only":true},{"name":"use_brand","title":"Switch profile","description":"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, n","read_only":false},{"name":"create_brand","title":"Create a profile","description":"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 int","read_only":false},{"name":"delete_brand","title":"Delete a profile","description":"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 unambigu","read_only":false},{"name":"upload_file","title":"Upload a local file -> durable public URL","description":"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 y","read_only":false},{"name":"pinterest_ads_async_report","title":"Pinterest deep (async) ad report","description":"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 /","read_only":true},{"name":"search_pinterest_ads_targeting","title":"Find Pinterest ad targeting options","description":"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, GE","read_only":true},{"name":"upload_meta_asset","title":"Upload an asset to a Meta ad account","description":"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","read_only":false},{"name":"create_meta_campaign","title":"Create a Meta ad campaign (paused)","description":"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","read_only":false},{"name":"set_meta_campaign_status","title":"Activate or pause a Meta campaign","description":"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.","read_only":false},{"name":"upload_meta_playable","title":"Upload a playable ad to Meta","description":"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(pl","read_only":false},{"name":"list_meta_playables","title":"List Meta playables","description":"List the playables uploaded to a Meta ad account (id and name), for create_meta_ad's playableAssetId. Free.","read_only":true},{"name":"create_meta_ad","title":"Build a full Meta ad (campaign -> ad set -> ad, paused)","description":"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–1","read_only":false},{"name":"create_meta_adset","title":"Create a Meta ad set (audience + budget + schedule)","description":"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 ","read_only":false},{"name":"find_meta_audiences","title":"Look up Meta targeting ids","description":"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 ","read_only":true},{"name":"list_meta_ads","title":"List Meta campaigns / ad sets / ads","description":"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 insp","read_only":true},{"name":"analyze_campaigns","title":"What to scale, pause, fix and test next","description":"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, clic","read_only":false},{"name":"meta_insights","title":"Meta ad performance metrics","description":"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 o","read_only":true},{"name":"preview_meta_ad","title":"Preview a Meta ad exactly as it will appear","description":"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","read_only":true},{"name":"meta_catalog_suggestions","title":"Which catalog Meta would show under a new ad","description":"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 O","read_only":true},{"name":"estimate_meta_reach","title":"Estimate how many people a Meta audience reaches","description":"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 d","read_only":true},{"name":"list_meta_audiences","title":"List Meta custom audiences + lookalikes","description":"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.","read_only":true},{"name":"create_meta_audience","title":"Create a Meta custom audience or lookalike","description":"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:\"lookal","read_only":false},{"name":"list_meta_pixels","title":"List Meta Pixels on an ad account","description":"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. Without this tool that id coul","read_only":true},{"name":"get_meta_ad_account","title":"Read a Meta ad account’s billing and status","description":"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 ","read_only":true},{"name":"create_meta_pixel","title":"Create a Meta Pixel","description":"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:","read_only":false},{"name":"send_meta_conversions","title":"Send conversions to a Meta pixel (Conversions API)","description":"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","read_only":false},{"name":"meta_dataset_quality","title":"Check a Meta pixel’s Conversions API health","description":"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 scor","read_only":true},{"name":"set_meta_conversions_auto","title":"Automatic sending to a Meta pixel","description":"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 con","read_only":false},{"name":"list_meta_lead_forms","title":"List Meta instant (lead) forms","description":"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","read_only":true},{"name":"create_meta_lead_form","title":"Create a Meta instant (lead) form","description":"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 quest","read_only":false},{"name":"archive_meta_lead_form","title":"Archive (or restore) a Meta instant form","description":"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. ","read_only":false},{"name":"read_meta_leads","title":"Read Meta lead-ad submissions","description":"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 kee","read_only":true},{"name":"delete_meta_audience","title":"Delete a Meta custom audience","description":"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 ","read_only":false},{"name":"register_merchant_developer","title":"Register Hermoso with a Merchant Center account","description":"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 u","read_only":false},{"name":"list_merchant_accounts","title":"List Merchant Center accounts","description":"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.","read_only":true},{"name":"list_merchant_products","title":"List Merchant Center products","description":"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.","read_only":true},{"name":"record_shopify_marketing_activity","title":"Record an ad or campaign in Shopify > Marketing","description":"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 carr","read_only":false},{"name":"list_shopify_marketing_activities","title":"List Shopify marketing activities","description":"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 th","read_only":true},{"name":"delete_shopify_marketing_activity","title":"Delete a Shopify marketing activity","description":"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 ","read_only":false},{"name":"merchant_report","title":"Merchant Center competitive visibility, best sellers and price benchmarks","description":"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` (w","read_only":true},{"name":"list_merchant_issues","title":"List Merchant Center account issues","description":"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.","read_only":true},{"name":"list_merchant_promotions","title":"List Merchant Center promotions","description":"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 C","read_only":true},{"name":"create_merchant_promotion","title":"Create a Merchant Center promotion (sale badge)","description":"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, ","read_only":false},{"name":"merchant_issue_help","title":"Google's own fix steps for a Merchant Center issue","description":"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') ","read_only":true},{"name":"trigger_merchant_issue_action","title":"Fire a Merchant Center issue action","description":"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 i","read_only":false},{"name":"list_merchant_inventory","title":"Merchant store and region overrides","description":"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 M","read_only":true},{"name":"set_merchant_inventory","title":"Set store or region price and stock","description":"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 st","read_only":false},{"name":"merchant_account_status","title":"Merchant Center serving status","description":"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, ","read_only":true},{"name":"manage_merchant_settings","title":"Change Merchant Center settings","description":"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 ow","read_only":false},{"name":"merchant_quota","title":"Merchant Center quota and limits","description":"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","read_only":true},{"name":"manage_merchant_notifications","title":"Merchant Center push notifications","description":"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","read_only":false},{"name":"manage_merchant_conversion_source","title":"Merchant Center conversion sources","description":"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 plac","read_only":false},{"name":"list_merchant_data_sources","title":"List Merchant Center product feeds","description":"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 ","read_only":true},{"name":"create_merchant_data_source","title":"Create a Merchant Center product feed","description":"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, whi","read_only":false},{"name":"upsert_merchant_product","title":"Create or replace a Merchant Center product","description":"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 — ","read_only":false},{"name":"delete_merchant_product","title":"Delete a Merchant Center product","description":"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 + feed","read_only":false},{"name":"update_merchant_product","title":"Update fields on a Merchant Center product","description":"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 q","read_only":false},{"name":"delete_merchant_data_source","title":"Delete a Merchant Center product feed","description":"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 im","read_only":false},{"name":"list_google_ads_campaigns","title":"List Google Ads accounts / campaigns","description":"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 ","read_only":true},{"name":"google_ads_report","title":"Google Ads GAQL report","description":"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, ","read_only":true},{"name":"google_ads_change_history","title":"What changed on a Google Ads account, and when","description":"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","read_only":true},{"name":"create_google_ads_campaign","title":"Build a Google Ads campaign (paused)","description":"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 ","read_only":false},{"name":"create_google_ads_ad_group","title":"Add an ad group to a Google Ads campaign","description":"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 ","read_only":false},{"name":"create_google_ads_ad","title":"Create a Google Ads ad","description":"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, busi","read_only":false},{"name":"add_google_ads_keywords","title":"Add Google Ads keywords","description":"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 a","read_only":false},{"name":"set_google_ads_targeting","title":"Add Google Ads location & language targeting","description":"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 languag","read_only":false}],"server_info":{"name":"hermoso","version":"0.1.610"},"category":"marketing","tags":["web-search","analytics","ecommerce"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-06","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-hermoso-ai-hermoso-ads-manager/"}