Cli

What @easysociable/cli does

@easysociable/cli exposes EasySociable’s visual production workflow through the Model Context Protocol. An AI agent can turn a topic, outline, prompt, or Markdown document into a multi-page social carousel or slideshow, using saved brand settings and available layouts.

EasySociable applies layout families, brand colors, and fonts to the agent’s content. The resulting Slideshow Run can be opened through a private Studio link for review, text edits, or image changes. Finished work can be downloaded as a PNG pack sized for supported social platforms.

The documented platform presets include TikTok at 9:16, LinkedIn at 4:5, Instagram at 4:5 or 1:1, Xiaohongshu at 3:4, and Threads or X at 1:1 or 4:5.

How it works

The package runs as an MCP server over stdio. An MCP-compatible client starts it with the mcp serve --transport stdio command, allowing the agent to call EasySociable operations as tools.

A typical workflow begins by loading a saved brand and selecting templates. The agent then creates a slideshow run that combines the copy, layouts, and brand. The workflow can also draft a title and caption within the selected platform’s limits. The agent returns a private Studio link where the pages can be polished before the PNG pack is downloaded or the content is published through the EasySociable app.

The repository also includes agent skills. The slideshow skill covers a topic-to-carousel workflow; the template skill supports designing and publishing reusable templates from a brief or image; and the content skill points to the separate local Content Engine.

Setup and configuration

Claude Desktop can launch the package with npx using this MCP configuration:

{
  "mcpServers": {
    "easysociable": {
      "command": "npx",
      "args": ["-y", "@easysociable/cli", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

Cursor can add the same command from Settings > Features > MCP Servers > Add New, using npx -y @easysociable/cli mcp serve --transport stdio as the command.

For direct use, install globally with npm install -g @easysociable/cli, then run easysociable mcp serve --transport stdio. macOS and Linux also have an automated installer available at https://easysociable.com/install.sh. The easysociable install --yes command installs the skills and MCP setup together. Claude Code users can install the provided plugin through the EasySociable marketplace.

Tools and capabilities

The server provides 36 tools across these areas:

• Slideshow runs: create, retrieve, list, update, archive, restore, and delete runs.
• Brands: create, retrieve, list, update, archive, restore, and delete brand records.
• Templates: list and retrieve templates.
• Template authoring: create, retrieve, list, update, delete, and publish template drafts; create preview jobs; and import template images.
• Images: import, retrieve, list, update, attest, archive, restore, and delete images.
• Design assets: search icons, retrieve icons, list gradients, and retrieve gradients.

These operations let an agent assemble content, select design resources, manage reusable brand and template data, and maintain the lifecycle of slideshow, image, and draft records.

Limitations and notes

The server is focused on creating and managing visual social content rather than directly replacing the review step. Its documented flow returns a private Studio link so pages can be checked and refined in a browser. Platform output is represented through predefined canvas presets, and the listed PNG formats cover TikTok, LinkedIn, Instagram, Xiaohongshu, Threads, and X.

The package is available through npm and is listed in the Official MCP Registry. It is distributed under the MIT license.