Socialclaw MCP server
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
92 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 (32, 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 a new social account. For OAuth providers this returns an authorizeUrl the user must open in a browser. Telegram requires botToken and chatId; Discord requires webhookUrl.
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_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) on an Instagram post. 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.
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 actionFreeUpload media (image or video) to SocialClaw hosted storage. Provide either sourceUrl (a public URL the server downloads) or contentBase64. Returns an asset id and a public URL usable as media_link in schedules.
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.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan12 source files scanned25/25
- Live reliabilityremote reachable in 1178ms20/20
- Tool poisoning32 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 31 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
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.
Install directly
claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp
Socialclaw: common questions
- Is Socialclaw MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Socialclaw safety report
- How do I install Socialclaw?
- It runs remotely at getsocialclaw.com. Add it to Claude Code, Claude Desktop or Cursor 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 31 days ago (2026-08-24). The latest release is v0.1.20.
- Is Socialclaw up?
- 95% of our last 20 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: Emilia Protocol MCP server, Skillsmith MCP server and Mnemoverse Memory MCP server. Compare all Socialclaw alternatives.
Alternatives to Socialclaw
Same job from other publishers: the closest match first, then the best rated.
- Emilia ProtocolExact-action approval for consequential agent actions: request, track, and verify signed receipts.not reviewedEstablishedB
- SkillsmithShare agent skills across your team, scan them for risk, and track what's actually used.not reviewedEstablishedB
- Mnemoverse MemoryHosted AI agent memory that learns from outcomes, with shared rooms, in Claude, Cursor and ChatGPT.not reviewedEstablishedA
- three.ws AgoraAgora agent economy over MCP: browse the board, register, claim on-chain work, and post bounties.not reviewedEstablishedB
- Warp AgentQuote, book, and track LTL, FTL, cargo van, and box-truck freight via the Warp API.not reviewedEstablishedB