EasySociable MCP Server
A Model Context Protocol (MCP) server that empowers AI agents (Claude Desktop, Claude Code, Cursor, Codex) to turn prompts, outlines, and markdown into branded, multi-page social carousels and slideshows for TikTok, LinkedIn, Instagram, Threads, and Xiaohongshu.
What is EasySociable?
EasySociable is an agent-native visual production layer that bridges the gap between text-based AI models and finished visual carousel decks:
- AI Agent writes the content: Claude or Cursor creates the story, pacing, and slide copy.
- EasySociable binds the design: Applies proven layout families, enforces Brand Kits (fonts, colors), and prepares a durable Slideshow Run.
- In-Browser Studio: Open the private review link in your browser to polish text or swap images without layout drift.
- Multi-Platform PNG Pack: One-click download optimized for TikTok (9:16), LinkedIn (4:5 / 1:1), Instagram (4:5 / 1:1), and Xiaohongshu (3:4).
Quickstart & Installation
This server is listed in the Official MCP Registry.
Option 1: Claude Desktop
Add this configuration to your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"easysociable": {
"command": "npx",
"args": ["-y", "@easysociable/cli", "mcp", "serve", "--transport", "stdio"]
}
}
}
Option 2: Cursor
Add the MCP server to Cursor via Cursor Settings > Features > MCP Servers > Add New:
- Name:
easysociable
- Type:
command
- Command:
npx -y @easysociable/cli mcp serve --transport stdio
Option 3: Global CLI Install
# macOS / Linux automated installer
curl -fsSL https://easysociable.com/install.sh | bash
# Or via npm
npm install -g @easysociable/cli
# Run MCP server directly
easysociable mcp serve --transport stdio
Available MCP Tools
36 tools, grouped by what the agent works on:
| Group | Tools |
|---|
| Slideshow Runs | create_slideshow_run, get_slideshow_run, list_slideshow_runs, update_slideshow_run, archive_slideshow_run, restore_slideshow_run, delete_slideshow_run |
| Brands | create_brand, get_brand, list_brands, update_brand, archive_brand, restore_brand, delete_brand |
| Templates | list_templates, get_template |
| Template authoring | create_template_draft, get_template_draft, list_template_drafts, update_template_draft, delete_template_draft, publish_template_draft, create_template_preview_job, import_template_image |
| Images | import_image, get_image, list_images, update_image, attest_image, archive_image, restore_image, delete_image |
| Design assets | search_icons, get_icon, list_gradients, get_gradient |
Agent Skills
The skills/ folder holds the workflows the agent follows on top of the tools:
Install skills + MCP in one go with easysociable install --yes, or as a Claude Code plugin:
/plugin marketplace add murphywuwu/easysociable-mcp
/plugin install easysociable@easysociable
Example Agent Workflow
When you ask your agent:
"Create a 5-slide LinkedIn carousel about 4 Micro-SaaS pricing mistakes with my Brand."
Your Agent will:
- Call
list_brands to load your saved Brand (name, handle, colors, fonts).
- Pick a proven structure from the Formula catalog (page 1 is its opening hook), then draft the copy.
- Call
list_templates to choose a layout for each page.
- Call
create_slideshow_run to bind copy, layouts and Brand into a Slideshow Run, with the post's title and caption drafted to the platform's limits.
- Return a private Studio link: polish the pages, then on your phone tap Publish to share every page to the app with the caption copied, or download the PNG pack.
Supported Formats
| Platform | Canvas Preset | Ratio |
|---|
| TikTok | 1080 × 1920 | 9:16 (Photo Mode) |
| LinkedIn | 1080 × 1350 | 4:5 (Document Carousel) |
| Instagram | 1080 × 1350 / 1080 × 1080 | 4:5 / 1:1 |
| Xiaohongshu (RED) | 1080 × 1440 | 3:4 |
| Threads / X | 1080 × 1080 / 1080 × 1350 | 1:1 / 4:5 |
Links & Resources
License
MIT © EasySociable
