Hermoso MCP Server

by hermoso-aiio.github.hermoso-ai/hermosov0.1.406

Ad studio: generate video, image and UGC avatar ads with script, voiceover and music, and research competitor ads in Meta, Google and LinkedIn ad libraries.

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Hermoso MCP server

claude mcp add hermoso -e HERMOSO_TOKEN='<hermoso-token>' -- npx -y hermoso mcp

{
  "mcpServers": {
    "hermoso": {
      "command": "npx",
      "args": [
        "-y",
        "hermoso",
        "mcp"
      ],
      "env": {
        "HERMOSO_TOKEN": "<hermoso-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "hermoso": {
      "command": "npx",
      "args": [
        "-y",
        "hermoso",
        "mcp"
      ],
      "env": {
        "HERMOSO_TOKEN": "<hermoso-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "hermoso": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hermoso",
        "mcp"
      ],
      "env": {
        "HERMOSO_TOKEN": "<hermoso-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "hermoso": {
      "command": "npx",
      "args": [
        "-y",
        "hermoso",
        "mcp"
      ],
      "env": {
        "HERMOSO_TOKEN": "<hermoso-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
HERMOSO_TOKEN	—	yes	Hermoso agent key (hmk_…) from app.hermoso.ai, on the MCP & CLI tab under Terminal & API keys. Required against the hosted app.
HERMOSO_API_BASE	—	—	Hermoso API origin. Defaults to https://app.hermoso.ai; set http://localhost:3000 to run against your own server.

Remote endpoints

streamable-httphttps://app.hermoso.ai/mcp?src=registry

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-10-07 · 2d ago · GitHub · v0.1.406
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v0.1.406

FAQ

›How do I install the Hermoso MCP server in Claude Code?

Run: claude mcp add hermoso -e HERMOSO_TOKEN='<hermoso-token>' -- npx -y hermoso mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Hermoso require an API key?

Yes. It expects HERMOSO_TOKEN, of which 1 is a secret.

›Can I use Hermoso as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Hermoso in the official MCP registry?

Yes, as io.github.hermoso-ai/hermoso.