Skip to main content
Glama
hermoso-ai

Hermoso

Official

Hermoso — MCP, CLI & Skills

Betreiben Sie Ihren gesamten Marketing-Betrieb von jedem beliebigen KI-Agenten aus: Claude Code, Claude.ai, Cursor, Codex oder Ihren eigenen Skripten. Recherchieren Sie die Anzeigen, die in einem Markt bereits gewinnen, generieren Sie fertige Bild- und Videoanzeigen (Ihr echtes Produkt wird eingefügt, inklusive Text und Call-to-Action), veröffentlichen Sie sie auf Ihren eigenen Social-Media-Kanälen und erstellen und verwalten Sie die dahinterliegenden Werbekampagnen – alles über MCP-Tools, eine CLI oder installierbare Claude-Skills.

718 Tools. tools/list ist immer die maßgebliche Menge; hermoso_capabilities (kostenlos) liefert den Live-Modellkatalog mit den genauen Kreditkosten pro Render sowie die vollständige Fähigkeitsübersicht.

Womit es verbunden ist. Werbeplattformen: Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads, Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads und ChatGPT Ads, plus Produktfeeds im Google Merchant Center. Veröffentlichung und Planung – zehn Kanäle: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky und Telegram. Messaging: WhatsApp (Sie schreiben einer Person, daher ist es kein elfter Veröffentlichungskanal). Werberecherche: die Meta-, Google- und LinkedIn-Anzeigenbibliotheken sowie organische TikTok-, Instagram-, YouTube-, Threads- und Reddit-Inhalte. Analytik: Google Analytics 4, Google Search Console und die eigenen Beitrags- und Kampagneneinblicke jeder verbundenen Plattform. Dateien: Google Drive, Sheets, Docs und OneDrive.

Es ist nicht alles-oder-nichts. Recherche, Erstellung, Veröffentlichung/Planung und Anzeigenverwaltung sind vier unabhängige Bereiche – kein Tool setzt voraus, dass Sie zuerst ein anderes verwendet haben. Veröffentlichen oder planen Sie bereits vorhandene Creatives und generieren Sie hier nichts (upload_file verwandelt jede lokale oder externe Datei in eine URL, die jedes Veröffentlichungs-, Planungs- und Anzeigenbau-Tool akzeptiert); erstellen und lesen Sie Kampagnen auf Ihren eigenen Werbekonten mit Ihren eigenen Creatives; recherchieren Sie Wettbewerber ohne entworfenes Brand und ohne verbundenen Kanal; oder generieren Sie eine Datei ohne jegliche Verbindung und laden Sie sie einfach herunter. Nutzen Sie den einen Teil, den Sie brauchen, oder alles zusammen.

Welche Oberfläche sollte Ihr Agent verwenden?

Zwei Formen, und die richtige wird durch das entschieden, was Ihr Client kann, nicht durch das, was wir bevorzugen.

Ihr Client

Verwenden Sie

Warum

Läuft in einem Browser – Claude.ai, ChatGPT, Claude Desktop

den gehosteten Connector https://app.hermoso.ai/mcp

Er kann keinen lokalen Prozess starten, daher ist eine URL die einzige Form, die er hat. Nichts zu installieren, kein Schlüssel einzufügen, und die vollständige Tool-Ausstattung kommt mit Ihrem gespeicherten Markenkontext. Dies ist die richtige Antwort für diese Clients, nicht eine geringere.

Kann eine Shell ausführen – Claude Code, Cursor, Codex, Cline, OpenClaw, Hermes, Ihre eigenen Skripte

die CLI, npm install -g hermoso

Ein Tool-Manifest wird in jede Sitzung geladen, unabhängig davon, ob ein Tool aufgerufen wird. Ein Shell-Befehl kostet nichts, bis er ausgeführt wird, und er erreicht jedes Tool statt der Standardauswahl.

Der gemessene Unterschied (2026-08-27, gezählt als echte Tool-Definitionen, nicht aus Bytes geschätzt):

Tools im Bereich

pro Sitzung geladen

Gehosteter Connector, Standardauswahl

306

181.713 Tokens

Gehosteter Connector, ?tools=all

718

472.062 Tokens

stdio-Server (npx -y hermoso mcp)

306

181.713 Tokens

CLI

alle 718

0

Die CLI beantwortet dieselben Fragen stattdessen auf Abruf, und nur wenn gefragt:

npx -y hermoso tools --search reddit   # every matching tool, name + one line   2,459 tokens
npx -y hermoso tools plan_ad           # one tool's full argument schema           633 tokens
npx -y hermoso call plan_ad --json '{"product":"…"}'   # run it

Ein Terminal-Agent erreicht also seinen ersten Aufruf in etwa 3,4K Tokens mit der gesamten Auswahl im Bereich, gegenüber 182K für einen Bruchteil davon. tools und tools <name> lesen ein im Paket gebündeltes Register – kein Schlüssel, kein Netzwerk, keine Anmeldung – sodass ein Agent das gesamte Produkt durchsuchen kann, bevor sich jemand anmeldet. Nur call kostet etwas, und nur das benötigt einmalig hermoso auth login.

Beides gleichzeitig ist in Ordnung und das, was wir für Claude Code empfehlen. Ein hermoso auth login deckt die CLI und ermöglicht claude mcp add hermoso -- npx -y hermoso mcp, den Schlüssel ohne env-Block aufzunehmen, sodass der Agent nach einem nativen Tool greifen kann, wenn er strukturierte Ergebnisse möchte, und die Shell nutzen kann, wenn er Breite möchte. Wenn Sie nur eines möchten, nehmen Sie die CLI: Sie deckt streng mehr ab.

Wann der Connector auf einem shell-fähigen Client dennoch der bessere Kompromiss ist: eine Sitzung, die viele Aufrufe in einen Bereich tätigen wird. enable_tools({groups:['ads']}) aktiviert die Kampagnenverwaltung in einem einzigen kostenlosen Aufruf, und die Tools sind dann nativ – keine Shell-Quoting, strukturierte Ergebnisse. Ein Shell-Roundtrip schlägt das Laden einer 221K-Token-Gruppe für ein einzelnes Tool; das Gegenteil gilt, sobald sich eine Sitzung in diesem Bereich niederlässt.

Related MCP server: Prizmad

Ihr Agent kann sich selbst anmelden

Ein Agent ohne Hermoso-Konto kann eines bereitstellen, seinen eigenen Schlüssel erhalten und in derselben Sitzung Anzeigen rendern. Kein Mensch am Browser, kein Ticket, kein Warten.

# 1. Start a signup. This call takes no credential, because the credential is what it creates.
curl -sX POST https://app.hermoso.ai/v1/signup \
  -H 'content-type: application/json' \
  -d '{"plan":"pro","period":"mo"}'
# -> { "id": "cs_...", "checkout_url": "https://checkout.stripe.com/...", "claim_token": "hsc_..." }

# 2. Pay at checkout_url. Store claim_token first: it is returned only in that response.

# 3. Claim it. Poll until status is "ready".
curl -sX POST https://app.hermoso.ai/v1/signup/cs_.../claim \
  -H 'content-type: application/json' \
  -d '{"claim_token":"hsc_..."}'
# -> { "status": "ready", "api_key": "hmk_...", "credits": 3000 }

Dieser hmk_-Schlüssel ist dieselbe Anmeldeinformation, die alles andere auf dieser Seite akzeptiert: /v1, der MCP-Server, die CLI. Richten Sie Ihren Client darauf aus, und die gesamte Oberfläche ist offen.

Bezahlen kann ein browserfähiger Agent bereits selbst. Der Checkout ist Stripe's eigene gehostete Seite, daher können Claude in Chrome und ähnliche Clients ihn heute unbeaufsichtigt abschließen. Alles andere ist eine Ein-Klick-Übergabe: Senden Sie checkout_url an denjenigen, der die Karte besitzt. Dieselbe Form deckt Sie später ab, sobald Sie laufen: buy_credits und upgrade_plan erstellen einen zahlungsbereiten Link für weitere Credits oder einen größeren Plan, und billing_status liest den Kontostand jederzeit.

Der agentische Weg erfordert einen kostenpflichtigen Plan. Jeden beliebigen. Der kostenlose Plan ist für eine Person gedacht, die sich unter app.hermoso.ai anmeldet, und eine Anfrage hierfür führt zu einer Ablehnung, die genau das sagt. Es wird nichts erstellt, bis die Zahlung abgeschlossen ist, sodass eine unbezahlte Anmeldung kein Konto hinterlässt und nichts berechnet.

Eine Sache braucht immer noch eine Person, und es lohnt sich, das im Voraus zu wissen. Das Verbinden eines Social- oder Werbekontos bedeutet einen OAuth-Zustimmungsbildschirm, und ein Zustimmungsbildschirm kann auf keiner Plattform headless abgeschlossen werden. list_connectors zeigt, was bereits verbunden ist und was nicht. Alles andere läuft ohne Browser: Recherche, Generierung, Veröffentlichung auf einem bereits verbundenen Kanal, Kampagnenaufbau, Berichterstattung.

Vollständige Anfrage- und Antwortformate sowie alle anderen Endpunkte finden Sie im OpenAPI-Dokument unter app.hermoso.ai/openapi.json, das live aus derselben Tabelle bedient wird, die die Routen bereitstellt.

Sofort: der gehostete Claude.ai-Connector

Fügen Sie https://app.hermoso.ai/mcp in Claude → Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen ein, genehmigen Sie mit Ihrem Hermoso-Konto, fertig – die vollständige Tool-Ausstattung mit Ihrem gespeicherten Markenkontext, abgerechnet über Ihren Plan.

Schnellstart für Claude Code (eine Zeile)

  1. Holen Sie sich ein Konto unter app.hermoso.ai – kostenlose Stufe inklusive; Pläne und Credits sind dieselben, die das Web-Studio verwendet. Oder überspringen Sie den Browser vollständig und lassen Sie Ihren Agenten sich selbst auf einem kostenpflichtigen Plan anmelden mit POST /v1/signup (oben).

  2. Führen Sie eine Zeile aus. Ihr Browser öffnet sich einmal zur Anmeldung. Nichts einzufügen, und kein Schlüssel landet in .claude.json:

npm install -g hermoso && hermoso auth login && claude mcp add hermoso -- npx -y hermoso mcp
  1. Fragen Sie nach dem, was Sie möchten, in Ihren normalen Eingabeaufforderungen. Claude Code greift nach einem Tool oder führt den Befehl hermoso in Ihrem Terminal aus, je nachdem, was die Aufgabe benötigt. Sie tippen keines von beiden.

Werbekampagnen- und Analysetools bleiben aus der Tool-Liste heraus, bis Sie sie mit enable_tools aktivieren, was sie klein hält. Auf einem Rechner ohne Browser melden Sie sich mit hermoso auth login --token hmk_… an, wobei Sie einen Schlüssel aus Einstellungen → Agents & API verwenden, oder überspringen Sie die Anmeldung und übergeben Sie den Schlüssel stattdessen an den Client:

claude mcp add hermoso -e HERMOSO_TOKEN=hmk_… -- npx -y hermoso mcp

Die gehostete URL funktioniert auch in Claude Code, aber sie ist dort der schlechtere Weg, und es lohnt sich zu wissen, warum: claude mcp add --transport http hermoso https://app.hermoso.ai/mcp wird akzeptiert, und dann meldet claude mcp list ! Needs authentication, weil der Client den OAuth-Flow nicht selbst startet – Sie müssen eine Sitzung öffnen, /mcp ausführen, den Server finden und Authentifizieren drücken. Gemessen gegen Claude Code 2.1.241 am 2026-08-23.

Ihr Agent hat jetzt das vollständige Studio mit dem Kontext Ihres Workspace: das Markenprofil, Produkte, Logos und gelerntes Gedächtnis, die Sie in der Web-App eingerichtet haben, werden automatisch angewendet (get_brand zeigt, was gespeichert ist; lassen Sie brand in plan_ad/plan_variations weg, um es zu verwenden). Renderings belasten Ihre Hermoso-Credits – gleiche Preise wie im Studio.

1. MCP-Server (stdio) – Claude Code / Cursor / Codex

