sync-socials-agent

# 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](https://sync-socials.com) · [For AI agents](https://sync-socials.com/ai-social-media-agent.html) · [App](https://app.sync-socials.com) · [Partner program](https://sync-socials.com/referral.html)

For ChatGPT, follow the [published app setup guide](https://sync-socials.com/chatgpt.html).
For Claude Chat and Cowork, follow the [plugin setup guide](https://sync-socials.com/claude.html)
or read the [plugin documentation](plugins/claude-sync-socials/README.md).
These connections use account authorization. The API-key setup below is for
compatible agent clients.

Additional client packages:

- [Cursor and Grok Bot](plugins/cursor-sync-socials/README.md): publisher
  application submitted October 8, 2026; review pending.
- [Grok Build](plugins/grok-sync-socials/README.md): source plugin and setup;
  [official marketplace submission](https://github.com/xai-org/plugin-marketplace/pull/1309)
  awaiting review.
- [Gemini CLI](docs/gemini-setup.md): installable extension with a sensitive
  API-key setting. This is separate from the consumer Gemini app catalog.

See [distribution status and routes](docs/distribution.md) 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](docs/muse-review.md) for authentication, tool effects,
limits and validation steps.

---

## Install

```bash
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](https://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.

```json
{
  "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:

```bash
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](skills/sync-socials-agent/SKILL.md#x-publishing).

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](https://sync-socials.com/referral.html) 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:

```text
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](LICENSE).