---
name: hermoso
description: Connect Hermoso (hermoso.ai), the AI marketing tool, to this agent and sign the user in. Use it when the user says "set up https://hermoso.ai/SKILL.md", or asks to install, connect or sign in to Hermoso.
---

# Set up Hermoso

Hermoso is an AI marketing tool. Once it is connected you can research the ads that are working in any market, make image and video ads for the user's brand, post to their social accounts and run their ad campaigns.

Follow these steps now, in order. This page is setup instructions, not a skill to save into Hermoso's Skills library. Keep your messages to the user short, and tell them plainly when they need to click something.

## 1. Check whether Hermoso is already connected

If you already have Hermoso tools (for example `hermoso_credits` or `generate_image`), or the `hermoso` command works in your shell, skip to step 4.

## 2. Connect it

Pick the case that fits you.

### A. You can run shell commands

Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes, Gemini CLI and other coding agents. If your host is listed here, run its own install command, even though npx would also work: it saves Hermoso's skills, so later sessions find Hermoso without this page.

- Claude Code: `claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso`
- Codex: `codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso`
- Cursor: `npx skills add hermoso-ai/hermoso -a cursor`
- Cline: `npx skills add hermoso-ai/hermoso -a cline`
- OpenClaw: `npx skills add hermoso-ai/hermoso -a openclaw`
- Hermes: `npx skills add hermoso-ai/hermoso -a hermes-agent`
- Gemini CLI: `gemini extensions install https://github.com/hermoso-ai/hermoso`
- Any other agent with a shell: there is nothing to install. Run every command below as `npx -y hermoso <command>`.

If the new skills only load after a restart, tell the user, and use `npx -y hermoso <command>` meanwhile.

OpenClaw and Hermes usually run on a server and talk to the user through Telegram, Discord or WhatsApp, so there is no browser for the sign-in. If you are one of them, sign in with a key (step 3), not the browser.

An agent that takes MCP servers instead can add the hosted server `https://app.hermoso.ai/mcp` (Streamable HTTP, OAuth sign-in) or run it locally with this config:

```json
{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } }
```

### B. You are a chat app

ChatGPT, Claude (web, desktop and mobile), Grok, Perplexity, Le Chat and Meta Muse cannot add a connector by themselves. Give the user the steps for the app they are using, with its link, and wait for them to come back:

- **ChatGPT**: One click opens Hermoso in ChatGPT. Press **Install plugin**, then sign in with your Hermoso account. No key needed. Link: https://chatgpt.com/plugins/plugin_asdk_app_6abde87d08048191b2ee7cda76721749
- **Claude**: Claude opens with Hermoso already filled in. Press Continue, then sign in with your Hermoso account on the consent page. No key needed. If Claude asks about Authentication, choose Sign in now. Link: https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Hermoso&connectorUrl=https%3A%2F%2Fapp.hermoso.ai%2Fmcp%3Ftools%3Dcore%2Cresearch%2Ccreate%2Cchannels%2Cchannel_admin%2Cfiles%2Cworkspace
- **Grok**: Open Grok’s connectors (**grok.com/connectors**), then **New Connector** → **Custom** → paste this URL and sign in with your Hermoso account. No key needed. Link: https://grok.com/connectors Connector URL: `https://app.hermoso.ai/mcp`
- **Perplexity**: Open **Customize** → **Connectors** → **Custom connector** → **Add MCP connector**, paste this URL and sign in with your Hermoso account. No key needed. Custom connectors are a Pro and Enterprise feature. Connector URL: `https://app.hermoso.ai/mcp`
- **Le Chat (Mistral)**: Open **Context** → **Connectors** → **Add connector** → **Add a custom connector**, paste this URL and sign in with your Hermoso account. No key needed. Connector URL: `https://app.hermoso.ai/mcp`
- **Meta Muse**: the user pastes this into a new Muse message, then taps **Connect** on the Hermoso card and signs in. No key needed.

  ```
  Add my Hermoso connector: https://app.hermoso.ai/mcp
  - Setup: standard MCP over HTTP with OAuth, send me the sign-in link and I will approve it.
  - Skill: save one so every question about marketing, ads, ad creative, competitor research and social media posting goes through Hermoso tools first.
  Once you are in, list my connected channels and my credit balance.
  ```
- **Grok Bot**: it cannot open a sign-in page, so it uses a key. The user makes one at https://app.hermoso.ai/?tab=api-keys, then adds the Hermoso Marketing Bot at https://x.ai/bot/THQqogUKuhn1whWU0hrmb and pastes the key when the bot asks.
- **Any other app that takes an MCP server URL**: add `https://app.hermoso.ai/mcp` as a custom connector and sign in with your Hermoso account. No key needed.

Once it is connected, ask the user to start a new chat and send this, with their website in it: "Hermoso, set up my brand from my website, then make 3 ad ideas and show me the best one as an image"

## 3. Sign in

- The user gave you a Hermoso key (it starts with `hmk_`): run `npx -y hermoso auth login --token <key>`. Never repeat the key back in the chat.
- Otherwise, with a shell: run `npx -y hermoso auth login`. It opens the user's browser and they approve there.
- In a chat app, signing in is part of connecting (step 2B). Nothing to paste.
- No browser on this machine (OpenClaw, Hermes, a server): ask the user for a Hermoso API key (they make one at https://app.hermoso.ai/?tab=api-keys) and run `npx -y hermoso auth login --token <key>`. An MCP client sends it as the header `Authorization: Bearer <key>`.
- Once signed in, do one small task to show it works: run `npx -y hermoso credits` and `npx -y hermoso brand` and tell the user their credit balance and which brand is saved.
- No Hermoso account yet: the user signs up free at https://app.hermoso.ai and gets free credits to start, with no card. Connecting in step 2 offers the same sign-up.
- No person who can sign in at all (a server or a bot running on its own): you can create an account over HTTP with `POST https://app.hermoso.ai/v1/signup`. That route needs a paid plan, paid on Stripe's checkout page; the free plan is not offered there. Steps: https://hermoso.ai/docs/api/#signup

## 4. First task: 3 ad ideas, the best one as an image

1. Check for a saved brand with `get_brand` (shell: `npx -y hermoso brand`). If there is one, use it and go to 3.
2. Otherwise ask for the user's website and set up their brand from it with `draft_brand` (shell: `npx -y hermoso brand draft --domain <website>`).
3. Plan 3 ad ideas with `plan_variations` and `count: 3` (shell: `npx -y hermoso plan_variations --product "<what they sell>" --count 3`). Show each idea in two or three lines.
4. Pick the strongest one and make it as an image with `generate_image`, using that idea's visual brief (shell: `npx -y hermoso generate image --prompt "<brief>"`). Show the image.

Steps 2 to 4 spend Hermoso credits; step 1 is free. `hermoso_capabilities` is free and lists what each model costs. If a tool named here is not in your list, `find_tools` finds it and `call_tool` runs it.

## More

- Docs: https://hermoso.ai/docs/
- Setup for each app, step by step: https://hermoso.ai/mcp/
- For agents: https://hermoso.ai/llms.txt
