Sync Socials

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.

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

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

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.