Connect-MCP

io.github.ndesv21/socialclaw

io.github.ndesv21/socialclaw · v0.1.20

Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.

MCPremotelocal · npmAPI keySocial mediaMessaging

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 34 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 84/100

What it does: 34 tools · 22 read, 12 write (incl. delete/pay) · Social media, Messaging

Test call list_accounts: needs a key: tool error: Sign in to SocialClaw to use this tool. OAuth clients (ChatGPT, Claude) link the account automatically; other clients se (776 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +6
  • Read/write annotations: +5
  • Safe test call: +8
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://getsocialclaw.com/mcp
Package
registry:   npm
identifier: socialclaw
version:    0.1.20
transport:  stdio

Tools

34 tools listed at last check
  • list_accounts List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, threads, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, youtube, reddit, wordpress).
  • account_capabilities Get publish capabilities and provider rules for connected accounts: what media is allowed, text limits, and whether publishing is currently possible. Pass accountId for one account, or provider to filter, or neither for all.
  • connect_account Start connecting one of the user's own social accounts to their SocialClaw workspace. For most providers this returns an authorizeUrl; give it to the user so they sign in with the provider themselves (SocialClaw never sees their password). Telegram and Discord have no sign-in page: Telegram takes th
  • upload_asset Add an image or video to the user's SocialClaw media library so it can be attached to a post. Pass exactly one of: file (a file the user attached in this chat), sourceUrl (a direct public http(s) link to the image or video file, not a web page), or contentBase64 (small files only). Files up to 1 GB
  • get_asset Get one media asset from the user's SocialClaw library by id, including its status (uploading, ready, or failed), import progress, and publicUrl. Use it after upload_asset returns status uploading, until the asset is ready.
  • validate_schedule Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
  • preview_campaign Preview how a campaign schedule document expands into concrete posts and steps without creating anything.
  • apply_schedule Create a publishing run from a schedule document. Posts are scheduled or published through connected accounts. Send an idempotencyKey so retries do not create duplicate runs.
  • publish_draft Publish a previously created draft run, optionally at a given ISO-8601 start time.
  • list_posts List posts in the workspace with optional filters.
  • list_assets List media (images/videos) the user has uploaded to their SocialClaw library, newest first. Each asset includes a publicUrl usable directly as media_link in validate_schedule/apply_schedule. Use this to find a previously uploaded file (e.g. from the dashboard) to post. Optionally filter by kind (ima
  • get_post Get one post including its delivery state and provider identifiers.
  • post_attempts List publish attempts for a post, including provider errors. Use this to debug failed posts.
  • retry_post Retry a failed post.
  • cancel_post Cancel a scheduled post before it publishes.
  • run_status Get the status summary of a publishing run and its posts.
  • get_analytics Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
  • refresh_analytics Fetch fresh analytics for a published post from the provider and store a new snapshot, then return it. Supported providers: Instagram, TikTok, YouTube, Reddit, X, Pinterest, Snapchat (others return an unsupported snapshot). Call this before get_analytics when you need current numbers rather than the
  • list_instagram_media List an Instagram account's recent posts (caption, permalink, timestamp, comment count) so you can find one to read or moderate comments on. account is the connected-account id or handle.
  • get_instagram_comments Read the comments and replies people left on one of the user's own Instagram posts, so the user can review and answer them. Use list_instagram_media first to get a mediaId.
  • reply_instagram_comment Reply to an Instagram comment on the user's media.
  • hide_instagram_comment Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
  • delete_instagram_comment Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
  • get_instagram_media_insights Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
  • get_instagram_profile Get an Instagram account's profile stats: followers, follows, media count, bio.
  • get_instagram_account_insights Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
  • react_instagram_message React to a received Instagram direct message (e.g. love).
  • list_instagram_mentions List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
  • list_instagram_conversations List the Instagram direct-message conversations for an account, most recent first. Each conversation includes `counterpart` (the other person's {id, username}) — use its id as the recipientId when replying; `participants` also lists the account itself.
  • get_instagram_messages Read the messages in an Instagram direct-message conversation.
  • send_instagram_message Send an Instagram direct message — a text reply, or an image/video attachment via attachment_url. Only allowed within 24 hours of the recipient's last message unless a message tag (e.g. HUMAN_AGENT) is supplied.
  • workspace_usage Get workspace usage counters and plan entitlement consumption.
  • workspace_health Get workspace health, including connection state across providers. Pass provider to check one provider's connections.
  • get_profile Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.

Badge

Connect-MCP badge for io.github.ndesv21/socialclaw

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.ndesv21/socialclaw.svg)](https://clawy.uk/mcp/s/io.github.ndesv21/socialclaw)

Repository · Website