hermoso mcp führt einen stdio-MCP-Server aus, der die vollständige Tool-Ausstattung bereitstellt. Das veröffentlichte hermoso-Paket bedeutet kein Klonen – npx -y hermoso mcp holt und führt es aus. Melden Sie sich einmal mit der CLI an, und kein Schlüssel geht in eine Client-Konfiguration, weil hermoso mcp das gespeicherte Bearer-Token von hermoso auth login liest:

npm install -g hermoso && hermoso auth login && claude mcp add hermoso -- npx -y hermoso mcp

Cursor / Codex – melden Sie sich auf dieselbe Weise an und fügen Sie dann zu mcp.json hinzu (Codex verwendet das TOML-Äquivalent). Lassen Sie den env-Block vollständig weg, wenn Sie sich oben angemeldet haben; er ist für CI gedacht, wo der Prozess Ihr Home-Verzeichnis nicht lesen kann:

{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"],
  "env": { "HERMOSO_API_BASE": "https://app.hermoso.ai", "HERMOSO_TOKEN": "<your token>" } } } }

Dann fragen Sie Ihren Agenten: „Generiere eine Bildanzeige mit Hermoso."

Was die 718 Tools abdecken

Anzeigen-Spionage / Recherchefind_competitors, competitor_teardown, pull_competitor_ads, research_ads; die Meta-/Google-/LinkedIn-Anzeigenbibliotheken (search_meta_ads, search_google_ads, search_linkedin_ads); organische soziale Medien (search_tiktok, search_instagram, search_youtube, search_reddit, search_threads); fetch_social_data, mine_angles, analyze_video, check_ad_policy, list_skills / get_skill.

Erstellendraft_brandplan_adrender_ad (die Studio-Qualitätspipeline: zusammengesetzter Text, klare Sprache, Musik, Marken-Endcard) oder generate_image / generate_video / generate_avatar (UGC-Ersteller + Lippen-Synchronisation). Die gespeicherte Besetzung des Workspace ist wiederverwendbar: list_creators gibt jeden gespeicherten Ersteller mit seiner Porträt-URL zurück, save_creator fügt einen hinzu, delete_creator entfernt einen – übergeben Sie ein Porträt erneut an generate_avatar / generate_video / recast_motion, und DIESELBE Person spielt in jeder Anzeige mit, statt bei jedem Render ein neues Gesicht. Außerdem make_template_ad (native HTML-Anzeigenformate), make_explainer, product_sizzle, make_thumbnail, remix_static, recast_motion, reframe_video, upscale_video, dub_video, change_voice, finish_video, fix_beat, stitch_video, clip_video, post_edit, plus plan_variations + score_ad zum Ausweiten und Bewerten. Die Länge liegt bei Ihnen: Übergeben Sie durationSeconds an plan_ad, und das Storyboard wird darauf zugeschnitten – eine Länge, die in einen Clip des Render-Modells passt, rendert als eine einzige durchgehende Aufnahme, längere wird aus Akten zusammengesetzt (bei einem 15s-Clip-Modell: 40s = 15+15+10), niemals zeitkomprimiert. Was in einen Clip passt, ist das Maximum des Modells selbst, keine feste Zahl: Die meisten Videomodelle begrenzen einen Clip auf 15 Sekunden, und das Modell mit dem längsten Clip nimmt 30 Sekunden in einer einzigen ununterbrochenen Aufnahme mit nativem synchronisiertem Audio. hermoso_capabilities ist die Live-Liste – Dauern, Auflösungen und die genauen Kreditkosten jeder Stufe – und dieses Modell in model zu nennen, ist der Weg, es zu erhalten, da ein unbenannter Render über einen engeren Auto-Pool geleitet wird.

Roher Modell-Playground – der vollständige Katalog (30+ Bild-/Video-/Sprach-/Textmodelle, jedes mit seinen exakten Kreditkosten pro Render) ohne Werbe-Framing: generate_image / generate_video mit useBrand:false, generate_voice, generate_text.

