{"id":"io.github.hermoso-ai/hermoso-ai-ad-generator","slug":"io-github-hermoso-ai-hermoso-ai-ad-generator","title":"Hermoso: AI Ad Generator","description":"AI ad generator: make image and video ads for your brand and research the ads competitors run.","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-create&src=registry"}],"packages":[],"published":"2026-11-06","updated":"2026-11-06","status":"online","auth":"","latency_ms":1106,"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. It is NOT a prerequisite for rendering: generate_image, generate_video ","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":"save_to_drive","title":"Save file(s) to Google Drive","description":"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 ","read_only":false},{"name":"import_from_cloud","title":"Import a Drive / OneDrive folder into the Library","description":"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_onedriv","read_only":false},{"name":"list_drive_files","title":"List Google Drive files","description":"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 f","read_only":true},{"name":"get_drive_file","title":"Get a Drive file’s details","description":"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.","read_only":true},{"name":"update_drive_file","title":"Rename / move / trash a Drive file","description":"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.","read_only":false},{"name":"delete_drive_file","title":"Delete a Drive file","description":"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.","read_only":false},{"name":"create_drive_folder","title":"Create a Drive folder","description":"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_","read_only":false},{"name":"create_sheet","title":"Create a Google Sheet","description":"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).","read_only":false},{"name":"append_to_sheet","title":"Append rows to a Google Sheet","description":"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.","read_only":false},{"name":"read_sheet","title":"Read a Google Sheet range","description":"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 t","read_only":true},{"name":"export_swipefile_deck","title":"Swipefile to Google Slides","description":"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 canno","read_only":false},{"name":"list_notion_pages","title":"List Notion pages","description":"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).","read_only":true},{"name":"save_to_notion","title":"Save to Notion","description":"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","read_only":false},{"name":"append_to_notion_page","title":"Add to a Notion page","description":"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.","read_only":false},{"name":"read_notion_page","title":"Read a Notion page","description":"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.","read_only":true},{"name":"export_schedule_to_notion","title":"Export the schedule to Notion","description":"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.","read_only":false},{"name":"query_notion_database","title":"Read a Notion database","description":"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 colu","read_only":true},{"name":"update_notion_row","title":"Update a Notion database row","description":"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}","read_only":false},{"name":"create_doc","title":"Create a Google Doc","description":"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).","read_only":false},{"name":"append_to_doc","title":"Append text to a Google Doc","description":"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\"","read_only":false},{"name":"read_doc","title":"Read a Google Doc","description":"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 ","read_only":true},{"name":"list_sheet_tabs","title":"List the tabs in a Google Sheet","description":"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.","read_only":true},{"name":"update_sheet","title":"Write to a range in a Google Sheet","description":"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) ","read_only":false},{"name":"clear_sheet_range","title":"Clear a range in a Google Sheet","description":"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 mea","read_only":false},{"name":"manage_sheet_tabs","title":"Add, rename or delete a sheet tab","description":"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","read_only":false},{"name":"format_sheet","title":"Format a Google Sheet","description":"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","read_only":false},{"name":"update_doc","title":"Edit a Google Doc in place","description":"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 ch","read_only":false},{"name":"save_to_onedrive","title":"Save file(s) to OneDrive","description":"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).","read_only":false},{"name":"list_onedrive_files","title":"List OneDrive files","description":"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.","read_only":true},{"name":"get_onedrive_file","title":"Get a OneDrive file’s details","description":"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.","read_only":true},{"name":"update_onedrive_file","title":"Rename / move a OneDrive file","description":"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.","read_only":false},{"name":"delete_onedrive_file","title":"Delete a OneDrive file","description":"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.","read_only":false},{"name":"share_onedrive_file","title":"Share a OneDrive file as a link","description":"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","read_only":false},{"name":"onedrive_file_permissions","title":"Who can open a OneDrive file","description":"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 inheri","read_only":false},{"name":"convert_onedrive_file","title":"Convert a OneDrive file to PDF or JPG","description":"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 (C","read_only":false},{"name":"create_onedrive_folder","title":"Create a OneDrive folder","description":"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.","read_only":false},{"name":"plan_ad","title":"Plan an ad concept","description":"Plan an ad: turns a brand and a product or brief into an ad concept, with copy variants (headline, primary text, call to action) and either an image prompt or a timed video storyboard, plus the recipe and the model ids to render with. It renders nothing; pass its output to render_ad, generate_image or generate_video. For a single image ad it is optional: generate_image alone makes one from the sav","read_only":false},{"name":"clone_video","title":"Clone a video for your brand","description":"Remake a video you like FOR THIS BRAND from its link — a TikTok, Instagram Reel, Facebook video or reel, X post, or a direct video file URL. YouTube does not let us download videos, so a YouTube link is refused up front and nothing is charged; the user downloads it themselves and uploads the file (upload_file). Hermoso WATCHES it first (frames across the whole clip plus a transcript of the voiceov","read_only":false},{"name":"save_video_preset","title":"Save a video as a preset","description":"SAVE A FINISHED VIDEO AS A REUSABLE PRESET: its beat structure, pacing, look, captions, how the words are delivered and its sound are read off it once and kept with the video, so new videos can be made in the same style (make_from_preset). Takes a render, a Library video, a file link, or a TikTok / Reel / Facebook / X post link. About 2 credits (one watch). Optional: name, the saved creator who st","read_only":false},{"name":"list_video_presets","title":"List video presets","description":"The brand's saved video presets (save_video_preset): each one's id, name, format, length, shots and captions. Free.","read_only":true},{"name":"update_video_preset","title":"Update a video preset","description":"Rename a saved video preset, change its notes, the creator who stars in it, or its captions (true / false / {style}). What was read off the video stays. Free.","read_only":false},{"name":"delete_video_preset","title":"Delete a video preset","description":"Delete one saved video preset by id. Videos already made from it are kept. Free.","read_only":false},{"name":"make_from_preset","title":"Make a video from a preset","description":"PLAN A NEW VIDEO FROM A SAVED PRESET (save_video_preset): it keeps the preset's beat structure, pacing, look, captions, delivery and sound, and makes the topic, every word, the person and the product this brand's own. Same length as the preset unless durationSeconds is given. Renders nothing: costs the plan only (no second watch). Then render_ad(creative) makes the video and lays the preset's capt","read_only":false},{"name":"make_short","title":"Make a short in a ready format","description":"Plan a short-form video (Reel / TikTok / Short) in one of Hermoso's ready FORMATS: a written structure (beats, camera, length, aspect) plus the layers it lays on the finished video (its caption look, a closing \"Comment KEYWORD\" ask, cards). Call with no `preset` to list every format, which are ready and which are coming (free). With a preset: the person in it is this brand's own (pass `creator` to","read_only":false},{"name":"finish_short","title":"Finish a short (lay its format)","description":"Lay a make_short format's layers on its rendered video: its picture layers, the pauses between lines cut out (free), the format's captions (the spoken words, transcribed and burned in its look) and its \"Comment KEYWORD\" card, timed to the moment the presenter says \"comment\". Nothing else is laid: only what the format (or the keyword you chose) names. Pass the rendered video's url and the creative ","read_only":false},{"name":"click_to_ad","title":"Plan a video ad from a product link","description":"Paste a product page link (Shopify, Amazon or any store page) and get a creator-style video ad planned for that product. Hermoso reads the page (name, photos, what it says about the product, price), saves the product to the brand's catalog, checks the page's real product photo and pins it to this ad (the brand's saved default photo is not changed), then plans the ad. A store that hides its page fr","read_only":false},{"name":"generate_image","title":"Generate ad image","description":"Use this when the user asks for an image ad, ad creative, product photo or social post graphic for their business or product, or an ANIMATED GIF (format gif) or SVG file (format svg). It renders a finished image on a real image model, on their saved brand (product photos, logo), and returns a URL ready to post. For a video, use render_ad. The saved brand’s product photo is used automatically (see ","read_only":false},{"name":"edit_image","title":"Edit an image","description":"EDIT an existing image in place with a plain-language instruction and keep everything else: 'make the headline bigger', 'add our logo bottom right', 'swap the background for a kitchen', 'remove the person on the left', 'erase all the text'. Pass `image` (URL, Library item, upload_file URL or local path) and `instruction`. The same edit the web Studio's Edit runs: composition, aspect ratio, people ","read_only":false},{"name":"headline_variants","title":"Headline variants of a static ad","description":"Turn ONE finished static ad into several copies that differ ONLY in the headline, for an A/B test: same picture, product, layout, colours and every other line. Pass `image`, and either `headlines` (your own, up to 10) or `count` (default 5, max 10) to have distinct angles written for you in the saved brand's voice (never inventing numbers, prices, ratings or claims the ad or brand does not state);","read_only":false},{"name":"resize_ad","title":"Resize a static ad for other placements","description":"Re-lay out ONE finished static ad for other placements: the same ad, product, copy (word for word), logo and style, recomposed natively for each canvas rather than cropped. Pass `image` and optionally `aspectRatios` from 1:1, 4:5, 9:16, 16:9, 3:4, 4:3 (default 1:1, 4:5 and 9:16; the ad's own ratio is skipped). Reads the ad's text first (3 credits) so every line survives, then one image edit per ca","read_only":false},{"name":"localize_ad","title":"Localize a static ad into other languages","description":"Translate the on-image text of ONE finished static ad into other languages and keep everything else: same picture, layout, typeface, colours, logo and product. Pass `image` and `languages` (up to 5, e.g. [\"Spanish\", \"German\", \"French (Canada)\"]). The ad's text is read (3 credits), translated the way a native copywriter in each market would write it (brand and product names, URLs and prices kept as","read_only":false},{"name":"make_thumbnail","title":"Make video thumbnail","description":"Render a click-driving YOUTUBE / Shorts / Instagram THUMBNAIL or video cover through the full production pipeline (concept, casting, scene, render, tweaks, text), not a bare image prompt. Use it for any \"thumbnail\", \"video cover\" or MrBeast-style packaging ask INSTEAD of generate_image. Default: 4 variants at 1K (YouTube shows 1280x720 at most), each billed; 2K or 4K only when the user asks. dryRu","read_only":false},{"name":"generate_voice","title":"Generate voiceover or dialogue","description":"RAW speech as an MP3: one voice reading a script (text), or a DIALOGUE of two or more people (lines), each in their own voice. Not for adding audio to a video (render_ad and generate_video voice their own spots; change_voice re-voices a finished clip). ONE VOICE: text + engine (default 'seed-audio'; also 'eleven-v4', 'minimax-speech', 'kokoro'…) + voice, a preset from that engine (hermoso_capabili","read_only":false},{"name":"generate_sfx","title":"Generate a sound effect","description":"MAKE a sound effect or ambience that does not exist yet, from a description, as an MP3: a whoosh, a door slam, a cash-register ding, rain on a window, a busy cafe. (find_sound FINDS an existing sound, a meme or trending TikTok sound; this MAKES one.) seconds = length, 0.5-30 (default 5); loop:true for a loopable bed. engine: omit for Seed Audio 1.0 (length and loop are asked for in words, so the l","read_only":false},{"name":"generate_music","title":"Generate music","description":"RAW music: describe it (genre, mood, instruments, tempo), get an instrumental MP3. No length: a full track at a flat fee (explainerMusicCredits in hermoso_capabilities). With seconds: by the second up to about 38 s. A named model always runs.","read_only":false},{"name":"generate_text","title":"Generate text","description":"Text generation against the writing-model catalog (Claude, Gemini, GPT, Llama, DeepSeek…) — ad copy, hooks, scripts, rewrites, brainstorms. Prompt-only, no ad assembly (for a finished on-brand creative use plan_ad -> render_ad). BY DEFAULT the model answers as a marketing copywriter (a short house system prompt is applied, which is what you want for ad copy); pass raw:true for a plain, unstyled an","read_only":false},{"name":"render_ad","title":"Render ad video","description":"Use this when the user asks for a video ad, Reel, TikTok ad, UGC video or commercial for their business or product It renders a finished ad on a real video model, on their brand (real product photos, brand voice), as an mp4 ready to post: timed shots, clean speech, text set in post, no music, captions or end card unless asked. Pass plan_ad’s full output as `creative` (plan_ad turns a one-line ask ","read_only":false},{"name":"make_template_ad","title":"Make template ad","description":"Use this when the user asks for a quick, low-cost ad or post built from their words and pictures: a slideshow, carousel, iMessage or ChatGPT chat, Notes, kinetic type, myth vs fact, an app tour, or their own HTML design. Rendered from HTML, no AI model, ~30s, billed for its compute only, ready to post. Presets are SHORTCUTS; 'custom' is YOUR OWN design as config.html (+ css), so no layout, type, c","read_only":false},{"name":"make_motion_film","title":"Make a motion graphics video","description":"Use this when the user asks for motion graphics or an animated video: kinetic typography (animated text), a logo animation or intro, a product launch film, an animated social cut. Pick it for 'animated video', 'motion graphics', 'kinetic text', 'text animation', 'logo animation', 'logo intro', 'animated explainer' asks. STEPS: without confirm it is a FREE quote that gives both prices (length, the ","read_only":false},{"name":"finish_video","title":"Finish video","description":"Post-process an EXISTING rendered video (its served mp4 URL) with the proven direct-response 'reviewer' finish and/or a film-grain pass — no AI model, ~30s, billed for its compute only. pills=true composites a header pill (e.g. '10/10 would buy again'), a brand-accent sub-pill, and 3-4 green-check proof pills cascading in on the beat (YOU author the copy: header ≤40 chars, sub ≤34, each point ≤44 ","read_only":false},{"name":"post_edit","title":"Post-production edit","description":"MECHANICAL post-production on an EXISTING video (URL): ordered ffmpeg primitives, ~2 credits flat, NO AI model, outputs a NEW video. Ops: a branded end card, trim, speed (0.5-2x), mute (whole or a window), audio_gain (-20..+6 dB), fade_out, music (a ducked bed: omit track = a free library track picked by mood, no attribution; or track = an audio link (upload_file, find_sound or generate_sfx URL, o","read_only":false},{"name":"edit_timeline","title":"Compose an edit (timeline)","description":"Compose ANY edit or transition yourself; there is no preset list. Segments on an output timeline (later ones drawn on top; overlapping ones ARE the transition), each animated by keyframes (scale, x, y, rotate, opacity, blur, mblur, exposure, speed ramps, holds, reverse), plus your own HTML overlays and masks, compiled server-side into one render. Whip pan, zoom through, push, spin, slow motion, fr","read_only":false}],"server_info":{"name":"hermoso","version":"0.1.610"},"category":"productivity","tags":["image-video","health","marketing"],"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-ai-ad-generator/"}