io.github.ndesv21/socialclaw
io.github.ndesv21/socialclawConnect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Tools · 32
List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, yo…
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 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 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 …
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) on an Instagram post. 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.
Similar MCP servers embedding-nearest
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"
}
}
}