Skip to content

The Socifyr MCP server exposes 11 tools, each mapping to a common SDK operation.

Discovery ​

ToolPurpose
list_connectionsList connection slugs
list_mediaList media library items (returns IDs reusable in post_image/post_video)

Posting ​

ToolPurpose
post_textPublish text
post_imagePublish one or more images
post_videoPublish a video
schedule_postSchedule a post for later (text-only)

Status & management ​

ToolPurpose
check_post_statusGet the current status + per-channel results
retry_postRetry failed channels
publish_draftPublish a saved draft
get_post_analyticsPer-platform engagement metrics
delete_mediaRemove media library items

post_text ​

json
{
  "connections": ["linkedin-myhandle", "x-myhandle"],
  "caption": "Just shipped 🚀",
  "firstComment": "Some hashtags here"
}

caption is the post text. firstComment is optional (X, LinkedIn, Facebook).

post_image ​

json
{
  "connections": ["instagram-mybrand"],
  "images": [
    "6a04f715d3d7d93575e65d13",
    "https://cdn.example.com/banner.png"
  ],
  "text": "New product banner",
  "contentFormat": "photo_carousel"
}

images[] accepts media library IDs (24-char hex) or public URLs.

post_video ​

json
{
  "connections": ["tiktok-me", "instagram-mybrand"],
  "video": "6a04f715d3d7d93575e65d13",
  "text": "Behind the scenes",
  "contentFormat": "short_video"
}

schedule_post ​

json
{
  "connections": ["linkedin-myhandle"],
  "caption": "Tomorrow at 9",
  "scheduledAt": "2026-06-01T09:00:00Z"
}

Text-only scheduling. For scheduled media, create a draft and publish it at the target time from code.

check_post_status ​

json
{ "postId": "6a05032a84584482ace13d5f" }

Returns a formatted summary like:

Post 6a05032a84584482ace13d5f
Status: partial_failure

  ✓ linkedin → https://linkedin.com/...
  ✗ x (rate limit exceeded)

retry_post ​

json
{ "postId": "6a05032a84584482ace13d5f" }

publish_draft ​

json
{ "postId": "6a05032a84584482ace13d5f" }

list_media ​

json
{ "type": "image", "search": "banner", "limit": 10 }

delete_media ​

json
{ "ids": ["6a04f715d3d7d93575e65d13"] }

get_post_analytics ​

json
{ "postId": "6a05032a84584482ace13d5f" }

Returns per-platform engagement (likes, comments, shares, impressions).