socialclaw

Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.

CommunityOnlineAPI 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.

    How to connect

    How to connect socialclaw to Claude

    The server address to paste into Claude settings:

    https://getsocialclaw.com/mcp

    1. Open Claude (claude.ai or the desktop app).
    2. Go to Settings → Connectors.
    3. Click Add custom connector.
    4. Paste the server address copied below into Remote MCP server URL and click Add.
    5. In a chat, click + → Connectors and switch the new connector on.

    Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

    Authorization

    After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

    How to connect socialclaw to ChatGPT

    The server address to paste into ChatGPT settings:

    https://getsocialclaw.com/mcp

    1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
    2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
    3. Open Settings → Connectors and click Create.
    4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
    5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
    6. In a new chat open + → Apps/Connectors and enable the connector.

    OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

    Authorization

    On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

    How to connect socialclaw to Cursor

    The server address to paste into Cursor settings:

    https://getsocialclaw.com/mcp

    Fastest: click Open in Cursor below and confirm the prompt.

    Manually:

    1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
    2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
    3. Save the file. The server appears in the MCP list; authorize it there if asked.

    Authorization

    If the service needs sign-in, an authorize button appears next to the server in the MCP list.

    Server tool list (32)

    Raw names from tools/list. Only developers need these.

    list_accountsList 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_capabilitiesGet 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_accountStart 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_assetUpload 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_scheduleValidate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
    preview_campaignPreview how a campaign schedule document expands into concrete posts and steps without creating anything.
    apply_scheduleCreate 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_draftPublish a previously created draft run, optionally at a given ISO-8601 start time.
    list_postsList posts in the workspace with optional filters.
    list_assetsList 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_postGet one post including its delivery state and provider identifiers.
    post_attemptsList publish attempts for a post, including provider errors. Use this to debug failed posts.
    retry_postRetry a failed post.
    cancel_postCancel a scheduled post before it publishes.
    run_statusGet the status summary of a publishing run and its posts.
    get_analyticsGet analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
    refresh_analyticsFetch 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_mediaList 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_commentsRead the comments (and replies) on an Instagram post. Use list_instagram_media first to get a mediaId.
    reply_instagram_commentReply to an Instagram comment on the user's media.
    hide_instagram_commentHide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
    delete_instagram_commentPermanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
    get_instagram_media_insightsGet analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
    get_instagram_profileGet an Instagram account's profile stats: followers, follows, media count, bio.
    get_instagram_account_insightsGet an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
    react_instagram_messageReact to a received Instagram direct message (e.g. love).
    list_instagram_mentionsList recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
    list_instagram_conversationsList 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_messagesRead the messages in an Instagram direct-message conversation.
    send_instagram_messageSend 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_usageGet workspace usage counters and plan entitlement consumption.
    workspace_healthGet workspace health, including connection state across providers. Pass provider to check one provider's connections.