Sync Socials Agent

Let your AI agent run your social media. Sync Socials is a hosted MCP server for compatible AI agents, including Claude Code, OpenClaw and Codex. It provides tools to generate content, import media, create drafts, schedule posts and publish to supported social platforms.

Website · For AI agents · App · Partner program

For ChatGPT, follow the published app setup guide. For Claude Chat and Cowork, follow the plugin setup guide or read the plugin documentation. These connections use account authorization. The API-key setup below is for compatible agent clients.

Additional client packages:

• Cursor and Grok Bot: publisher application submitted October 8, 2026; review pending.
• Grok Build: source plugin and setup; official marketplace submission awaiting review.
• Gemini CLI: installable extension with a sensitive API-key setting. This is separate from the consumer Gemini app catalog.

See distribution status and routes for verified listing states, validation limits, and remaining submission steps.

The Muse connector is in review, not yet publicly available. See the Muse reviewer guide for authentication, tool effects, limits and validation steps.

---

Install

npx skills add DamianoTobasco/sync-socials-agent -g

The skill uses the open Agent Skills format. Your client must also support the remote MCP connection below to call Sync Socials tools.

Connect the MCP server

The server is remote, so there is nothing to run locally.

Your client needs remote Streamable HTTP and the authentication method below. Directory availability and successful sign-in are separate from protocol support; not every agent or client version has been tested. Installing the skill does not connect a Sync Socials workspace or social account automatically.

Endpoint	https://app.sync-socials.com/api/mcp
Transport	Streamable HTTP
Auth	Authorization: Bearer <SYNC_SOCIALS_API_KEY>

Create or use your workspace API key in settings at app.sync-socials.com. An eligible plan with API access is required; a free 7 day trial is available. Growth supports one active key. Replacing or revoking it also affects other clients using that key. The key grants workspace read/write access, including publishing, and has no automatic expiry.

{
  "name": "sync-socials",
  "transport": "streamable-http",
  "url": "https://app.sync-socials.com/api/mcp",
  "headers": {
    "Authorization": "Bearer <SYNC_SOCIALS_API_KEY>"
  }
}

For OpenClaw compatible CLIs:

openclaw mcp set sync-socials '{"url":"https://app.sync-socials.com/api/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer <SYNC_SOCIALS_API_KEY>"}}'

Create your first draft

After connecting, ask your agent:

Read my Sync Socials workspace, then create an untargeted draft titled "Getting started" with the caption "Our first post is coming soon." Return its draft ID so I can open it in Sync Socials.

This uses syncsocials_get_workspace and syncsocials_create_content_draft. It needs no social account or AI-generation provider. Open the saved draft, edit it for your business, then connect a destination in the app when you are ready to schedule or publish.

Tools

Tool	What it does
syncsocials_get_workspace	Read workspace settings, timezone, plan limits, publishing capabilities, and X eligibility/usage
syncsocials_list_connections	List connected social accounts and their IDs
syncsocials_list_media	Browse the media library
syncsocials_upload_media_from_url	Upload media from an HTTPS URL
syncsocials_upload_media_from_local_file	Import from allowed server-local paths for eligible API-key clients; cannot read an arbitrary client device's files
syncsocials_create_content_draft	Save an untargeted content concept for later
syncsocials_get_brand_profile	Read saved business profiles
syncsocials_generate_viral_concepts	Generate content concepts from a brand brief
syncsocials_produce_viral_video	Assemble a short video from a concept, existing footage, text and music
syncsocials_create_post	Create a draft or scheduled post with platform targets
syncsocials_get_post	Read a single post
syncsocials_list_posts	List drafts, scheduled and published posts
syncsocials_update_post	Edit content, targets, timing or media
syncsocials_publish_post	Publish an existing draft now
syncsocials_delete_post	Delete a draft or cancel a scheduled post

Example prompts

Once connected, talk to your agent normally:

• Post this Reel to TikTok, Instagram, Facebook and YouTube Shorts at 6pm.
• Queue five posts from the drafts folder across this week at 9am.
• Generate a month of content from sync-socials.com and schedule the best twelve.
• What is scheduled for the rest of the week? Move Friday's post to Saturday morning.

Platforms

Platform	Support
TikTok	Direct post and scheduling
Instagram	Image and video posts to a business or creator account linked to a Facebook Page
Facebook	Text, image and video posts to Pages; personal profiles are unsupported
YouTube	Video only, exactly one video asset per post, privacy control
LinkedIn	Text, image and video posts to personal profiles
Telegram, Discord, Slack	Posts to connected chat destinations, within their media limits
X / Twitter	Text, up to four photos, or one video; active paid Growth only, with separate attempt and usage limits

X is available through the same MCP endpoint and post tools. Read xUsage and postingCapabilities from syncsocials_get_workspace, then the selected account's capabilities from syncsocials_list_connections. Trials and unpaid review access exclude X. The default workspace allowance is 50 X attempts per month, 10 per day, including 3 link-post attempts per month; each stable X account also has 30 monthly and 3 daily attempts shared across workspaces. Reserved failures count, and media can exhaust the included usage budget sooner. Check the returned usage and UTC reset times before planning a batch.

X captions allow 280 weighted characters including overrides and hashtags. Posts support up to four photos or one MP4 video up to 140 seconds and 50 MiB after processing. GIFs, threads, and DMs are unsupported. Never automatically retry an ambiguous publish result; inspect the saved post and actual destination first. See the agent workflow.

New and existing customers can connect Facebook Pages and linked Instagram professional accounts after Meta approval. Each customer must grant publishing access and select the intended accounts in Sync Socials Connections.

Safety

• The skill defaults to creating drafts. It only schedules or publishes when you clearly ask.
• Access is scoped to an API key you generate and can revoke at any time.
• Social accounts connect through each platform's official OAuth login. Sync Socials never sees your passwords.
• Never commit your API key. Store it in your agent's MCP config or secret storage.

Content generation also depends on available tools and providers. Generation performed by your agent uses that runtime's capabilities; hosted Sync Socials concept generation needs a configured workspace AI provider and uses its allowance. Video assembly combines existing footage, text and music. Do not assume an agent subscription includes every hosted generation feature.

Partners

If you make tutorials or help clients connect their agents, the Sync Socials partner program offers 30% recurring commission on eligible subscription revenue, subject to its terms. Use an issued partner link and disclose the commercial relationship. A listing, installation or ordinary campaign URL does not automatically earn commission.

REST fallback

If MCP is unavailable, the same operations are available over REST at https://app.sync-socials.com/api/v1 using the same bearer token:

POST   /media/uploads
GET    /posts
POST   /posts
GET    /posts/:id
PATCH  /posts/:id
DELETE /posts/:id
POST   /posts/:id/publish

The same plan access, rate limits and usage limits apply to both MCP and REST.

License

MIT. See LICENSE.