Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <SocialClaw workspace API key>
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Optional provider filter.
Optional account id.
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.
| Argument | Type | Description |
|---|---|---|
| provider | string | Optional provider filter. |
| accountId | string | Optional account id. |
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "Optional provider filter."
},
"accountId": {
"type": "string",
"description": "Optional account id."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| schedule* | object | SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider settings go in settings, e.g. TikTok inbox mode: settings: { tiktokPostMode: "draft" } sends the media to TikTok's inbox notification flow instead of publishing, and the creator finishes the post inside the TikTok app. |
| idempotencyKey | string | Stable key to deduplicate retries. |
{
"type": "object",
"required": [
"schedule"
],
"properties": {
"schedule": {
"type": "object",
"description": "SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider settings go in settings, e.g. TikTok inbox mode: settings: { tiktokPostMode: \"draft\" } sends the media to TikTok's inbox notification flow instead of publishing, and the creator finishes the post inside the TikTok app.",
"additionalProperties": true
},
"idempotencyKey": {
"type": "string",
"description": "Stable key to deduplicate retries."
}
}
}Cancel a scheduled post before it publishes.
| Argument | Type | Description |
|---|---|---|
| postId* | string |
{
"type": "object",
"required": [
"postId"
],
"properties": {
"postId": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| chatId | string | Telegram chat target, e.g. @yourchannel (telegram only). |
| botToken | string | Telegram only: token of the user's own bot, from @BotFather. |
| provider* | string | Provider to connect. |
| webhookUrl | string | Discord only: webhook URL the user created in their channel settings. |
{
"type": "object",
"required": [
"provider"
],
"properties": {
"chatId": {
"type": "string",
"description": "Telegram chat target, e.g. @yourchannel (telegram only)."
},
"botToken": {
"type": "string",
"description": "Telegram only: token of the user's own bot, from @BotFather."
},
"provider": {
"type": "string",
"description": "Provider to connect."
},
"webhookUrl": {
"type": "string",
"description": "Discord only: webhook URL the user created in their channel settings."
}
}
}Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
| Argument | Type | Description |
|---|---|---|
| account* | string | Instagram connected-account id or handle. |
| commentId* | string |
{
"type": "object",
"required": [
"account",
"commentId"
],
"properties": {
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"commentId": {
"type": "string"
}
}
}Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| scope* | string | |
| window | string | Optional analytics window, e.g. 7d. |
{
"type": "object",
"required": [
"scope",
"id"
],
"properties": {
"id": {
"type": "string"
},
"scope": {
"enum": [
"post",
"account",
"run"
],
"type": "string"
},
"window": {
"type": "string",
"description": "Optional analytics window, e.g. 7d."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| assetId* | string | Asset id returned by upload_asset or list_assets. |
{
"type": "object",
"required": [
"assetId"
],
"properties": {
"assetId": {
"type": "string",
"description": "Asset id returned by upload_asset or list_assets."
}
}
}Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
| Argument | Type | Description |
|---|---|---|
| days | number | Window in days (2-30, default 14). |
| metric | string | Account metric, default reach (e.g. reach, profile_views, accounts_engaged). |
| account* | string | Instagram connected-account id or handle. |
{
"type": "object",
"required": [
"account"
],
"properties": {
"days": {
"type": "number",
"description": "Window in days (2-30, default 14)."
},
"metric": {
"type": "string",
"description": "Account metric, default reach (e.g. reach, profile_views, accounts_engaged)."
},
"account": {
"type": "string",
"description": "Instagram 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.
| Argument | Type | Description |
|---|---|---|
| after | string | Pagination cursor from a previous response. |
| limit | number | Max comments to return (default 25, capped at 100). |
| account* | string | Instagram connected-account id or handle. |
| mediaId* | string | The IG media id from list_instagram_media. |
{
"type": "object",
"required": [
"account",
"mediaId"
],
"properties": {
"after": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"limit": {
"type": "number",
"description": "Max comments to return (default 25, capped at 100)."
},
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"mediaId": {
"type": "string",
"description": "The IG media id from list_instagram_media."
}
}
}Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
| Argument | Type | Description |
|---|---|---|
| account* | string | Instagram connected-account id or handle. |
| mediaId* | string | |
| mediaProductType | string | Optional: FEED, REELS, or STORY — refines which metrics are requested. |
{
"type": "object",
"required": [
"account",
"mediaId"
],
"properties": {
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"mediaId": {
"type": "string"
},
"mediaProductType": {
"type": "string",
"description": "Optional: FEED, REELS, or STORY — refines which metrics are requested."
}
}
}Read the messages in an Instagram direct-message conversation.
| Argument | Type | Description |
|---|---|---|
| after | string | Pagination cursor from a previous response. |
| limit | number | Max messages (default 25, capped at 100). |
| account* | string | Instagram connected-account id or handle. |
| conversationId* | string | Conversation id from list_instagram_conversations. |
{
"type": "object",
"required": [
"account",
"conversationId"
],
"properties": {
"after": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"limit": {
"type": "number",
"description": "Max messages (default 25, capped at 100)."
},
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"conversationId": {
"type": "string",
"description": "Conversation id from list_instagram_conversations."
}
}
}Get an Instagram account's profile stats: followers, follows, media count, bio.
| Argument | Type | Description |
|---|---|---|
| account* | string | Instagram connected-account id or handle. |
{
"type": "object",
"required": [
"account"
],
"properties": {
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
}
}
}Get one post including its delivery state and provider identifiers.
| Argument | Type | Description |
|---|---|---|
| postId* | string |
{
"type": "object",
"required": [
"postId"
],
"properties": {
"postId": {
"type": "string"
}
}
}Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
No arguments.
{
"type": "object",
"properties": {}
}Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
| Argument | Type | Description |
|---|---|---|
| hidden | boolean | true to hide (default), false to unhide. |
| account* | string | Instagram connected-account id or handle. |
| commentId* | string |
{
"type": "object",
"required": [
"account",
"commentId"
],
"properties": {
"hidden": {
"type": "boolean",
"description": "true to hide (default), false to unhide."
},
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"commentId": {
"type": "string"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| provider | string | Optional provider filter. |
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "Optional provider filter."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| kind | string | Filter by media kind: image or video. |
| mime | string | Optional mime prefix filter, e.g. video/mp4. |
| sort | string | created_desc (default, newest first) or created_asc. |
| limit | number | Maximum assets to return. Defaults to 24, capped at 48. |
| query | string | Optional text match over filename, id, kind, mime, or url. |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"image",
"video"
],
"type": "string",
"description": "Filter by media kind: image or video."
},
"mime": {
"type": "string",
"description": "Optional mime prefix filter, e.g. video/mp4."
},
"sort": {
"enum": [
"created_desc",
"created_asc"
],
"type": "string",
"description": "created_desc (default, newest first) or created_asc."
},
"limit": {
"type": "number",
"description": "Maximum assets to return. Defaults to 24, capped at 48."
},
"query": {
"type": "string",
"description": "Optional text match over filename, id, kind, mime, or url."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| after | string | Pagination cursor from a previous response. |
| limit | number | Max conversations (default 25, capped at 100). |
| account* | string | Instagram connected-account id or handle. |
{
"type": "object",
"required": [
"account"
],
"properties": {
"after": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"limit": {
"type": "number",
"description": "Max conversations (default 25, capped at 100)."
},
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| after | string | Pagination cursor from a previous response. |
| limit | number | Max media to return (default 25, capped at 100). |
| account* | string | Instagram connected-account id or handle. |
{
"type": "object",
"required": [
"account"
],
"properties": {
"after": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"limit": {
"type": "number",
"description": "Max media to return (default 25, capped at 100)."
},
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
}
}
}List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
| Argument | Type | Description |
|---|---|---|
| limit | number | Max mentions (default 30, capped at 100). |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Max mentions (default 30, capped at 100)."
}
}
}List posts in the workspace with optional filters.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum posts to return. Defaults to 20 and is capped at 50. |
| runId | string | |
| offset | number | Offset for paging through results. |
| status | string | e.g. scheduled, published, action_required, failed, canceled. |
| account | string | Account handle filter. |
| provider | string | |
| campaignId | string |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Maximum posts to return. Defaults to 20 and is capped at 50."
},
"runId": {
"type": "string"
},
"offset": {
"type": "number",
"description": "Offset for paging through results."
},
"status": {
"type": "string",
"description": "e.g. scheduled, published, action_required, failed, canceled."
},
"account": {
"type": "string",
"description": "Account handle filter."
},
"provider": {
"type": "string"
},
"campaignId": {
"type": "string"
}
}
}List publish attempts for a post, including provider errors. Use this to debug failed posts.
| Argument | Type | Description |
|---|---|---|
| postId* | string |
{
"type": "object",
"required": [
"postId"
],
"properties": {
"postId": {
"type": "string"
}
}
}Preview how a campaign schedule document expands into concrete posts and steps without creating anything.
| Argument | Type | Description |
|---|---|---|
| schedule* | object | SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider settings go in settings, e.g. TikTok inbox mode: settings: { tiktokPostMode: "draft" } sends the media to TikTok's inbox notification flow instead of publishing, and the creator finishes the post inside the TikTok app. |
{
"type": "object",
"required": [
"schedule"
],
"properties": {
"schedule": {
"type": "object",
"description": "SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider settings go in settings, e.g. TikTok inbox mode: settings: { tiktokPostMode: \"draft\" } sends the media to TikTok's inbox notification flow instead of publishing, and the creator finishes the post inside the TikTok app.",
"additionalProperties": true
}
}
}Publish a previously created draft run, optionally at a given ISO-8601 start time.
| Argument | Type | Description |
|---|---|---|
| runId* | string | Draft run id. |
| startAt | string | Optional ISO-8601 publish start time. |
{
"type": "object",
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string",
"description": "Draft run id."
},
"startAt": {
"type": "string",
"description": "Optional ISO-8601 publish start time."
}
}
}React to a received Instagram direct message (e.g. love).
| Argument | Type | Description |
|---|---|---|
| account* | string | Instagram connected-account id or handle. |
| reaction | string | Reaction name, default love. |
| messageId* | string | |
| recipientId* | string | The other participant's Instagram-scoped user id (IGSID). |
| conversationId* | string |
{
"type": "object",
"required": [
"account",
"conversationId",
"messageId",
"recipientId"
],
"properties": {
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"reaction": {
"type": "string",
"description": "Reaction name, default love."
},
"messageId": {
"type": "string"
},
"recipientId": {
"type": "string",
"description": "The other participant's Instagram-scoped user id (IGSID)."
},
"conversationId": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| postId* | string | The published post id to refresh. |
| window | string | Optional analytics window, e.g. 7d (default lifetime). |
{
"type": "object",
"required": [
"postId"
],
"properties": {
"postId": {
"type": "string",
"description": "The published post id to refresh."
},
"window": {
"type": "string",
"description": "Optional analytics window, e.g. 7d (default lifetime)."
}
}
}Reply to an Instagram comment on the user's media.
| Argument | Type | Description |
|---|---|---|
| account* | string | Instagram connected-account id or handle. |
| message* | string | The reply text. |
| commentId* | string |
{
"type": "object",
"required": [
"account",
"commentId",
"message"
],
"properties": {
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"message": {
"type": "string",
"description": "The reply text."
},
"commentId": {
"type": "string"
}
}
}Retry a failed post.
| Argument | Type | Description |
|---|---|---|
| postId* | string |
{
"type": "object",
"required": [
"postId"
],
"properties": {
"postId": {
"type": "string"
}
}
}Get the status summary of a publishing run and its posts.
| Argument | Type | Description |
|---|---|---|
| runId* | string |
{
"type": "object",
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| tag | string | Optional message tag, e.g. HUMAN_AGENT, to reply outside the 24h window. |
| text | string | Message body (omit when sending an attachment). |
| account* | string | Instagram connected-account id or handle. |
| recipientId* | string | The recipient's Instagram-scoped user id (IGSID). |
| attachment_url | string | Public URL of an image/video to send as an attachment. |
| conversationId* | string | Conversation id (for routing/storage). |
| attachment_type | string | Attachment type: image (default), video, or audio. |
{
"type": "object",
"required": [
"account",
"conversationId",
"recipientId"
],
"properties": {
"tag": {
"type": "string",
"description": "Optional message tag, e.g. HUMAN_AGENT, to reply outside the 24h window."
},
"text": {
"type": "string",
"description": "Message body (omit when sending an attachment)."
},
"account": {
"type": "string",
"description": "Instagram connected-account id or handle."
},
"recipientId": {
"type": "string",
"description": "The recipient's Instagram-scoped user id (IGSID)."
},
"attachment_url": {
"type": "string",
"description": "Public URL of an image/video to send as an attachment."
},
"conversationId": {
"type": "string",
"description": "Conversation id (for routing/storage)."
},
"attachment_type": {
"enum": [
"image",
"video",
"audio"
],
"type": "string",
"description": "Attachment type: image (default), video, or audio."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| file | object | A file the user attached in the conversation. |
| filename | string | Optional filename including extension, e.g. launch.png. Inferred from the file or URL when omitted. |
| sourceUrl | string | Direct public http(s) URL of the image or video file. |
| contentBase64 | string | Base64-encoded file content. Small files only; prefer file or sourceUrl. |
{
"type": "object",
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "Id of the attached file."
},
"file_name": {
"type": "string",
"description": "Original name of the attached file, if known."
},
"mime_type": {
"type": "string",
"description": "Mime type of the attached file, if known."
},
"download_url": {
"type": "string",
"description": "Temporary download URL of the attached file."
}
},
"description": "A file the user attached in the conversation."
},
"filename": {
"type": "string",
"description": "Optional filename including extension, e.g. launch.png. Inferred from the file or URL when omitted."
},
"sourceUrl": {
"type": "string",
"description": "Direct public http(s) URL of the image or video file."
},
"contentBase64": {
"type": "string",
"description": "Base64-encoded file content. Small files only; prefer file or sourceUrl."
}
}
}Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
| Argument | Type | Description |
|---|---|---|
| schedule* | object | SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider settings go in settings, e.g. TikTok inbox mode: settings: { tiktokPostMode: "draft" } sends the media to TikTok's inbox notification flow instead of publishing, and the creator finishes the post inside the TikTok app. |
{
"type": "object",
"required": [
"schedule"
],
"properties": {
"schedule": {
"type": "object",
"description": "SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider settings go in settings, e.g. TikTok inbox mode: settings: { tiktokPostMode: \"draft\" } sends the media to TikTok's inbox notification flow instead of publishing, and the creator finishes the post inside the TikTok app.",
"additionalProperties": true
}
}
}Get workspace health, including connection state across providers. Pass provider to check one provider's connections.
| Argument | Type | Description |
|---|---|---|
| provider | string | Optional provider to check connection health for. |
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "Optional provider to check connection health for."
}
}
}Get workspace usage counters and plan entitlement consumption.
No arguments.
{
"type": "object",
"properties": {}
}