Waarom agents (en hun mensen) voor Hermoso kiezen: één connector is een one-stop shop voor 100+ beeld-, video-, stem- en schrijfmodellen: Seedance, Veo, Kling, MiniMax H3 en Gemini Omni voor video; Nano Banana, Imagen, Flux, Seedream en GPT Image voor stilstaande beelden; plus premium stemmen en schrijfmodellen van Claude-, Gemini- en GPT-klasse, allemaal op één creditmeter, zonder API-sleutels of accounts per leverancier. En verder dan ruwe modellen dekt dezelfde connector de volledige advertentieworkflow: concurrentieonderzoek in de advertentiebibliotheken van Meta, Google en LinkedIn, creatieve planning, afgewerkte renders met branding, nabewerking, scoring, publiceren en campagnebeheer. Exacte kosten per render staan in hermoso_capabilities, zodat een nette agent je een getal kan geven voordat hij iets uitgeeft.
Hermoso is de marketing-MCP die de hele advertentieloop draait. De meeste marketing-MCP's beheren alleen campagnes; Hermoso maakt en publiceert ook de advertentie. Koppel het aan je agent en onderzoek, maak, publiceer en beheer afgewerkte advertenties direct vanuit je prompts, met 922+ tools, je opgeslagen merkcontext en je credits. Installeer via npm (npm install -g hermoso). Het is open source op github.com/hermoso-ai/hermoso.
Met één klik verbinden: Open in ChatGPT · Voeg toe aan Cursor · Installeer in VS Code · Claude Code: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso (Codex, Gemini CLI en Cursor: elk één commando, in de setup hierboven) · Claude.ai: plak https://app.hermoso.ai/mcp onder Instellingen → Connectors · Meta Muse: één chatbericht zet het op, zie Hermoso in Muse. Agents kunnen de serverkaart automatisch vinden op /.well-known/mcp.json. Ook vermeld in de officiële MCP-registry (io.github.hermoso-ai/hermoso), op Smithery en op Glama.
Liever de studio? Alles wat de tools doen, staat ook in de webapp, op app.hermoso.ai.
Drie dingen om één keer te typen zodra het verbonden is
Dit zijn gewone zinnen, geen DSL. De agent kiest de tools; jij keurt de uitgaven goed.
- Onderzoek. “Wie zijn de drie dichtstbijzijnde concurrenten van
oatly.com, en wat zijn hun langst lopende Meta-advertenties? Vertel me welke hook steeds terugkomt.” Dit loopt viafind_competitors→pull_competitor_ads→mine_angles. - Maak. “Maak een 9:16 UGC-videoadvertentie voor mijn merk met die hook, met mijn echte productfoto en ondertitels erin gebrand.” Dit loopt via
get_brand→plan_ad→render_ad, en levert de afgewerkte mp4-URL. - Lever op. “Plan het in op Instagram en TikTok voor dinsdag om 9 uur, en bouw er een gepauzeerde Meta-campagne omheen die de VS target tegen $30/dag.” Dit loopt via
schedule_post→create_meta_campaign→create_meta_ad.
De tools, per taak
Alle 922+ tools via één OAuth-server. Roep er elk van aan vanuit ChatGPT, Claude, Claude Desktop, Codex, Cursor, Cline, OpenClaw, Hermes, Grok Bot of elke andere MCP-client. Elk levert een duurzame asset-URL of een gestructureerd resultaat, geen proza dat het model opnieuw moet ontleden.
Op zoek naar de volledige lijst? Die staat in de toolreferentie, met het echte parameterschema van elke tool en machine-leesbare JSON ernaast. Die referentie is gegenereerd: ze wordt gebouwd door de draaiende MCP-server te laten uitlezen via tools/list over een echt transport, dus het is precies het oppervlak dat je client ontvangt. De categorieën hieronder zijn een handgeschreven rondleiding langs de tools die je bij naam moet kennen. Vertrouw de referentie als die en deze van elkaar verschillen. Volledige ontwikkelaarsdocumentatie: hermoso.ai/docs.
Onderzoek & advertentiespionage: find_competitors, competitor_teardown, pull_competitor_ads, research_ads, mine_angles, score_ad, check_ad_policy, analyze_video; advertentiebibliotheken search_meta_ads, search_google_ads, search_linkedin_ads; organische social search_tiktok, search_instagram, search_youtube, search_reddit, search_threads, search_threads_keyword; fetch_social_data; creatieve playbooks list_skills, get_skill, save_skill.
Maak afgewerkte advertenties: merk draft_brand, get_brand, update_brand, use_brand, list_brands; plan plan_ad, plan_variations; render render_ad, generate_image, generate_video, generate_avatar, generate_voice, generate_text, make_template_ad (native HTML-advertentieformats die direct worden gerenderd, dus het type is pixelexact), make_explainer, product_sizzle, make_thumbnail; bewerken & afwerken remix_static, recast_motion, reframe_video, upscale_video, dub_video, change_voice, finish_video, fix_beat, post_edit, stitch_video, clip_video; assets list_product_photos, set_product_image, list_library, fetch_asset, upload_file.
Publiceer & plan op je kanalen: post_to_meta (Facebook / Instagram / Threads), post_to_tiktok, post_to_youtube, schedule_post (één wachtrij voor Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram en Google Business Profile), list_scheduled, cancel_scheduled, manage_meta_post, update_youtube_video, upload_meta_asset, list_meta_pages, youtube_channel, tiktok_account, list_tiktok_videos. YouTube gaat verder dan de upload: list_youtube_videos, update_youtube_video, set_youtube_thumbnail (zet een Hermoso-thumbnail op een upload; het is de grootste hefboom voor doorklikken, en YouTube kiest anders willekeurig een frame) en youtube_video_insights (views, kijktijd, gemiddeld bekeen percentage, nieuwe abonnees). Engagement: list_meta_comments, reply_to_meta_comment, moderate_meta_comment, list_threads_replies, reply_to_thread, list_youtube_comments, reply_to_youtube_comment. X / Twitter: post_to_x (tekst, afbeelding, video, reacties, quoteposts, polls en hele threads; 280 tekens op een gewoon account en tot 25.000 op een account met X Premium, gelezen uit het account en niet aangenomen, en nooit afgekapt), post_x_article (het eigen lange-vormartikel van X, geschreven in Markdown, met koppen, lijsten, citaten, codeblokken en tabellen die intact blijven), edit_x_post (een al gepubliceerde post herschrijven, binnen het uur dat X toestaat), delete_x_post, x_post_metrics en x_post_insights (vertoningen, likes, reposts, reacties, quotes, bladwijzers), x_post_insights_historical (dezelfde adverteerdercijfers over elke datumreeks, waar x_post_insights alleen de laatste 28 uur ziet), x_mentions. X is de enige connector die per API-aanroep credits rekent, omdat X ons per verzoek betaalt, en een post met een link kost ongeveer 13× zoveel als een zonder; je agent krijgt de prijs te zien voordat hij post. LinkedIn: list_linkedin_pages, post_to_linkedin_page, post_to_linkedin, manage_linkedin_post, linkedin_page_analytics (organische prestaties van de Pagina: volgers en volgerswinst, Pagina-weergaven, en vertoningen, klikken en engagement per post of voor het totaal van de Pagina). LinkedIn-publicatie gaat naar de bedrijfspagina's die je aanvinkt. Je persoonlijke profiel kan ook, maar blijft uit tot je het expliciet deelt. Pinterest: list_pinterest_boards, create_pinterest_board, post_to_pinterest (afbeelding- of video-Pins op een bord dat je kiest). Threads gaat verder dan publiceren: list_threads_posts, list_threads_replies, reply_to_thread, hide_thread_reply, delete_thread, list_threads_mentions, threads_insights.
Lees en beantwoord de DM's. list_inbox zet alles wat iemand tegen het merk zei op één lijst: Facebook- en Instagram-reacties, Threads-reacties en vermeldingen, YouTube- en Reddit-reacties, Google-reviews, Bluesky-reacties en X-vermeldingen, plus directe berichten op Messenger, Instagram Direct, X, Bluesky en Telegram. reply_to_inbox_item beantwoordt een van die op id en stuurt naar het juiste kanaal, zodat de agent nooit hoeft te weten welke reactietool een platform gebruikt. Per kanaal, wanneer je de hele thread wilt in plaats van de nieuwste regel: list_meta_conversations, read_meta_conversation, reply_to_meta_message; list_x_dms, send_x_dm; list_bluesky_convos, read_bluesky_dm, send_bluesky_dm, mark_bluesky_convo_read; list_telegram_dms, list_telegram_chats, post_to_telegram; en op WhatsApp send_whatsapp_message, send_whatsapp_broadcast, list_whatsapp_templates, create_whatsapp_template. instagram_profile zet een Instagram-@handle om in het numerieke account-id dat Meta echt wil. Wat elk platform toestaat verschilt, en Hermoso zegt welke regel er geldt in plaats van dat je het uit een weigering moet halen: Meta staat een antwoord toe binnen 24 uur nadat de persoon schreef, en dat venster wordt gratis gecontroleerd voordat iets verstuurd wordt; Telegram is een rollend venster van 24 uur en geen inbox, omdat de Bot API helemaal geen geschiedenis-endpoint publiceert; X bewaart 30 dagen aan directe berichten en rekent per gelezen bericht. WhatsApp is apart de moeite waard, omdat antwoorden daar geen inbox-antwoord is: Hermoso verstuurt op WhatsApp via send_whatsapp_message, hetzij een door Meta goedgekeurde template om een gesprek te openen, hetzij een vrije reactie binnen het 24-uursvenster van Meta's klantenservice, en het vraagt je de exacte tekst en het exacte nummer te bevestigen voordat het verstuurt, omdat het een echte telefoon bereikt en Meta het bedrijf per gesprek factureert. Meta publiceert ook geen WhatsApp-geschiedenis-endpoint, dus een gesprek van vóór je verbond kan tegen geen enkele prijs worden opgehaald. LinkedIn en Threads publiceren geen bruikbare DM-API, dus geen van beide wordt aangeboden.
Stuur één WhatsApp-bericht, of zend uit naar de hele lijst. send_whatsapp_broadcast stuurt één goedgekeurde template naar een klantenlijst, een segment of een lancering, en vult de waarden {{1}} en {{2}} van elke persoon in terwijl het gaat, zodat duizend mensen een bericht krijgen dat hen bij naam noemt in plaats van duizend keer dezelfde knal. Meta publiceert geen bulk-endpoint, dus het is een getimede verzending van één bericht per ontvanger, en het draait als een wachtrijtaak die je opvraagt in plaats van een aanroep die wacht: dubbele nummers worden verwijderd voordat er iets verstuurd wordt, een nummer dat Meta niet kan gebruiken wordt bij naam geweigerd in plaats van stilletjes overgeslagen, en elke ontvanger heeft zijn eigen uitkomst in het resultaat, dus een gedeeltelijke fout wordt als gedeeltelijke fout gemeld en nooit als succes. Draai het eerst met dryRun: dat kost niets, verstuurt niets en meldt het echte aantal ontvangers, de live categorie van de template, wat Meta ervoor factureert, en of de lijst past binnen de bewegende 24-uurslimiet van je business-portfolio voor berichten. Meta factureert je rechtstreeks voor de berichten, per bericht, tegen de eigen tarieven per land, dus een broadcast kost geen Hermoso-credits. Twee regels daar zijn die van Meta en niet van ons, en beide zijn blijvend: een broadcast is altijd een goedgekeurde template, omdat vrije tekst alleen legaal is binnen het 24-uursvenster dat opent wanneer die persoon het eerst naar jou schrijft; en WhatsApp vereist dat de ontvanger zich heeft opgegeven, wat niets in de API afdwingt en wat de verantwoordelijkheid van het bedrijf blijft.
Eén contentkalender voor elk kanaal: schedule_post zet een afgewerkte render in de wachtrij voor één of meerdere kanalen op een gekozen tijdstip, met captions per kanaal; list_scheduled leest wat in de wachtrij staat en wat al is afgevuurd, met uitkomsten per kanaal; cancel_scheduled haalt een post terug voordat hij uitgaat. In de studio is dezelfde wachtrij een echte kalender met maand-, week- en lijstweergaven: sleep een post om hem te verplaatsen, bewerk of dupliceer elk item, en gebruik vaste tijdsloten waarin je werk kunt zetten. Hermoso publiceert op het afgesproken moment; niets hoeft open te blijven.
Draai Meta-advertentiecampagnes: create_meta_campaign, create_meta_adset, create_meta_ad, find_meta_audiences, list_meta_ads, meta_insights, meta_page_insights, meta_post_insights, update_meta_object, set_meta_campaign_status, delete_meta_object. Objecten worden gepauzeerd aangemaakt, en elke uitgave en elke verwijdering vraagt om bevestiging. Voordat een budget wordt vastgelegd: preview_meta_ad rendert de echte advertentie per plaatsing als link die je kunt bekijken, en estimate_meta_reach zegt hoeveel mensen een targetingspecificatie werkelijk bereikt. Doelgroepen: list_meta_audiences en create_meta_audience bouwen retargeting via de website-pixel, doelgroepen op basis van Pagina- en Instagram-engagement, en lookalikes, en een doelgroep aanmaken kost niets. meta_insights splitst de prestaties uit naar leeftijd, geslacht, plaatsing en land. De Facebook Ads MCP-pagina loopt elke Meta-tool en de targeting die hij blootlegt door.
Draai Google Ads-campagnes: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, set_google_ads_budget, set_google_ads_bidding, set_google_ads_targeting, set_google_ads_status, find_google_ads_locations, upload_google_ads_asset, list_google_ads_campaigns, google_ads_report (GAQL). De volledige boom wordt in één atomische bewerking gebouwd en daarna van Google teruggelezen voordat de agent beschrijft wat hij maakte. Buiten de boom: create_google_ads_conversion_action en list_google_ads_conversion_actions (wat Google als resultaat telt; TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS en elke Performance Max-campagne zijn niet te leveren zonder een, dus Hermoso weigert ze te bouwen op een account zonder), create_google_ads_performance_max_campaign (Google's campagnetype over meerdere oppervlakken), add_google_ads_assets (sitelinks, callouts en gestructureerde snippets, aangemaakt en gekoppeld, want een niet-gekoppeld asset toont niets) en google_ads_keyword_ideas (Keyword Planner: echte maandelijkse zoekvolumes, concurrentie en bieddata bovenaan de pagina, zodat zoekwoorden uit data worden gekozen en niet geraden).
Draai LinkedIn-, Pinterest-, Microsoft-, X-, TikTok-, Snapchat-, ChatGPT-, Apple Search Ads- en AppLovin Ads-campagnes: hetzelfde standaard-gepauzeerde, bevestigingsgestuurde patroon op elk ander betaald platform. LinkedIn: list_linkedin_ads_campaigns, linkedin_ads_report, create_linkedin_ads_campaign_group, create_linkedin_ads_campaign, create_linkedin_ads_creative, search_linkedin_ads_targeting, set_linkedin_ads_budget, set_linkedin_ads_status, delete_linkedin_ads_object. Pinterest: list_pinterest_ads_campaigns, pinterest_ads_report, create_pinterest_ads_campaign, create_pinterest_ads_ad_group, create_pinterest_ads_ad, set_pinterest_ads_budget, set_pinterest_ads_status. Microsoft Advertising (Bing): list_microsoft_ads_campaigns, microsoft_ads_report, create_microsoft_ads_campaign, create_microsoft_ads_ad_group, create_microsoft_ads_ad, add_microsoft_ads_keywords, set_microsoft_ads_budget, set_microsoft_ads_status, microsoft_ads_geo_search (zet land-, regio- en plaatsnamen om naar de Microsoft-locatie-id's die een campagne nodig heeft; zonder locaties wordt een Microsoft-campagne aangemaakt die wereldwijd draait, wat Microsoft's eigen standaard is, en de terugleesactie waarschuwt je daar luid voor). Reddit Ads, de volledige accountboom: list_reddit_ads_campaigns, reddit_ads_report, create_reddit_ads_campaign, create_reddit_ads_ad_group, create_reddit_ads_ad, create_reddit_ads_post (een Reddit-advertentie promoot een post, dus de creatief is een post), set_reddit_ads_status, plus gratis planning met search_reddit_ads_targeting, reddit_ads_forecast en reddit_ads_bid_suggestion, conversietracking via list_reddit_ads_pixels en send_reddit_ads_conversions, retargeting en opgeslagen doelgroepen, lead-formulieren en reddit_ads_history. ChatGPT Ads (de advertenties die onder een ChatGPT-antwoord draaien), via de Advertiser API van OpenAI: list_openai_ads_campaigns, openai_ads_report, openai_ads_geo_search, create_openai_ads_campaign, create_openai_ads_ad_group, create_openai_ads_ad, update_openai_ads_object, set_openai_ads_budget, set_openai_ads_status. ChatGPT Ads heeft precies één creatiefformaat, een kaart met tekst en afbeelding, en geen video, dus de agent haalt een stilstaand beeld uit je film in plaats van je daar een videoadvertentie aan te bieden. X Ads, de volledige boom voor promoted posts, sinds augustus 2026 live: list_x_ads_accounts, list_x_ads_funding_instruments, x_ads_report, create_x_ads_campaign, create_x_ads_line_item (X's naam voor een advertentiegroep), create_x_ads_promoted_tweet, add_x_ads_targeting, x_ads_targeting_search, x_ads_geo_search, update_x_ads_campaign, update_x_ads_line_item, set_x_ads_status, delete_x_ads_object. Een X-advertentie promoot een post, dus de creatief is een post, dezelfde die post_to_x publiceert. TikTok Ads is een APARTE verbinding van de TikTok-publicatieconnector, en het is het enige platform dat objecten standaard INGESCHAKELD aanmaakt, dus Hermoso dwingt elke laag gepauzeerd af zonder uitzondering: list_tiktok_ads_accounts, list_tiktok_ads_campaigns, list_tiktok_ads_identities, search_tiktok_ads_targeting, tiktok_ads_report, create_tiktok_ads_campaign, create_tiktok_ads_ad_group, upload_tiktok_ads_creative, create_tiktok_ads_ad, set_tiktok_ads_budget, set_tiktok_ads_status, delete_tiktok_ads_object. Snapchat Ads: list_snapchat_ads_accounts, list_snapchat_ads_campaigns, list_snapchat_ads_profiles, search_snapchat_ads_targeting, snapchat_ads_report, upload_snapchat_ads_creative, create_snapchat_ads_campaign, create_snapchat_ads_ad_squad, create_snapchat_ads_ad, set_snapchat_ads_budget, set_snapchat_ads_status, delete_snapchat_ads_object. Budgetten zijn in micro-valuta (1.000.000 = één eenheid), de kop van de creatief is beperkt tot 34 tekens, en een Snapchat-advertentie verwijst naar een CREATIVE in plaats van naar een media-id. Drie toegangsnotities die je wilt hebben voordat je een budget plant: LinkedIn en Pinterest beperken advertentie-schrijfacties beide op de API-tier die je eigen advertentieaccount heeft. Lezen en rapporteren is onbeperkt, terwijl campagnes aanmaken afhangt van de toegang die het platform je account heeft gegeven. Meta, Google Ads, Microsoft Advertising, Reddit Ads en ChatGPT Ads kennen zo'n tier niet. X geeft Ads API-toegang per ADVERTENTIEACCOUNT in plaats van per app, dus in plaats van een OAuth-knop voeg je Hermoso's X-gebruiker toe aan je advertentieaccount op business.x.com → Accounttoegang, en die verschijnt in list_x_ads_accounts met het toegangsniveau dat X hem gaf. AppLovin Ads koppelt met een geplakte sleutel: applovin_ads_report werkt op elk account met zijn Reporting Key en applovin_ads_pixel met zijn Event Key, send_applovin_ads_events heeft AppLovin's Conversion API-sleutel nodig, en list_applovin_ads_campaigns, create_applovin_ads_campaign, update_applovin_ads_campaign, set_applovin_ads_status, de tools voor creative-sets en upload_applovin_ads_assets gebruiken AppLovin's Campaign Management API, die AppLovin per account activeert, net als de Conversion API-sleutel. Vraag je AppLovin-accountmanager ze aan te zetten, en plak daarna ook die sleutels.
Bouw Apple Search Ads, en lees ze tot op het zoekterm: App Store-zoekadvertenties, van begin tot eind. Bouwen: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, create_apple_ads_creative, create_apple_ads_ad, upload_apple_ads_asset, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object. Elk object wordt gepauzeerd aangemaakt zonder uitzondering, inschakelen is de ene schakelaar die echte uitgaven activeert en die vraagt om bevestiging, en elke samenvatting is opgebouwd uit een terugleesactie van wat Apple werkelijk heeft opgeslagen. Advertenties draaien op de Zoektab-plaatsing; een Search results-campagne heeft geen advertentie en geen creatief nodig, omdat Apple zelf je App Store-productpagina rendert, en Hermoso zegt dat gratis in plaats van Apple de build te laten afwijzen. Lezen: list_apple_ads_campaigns (status, bezorgstatus, dagelijks en totaal budget, de landen waarin het draait, en Apple's eigen reden wanneer een campagne niet kan draaien), list_apple_ads_ad_groups (standaardbod, en of Apple's Search Match aan staat), list_apple_ads_keywords (targeting en negatief, met matchtype en bod), apple_ads_report (vertoningen, taps, installaties, uitgaven, TTR, CPT en CPA, op campagne-, advertentiegroep-, zoekwoord-, zoekterm- of advertentieniveau), list_apple_ads_creatives, list_apple_ads_ads, list_apple_ads_assets, list_apple_ads_product_pages (je App Store-vermelding en eventuele aangepaste productpagina's, met hun inhoud per taal), search_apple_ads_apps en check_apple_ads_app_eligibility (op welke plaatsingen, landen en apparaten je app mag adverteren, de moeite waard om te lezen voordat je bouwt) en list_apple_ads_orgs. Er is geen OAuth-knop, omdat Apple geen OAuth-flow publiceert: Hermoso genereert de ondertekeningssleutel, je plakt het publieke deel in Apple Ads → Accountinstellingen → API en plakt daarna drie id's terug. Apple toont dat veld alleen aan een gebruiker met een API-rol, dus een Account Admin nodigt eerst iemand uit of schakelt er naar. De Apple Search Ads-connector-gids loopt het hele traject door. Elke verbinding is vastgezet op de ene Apple Ads-organisatie die je koos toen je haar maakte.
Rapporteren & exporteren: Google Drive save_to_drive, list_drive_files, get_drive_file, update_drive_file, delete_drive_file, create_drive_folder; Sheets create_sheet, append_to_sheet, read_sheet; Docs create_doc, append_to_doc, read_doc; Microsoft OneDrive save_to_onedrive, list_onedrive_files, get_onedrive_file, update_onedrive_file, create_onedrive_folder, delete_onedrive_file. Leads gaan je CRM in via de HubSpot MCP: sync_leads_to_hubspot zet leads uit Meta- en LinkedIn-lead-formulieren als contacten over, en hubspot_deals_report rapporteert deals per fase en bron.
Geheugen, profielen, skills & team: remember, forget, list_memory, store_get; profielen create_brand, delete_brand, use_brand, list_brands, zodat een bureau een nieuwe klant kan aannemen en er een kan verwijderen zonder de app te openen, en profielen zijn onbeperkt op elk abonnement; skills, nu één bibliotheek die de oude “AI-medewerkers”-opslag heeft opgenomen: save_skill, list_skills, get_skill, delete_skill; team invite_member, list_team, set_role, remove_member.
Account, instellingen & connectors: hermoso_capabilities (modellen en exacte kosten per render opvragen; roep het eerst aan), hermoso_credits, buy_credits, billing_status, upgrade_plan, set_auto_reload, get_job, list_jobs, report_bug, request_feature; instellingen get_settings, update_settings (taal en weergave, opgeslagen bij het account in plaats van in een browser, zodat een klant die alleen via agents werkt niet in het Engels blijft hangen); connectors list_connectors, list_connector_accounts, set_connector_accounts (kies precies welke Pagina's, advertentieaccounts en borden bruikbaar zijn; de tool meldt de terugleesactie van de server, nooit het verzoek), disconnect_connector. Een account verbinden is een OAuth-toestemmingsscherm, dus dat is de ene stap die nog een browser nodig heeft; alles daarna is door een agent aan te roepen.