socialclaw
Server Details
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- ndesv21/socialclaw
- GitHub Stars
- 110
- Server Listing
- socialclaw
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 34 tools
Most tools target distinct resources or actions, but the analytics surface has four overlapping tools (get_analytics, refresh_analytics, get_instagram_media_insights, get_instagram_account_insights) and post/run status tools require careful reading. Descriptions generally clarify boundaries, so an agent can still distinguish them.
Nearly all names use snake_case with predictable verb_noun or resource_noun patterns, and Instagram tools share a clear get_/list_/reply_ prefix. A few names like account_capabilities, workspace_health, run_status, and post_attempts omit a verb but remain readable and grouped consistently.
At 34 tools, the set is well above the 3-15 ideal and feels heavy for an agent to navigate. While the domain is broad, several Instagram-specific tools (four analytics tools, five comment tools, four message tools) could likely be consolidated.
Core publishing lifecycle (validate, apply, publish, cancel, retry, status) and Instagram engagement are well covered, including assets, analytics, comments, messages, and mentions. Gaps include no update/delete for posts or assets and no disconnect_account, but these are minor workarounds.
Available Tools
34 toolsaccount_capabilitiesAccount capabilitiesARead-onlyIdempotentInspect
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.
Inputs: provider, accountId.
apply_scheduleApply scheduleAInspect
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.
Inputs: schedule (required), idempotencyKey.
cancel_postCancel postBDestructiveIdempotentInspect
Cancel a scheduled post before it publishes.
Inputs: postId (required).
connect_accountConnect accountAInspect
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 the bot token and chat id of a bot the user created and made admin of their channel, and Discord takes a webhook URL the user created for their channel. Only pass values the user gave you for this purpose.
Inputs: provider (required), chatId, botToken, webhookUrl.
delete_instagram_commentDelete Instagram commentADestructiveInspect
Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
Inputs: account (required), commentId (required).
get_analyticsGet analyticsBRead-onlyIdempotentInspect
Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
Inputs: id (required), scope (required), window.
get_assetGet assetARead-onlyIdempotentInspect
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.
Inputs: assetId (required).
get_instagram_account_insightsGet Instagram account insightsARead-onlyIdempotentInspect
Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
Inputs: account (required), days, metric.
get_instagram_commentsGet Instagram commentsARead-onlyIdempotentInspect
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.
Inputs: account (required), mediaId (required), after, limit.
get_instagram_media_insightsGet Instagram media insightsARead-onlyIdempotentInspect
Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
Inputs: account (required), mediaId (required), mediaProductType.
get_instagram_messagesGet Instagram messagesBRead-onlyIdempotentInspect
Read the messages in an Instagram direct-message conversation.
Inputs: account (required), conversationId (required), after, limit.
get_instagram_profileGet Instagram profileBRead-onlyIdempotentInspect
Get an Instagram account's profile stats: followers, follows, media count, bio.
Inputs: account (required).
get_postGet postBRead-onlyIdempotentInspect
Get one post including its delivery state and provider identifiers.
Inputs: postId (required).
get_profileGet profileARead-onlyIdempotentInspect
Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
Inputs: no named parameters.
hide_instagram_commentHide Instagram commentBIdempotentInspect
Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
Inputs: account (required), commentId (required), hidden.
list_accountsList accountsARead-onlyIdempotentInspect
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).
Inputs: provider.
list_assetsList assetsARead-onlyIdempotentInspect
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 (image/video), mime, or a text query over filename/id.
Inputs: kind, mime, sort, limit, +1 more.
list_instagram_conversationsList Instagram conversationsARead-onlyIdempotentInspect
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.
Inputs: account (required), after, limit.
list_instagram_mediaList Instagram mediaARead-onlyIdempotentInspect
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.
Inputs: account (required), after, limit.
list_instagram_mentionsList Instagram mentionsARead-onlyIdempotentInspect
List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
Inputs: limit.
list_postsList postsCRead-onlyIdempotentInspect
List posts in the workspace with optional filters.
Inputs: limit, runId, offset, status, +3 more.
post_attemptsPost attemptsARead-onlyIdempotentInspect
List publish attempts for a post, including provider errors. Use this to debug failed posts.
Inputs: postId (required).
preview_campaignPreview campaignARead-onlyIdempotentInspect
Preview how a campaign schedule document expands into concrete posts and steps without creating anything.
Inputs: schedule (required).
publish_draftPublish draftAInspect
Publish a previously created draft run, optionally at a given ISO-8601 start time.
Inputs: runId (required), startAt.
react_instagram_messageReact Instagram messageCInspect
React to a received Instagram direct message (e.g. love).
Inputs: account (required), messageId (required), recipientId (required), conversationId (required), +1 more.
refresh_analyticsRefresh analyticsAIdempotentInspect
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 last stored snapshot.
Inputs: postId (required), window.
reply_instagram_commentReply Instagram commentCInspect
Reply to an Instagram comment on the user's media.
Inputs: account (required), message (required), commentId (required).
retry_postRetry postCInspect
Retry a failed post.
Inputs: postId (required).
run_statusRun statusBRead-onlyIdempotentInspect
Get the status summary of a publishing run and its posts.
Inputs: runId (required).
send_instagram_messageSend Instagram messageAInspect
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.
Inputs: account (required), recipientId (required), conversationId (required), tag, +3 more.
upload_assetUpload assetAInspect
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 are supported through file or sourceUrl. The result is the asset: when status is ready, use its publicUrl as media_link in validate_schedule/apply_schedule. Large videos may come back with status uploading; then call get_asset with the asset id until status is ready (or failed) before scheduling.
Inputs: file, filename, sourceUrl, contentBase64.
validate_scheduleValidate scheduleARead-onlyIdempotentInspect
Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
Inputs: schedule (required).
workspace_healthWorkspace healthARead-onlyIdempotentInspect
Get workspace health, including connection state across providers. Pass provider to check one provider's connections.
Inputs: provider.
workspace_usageWorkspace usageARead-onlyIdempotentInspect
Get workspace usage counters and plan entitlement consumption.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Schedule and publish posts and short videos to every major social platform from any AI agent.
Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).
Draft, schedule and publish social posts to nine platforms from any AI agent.
Schedule, publish and track social posts on 11 networks from any AI agent, with a full dashboard.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to post, schedule, thread, delete, and analyze social media posts across platforms like X, Bluesky, LinkedIn, and Instagram through a single MCP interface.107 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to create, schedule, and manage social media posts across 10 platforms via a unified API.-

Chat33 MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents and MCP clients to publish and schedule posts across eight social networks, answer Instagram and Facebook DMs and comments, and build comment-to-DM automations through a hosted remote endpoint.MIT- AlicenseAqualityCmaintenanceGive any AI agent — Claude, Cursor, Windsurf, or any MCP-compatible client — full control over your social media through natural language.2118 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.