Log inSubmit server
Hermoso logo

Hermoso

by hermoso-ai

Generate ads, research competitors, publish content, and manage campaigns across major marketing platforms through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Hermoso

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hermoso-ai-hermoso": {
      "command": "npx",
      "args": [
        "-y",
        "hermoso"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

hermoso-ai/hermoso connects AI agents to ad creation, marketing research, publishing, analytics, and campaign management workflows. It can generate image and video ads with scripts, voiceovers, music, product compositing, calls to action, and brand end cards, while also researching competitor activity across major ad libraries and social platforms. Agents can use the local MCP server through the Hermoso CLI or connect to the hosted endpoint at app.hermoso.ai/mcp. Reach for it when a marketing workflow needs creation, competitor research, social publishing, or paid campaign operations in one tool surface.

Use cases

  • Generate branded image, video, and UGC avatar ads
  • Research competitor ads across major ad libraries
  • Publish and schedule content across social channels
  • Build and manage paid advertising campaigns
  • Review marketing and campaign analytics

Key features

  • AI image and video ad generation
  • Competitor ad and organic content research
  • Multi-channel publishing and scheduling
  • Paid campaign management
  • Analytics across connected platforms
  • CLI and hosted MCP access

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

22/22 checks healthy over the last 89d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · hermoso (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads20kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Hermoso works

What hermoso-ai/hermoso does

hermoso-ai/hermoso provides MCP tools for marketing work across four independent areas: research, creative generation, publishing and scheduling, and advertising operations. It can produce image and video ads with copy, calls to action, voiceover, music, product imagery, and a branded end card. It also supports UGC avatar ads and lets agents work with creative that was created elsewhere.

Research tools cover the Meta, Google, and LinkedIn ad libraries, along with organic content from TikTok, Instagram, YouTube, Threads, and Reddit. The service can publish and schedule content to Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, and Google Business Profile. Paid advertising connections include Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads, Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads, ChatGPT Ads, AppLovin Ads, and Google Merchant Center product feeds.

How it works

An agent can use Hermoso through a local CLI-backed MCP process or the hosted MCP endpoint at https://app.hermoso.ai/mcp. The CLI exposes the tool registry on demand, so an agent can search tool names, inspect a tool schema, and invoke a selected tool. The MCP surface can also be added to an agent for native structured tool calls.

Research, generation, publishing, and campaign management do not depend on one another. An agent can research competitors without a connected brand, generate a file without connecting a channel, publish an existing file, or manage campaigns using its own ad accounts. upload_file converts a local or external file into a URL accepted by publishing, scheduling, and ad-building tools.

Setup and configuration

The local server can be started with:

Terminal
npx -y hermoso mcp

Authenticate once with npx -y hermoso auth login; the command opens a browser for sign-in. A key created under the account’s MCP & CLI settings can be supplied with npx -y hermoso auth login --token <key> when browser access is unavailable. For repeated use on a server or in CI, the package can be installed globally with npm i -g hermoso.

The hosted option requires no local process. Add https://app.hermoso.ai/mcp as a custom connector in a compatible browser-based client and sign in to the Hermoso account. The repository also provides install paths for Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, VS Code, and other agent environments through their plugin or skills mechanisms.

Tools and capabilities

The live tool set is authoritative through tools/list; the package describes the available registry without requiring sign-in. The hermoso_capabilities tool returns the live model catalog, render credit costs, and capability map. The service includes tools for:

  • Generating image, video, voice, text, planning, and post-production assets
  • Researching competitor ads and organic social content
  • Publishing and scheduling content across eleven social channels
  • Building and managing paid campaigns
  • Reading post, campaign, and connected-platform analytics
  • Working with Google Analytics 4, Google Search Console, Google Drive, Sheets, Docs, and OneDrive
  • Handling comments, direct messages, and supported DM automations

Limitations and notes

Model runs and Ad Spy research consume credits. Publishing, scheduling, campaign management, analytics, comments and DMs, connectors, profiles, and team seats are free on every plan, while X usage also consumes credits because its API charges per request. Posting an already-rendered ad does not create a second rendering charge.

The available tools can change, so agents should treat tools/list as the source of truth. The MCP manifest can add context to every session; the CLI is useful when an agent needs to search or invoke the broader registry on demand. An account and authentication are required for calls that reach Hermoso services.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Hermoso

hermoso-ai/hermoso is an MCP server that connects AI agents to advertising platforms, social publishing channels, analytics services, and competitor research sources. Its main tools generate image and video ads, research ad libraries and organic content, publish or schedule posts, and build or manage paid campaigns.

Install it with `npx -y hermoso mcp`. Authenticate with `npx -y hermoso auth login`, or use a token created in the Hermoso account under MCP & CLI. You can also connect the hosted endpoint at `https://app.hermoso.ai/mcp` instead of running a local process.

Yes, hermoso-ai/hermoso works with Cursor through the open skills installer. Run `npx skills add hermoso-ai/hermoso`, or select Cursor with `-a cursor`; the repository also supports installing individual skills such as `hermoso-research`.

hermoso-ai/hermoso publishes and schedules content to Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, and Google Business Profile. It also supports WhatsApp messaging and DM automations for Instagram, Facebook Pages, Messenger, and X.

Hermoso charges credits for AI model runs and Ad Spy research. Publishing, scheduling, campaign management, analytics, comments and DMs, connectors, profiles, and team seats are free on every plan; X posting and reads also use credits because X charges per API request.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHermoso AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hermoso-ai-hermoso?style=directory)](https://allmcps.com/mcp/hermoso-ai-hermoso)
HTML Embed
<a href="https://allmcps.com/mcp/hermoso-ai-hermoso"><img src="https://allmcps.com/api/badge/hermoso-ai-hermoso?style=directory" alt="Hermoso on AllMCPs" /></a>