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

Discovery

Tool	Purpose
list_connections	List connection slugs
list_media	List media library items (returns IDs reusable in post_image/post_video)

Posting

Tool	Purpose
post_text	Publish text
post_image	Publish one or more images
post_video	Publish a video
schedule_post	Schedule a post for later (text-only)
generate_caption	Use AI to draft captions

Status & management

Tool	Purpose
check_post_status	Get the current status + per-channel results
retry_post	Retry failed channels
publish_draft	Publish a saved draft
get_post_analytics	Per-platform engagement metrics
delete_media	Remove media library items

---

post_text

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

post_image

{
  "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

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

schedule_post

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

check_post_status

{ "postId": "6a05032a84584482ace13d5f" }

Returns a formatted summary like:

Post 6a05032a84584482ace13d5f
Status: partial_failure

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

retry_post

{ "postId": "6a05032a84584482ace13d5f" }

publish_draft

{ "postId": "6a05032a84584482ace13d5f" }

generate_caption

{
  "description": "Launching our new automation SDK",
  "platforms": ["linkedin", "x"],
  "tone": "professional"
}

Returns one caption per platform.

list_media

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

delete_media

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

get_post_analytics

{ "postId": "6a05032a84584482ace13d5f" }

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