Socialclaw
ndesv21/socialclaw
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
- GitHub stars
- 106
- tools
- 34
- auth
- Secret needed
- transport
- STDIO, HTTP
- env var
- 1
- last updated
- Aug 4, 2026
Install
From registry metadata$ npx add-mcp https://getsocialclaw.com/mcp --name socialclaw --header 'Authorization: Bearer ${API_TOKEN}'Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp --header 'Authorization: YOUR_AUTHORIZATION'Run in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 34 toolsVerified live against the running server on Nov 6, 2026.
list_accountsList 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).1 params
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).
Parameters* required
providerstringOptional provider filter.
account_capabilitiesGet 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.2 params
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.
Parameters* required
accountIdstringOptional account id.
providerstringOptional provider filter.
connect_accountStart 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...4 params
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...
Parameters* required
botTokenstringTelegram only: token of the user's own bot, from @BotFather.
chatIdstringTelegram chat target, e.g. @yourchannel (telegram only).
provider*stringProvider to connect.
webhookUrlstringDiscord only: webhook URL the user created in their channel settings.
upload_assetAdd 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 o...4 params
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 o...
Parameters* required
contentBase64stringBase64-encoded file content. Small files only; prefer file or sourceUrl.
fileobjectA file the user attached in the conversation.
filenamestringOptional filename including extension, e.g. launch.png. Inferred from the file or URL when omitted.
sourceUrlstringDirect public http(s) URL of the image or video file.
get_assetGet 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.1 params
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.
Parameters* required
assetId*stringAsset id returned by upload_asset or list_assets.
validate_scheduleValidate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.1 params
Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
Parameters* required
schedule*objectSocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider...
preview_campaignPreview how a campaign schedule document expands into concrete posts and steps without creating anything.1 params
Preview how a campaign schedule document expands into concrete posts and steps without creating anything.
Parameters* required
schedule*objectSocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider...
apply_scheduleCreate 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.2 params
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.
Parameters* required
idempotencyKeystringStable key to deduplicate retries.
schedule*objectSocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider...
publish_draftPublish a previously created draft run, optionally at a given ISO-8601 start time.2 params
Publish a previously created draft run, optionally at a given ISO-8601 start time.
Parameters* required
runId*stringDraft run id.
startAtstringOptional ISO-8601 publish start time.
list_postsList posts in the workspace with optional filters.7 params
List posts in the workspace with optional filters.
Parameters* required
accountstringAccount handle filter.
campaignIdstringlimitnumberMaximum posts to return. Defaults to 20 and is capped at 50.
offsetnumberOffset for paging through results.
providerstringrunIdstringstatusstringe.g. scheduled, published, action_required, failed, canceled.
list_assetsList 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. Optiona...5 params
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. Optiona...
Parameters* required
kindstringFilter by media kind: image or video.one of
image · videolimitnumberMaximum assets to return. Defaults to 24, capped at 48.
mimestringOptional mime prefix filter, e.g. video/mp4.
querystringOptional text match over filename, id, kind, mime, or url.
sortstringcreated_desc (default, newest first) or created_asc.one of
created_desc · created_ascget_postGet one post including its delivery state and provider identifiers.1 params
Get one post including its delivery state and provider identifiers.
Parameters* required
postId*stringpost_attemptsList publish attempts for a post, including provider errors. Use this to debug failed posts.1 params
List publish attempts for a post, including provider errors. Use this to debug failed posts.
Parameters* required
postId*stringretry_postRetry a failed post.1 params
Retry a failed post.
Parameters* required
postId*stringcancel_postCancel a scheduled post before it publishes.1 params
Cancel a scheduled post before it publishes.
Parameters* required
postId*stringrun_statusGet the status summary of a publishing run and its posts.1 params
Get the status summary of a publishing run and its posts.
Parameters* required
runId*stringget_analyticsGet analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.3 params
Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
Parameters* required
id*stringscope*stringone of
post · account · runwindowstringOptional analytics window, e.g. 7d.
refresh_analyticsFetch 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...2 params
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...
Parameters* required
postId*stringThe published post id to refresh.
windowstringOptional analytics window, e.g. 7d (default lifetime).
list_instagram_mediaList 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.3 params
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.
Parameters* required
account*stringInstagram connected-account id or handle.
afterstringPagination cursor from a previous response.
limitnumberMax media to return (default 25, capped at 100).
get_instagram_commentsRead 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.4 params
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.
Parameters* required
account*stringInstagram connected-account id or handle.
afterstringPagination cursor from a previous response.
limitnumberMax comments to return (default 25, capped at 100).
mediaId*stringThe IG media id from list_instagram_media.
reply_instagram_commentReply to an Instagram comment on the user's media.3 params
Reply to an Instagram comment on the user's media.
Parameters* required
account*stringInstagram connected-account id or handle.
commentId*stringmessage*stringThe reply text.
hide_instagram_commentHide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.3 params
Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
Parameters* required
account*stringInstagram connected-account id or handle.
commentId*stringhiddenbooleantrue to hide (default), false to unhide.
delete_instagram_commentPermanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.2 params
Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
Parameters* required
account*stringInstagram connected-account id or handle.
commentId*stringget_instagram_media_insightsGet analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.3 params
Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
Parameters* required
account*stringInstagram connected-account id or handle.
mediaId*stringmediaProductTypestringOptional: FEED, REELS, or STORY — refines which metrics are requested.
get_instagram_profileGet an Instagram account's profile stats: followers, follows, media count, bio.1 params
Get an Instagram account's profile stats: followers, follows, media count, bio.
Parameters* required
account*stringInstagram connected-account id or handle.
get_instagram_account_insightsGet an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.3 params
Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
Parameters* required
account*stringInstagram connected-account id or handle.
daysnumberWindow in days (2-30, default 14).
metricstringAccount metric, default reach (e.g. reach, profile_views, accounts_engaged).
react_instagram_messageReact to a received Instagram direct message (e.g. love).5 params
React to a received Instagram direct message (e.g. love).
Parameters* required
account*stringInstagram connected-account id or handle.
conversationId*stringmessageId*stringreactionstringReaction name, default love.
recipientId*stringThe other participant's Instagram-scoped user id (IGSID).
list_instagram_mentionsList recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).1 params
List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
Parameters* required
limitnumberMax mentions (default 30, capped at 100).
list_instagram_conversationsList 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.3 params
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.
Parameters* required
account*stringInstagram connected-account id or handle.
afterstringPagination cursor from a previous response.
limitnumberMax conversations (default 25, capped at 100).
get_instagram_messagesRead the messages in an Instagram direct-message conversation.4 params
Read the messages in an Instagram direct-message conversation.
Parameters* required
account*stringInstagram connected-account id or handle.
afterstringPagination cursor from a previous response.
conversationId*stringConversation id from list_instagram_conversations.
limitnumberMax messages (default 25, capped at 100).
send_instagram_messageSend 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.7 params
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.
Parameters* required
account*stringInstagram connected-account id or handle.
attachment_typestringAttachment type: image (default), video, or audio.one of
image · video · audioattachment_urlstringPublic URL of an image/video to send as an attachment.
conversationId*stringConversation id (for routing/storage).
recipientId*stringThe recipient's Instagram-scoped user id (IGSID).
tagstringOptional message tag, e.g. HUMAN_AGENT, to reply outside the 24h window.
textstringMessage body (omit when sending an attachment).
workspace_usageGet workspace usage counters and plan entitlement consumption.
Get workspace usage counters and plan entitlement consumption.
No parameters. Call it with no arguments.
workspace_healthGet workspace health, including connection state across providers. Pass provider to check one provider's connections.1 params
Get workspace health, including connection state across providers. Pass provider to check one provider's connections.
Parameters* required
providerstringOptional provider to check connection health for.
get_profileIdentify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
No parameters. Call it with no arguments.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SOCIALCLAW_API_KEY*secretSocialClaw workspace API key from https://getsocialclaw.com/dashboard
Readme
SocialClaw
Social media scheduling CLI and OpenClaw skill for AI agents posting to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.
Official Website: getsocialclaw.com · Dashboard · npm · Skill Bundle
Details
- Repository
- github.com/ndesv21/socialclaw
- Website
- getsocialclaw.com
- Categories
- AI & LLM Tools, Automation & Workflows, Media & Entertainment
- Package
socialclaw- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026
