easysociable-mcp
EasySociable MCP server lets AI agents create, style, review, and manage branded multi-page social carousels/slideshows and supporting design assets for TikTok, LinkedIn, Instagram, Threads, and Xiaohongshu.
Create/list/get/update/archive/restore/delete Slideshow Runs with revision locking and Studio review links.
Manage Brand Kits including typography, palettes, handles, and logos.
Browse public templates, inspect template slots, and recommend diverse page templates per slide.
Author template drafts: create/list/get/update/delete, publish, preview, and import draft images.
Manage media library images: import, list/get, update metadata, attest rights, archive/restore/delete.
Search icons, materialize icon assets, and list/get gradient CSS presets.
Produce platform-optimized Studio links and PNG packs for multiple social formats.
Enables creating branded multi-page social carousels/slideshows for Instagram, with 4:5 or 1:1 canvas presets and PNG pack export.
Enables creating branded multi-page social carousels/slideshows for Threads/X, with 1:1 or 4:5 canvas presets and PNG pack export.
Enables creating branded multi-page social carousels/slideshows formatted for TikTok Photo Mode (1080 × 1920, 9:16) and exporting them as PNG packs.
Enables creating branded multi-page social carousels/slideshows for Xiaohongshu (RED), formatted at 1080 × 1440 (3:4).
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).
Related MCP server: Carousels MCP from Houtini
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.jsonWindows:
%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:
easysociableType:
commandCommand:
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 stdioAvailable MCP Tools
36 tools, grouped by what the agent works on:
Group | Tools |
Slideshow Runs |
|
Brands |
|
Templates |
|
Template authoring |
|
Images |
|
Design assets |
|
Agent Skills
The skills/ folder holds the workflows the agent follows on top of the tools:
Skill | Purpose |
Topic → proven hook → structure → editable carousel, returned as a Studio link | |
Design and publish reusable page templates from a brief or an image | |
Pointer to the local Content Engine |
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@easysociableExample 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_brandsto 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_templatesto choose a layout for each page.Call
create_slideshow_runto 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) |
1080 × 1350 | 4:5 (Document Carousel) | |
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
Website: https://easysociable.com
Formula Catalog: https://easysociable.com/formulas
LLM Specification: https://easysociable.com/llms.txt
npm Package: @easysociable/cli
License
MIT © EasySociable
Available Tools
36 toolsarchive_brandArchive brandAIdempotent
Archive an active Brand to soft-hide it from default pickers and list queries without losing styling tokens. Call to declutter workspace brands. Do NOT use for permanent deletion; use delete_brand instead. Idempotent state transition, fully reversible via restore_brand. Existing slideshow runs referencing this brand continue to display correctly. Returns updated Brand with status set to archived.
Inputs: brandId (required). Returns: status, brandId
archive_imageArchive imageAIdempotent
Archive an image asset to soft-hide it from active media pickers without deleting binary files from storage. Call to declutter media library when an image is retired from active use. For permanent deletion, use delete_image instead. Idempotent state transition, fully reversible via restore_image. Slides and carousels currently referencing this image continue to display and render without disruption. Returns updated Image record with status set to archived.
Inputs: imageId (required). Returns: status, imageId
archive_slideshow_runArchive slideshow runAIdempotent
Soft-hide an active Slideshow Run from default workspace lists and pickers without deleting slide data or review URLs. Use to declutter the workspace after campaign completion. Do NOT use for permanent destruction; use delete_slideshow_run instead. Idempotent state change, fully reversible via restore_slideshow_run. Preserves all slide records, rendered assets, and external links. Returns updated SlideshowRun with status set to archived.
Inputs: runId (required). Returns: runId, status
attest_imageAttest image rightsAIdempotent
Record an immutable legal copyright or commercial rights ownership attestation for an image asset. Call before multi-platform export to satisfy commercial compliance requirements. Do NOT use to edit metadata like title or tags (use update_image instead) or upload images (use import_image). Not required for personal or draft-only runs. Requires workspace owner authorization. Writes a permanent audit log record bound to imageId. Re-attesting with a new statementVersion creates a new timestamped attestation record without revoking prior history. Returns attestation confirmation object.
Inputs: imageId (required), statementVersion. Returns: imageId, attestedAt, statementVersion
create_brandCreate brandA
Create a new owner-scoped Brand kit defining typography, color palette, handle, and optional logo asset. Call before creating slideshow runs to establish consistent visual identity. Do NOT use to edit an existing brand; use update_brand instead. Requires workspace owner authorization. Persists initial brand record with revision 1. Returns created Brand entity with brandId and initial revision.
Inputs: name (required), colors, handle, typography, +2 more. Returns: brandId, revision
create_slideshow_runCreate slideshow runA
Create a durable multi-page Slideshow Run from a structured ContentPack (platform + pages; each page carries role, slots and either a generated layout { studioJson, canvas } adapted from a Deck Style family, or a layoutFamilyId). Pass brandId to apply the user Brand. Put the post text beside the images in pack.post { title?, description? } (Xiaohongshu / TikTok have a title; Instagram, Threads, LinkedIn and X use description). X image Runs support 2–20 pages and default to the Instagram-compatible 4:5 canvas. Do NOT use to edit an existing run (use update_slideshow_run instead). Requires workspace owner write authorization. Returns created SlideshowRun record with generated runId, initial revision (1), and authoringStudioUrl for interactive browser review and PNG download.
Inputs: pack (required), brandId, contentSlug, brandProfileId. Returns: runId, revision, studioUrl
create_template_draftCreate authoring draftA
Initialize a new Page Template draft for authoring with custom layout, layers, and slot contracts. Use when authoring a new slide template from scratch. Do NOT use to edit an existing draft (use update_template_draft) or browse public templates (use list_templates). Requires workspace owner authorization. Returns created TemplateDraft record with draftId and interactive authoringStudioUrl for real-time visual canvas editing.
Inputs: name (required), theme, source, authoringSource, +1 more. Returns: id, authoringStudioUrl
create_template_preview_jobCreate preview jobA
Request an asynchronous server-side render preview image of a template draft for thumbnail generation. For interactive real-time visual authoring, prefer opening the authoringStudioUrl in browser.
Inputs: draftId (required). Returns: jobId, status
delete_brandDelete brandADestructive
Move a Brand to trash for deletion. Call only when a brand kit is obsolete and permanently discarded. Alternatives: If existing runs still use this brand theme, prefer archive_brand to preserve styling safely. Destructive operation requiring explicit confirmation. Dependent design workflows may lose default brand styling. Returns deletion confirmation record.
Inputs: brandId (required). Returns: brandId, deleted
delete_imageDelete imageADestructive
Move an image asset to trash for permanent removal. Call only when an image is obsolete, copyrighted without license, or marked for permanent deletion. If existing slides still use this image, prefer archive_image to hide it safely without breaking slide renders. Destructive operation requiring explicit user confirmation. May cause slide render failures if imageId is bound to active slides. Returns deletion confirmation record.
Inputs: imageId (required). Returns: deleted, imageId
delete_slideshow_runDelete slideshow runADestructive
Move a Slideshow Run to trash or permanently remove it from the workspace along with its slide page records. Use only when a run is obsolete and permanently discarded. Alternatives: If you only want to hide the run from active lists while preserving review links and data, use archive_slideshow_run instead. Destructive operation requiring explicit user confirmation. Invalidates studio review URLs. Returns deletion confirmation record.
Inputs: runId (required). Returns: runId, deleted
delete_template_draftDelete authoring draftADestructive
Permanently delete a template authoring draft by draftId. Call only when abandoning a draft that should be permanently destroyed. If the draft is complete and ready for production, call publish_template_draft instead. Destructive operation requiring explicit user confirmation: draft canvas data, layer AST, and unpublished revisions cannot be recovered. Returns deletion confirmation record.
Inputs: draftId (required). Returns: deleted, draftId
get_brandGet brandARead-onlyIdempotent
Fetch a complete Brand profile by brandId, including typography tokens, 4-color palette (primary, secondary, accent, surface), logoAssetId, and baseRevision. Call before generating or updating branded slides to inject brand styles and capture baseRevision. Alternatives: Use list_brands to discover brandIds. Read-only query scoped to workspace owner. Returns full Brand entity.
Inputs: brandId (required). Returns: colors, brandId, revision, typography
get_gradientGet gradientARead-onlyIdempotent
Retrieve the full gradient CSS recipe (linear angle, color stops, and semantic token values) for a specific gradient by gradientId. Call after list_gradients to materialize background styles or decorative surfaces on cards. Alternatives: Use list_gradients to search available recipes. Read-only platform catalog lookup. Returns full gradient recipe object.
Inputs: gradientId (required). Returns: id, css
get_iconGet / materialize iconA
Materialize an immutable TemplateIconAsset via Gateway from a confirmed iconId. Call after confirming a candidate from search_icons. Requires idempotencyKey to prevent duplicate creation. Idempotent: repeated calls with identical keys return the existing asset without consuming extra quota. Returns canonical SVG string, iconAssetId, and contentHash.
Inputs: iconId (required), idempotencyKey (required). Returns: contentHash, iconAssetId, canonicalSvg
get_imageGet imageARead-onlyIdempotent
Fetch metadata and public R2/CDN delivery URL for a specific image asset by imageId. Call to inspect dimensions, content hash, and rightsStatus before binding to slide slots. Alternatives: Use list_images to search assets across media library. Read-only query scoped to workspace owner. Returns full Image entity.
Inputs: imageId (required). Returns: url, imageId, rightsStatus
get_slideshow_runGet slideshow runARead-onlyIdempotent
Retrieve full details of an existing Slideshow Run by runId, including complete slide pages, bound template IDs, slot contents, brand theme snapshot, current revision number, and studio review URL. Call before update_slideshow_run to inspect current slide contents and capture baseRevision for concurrency locking. Alternatives: Use list_slideshow_runs to discover runIds. Read-only query scoped to authenticated workspace owner.
Inputs: runId (required). Returns: pages, runId, revision, studioUrl
get_templateGet templateARead-onlyIdempotent
Get one published template detail including the public slots[] table (key, type, required, constraints). Use slots to bind slide copy in create_slideshow_run or inspect template constraints. Alternatives: Use list_templates to browse catalog. Read-only catalog query.
Inputs: templateId (required). Returns: id, slots
get_template_draftGet authoring draftARead-onlyIdempotent
Fetch complete authoring draft details by draftId, including full layer AST, slot contract definitions, theme bindings, and validation error logs. Call before update_template_draft or publish_template_draft to inspect draft structure and check validation status. Alternatives: Use list_template_drafts to discover draftIds. Read-only query scoped to draft owner. Returns full TemplateDraft AST entity.
Inputs: draftId (required). Returns: id, name, authoringSource
import_imageImport imageA
Upload a new image file into the permanent workspace media library, storing the binary asset on Cloudflare R2 and registering metadata in Directus. Call to add reusable media assets (logos, photos, graphics) for use across slideshow runs and brands. Do NOT use for transient template draft canvas images (use import_template_image instead). Requires workspace write permissions. Returns created Image record with generated imageId and public delivery URL.
Inputs: file, name, filename, sourceUrl, +1 more. Returns: url, imageId
import_template_imageImport template imageA
Upload and attach a transient image asset specifically to a template draft canvas. Call while authoring a template draft in canvas studio to place background or sample imagery. Do NOT use for general workspace media library assets, logos, and photos (use import_image instead). Requires draft owner authorization and idempotencyKey. Idempotent: duplicate uploads with identical idempotencyKey return the existing asset. Returns created template image asset with imageId, dimensions, and public CDN preview URL.
Inputs: draftId (required), fileName (required), mimeType (required), provider (required), +9 more. Returns: url, imageId
list_brandsList brandsARead-onlyIdempotent
List owner-scoped Brands with typography tokens, color palettes, and logos. Call to discover available brand identities before creating or styling slideshow runs. Alternatives: Use get_brand when you have a specific brandId to inspect full tokens. Read-only query scoped to current workspace owner. Returns array of Brand summaries.
Inputs: no named parameters. Returns: brands
list_gradientsList gradientsARead-onlyIdempotent
List or search platform gradient recipe summaries by keyword query or tag. Call to discover gradient presets before styling cards. Alternatives: Use get_gradient to retrieve full CSS declaration for a specific gradientId. Read-only platform catalog query.
Inputs: q, tag, limit. Returns: gradients
list_imagesList imagesARead-onlyIdempotent
List owner-scoped image assets in the media library with optional search query q. Returns image IDs, CDN URLs, dimensions, and rights status for slot assignment. Call to browse media assets or discover imageId before slot binding. Alternatives: Use get_image to fetch full metadata for a specific imageId. Read-only query scoped to workspace owner.
Inputs: q. Returns: images
list_slideshow_runsList slideshow runsARead-onlyIdempotent
List owner-scoped Slideshow Runs with optional platform, lifecycle status, or search query filters. Returns run metadata, platform target, page counts, revision numbers, and timestamps. Call to browse existing carousels or find a runId before inspection, updating, or archiving. Alternatives: Use get_slideshow_run when you already have a specific runId to fetch full slide content. Behavior: Read-only query scoped to current authenticated workspace owner.
Inputs: q, status, brandId, platform, +3 more. Returns: runs, total
list_template_draftsList authoring draftsARead-onlyIdempotent
List all template authoring drafts for the current account owner. Returns draft summaries with validation status, name, and timestamps. Use to resume an authoring session or discover draft IDs before updating or publishing. Alternatives: Use get_template_draft when you have a draftId to inspect full layer AST. Read-only query scoped to account owner.
Inputs: no named parameters. Returns: drafts
list_templatesList templatesARead-onlyIdempotent
List public template catalog summaries from Gateway (filterable by platform, role, density, canvasPreset). Alternatives: Use get_template to inspect specific slot requirements. Read-only catalog query.
Inputs: q, all, limit, roles, +8 more. Returns: templates, nextCursor
publish_template_draftPublish authoring draftA
Validate and publish an authoring draft into the public or workspace template catalog. Call when draft design and slot contracts are finalized and ready for instantiation in slideshow runs. If still editing or fixing layout rules, use update_template_draft. To inspect validation before publishing, use get_template_draft. Promotes draft to an immutable published template. Validates AST against layout rules; fails if required slots or constraints are violated. Returns published Template entity with public templateId, slots table, and catalog status.
Inputs: draftId (required). Returns: id, slots, status
restore_brandRestore brandAIdempotent
Restore a previously archived or trashed Brand back to active status. Call to unhide a brand and make it immediately selectable in brand selectors and default list queries. Alternatives: Use get_brand to inspect tokens before restoring. Idempotent state transition. Returns restored Brand with status set to active.
Inputs: brandId (required). Returns: status, brandId
restore_imageRestore imageAIdempotent
Restore a previously archived or trashed image asset back to active status in the workspace media library. Call to unhide a retired asset and make it selectable again in slide slot editors. Alternatives: Use get_image to inspect asset details before restoring. Idempotent state transition. Returns restored Image record visible in default media queries.
Inputs: imageId (required). Returns: status, imageId
restore_slideshow_runRestore slideshow runAIdempotent
Restore a previously archived or trashed Slideshow Run back to active workspace status, restoring it to the default projects view. Use to reactivate an archived or trashed carousel project. Alternatives: Use get_slideshow_run to inspect run contents before restoring. Idempotent state change. Returns restored SlideshowRun record visible in default workspace listings.
Inputs: runId (required). Returns: runId, status
search_iconsSearch iconsARead-onlyIdempotent
Search the internal safe Template Icon Catalog (curated Iconify collections) by keyword, collection, or visual style. Use when designing templates or adding icon decorations. Select ≤8 candidates and confirm choice before materializing. Alternatives: Call get_icon once an iconId is selected to generate the immutable asset. Read-only catalog search; does not consume quota.
Inputs: query (required), limit, style, collection. Returns: icons
update_brandUpdate brandA
Patch visual styles, typography, or metadata of an existing Brand by brandId. Call after get_brand to modify palette or fonts. Do NOT use to create new brands (use create_brand) or to delete (use delete_brand). Requires baseRevision for optimistic concurrency locking to prevent overwrite races; on revision mismatch returns 409 Conflict. Safe partial patch: unspecified styling tokens are preserved. Returns updated Brand with incremented revision.
Inputs: brandId (required), baseRevision (required), name, colors, +4 more. Returns: brandId, revision
update_imageUpdate imageA
Update metadata fields (such as human-readable name or rightsStatus) for an existing image asset by imageId. Call to rename images or change categorization tags. Do NOT use to record legal commercial compliance attestations (use attest_image instead) or to replace image binary pixels (use import_image to upload a new asset). Requires workspace owner authorization. Safe partial update: only provided fields are modified. Returns updated Image asset record.
Inputs: imageId (required), name, rightsStatus. Returns: name, imageId, rightsStatus
update_slideshow_runUpdate slideshow runA
Partially update slide copy, slot bindings, layout, styling, or brand settings of an existing Slideshow Run by runId. Call get_slideshow_run first to obtain current revision and slide data. Do NOT use to create new runs (use create_slideshow_run) or delete runs (use delete_slideshow_run). Safe partial patch: unspecified fields are preserved. Requires baseRevision for optimistic concurrency locking; on revision mismatch returns 409 Conflict (no auto-merge), requiring a fresh get_slideshow_run. To patch a single slide, provide pageIndex (0-indexed) with slots, layout, or style. To update entire deck, provide pack. Returns updated SlideshowRun with incremented revision number.
Inputs: runId (required), pack, post, slots, +8 more. Returns: runId, revision, studioUrl
update_template_draftUpdate authoring draftA
Update layer AST, slot definitions, selection metadata, or theme tokens of an existing template authoring draft by draftId. Call iteratively to refine draft layout and slot contracts during authoring. Do NOT use to create new drafts (use create_template_draft), view draft AST (use get_template_draft), or release to public catalog (use publish_template_draft). Requires draft owner authorization. Performs safe partial patch: unmentioned properties remain untouched. Automatically triggers layout rule validation on save; returns validation warnings if constraints are breached. Returns updated TemplateDraft record with latest validation status and AST snapshot.
Inputs: draftId (required), name, theme, authoringSource, +1 more. Returns: id, validationStatus
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 36 tools
Tools are mostly cleanly separated by resource and action, and descriptions explicitly disambiguate risky pairs such as archive vs delete and import_image vs import_template_image. Some boundary confusion remains between published templates and template drafts, and between the two image-import paths, but documentation largely mitigates it.
Names consistently use snake_case with verb-first resource naming: list_/get_/create_/update_/delete_/archive_/restore_ patterns are repeated across resources. Minor variations like search_icons and create_template_preview_job still fit the same readable convention.
The 36 tools span template catalog, template drafts, slideshow runs, brands, images, gradients, and icons, so many are justified individually. However, this is a heavy surface for one server and exceeds the streamlined 3–15 range, forcing the agent to navigate many resource families and lifecycle operations.
Coverage is strong for the core lifecycle: brands, images, slideshow runs, and template drafts have create/read/update/delete plus archive/restore where relevant, and catalog resources are sensibly read-only. Minor gaps exist around polling/result retrieval for create_template_preview_job and lifecycle management for published templates, though those may be intentional.
Maintenance
Related MCP Connectors
Turn a URL, YouTube video or text into a branded LinkedIn/Instagram carousel PDF. No key needed.
Plan, write, render and schedule short-form social videos, carousels and threads for your brand.
Carousel assistant: your AI writes the slides, Karou renders Instagram, LinkedIn, TikTok carousels.
Finished TikTok/Instagram carousels from a topic, photos or video. Edit any layer, export PSD/SVG.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables creation of optimized LinkedIn posts using a component-based design system with variants, themes, and composition patterns. Supports multiple post types (text, document, poll, video, carousel) with research-backed optimization for maximum engagement.3Apache 2.0
- AlicenseAqualityDmaintenanceMCP server that turns articles, transcripts, and markdown into LinkedIn carousel PDFs, Instagram PNGs, and Threads PNGs. Content in, slides out. No web UI, no cloud service.53MIT
- AlicenseAqualityDmaintenanceAI-powered social media posting across 14 platforms. Post to Twitter, Instagram, TikTok, Facebook, LinkedIn, YouTube and more with one command. AI adapts content per platform, schedules posts, and generates 30-day content calendars.6MIT
- AlicenseAqualityDmaintenanceConverts text or markdown into Xiaohongshu (Little Red Book) style image cards with AI cover generation, supporting multiple themes and aspect ratios.417 npm2MIT