Skip to main content
Glama

EasySociable MCP Server

npm version License: MIT MCP

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.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:

Skill

Purpose

easysociable-slideshow

Topic → proven hook → structure → editable carousel, returned as a Studio link

easysociable-template

Design and publish reusable page templates from a brief or an image

easysociable-content

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@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:

  1. Call list_brands to load your saved Brand (name, handle, colors, fonts).

  2. Pick a proven structure from the Formula catalog (page 1 is its opening hook), then draft the copy.

  3. Call list_templates to choose a layout for each page.

  4. 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.

  5. 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



License

MIT © EasySociable

Available Tools

36 tools
archive_brandArchive brandA
Idempotent

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 imageA
Idempotent

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 runA
Idempotent

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 rightsA
Idempotent

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 brandA
Destructive

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 imageA
Destructive

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 runA
Destructive

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 draftA
Destructive

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 brandA
Read-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 gradientA
Read-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 imageA
Read-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 runA
Read-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 templateA
Read-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 draftA
Read-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 brandsA
Read-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 gradientsA
Read-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 imagesA
Read-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 runsA
Read-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 draftsA
Read-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 templatesA
Read-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 brandA
Idempotent

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 imageA
Idempotent

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 runA
Idempotent

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 iconsA
Read-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

    A3.9/5.0

    Scored across 36 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers