io.github.ndesv21/socialclaw
io.github.ndesv21/socialclawConnect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Watch this dependency
Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.
Inspect evidence and set up a watch Share public evidence report
Score: 100/100
Handshake verified by our own probe.
why this score
Tools · 34
List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, threads, linkedin, linkedin_page, pinterest, tiktok, telegram, di…
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 fil…
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 …
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…
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, un…
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 how a campaign schedule document expands into concrete posts and steps without creating anything.
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 a previously created draft run, optionally at a given ISO-8601 start time.
List posts in the workspace with optional filters.
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 …
Get one post including its delivery state and provider identifiers.
List publish attempts for a post, including provider errors. Use this to debug failed posts.
Retry a failed post.
Cancel a scheduled post before it publishes.
Get the status summary of a publishing run and its posts.
Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
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…
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.
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 to an Instagram comment on the user's media.
Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
Get an Instagram account's profile stats: followers, follows, media count, bio.
Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
React to a received Instagram direct message (e.g. love).
List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
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 rep…
Read the messages in an Instagram direct-message conversation.
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) i…
Get workspace usage counters and plan entitlement consumption.
Get workspace health, including connection state across providers. Pass provider to check one provider's connections.
Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"io.github.ndesv21/socialclaw": {
"url": "https://getsocialclaw.com/mcp",
"transport": "streamable-http"
}
}
}