Auf eigenen Kanälen veröffentlichenzehn davon: Facebook, Instagram und Threads (post_to_meta), TikTok (post_to_tiktok), YouTube (post_to_youtube + update_youtube_video, youtube_video_insights, Kommentare lesen/antworten), X (post_to_x, x_post_metrics, x_post_insights, x_mentions, list_x_dms, send_x_dm), LinkedIn-Profil und Unternehmensseiten (post_to_linkedin, post_to_linkedin_page), Pinterest (post_to_pinterest + Boards), Bluesky (post_to_bluesky, delete_bluesky_post, bluesky_post_metrics, plus list_bluesky_convos / read_bluesky_dm / send_bluesky_dm) und Telegram (post_to_telegram, delete_telegram_message, list_telegram_chats). schedule_post / list_scheduled / cancel_scheduled geben dir einen Content-Kalender über genau diese Menge. upload_file bringt beliebige externe oder lokale Medien ein, nicht nur Hermoso-Render. X-Posts werden pro API-Aufruf mit Credits abgerechnet (X berechnet pro Anfrage); ein Beitrag mit Link kostet das 13-fache eines Beitrags ohne. Zurückgehalten und benannt statt versteckt: Google Business Profile ist gebaut (post_to_google_business, Bewertungen, Q&A, Insights) und wird nicht angeboten – Google setzt diese API pro Projekt auf eine Allowlist und unsere liest 0 QPM, sodass jeder Aufruf für jeden Benutzer 403 zurückgeben würde. Es ist im Kanal-Enum von schedule_post enthalten und wird beim Einreihen abgelehnt.

Kunden auf WhatsApp schreiben – Messaging, kein elfter Veröffentlichungskanal: Du schreibst einer Person, und nichts davon postet in einen Feed. list_whatsapp_accounts findet das Business-Konto und seine Nummern, list_whatsapp_templates / create_whatsapp_template / delete_whatsapp_template verwalten die Vorlagen, die Meta prüft, und send_whatsapp_message sendet eine – bestätigungsgeschützt, weil sie ein echtes Telefon erreicht und Meta dem Unternehmen die Konversation in Rechnung stellt. Zwei Grenzen, die dauerhafte Fakten über Metas API sind und nichts Ausstehendes: Hermoso empfängt keine WhatsApp-Webhooks, es gibt also keinen Nachrichtenverlauf zu lesen – es ist keine Inbox-Oberfläche und list_inbox deckt es nicht ab – und außerhalb des 24-Stunden-Fensters, das sich öffnet, wenn der Kunde zuerst schreibt, akzeptiert WhatsApp eine GENEHMIGTE Vorlage und sonst nichts.

Anzeigen schalten – vollständige Kampagnenbäume, pausiert gebaut und zurückgelesen, bevor etwas gemeldet wird, mit jeder Ausgabenänderung bestätigungsgeschützt, auf elf Plattformen: Meta, Google Ads, LinkedIn Ads, Reddit Ads, Pinterest Ads, Microsoft Advertising, ChatGPT Ads (OpenAIs Advertiser API), X Ads, TikTok Ads, Snapchat Ads und Apple Ads (Apple Search Ads im App Store). Jede hat Listen- + Berichts- + Erstellungs- + Budget/Status-Tools (z. B. list_google_ads_campaigns, google_ads_report, create_google_ads_campaign, set_google_ads_budget, set_google_ads_status). Snapchat braucht einen zusätzlichen Schritt, den die anderen nicht brauchen: Eine Anzeige zeigt auf ein CREATIVE, und jedes Snapchat-Creative muss eine Public-Profile-ID tragen – baue es mit upload_snapchat_ads_creative.

Shopping-Oberflächen versorgenGoogle Merchant Center ist der Katalog, den eine Retail-Performance-Max- oder Shopping-Kampagne bewirbt (create_google_ads_performance_max_campaign nimmt eine merchantCenterId entgegen), und du verwaltest ihn von hier aus: Konten und Kontostatus, Datenquellen, Produkt-Upsert / -Update / -Löschung, Bestand pro Region, Kontingent, merchant_report für Produktleistung, Benachrichtigungen und Conversion-Quellen, plus die Ablehnungsschleife – list_merchant_issues sagt, was falsch ist, und merchant_issue_help liefert Googles eigene dokumentierte Lösung. Promotions erfordern die eigene Anmeldung des Händlers in Googles Promotions-Programm; ohne sie lehnt Google diese Sub-API rundweg ab. Microsoft Merchant Center ist in derselben Form abgedeckt (Stores, Kataloge, Produkte, Probleme) für Bing Shopping.

Messen, was die Anzeigen erreicht haben – Google Analytics 4 schließt den Kreis. Jeder andere Connector hier berichtet, was eine Anzeige gekostet hat; dieser ist der, der berichtet, was sie bewirkt hat. analytics_report schlüsselt Sitzungen, Nutzer, Conversions und Umsatz nach Kanal, Quelle/Medium, Kampagne, Landingpage, Land, Gerät oder Datum auf, sodass die Kampagne, die Hermoso gebaut hat, und der Umsatz, den sie erzielt hat, in einer Konversation liegen. analytics_realtime zeigt, wer gerade auf der Website ist. Beginne bei list_analytics_properties – die Tools nehmen eine numerische Property-ID entgegen, nicht die G-XXXXXXXXX-Measurement-ID aus deinem Tracking-Snippet, und genau das löst eine in die andere auf. Es schreibt ebenso wie es liest: create_analytics_key_event markiert ein Ereignis, das GA4 bereits erfasst, als Schlüsselereignis – das macht es als Conversion in Google Ads importierbar – und create_analytics_custom_dimension registriert einen Ereignisparameter, damit Berichte danach aufschlüsseln können, wobei list_analytics_definitions zeigt, was die Property bereits misst. Es meldet sich mit demselben Google-Konto an wie Google Ads, YouTube und Drive, ist aber eine eigene Verbindung. Nur GA4 – die API hat keine Universal-Analytics-Oberfläche. Eine Custom Dimension kann archiviert, aber nie gelöscht werden, und eine Property enthält 50 ereignisbezogene.

Dateien – Google-Drive-CRUD (save_to_drive, list_drive_files, update_drive_file, delete_drive_file, create_drive_folder), Google Sheets (create_sheet, append_to_sheet, read_sheet), Google Docs (create_doc, append_to_doc) und OneDrive (save_to_onedrive + vollständiges CRUD).

Arbeitsbereich & Konto – Marken-Arbeitsbereiche (list_brands, create_brand, use_brand, update_brand, delete_brand – ein Konto enthält viele Marken, sodass eine Agentur jeden Kunden darüber abwickelt), Speicher (remember, forget, list_memory), benutzerdefinierte Skills (save_skill, get_skill, list_skills, delete_skill – die eine Bibliothek, die die alten AI-Employee-Personas aufgenommen hat), Team (list_team, invite_member, remove_member, set_role), Einstellungen (get_settings, update_settings – einschließlich der Sprache, in der jede Anzeige, jedes Skript und jeder Plan geschrieben ist), Connectors (list_connectors, list_connector_accounts, set_connector_accounts, disconnect_connector) und Abrechnung (hermoso_credits, billing_status, buy_credits, upgrade_plan, set_auto_reload), plus list_jobs / get_job für asynchrone Render.

Connector-Konten werden ausgewählt, nicht erraten. Eine Person verwaltet oft mehrere Facebook-Seiten, Google-Ads-Kunden oder LinkedIn-Unternehmensseiten. Nur die für eine Marke angehakten Konten sind nutzbar – serverseitig erzwungen, und eine leere Auswahl teilt nichts. Ein neues Konto zu verknüpfen ist der eine Schritt, der nicht headless ist (es ist ein OAuth-Zustimmungsbildschirm, den der Benutzer also in der App ausführt).

Render-Jobs werden serverseitig in die Warteschlange gestellt und bis zum Abschluss abgefragt, wobei eine ausgelieferte URL zurückgegeben wird.

2. CLI – der token-sparsame Weg für Terminal-Agenten

bin/hermoso.mjs stellt das vollständige MCP-Toolset als Subprozess-Befehle bereit, sodass ein Agent auslagern kann, statt ein dickes Tool-Manifest mit sich zu führen.

npm install -g hermoso                             # installs `hermoso`
hermoso capabilities                               # valid model ids + costs (run first)
hermoso create --brand "YourBrand" --product "your best-selling product" --format image
hermoso generate image --prompt "…" --ref ./product.png --wait
hermoso generate video --prompt "…" --duration 8 --wait
hermoso competitors yourbrand.com
hermoso research "Liquid Death’s longest-running ads"

