socialclaw
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Community: Submitted by a user or imported; check the owner before granting accessOnlineAPI key requiredGlobalFreeCan modify data
What it can do
What data it sees
Do you need an account
An API key from the service settings is required
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Server tool list (32)
Raw names from tools/list. Only developers need these.
| list_accounts | 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). |
| account_capabilities | 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. |
| connect_account | Start 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. |
| upload_asset | Upload 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_schedule | 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_campaign | Preview how a campaign schedule document expands into concrete posts and steps without creating anything. |
| 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. |
| publish_draft | Publish a previously created draft run, optionally at a given ISO-8601 start time. |
| list_posts | List posts in the workspace with optional filters. |
| list_assets | 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. |
| get_post | Get one post including its delivery state and provider identifiers. |
| post_attempts | List publish attempts for a post, including provider errors. Use this to debug failed posts. |
| retry_post | Retry a failed post. |
| cancel_post | Cancel a scheduled post before it publishes. |
| run_status | Get the status summary of a publishing run and its posts. |
| get_analytics | Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier. |
| 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. |
| list_instagram_media | 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. |
| get_instagram_comments | Read the comments (and replies) on an Instagram post. Use list_instagram_media first to get a mediaId. |
| reply_instagram_comment | Reply to an Instagram comment on the user's media. |
| hide_instagram_comment | Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide. |
| delete_instagram_comment | Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure. |
| get_instagram_media_insights | Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId. |
| get_instagram_profile | Get an Instagram account's profile stats: followers, follows, media count, bio. |
| get_instagram_account_insights | Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days. |
| react_instagram_message | React to a received Instagram direct message (e.g. love). |
| list_instagram_mentions | List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks). |
| list_instagram_conversations | 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. |
| get_instagram_messages | Read the messages in an Instagram direct-message conversation. |
| 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. |
| workspace_usage | Get workspace usage counters and plan entitlement consumption. |
| workspace_health | Get workspace health, including connection state across providers. Pass provider to check one provider's connections. |