Socifyr MCP
Enables publishing text, image, and video posts to connected Bluesky accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing text, image, and video posts to connected Facebook accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing photos, carousels, stories, and videos to connected Instagram accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing text, image, and video content to connected Pinterest accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing text, image, and video posts to connected Reddit accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing text, image, and video posts to connected Threads accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing videos and text posts to connected TikTok accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Enables publishing videos and shorts to connected YouTube accounts, scheduling posts, retrying failed channels, and retrieving post analytics and follower growth data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Socifyr MCP Post 'Just shipped our new docs' to my X and LinkedIn"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@socifyr/mcp
MCP (Model Context Protocol) server that lets AI assistants publish to social media through Socifyr. Powered by @socifyr/sdk over stdio.
Supported platforms: Instagram, Facebook, X (Twitter), LinkedIn, TikTok, YouTube, Threads, Pinterest, Reddit, Bluesky
Setup
The server is configured entirely via environment variables:
Variable | Required | Description |
| ✅ | API key ( |
| — | Custom API URL (self-hosted); defaults to the hosted API |
The API key belongs to one workspace, and the server always works in that workspace.
Claude Desktop
Add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"socifyr": {
"command": "npx",
"args": ["-y", "@socifyr/mcp"],
"env": {
"SOCIFYR_API_KEY": "sk_..."
}
}
}
}Claude Code
claude mcp add socifyr \
--env SOCIFYR_API_KEY=sk_... \
-- npx -y @socifyr/mcpFrom the monorepo (unpublished)
cd packages/mcp
pnpm install
pnpm run buildThen point your client at node with the absolute path, e.g. for Claude Code:
claude mcp add socifyr \
--env SOCIFYR_API_KEY=sk_... \
-- node /path/to/socifyr/packages/mcp/dist/index.jsThe server speaks newline-delimited JSON-RPC over stdio (initialize → tools/list → tools/call), so it works with any MCP client.
Related MCP server: PostMCP MCP Server
Tools
list_connections
List connected social accounts and their slugs. Call this first — posting tools need slugs from here.
"What accounts can I post to?"
Connected accounts (3):
• youtube-black-curtains — youtube / Black Curtains
• tiktok-rebuild-nepali-root — tiktok / rebuild.nepali.root
• instagram-socifyr-post — instagram / socifyr.post (expires 10/28/2026)
Use these slugs in the "connections" field when posting.post_text
Post text immediately.
Input | Type | Description |
| string | The text to post |
| string[] (≥1) | Connection slugs |
| string? | Optional first comment (e.g. hashtags) |
"Post 'Just shipped our new docs 🚀' to my X and LinkedIn, with hashtags as a first comment"
Post submitted successfully!
ID: 6b1f0c2a9d3e4f5a6b7c8d9e
Request ID: 9f2c7a1e-3d44-4b2a-8e1f-0a5c2d7e9f10
Check results with: check_post_status tool using ID "6b1f0c2a9d3e4f5a6b7c8d9e"schedule_post
Schedule a text post for later.
Input | Type | Description |
| string | The text to post |
| string[] (≥1) | Connection slugs |
| string | ISO 8601 datetime, e.g. |
| string? | Optional first comment |
"Schedule 'Happy Monday!' for June 15 at 9am UTC on my X account"
Post scheduled for 6/15/2026, 9:00:00 AM
ID: 6b1f0c2a9d3e4f5a6b7c8d9e
Connections: x-myhandlecheck_post_status
Check publishing status by ID (upload ID, draft ID, or requestId).
Input | Type | Description |
| string | The ID returned from |
"Did my last post go through?"
Post 6b1f0c2a9d3e4f5a6b7c8d9e
Status: partial_failure
✓ youtube → https://youtube.com/shorts/6zaztTmk3Ck
✗ instagram (Requires instagram_content_publish permission)post_image
Post images.
Input | Type | Description |
| string[] (≥1) | Connection slugs |
| string[] (1–10) | Public image URLs or media library IDs (24-char hex ObjectIds) |
| string? | Caption |
| string? | ISO 8601 — omit to post immediately |
| string? | Optional first comment |
| enum? |
|
"Post these two images to Instagram with the caption 'Behind the scenes'"
Submitted
ID: 6b1f0c2a9d3e4f5a6b7c8d9e
Images: 2
Connections: instagram-mybrandpost_video
Post a video.
Input | Type | Description |
| string[] (≥1) | Connection slugs |
| string | Public video URL or media library ID (24-char hex ObjectId) |
| string? | Caption |
| string? | ISO 8601 — omit to post immediately |
| string? | Optional first comment |
| enum? |
|
"Post this video https://cdn.example.com/teaser.mp4 to TikTok and YouTube as a short"
Submitted
ID: 6b1f0c2a9d3e4f5a6b7c8d9e
Connections: tiktok-mybrand, youtube-mybrandretry_post
Retry the failed channels of a partially/fully failed post.
Input | Type | Description |
| string | The post ID |
"Retry the failed channels on that post"
Retry queued
ID: 6b1f0c2a9d3e4f5a6b7c8d9e
Retried channels: 1
Check results with: check_post_status tool using ID "6b1f0c2a9d3e4f5a6b7c8d9e"publish_draft
Publish a saved draft immediately.
Input | Type | Description |
| string | The draft ID |
"Publish that draft now"
Draft published
ID: 6b1f0c2a9d3e4f5a6b7c8d9e
Request ID: 9f2c7a1e-3d44-4b2a-8e1f-0a5c2d7e9f10
Check results with: check_post_status tool using ID "6b1f0c2a9d3e4f5a6b7c8d9e"get_post_analytics
Per-platform analytics and engagement for one post.
Input | Type | Description |
| string | Post ID or requestId |
"How is my YouTube short performing?"
Post analytics: 6b1f0c2a9d3e4f5a6b7c8d9e
Status: completed
✓ youtube → https://youtube.com/shorts/6zaztTmk3Ck | likes: 12, comments: 3, impressions: 480get_follower_growth
Follower/subscriber growth per connected account. Counts are captured once a day; LinkedIn and TikTok can't report followers.
Input | Type | Description |
| enum? |
|
| string? | Only this account, by slug |
| string? | Only this platform |
"How many followers did we gain this quarter?"
Follower growth 2026-08-12 → 2026-11-12
Total: 5340 followers, +212
· x-mybrand: 4200 followers, +180 (+4.48%)
· bluesky-mybrand: 1140 followers, +32 (+2.89%)
· linkedin-me: follower count not available on linkedincompare_accounts
Side-by-side account comparison for a window: followers and change, posts, engagement, engagement per post, engagement rate and per-follower engagement. Sorted by engagement. Same inputs as get_follower_growth.
"Which of my accounts performed best last month?"
Account comparison 2026-10-12 → 2026-11-12
· x-mybrand [x]: 4200 followers (+180), 12 posts, 424 engagement (35.33/post), 2.02% rate, 0.84% per follower
· bluesky-mybrand [bluesky]: 1140 followers (+32), 9 posts, 150 engagement (16.67/post), 0% rate, 1.46% per followerlist_media
List media library items — the IDs are reusable in post_image / post_video without re-uploading.
Input | Type | Description |
| enum? |
|
| string? | Search by filename |
| int? (1–100) | Max results (default 20) |
"Show me the videos in my media library"
Media library (2 total):
• 6a93a4bfaa1135c3d8dd3df5 — launch-teaser.mp4 (video, 8.4MB)
• 6a93b7c2d1e0f3a4b5c6d7e8 — demo-full.mp4 (video, 156.2MB)
Use these IDs in post_image or post_video "images"/"video" fields.delete_media
Delete one or more media items.
Input | Type | Description |
| string[] (≥1) | Media IDs to delete |
"Delete that old teaser video from the media library"
Deleted 1 media item: 6a93a4bfaa1135c3d8dd3df5generate_caption
Generate AI captions from a description, URL, or content brief.
Input | Type | Description |
| string | What to post about, or the raw content to work from |
| string[] (≥1) | Platform types for tone optimization, e.g. |
| enum? |
|
"Generate a casual caption about our new pricing page for LinkedIn and X"
Generated captions:
[linkedin]
...
---
[x]
...Notes
Slugs vs platform types: posting tools take connection slugs from
list_connections;generate_caption.platformstakes platform type enums ("linkedin","x", ...) for tone tailoring.Errors come back as tool results with
isError: trueand the API's message (e.g.Connection "x" not found), so the assistant can self-correct.The server exits with a clear stderr message if
SOCIFYR_API_KEYis missing.
Available Tools
20 toolscheck_post_statusC
Check the publishing status of a post by its ID.
Inputs: postId (required).
compare_accountsA
Compare connected accounts side by side for a time window: followers and follower change, posts published, total engagement (likes + comments + shares + saves), average engagement per post, engagement rate (engagement ÷ impressions) and follower engagement rate (avg engagement per post ÷ followers). Sorted by engagement.
Inputs: period, platform, connection.
delete_mediaC
Delete one or more items from the media library by their IDs.
Inputs: ids (required).
generate_captionB
Use AI to generate social media captions from a description, URL, or content brief.
Inputs: platforms (required), description (required), tone.
get_follower_growthA
Follower/subscriber growth per connected account over a time window: current count, change and percent change. Counts are captured once a day; LinkedIn and TikTok accounts cannot report followers.
Inputs: period, platform, connection.
get_post_analyticsC
Get detailed per-platform analytics and engagement metrics for a specific post.
Inputs: postId (required).
get_usageA
Show the workspace's current usage against its plan limits: posts this month, connected accounts, and storage. Check this before connecting accounts or posting to see remaining quota.
Inputs: no named parameters.
list_connectionsA
List all connected social media accounts and their slugs. Call this first to know which slugs to use when posting.
Inputs: no named parameters.
list_mediaA
List files in the media library. Returns IDs you can reuse in post_image or post_video without re-uploading.
Inputs: type, limit, search.
list_postsA
List your posts (drafts, scheduled, and published) with their IDs — use this to find a post to edit, publish, or check. Returns each post's ID, status, type, a text preview, schedule time, and target accounts.
Inputs: limit, status.
post_imageC
Post one or more images to social platforms. Accepts public image URLs or media library IDs (24-character hex MongoDB ObjectIds).
Inputs: images (required), connections (required), text, scheduledAt, +2 more.
post_textB
Post text content to one or more connected social media accounts immediately.
Inputs: caption (required), connections (required), firstComment.
post_videoB
Post a video to social platforms. Accepts a public video URL or a media library ID (24-character hex MongoDB ObjectId).
Inputs: video (required), connections (required), text, scheduledAt, +2 more.
publish_draftC
Publish a saved draft immediately.
Inputs: postId (required).
reconnect_connectionA
Get a short-lived, single-use link to re-authorize an account whose token expired or cannot refresh (status "needs_reconnect", or a post failed with "reconnect_required"). Give the link to the user to open in a browser; the account and its slug are updated in place, so scheduled posts keep working. After they approve, retry the post. Owner-only.
Inputs: connection (required).
refresh_connectionA
Renew an account's access token without the owner (use when list_connections shows "expiring" or a post failed with an expired/invalid token). Works only for accounts that can refresh; if it fails, call reconnect_connection.
Inputs: connection (required).
retry_postA
Retry publishing failed channels for a post that partially or fully failed.
Inputs: postId (required).
schedule_postC
Schedule a text post to publish at a specific date and time.
Inputs: caption (required), connections (required), scheduledAt (required), firstComment.
schedule_postsA
Schedule MANY text posts in one call (bulk). Each item becomes its own scheduled post. Returns how many were created and any per-item errors. Use this instead of calling schedule_post repeatedly.
Inputs: posts (required).
update_postA
Edit an existing draft or scheduled post — change its text, media, schedule, or which accounts it posts to. Only drafts and not-yet-published scheduled posts can be edited. IMPORTANT: "connections" is a FULL REPLACEMENT of the target accounts, not a delta — to add or remove one account, pass the complete desired set of slugs (use list_posts / list_connections first to see the current ones).
Inputs: postId (required), text, title, mediaIds, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a distinct resource and action, and potential overlaps are explicitly clarified (schedule_post vs. schedule_posts, refresh_connection vs. reconnect_connection). Posting tools are cleanly separated by content type and timing, while analytics tools differ by granularity and scope.
All 20 tools use a consistent snake_case verb_noun pattern such as list_connections, post_text, get_post_analytics, and update_post. The few longer names like check_post_status remain readable and follow the same convention.
At 20 tools this is on the higher end for a social publishing server, but each tool maps to a distinct operation and the bulk scheduling tool reduces the need for redundant repeated calls. The surface is broad but not padded with obvious duplicates.
The set covers connection management, posting, scheduling, drafts, retries, media listing/deletion, analytics, usage, and caption generation, which is a strong lifecycle surface. Minor gaps remain: there is no media upload tool, no post deletion tool, and no comment/engagement-response operations.
Maintenance
Related MCP Connectors
Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.
Lets Claude and AI agents post and schedule on Instagram, TikTok, LinkedIn and 5 more networks.
Schedule and publish social posts from your AI to Facebook, Instagram, TikTok and more.
Schedule and publish posts and short videos to every major social platform from any AI agent.
Related MCP Servers
- AlicenseAqualityBmaintenanceOfficial MCP server for PostEverywhere (posteverywhere.ai/social-media-scheduler). Let Claude, ChatGPT, Cursor or any MCP client schedule and publish posts to 13 platforms: Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram, Discord, WordPress and Google Business Profile. 40 tools: best-time scheduling, threads, cross-posting, campaigns, analytics.33289 npm7MIT

PostMCP MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.754 npmMIT
AdaptlyPostofficial
AlicenseAqualityBmaintenanceGives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.82MIT- AlicenseNot gradedqualityCmaintenanceEnables AI agents to publish posts to Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube and Pinterest. Includes a free trial key that simulates publishing and returns a preview link, so it can be tested without registration.MIT