Füge --json zu jedem Befehl hinzu, um Maschinenausgabe zu erhalten.

Diese Abkürzungen sind der übliche Weg, nicht die Grenze. Jedes Tool, das der MCP-Server hat, ist auch hier erreichbar, einschließlich der Anzeigenkampagnen- und Analytics-Gruppen, die ein Connector aus seiner Standard-Liste auslässt:

hermoso tools                          # every tool, grouped, name + one line
hermoso tools --group ads --search reddit   # narrow it
hermoso tools create_meta_campaign     # that tool's full argument schema
hermoso call create_meta_campaign --json '{"name":"…"}'   # run it
hermoso create_meta_campaign --name "…"                   # same thing, shorter

call durchläuft denselben Handler, dieselbe Argumentvalidierung und dieselben Bestätigungs-/Ausgabengates, die der MCP-Server verwendet – es gibt keine zweite Implementierung, die abweichen könnte. tools und tools <name> lesen ein im Paket gebündeltes Register, brauchen also keinen Schlüssel, kein Netzwerk und keine Anmeldung.

3. Claude-Skills – Slash-Befehle, die die CLI umschließen

skills/ enthält vier installierbare Skills: hermoso-generate, hermoso-ad-from-brand, hermoso-product-photoshoot, hermoso-research.

cp -r skills/* ~/.claude/skills/

Dann rufe /hermoso-ad-from-brand an ad for yourbrand.com — our hero product auf.

Konfiguration

Env

Bedeutung

HERMOSO_API_BASE

Der Hermoso-API-Ursprung (Standard https://app.hermoso.ai – setze http://localhost:3000, wenn du die App selbst betreibst)

HERMOSO_TOKEN

Bearer-Agent-Schlüssel (hmk_…) – erforderlich gegen die gehostete App

HERMOSO_PROFILE

Marken-Arbeitsbereichs-ID, für Konten mit mehreren Markenprofilen

HERMOSO_OWNER

Nur für eine Marke, die ein anderes Konto mit dir geteilt hat (ein Team-Arbeitsbereich): die ID des besitzenden Kontos. Setze sie zusammen mit HERMOSO_PROFILE, und setze HERMOSO_PROFILE auf die profileUuid dieses Arbeitsbereichs – ein kurzer Slug einer Marke wird abgelehnt. Führe list_brands (oder hermoso list_brands aus der CLI) aus, um beide Werte für jeden Arbeitsbereich zu drucken, den du betreten kannst. Der Server autorisiert das Paar bei jeder Anfrage neu, sodass ein falscher Wert abgelehnt, nie vertraut wird.

mcp/http.mjs ist der gehostete Remote-Connector-Transport (URL in Claude.ai → Connectors einfügen). Es wird in diesem Repository aus Transparenzgründen mitgeliefert und weigert sich, ohne authentifizierte Identität zu mounten – niemals anonyme Ausgaben.

Lizenz

MIT © Hermoso

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides Meta and Google Ads intelligence for AI assistants, enabling users to analyze performance, track competitors, and manage ad campaigns through natural language. It features 17 tools for generating creative concepts, scraping competitor ads, and performing deep account-level analysis.
    17
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Generate AI UGC video ads from any product URL in 5 minutes. Realistic AI avatars, natural voiceover, proven ad templates. No actors, no editing, no experience required.
    126
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Manage ad campaigns across Meta, Google, and TikTok, create campaigns, analyze performance, spy on competitors, and generate AI creatives.
    10
    MIT

View all related MCP servers

Related MCP Connectors

  • 60+ Meta Ads tools for AI agents: audits, campaign management, audiences and CAPI tracking.

  • Run ads on Google, Meta, LinkedIn, TikTok and more from AI. 430+ tools across 13 platforms.

  • Manage Google, Meta, Amazon, TikTok, LinkedIn & ChatGPT ads. 430 tools for campaigns & analytics.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hermoso-ai/hermoso'

If you have feedback or need assistance with the MCP directory API, please join our Discord server