account_capabilitiesread-only | 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. |
apply_schedule | 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_postdestructive | Cancel a scheduled post before it publishes. |
connect_account | 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 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_commentdestructive | Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure. |
get_analyticsread-only | Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier. |
get_assetread-only | 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. |
get_instagram_account_insightsread-only | Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days. |
get_instagram_commentsread-only | 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_instagram_media_insightsread-only | Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId. |
get_instagram_messagesread-only | Read the messages in an Instagram direct-message conversation. |
get_instagram_profileread-only | Get an Instagram account's profile stats: followers, follows, media count, bio. |
get_postread-only | Get one post including its delivery state and provider identifiers. |
get_profileread-only | Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on. |
hide_instagram_comment | Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide. |
list_accountsread-only | 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). |
list_assetsread-only | 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. Optionally filter by kind (image/video), mime, or a text query over filename/id. |
list_instagram_conversationsread-only | 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. |
list_instagram_mediaread-only | 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. |
list_instagram_mentionsread-only | List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks). |
list_postsread-only | List posts in the workspace with optional filters. |
post_attemptsread-only | List publish attempts for a post, including provider errors. Use this to debug failed posts. |
preview_campaignread-only | Preview how a campaign schedule document expands into concrete posts and steps without creating anything. |
publish_draft | Publish a previously created draft run, optionally at a given ISO-8601 start time. |
react_instagram_message | React to a received Instagram direct message (e.g. love). |
refresh_analytics | 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 numbers rather than the last stored snapshot. |
reply_instagram_comment | Reply to an Instagram comment on the user's media. |
retry_post | Retry a failed post. |
run_statusread-only | Get the status summary of a publishing run and its posts. |
send_instagram_message | 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. |
upload_asset | 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 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_scheduleread-only | Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule. |
workspace_healthread-only | Get workspace health, including connection state across providers. Pass provider to check one provider's connections. |
workspace_usageread-only | Get workspace usage counters and plan entitlement consumption. |