Socialync

io.github.JackVitickPublished by GitHub account JackVitickv1.1.0Updated Oct 24, 2026

Draft, schedule, and publish posts to 8 social platforms with human approval via Socialync OAuth.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationData & Analytics

Overview

AI-generated overview

Hosted Socialync MCP server that lets an assistant draft, schedule and publish social posts to eight platforms and read back analytics, with approval in chat.

What you can do
  • List brand profiles, connected accounts, saved audiences and media library items, and upload images or videos
  • Validate a post before publishing and check plan quota, remaining posts and per-platform caps
  • Create drafts, schedule or publish text, image and video posts, including long-form X Articles
  • Review, reschedule, edit or cancel scheduled posts and check published post history
  • Read analytics: totals, top posts, per-post insights, comments, best posting times and follower growth
  • Reply to comments on supported platforms and generate AI captions on paid plans
When to use it
Useful for creators and small teams who cross-post to TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Threads and Bluesky and want an assistant to plan, draft and queue content from performance data. Also handy for weekly analytics reviews and queue checks.
Requirements
A remote Streamable HTTP endpoint; nothing to install locally. A Socialync account with OAuth 2.1 sign-in (preferred, browser-based, choose which brands the agent may manage), or a Bearer API key in the Authorization header for clients that cannot do OAuth. Network access to the hosted service.
Before you install
Publishing, scheduling and approving drafts send content to public social accounts; the server asks for confirmation in chat and marks those tools destructive, but review each post before approving. A Bearer API key grants posting rights and should be kept secret and never committed. Free plan allows 5 posts a month on 7 platforms; X and analytics need paid plans. AI caption generation is limited per day on paid plans.

Installation

In SourceWeft

  1. Open Socialync in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.JackVitick%2Fsocialync/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "socialync": {
      "type": "http",
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

README

Socialync MCP Server

[Socialync]

Official documentation, registry manifest, and Cursor plugin for the Socialync hosted MCP server. Socialync is a cross-posting and scheduling tool for creators: upload once, publish to TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Threads, and Bluesky.

This MCP server lets Claude, ChatGPT, Cursor, Google Antigravity, Gemini CLI, OpenAI Codex, Grok Bot, and any MCP-compatible AI agent draft, schedule, and publish social media posts through your own OAuth-authorized Socialync account, with human-in-the-loop approval built into the workflow. It also reads back your analytics (views, likes, comments, shares, saves, followers, and your best and worst posts), so an agent can plan next week's content from what actually performed.

Every platform integration runs on the official platform API. No browser automation, no scraping, no unofficial endpoints. Your agent cannot get your account restricted on our behalf.

Duplicate protection means a retry can never publish twice, and failed posts are retried automatically. Both matter when an agent is doing the posting.

Note: Socialync's server is hosted (remote) and closed source. This repository contains the documentation, the MCP Registry manifest, and the Cursor plugin files only. There is nothing to install or run from here.

Endpoint

https://mcp.socialync.io/mcp

Transport: Streamable HTTP. Discovery document (tools, platforms, auth, limits, as JSON): https://mcp.socialync.io/.well-known/mcp

MCP and API access are on the free plan. $0, no credit card, 5 posts a month on 7 platforms (X is on paid plans). Your agent can connect and publish without anyone reaching for a card. Paid plans start at $20/month for unlimited posts and 5 connected accounts (Starter $20, Creator $30 for 10 accounts, Agency $99 for 100, extra accounts from $2 a month). Plans and pricing.

Limits worth knowing: 1 API key per brand, and 10 AI-created posts per day per brand on paid plans (5 on free).

Authentication, two ways

A) OAuth 2.1 (preferred). Add the URL with no headers. Your client registers itself (dynamic client registration, PKCE, no client secret), opens a browser, and you sign in with your Socialync account and choose which brands the agent may manage. This is what Claude.ai, Claude Code, Cursor, ChatGPT, Google Antigravity, Gemini CLI, and Codex do on their own.

B) Bearer API key. For clients that cannot complete a browser OAuth flow (Grok Bot, headless agents, hand-edited config files). Generate a key at https://www.socialync.io/go/github-api-keys and send Authorization: Bearer <key>. One key per brand, included on every plan. Never commit the key.

