MCP serverio.github.ndesv21/socialclaw

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

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.

Cancel a scheduled post before it publishes.

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

Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.

Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.

Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.

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.

Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.

Read the messages in an Instagram direct-message conversation.

Get an Instagram account's profile stats: followers, follows, media count, bio.

Get one post including its delivery state and provider identifiers.

Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.

Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.

List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, threads, linkedin, linkedin_page, pinterest,

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

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

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

List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).

List posts in the workspace with optional filters.

List publish attempts for a post, including provider errors. Use this to debug failed posts.

Preview how a campaign schedule document expands into concrete posts and steps without creating anything.

Publish a previously created draft run, optionally at a given ISO-8601 start time.

React to a received Instagram direct message (e.g. love).

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, Snapch

Reply to an Instagram comment on the user's media.

Retry a failed post.

Get the status summary of a publishing run and its posts.

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

Upload an image or video the user wants to post, so it can be attached to a post. Provide either sourceUrl (a public http(s) URL of the media) or contentBase64. The file is stored

Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.

Get workspace health, including connection state across providers. Pass provider to check one provider's connections.

Get workspace usage counters and plan entitlement consumption.