Socialclaw MCP server
online · 100% uptimeio.github.ndesv21/socialclaw·v0.1.20·105 starsConnect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
105 stars83 downloads/wk
Reviews
Write oneNobody has reviewed Socialclaw yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Socialclaw tools (34, 10 write)
write = sends, deletes, buys or postsaccount_capabilitiesFreeGet 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.
apply_schedulewrite actionFreeCreate 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.
cancel_postwrite actionFreeCancel a scheduled post before it publishes.
connect_accountFreeStart 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.
delete_instagram_commentwrite actionFreePermanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
get_analyticsFreeGet analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
get_assetFreeGet 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.
get_instagram_account_insightsFreeGet an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
get_instagram_commentsFreeRead 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.
get_instagram_media_insightsFreeGet analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
get_instagram_messagesFreeRead the messages in an Instagram direct-message conversation.
get_instagram_profileFreeGet an Instagram account's profile stats: followers, follows, media count, bio.
get_postwrite actionFreeGet one post including its delivery state and provider identifiers.
get_profileFreeIdentify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
hide_instagram_commentFreeHide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
list_accountsFreeList 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).
list_assetsFreeList 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.
list_instagram_conversationsFreeList 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.
list_instagram_mediaFreeList 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.
list_instagram_mentionsFreeList recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
list_postsFreeList posts in the workspace with optional filters.
post_attemptswrite actionFreeList publish attempts for a post, including provider errors. Use this to debug failed posts.
preview_campaignFreePreview how a campaign schedule document expands into concrete posts and steps without creating anything.
publish_draftwrite actionFreePublish a previously created draft run, optionally at a given ISO-8601 start time.
react_instagram_messageFreeReact to a received Instagram direct message (e.g. love).
refresh_analyticsFreeFetch 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.
reply_instagram_commentFreeReply to an Instagram comment on the user's media.
retry_postwrite actionFreeRetry a failed post.
run_statuswrite actionFreeGet the status summary of a publishing run and its posts.
send_instagram_messagewrite actionFreeSend 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.
upload_assetwrite actionFreeAdd 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.
validate_scheduleFreeValidate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
workspace_healthFreeGet workspace health, including connection state across providers. Pass provider to check one provider's connections.
workspace_usageFreeGet workspace usage counters and plan entitlement consumption.
Public scan report
scanner v0.1.10 · 2026-11-04 · same rubric, same numbers if you re-run it
- Code scan12 source files scanned25/25
- Live reliabilityremote reachable in 1236ms20/20
- Tool poisoning34 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 23 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Socialclaw compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 91/100
- higher than 88% of 4,456 AI and agents servers
- Tools
- 34
- the typical AI and agents server has 7
- Tools that change things
- 29%
- typical: 3%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote AI and agents server answers 100%
- Response time
- 315 ms
- faster than 41% of 2,337 AI and agents servers
- GitHub stars
- 105
- more than 94% of 2,733 AI and agents servers
- Downloads a week
- 83
- more than 55% of 1,712 AI and agents servers with a package
What its tools let an agent do: 23 read · 1 create · 2 change · 2 delete · 4 send or post · 2 run or deploy
Install Socialclaw in Claude Code, Cursor or VS Code
claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp
What the publisher says
From the Socialclaw repository's README, as published. We do not edit it. Read it on GitHub
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
getsocialclaw.com is the official SocialClaw website — the hosted dashboard, API, and account sign-up all live there.
This repo is the public home for:
- the socialclaw npm CLI
- the OpenClaw and ClawHub skill bundle
- the Claude Code plugin and /socialclaw command asset
- public usage docs, provider notes, and schedule examples
Install
npm install -g socialclaw
socialclaw login
socialclaw accounts list --jsonInstall as an AI agent skill (Claude Code, Cursor, Cline, Codex, and more):
npx skills add ndesv21/socialclawWhat the CLI covers
- workspace API key login and hosted dashboard bootstrap
- browser OAuth connect plus manual Discord and Telegram connect
- hosted asset upload and deletion
- schedule validation, campaign preview, apply, inspect, clone, and draft publishing
- post, run, attempt, analytics, job, usage, and health inspection
- provider-side deletion for supported published posts
- Claude Code command installation through socialclaw install --claude
CLI at a glance
socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file ./image.png --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
socialclaw posts delete --post-id <post-id> --jsonCurrent help surface
____ _ _ ____ _
/ ___| ___ ___(_) __ _| | / ___| | __ ___ __
\___ \ / _ \ / __| |/ _` | | | | | |/ _` \ \ /\ / /
___) | (_) | (__| | (_| | | | |___| | (_| |\ V V /
|____/ \___/ \___|_|\__,_|_| \____|_|\__,_| \_/\_/
socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file <path> --json
socialclaw campaigns preview -f <schedule.(yaml|yml|json)> --json
socialclaw validate -f <schedule.(yaml|yml|json)> --json
socialclaw apply -f <schedule.(yaml|yml|json)> --json
socialclaw posts get --post-id <id> --json
socialclaw posts delete --post-id <id> --json
socialclaw status --run-id <id> --json
socialclaw analytics post --post-id <id> --jsonWatch the Demo
Click the image to open the demo video.
Built for Agent-Driven Publishing
Authentication and access
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Socialclaw: common questions
- Is Socialclaw MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Socialclaw safety report
- How do I install Socialclaw?
- It runs remotely at getsocialclaw.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Socialclaw need an API key?
- Yes. The registry entry asks for
SOCIALCLAW_API_KEY,Authorization. - Is Socialclaw maintained?
- The last commit was 34 days ago (2026-10-12). The latest release is v0.1.20.
- Is Socialclaw up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Socialclaw?
- Servers from other publishers that do the same job: Taisly Social Media Posting MCP server, Commonly MCP server and SuperCompress MCP server.
- How does Socialclaw compare with other AI and agents MCP servers?
- safety score 91/100 (higher than 88% of 4,456 AI and agents servers); tools 34 (the typical AI and agents server has 7); tools that change things 29% (typical: 3%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Socialclaw
Same job from other publishers: the closest match first, then the best rated.
Taisly Social Media PostingPublish videos to TikTok, Reels, Shorts, X, and Facebook through Taisly.not reviewedEstablishedA- CommonlyRead Commonly pods and post as a Commonly agent you create, with a token from your Commonly account.not reviewedEstablishedA
- SuperCompressCompress coding-agent context ~64%. Hosted Neural Keep MCP for Cursor/Claude/Codex.not reviewedEstablishedB
- Emilia ProtocolExact-action approval for consequential agent actions: request, track, and verify signed receipts.not reviewedEstablishedB
- Mnemoverse MemoryHosted agent memory that learns from outcomes, with shared rooms. No key: mcp.mnemoverse.com/mcpnot reviewedEstablishedA