OAuth callbacks known to work end to end (any https redirect URI plus http://localhost and http://127.0.0.1 on any port is accepted):

Connect

Claude (claude.ai): Socialync is listed in Claude's connector directory. Open Settings, then Connectors, then Browse connectors, search Socialync and sign in. To add it by URL instead, choose "Add custom connector" and paste the endpoint above. Full walkthrough: Socialync MCP connector guide.

Claude Code:

bash
claude mcp add --transport http socialync https://mcp.socialync.io/mcp

Cursor / Grok Bot (OAuth, url only):

json
{  "mcpServers": {    "socialync": {      "url": "https://mcp.socialync.io/mcp"    }  }}

Grok Bot or any client that cannot complete OAuth (Bearer key):

json
{  "mcpServers": {    "socialync": {      "url": "https://mcp.socialync.io/mcp",      "headers": {        "Authorization": "Bearer YOUR_SOCIALYNC_API_KEY"      }    }  }}

Grok Bot runs OAuth from Cursor's cloud, not your machine. The same URL can work in the Cursor IDE and fail in Grok Bot. Test in Grok Bot under Settings, then Plugins, not only in the IDE. If OAuth never starts or you see "fetch failed", use the Bearer key form.

Google Antigravity: add this to ~/.gemini/config/mcp_config.json (or .agents/mcp_config.json in a workspace). Antigravity uses serverUrl and handles the OAuth sign in itself through dynamic client registration.

json
{  "mcpServers": {    "socialync": {      "serverUrl": "https://mcp.socialync.io/mcp"    }  }}

Gemini CLI: install the extension, then run /mcp auth socialync.

bash
gemini extensions install https://github.com/JackVitick/socialync-mcp

Or add this to ~/.gemini/settings.json yourself:

json
{  "mcpServers": {    "socialync": {      "httpUrl": "https://mcp.socialync.io/mcp"    }  }}

OpenAI Codex CLI:

bash
codex mcp add socialync --url https://mcp.socialync.io/mcpcodex mcp login socialync

ChatGPT: turn on developer mode and add a custom connector with the endpoint URL. Which ChatGPT plans can add custom connectors has changed over time, so check OpenAI's developer mode help page for yours.

OpenClaw:

bash
openclaw mcp add socialync --url https://mcp.socialync.io/mcp --transport streamable-httpopenclaw mcp login socialync

Other MCP clients (generic config):

json
{  "mcpServers": {    "socialync": {      "type": "streamable-http",      "url": "https://mcp.socialync.io/mcp"    }  }}

Claude Code plugin

This repository is a Claude Code plugin and its own plugin marketplace. It adds the hosted server (.mcp.json, no secrets) and the skills below.

/plugin install socialync --marketplace JackVitick/socialync-mcp

On Claude Code versions before 2.1.275, use two steps:

/plugin marketplace add JackVitick/socialync-mcp/plugin install socialync@socialync

Sign in opens in your browser the first time a Socialync tool runs. Setup notes: SETUP.md. To skip the plugin, add the server directly (see Claude Code under Connect).

Skills

Six skills teach an agent to use the server well. Every one of them asks you to approve each post before it goes out.

SkillWhat it does
schedule-social-postDraft, schedule or publish to 8 platforms, with your yes on every post
film-once-week-of-shortsOne filming session becomes a week of TikTok, Reels and Shorts
blog-to-a-week-of-postsOne article becomes a week of LinkedIn and X posts, link in the first comment
weekly-what-workedWeekly review from your analytics, plus next week's ideas
notes-to-carouselNotes become a rendered image carousel for Instagram, LinkedIn and Threads
social-queue-analyticsCheck, move or cancel what is scheduled, and see why a post failed

Install them:

  • Claude Code: the plugin above.
  • Cursor, Codex, Windsurf, Gemini CLI and other agents: npx skills add JackVitick/socialync-mcp
  • OpenClaw: openclaw skills install @jackvitick/socialync
  • Claude (web and desktop): download a skill folder, zip it, then go to Customize, Skills, the + button, Create skill, Upload a skill. Code execution has to be on (Settings, Capabilities).

The skills are optional guidance. The server works without them.

Cursor and Grok Bot plugin

This repository is also the Cursor plugin (.cursor-plugin/plugin.json, mcp.json, skills/, assets/logo.png). Install from the Cursor Marketplace (search "Socialync") once listed, or add the MCP URL directly as above. Skills in skills/ tell the agent how to draft, schedule, plan a week of posts, or inspect the queue. Submission checklist: MARKETPLACE-SUBMIT.md.

Tools

Twenty-eight tools. The same list is published at https://www.socialync.io/.well-known/mcp.

ToolWhat it does
list_profilesList your Socialync brand profiles (call first; every write takes a profileId)
list_connectionsShow which social accounts are connected and healthy
list_audiencesList saved audiences a post can target
list_mediaBrowse media already in Socialync, with the mediaId used to attach video
create_media_upload / finalize_media_uploadUpload images or a generated video
import-claude-motion-from-urlBring a Claude Motion video into your library, ready to post
check_quotaPlan, remaining posts, per-platform daily caps, scheduling window
validate_postRead-only preflight: caption length, links, media, aspect ratio, video duration, connection health
create_post_draftHold a text or image post as a draft until you say yes in chat
schedule_post_draftHold a post for a future time (text, image, or video) as a draft until you say yes in chat
get_draft_statusCheck where a draft is in the pipeline
approve_draftPublish a pending draft after you confirm in chat
publish_nowPublish a text or image post immediately, after you confirm in chat
publish_scheduledSchedule a post directly, including video to TikTok and YouTube, after you confirm in chat
create_x_article_draft / publish_x_article_nowLong-form X Articles (X Premium account required)
get_scheduled_postsList upcoming scheduled posts
update_scheduled_postChange a scheduled post's time, caption, title or first comment, or drop a platform
delete_scheduled_postCancel a scheduled post
get_post_historyReview published post history and status
get_top_postsSurface your best-performing content, with watch time and 3 second hold on videos
get_post_insightsOne post in depth: retention curve, biggest drop, every platform side by side (interactive chart in apps-capable clients)
get_commentsRead a post's comments and replies
reply_to_commentReply to one comment after you confirm in chat (Instagram, Threads, LinkedIn Pages, Bluesky)
get_best_timesYour best posting windows per platform, from your own history
get_analyticsPull follower and engagement analytics
generate_contentGenerate platform-native captions with AI (paid plans)

Text and image posts publish immediately to Instagram, Facebook, X, LinkedIn, Threads, and Bluesky. Video posts, including TikTok and YouTube (title required), go out as scheduled posts using media hosted in your Socialync library or a public video URL. A raw video file cannot be pasted into a chat; upload it in Socialync first.

Full reference, including recommended call order, per-platform limits, and error handling: docs/tools.md.

Analytics through MCP

Socialync collects post and account analytics for TikTok, YouTube, Instagram, Facebook, Threads, and Bluesky, and the MCP server returns the same numbers the Socialync analytics page shows (paid plans).

  • get_analytics returns totals for views, likes, comments, shares, saves, and followers over the last week or month, the change against the previous period, an optional per-platform breakdown, and an optional daily timeseries for charts.
  • get_top_posts returns your posts with views, likes, comments, shares, engagement rate, and a performance status (viral, good, average, flop), sorted by engagement or by date, filterable by platform and by minimum status.
  • get_post_history returns what was posted where, with a plain reason and a retry hint for anything that failed.

Bluesky reports engagement but not views, so its posts are rated on engagement alone.

Example workflows

Paste these into any connected agent. Naming the tool is optional; it just makes the run easier to follow. Each skill above ends with a "Try it" prompt you can paste.

Plan the week from what worked

Use get_top_posts to pull my 5 best posts from the last 30 days and tell me what they have in common. Then give me 5 post ideas for this week in that style.

Write and schedule a week of posts

Write each idea as a post for TikTok, Instagram, LinkedIn, and Threads, with a caption that fits each platform. Run validate_post on every one, then schedule them as drafts Monday to Friday at 6pm my time and list them for me to approve.

Send one video everywhere

List my newest videos with list_media. Schedule the latest one to TikTok, Instagram Reels, and YouTube Shorts for tomorrow at 5pm. YouTube title: "How I edit a Short in 10 minutes". Show me everything before you schedule it.

Weekly report

Use get_analytics for the last week with breakdown by_platform. Tell me which platform grew, which slipped, and which post did best on each.

Check the queue

Show me next week's posts with get_scheduled_posts, and anything that failed this week with get_post_history.

How the human stays in the loop

Socialync tells every connected agent to show you the exact post (platforms, text for each one, media, time) and wait for your yes in chat before it calls publish_now, publish_scheduled or approve_draft. Those tools are marked as destructive, so clients like Claude ask your permission before running them. The skills in this repo do the same for batches: every post shown in full and numbered, and only the numbers you approve get published. For TikTok, the agent asks who can view each video (Everyone, Friends, Followers or Only me) and never picks for you. To review in the app instead, ask for a draft: create_post_draft and schedule_post_draft save it for you to approve in Socialync, and nothing goes out until you do.

For a second check run by Socialync itself, switch on the confirmation dialog in Socialync settings. Clients that support MCP elicitation then show you the post before it publishes, and a decline stops it.

Socialync publishes the exact content you approved and logs who approved each post and when. Posts go out through accounts you connected and can disconnect at any time. There is no unattended posting mode.

Links

Support

Questions or issues: open an issue here or email [email protected].

Follow Socialync

Source: README.md at commit 5931296

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts