Skip to content
Agentmart
Submit a tool

Socialclaw

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

Connector by ndesv21 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)Remote (HTTP)★ 98
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ndesv21-socialclaw

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://getsocialclaw.com/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
22 read · 10 write · 2 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 34

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 22 · Look things up without changing anything.

  • account_capabilities
  • get_analytics
  • get_asset
  • get_instagram_account_insights
  • get_instagram_comments
  • get_instagram_media_insights
  • get_instagram_messages
  • get_instagram_profile
  • get_post
  • get_profile
  • list_accounts
  • list_assets
Show 10 more tools
  • list_instagram_conversations
  • list_instagram_media
  • list_instagram_mentions
  • list_posts
  • post_attempts
  • preview_campaign
  • run_status
  • validate_schedule
  • workspace_health
  • workspace_usage

Write 10 · Create, change, send or run things.

  • apply_schedule
  • connect_account
  • hide_instagram_comment
  • publish_draft
  • react_instagram_message
  • refresh_analytics
  • reply_instagram_comment
  • retry_post
  • send_instagram_message
  • upload_asset

Delete 2 · Delete, drop, revoke or wipe things.

  • cancel_post
  • delete_instagram_comment

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • Authorization
  • SOCIALCLAW_API_KEY

Network hosts it talks to 8

  • discord.com · found in code
  • facebook.com · found in code
  • getsocialclaw.com · found in remote endpoint, install command, code
  • github.com · found in code
  • pinterest.com · found in code
  • reddit.com · found in code
  • t.me · found in code
  • tiktok.com · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (34)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • account_capabilitiesAccount 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_scheduleApply 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_postCancel postcan change or delete data

    Cancel a scheduled post before it publishes.

  • connect_accountConnect 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_commentDelete Instagram commentcan change or delete data

    Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.

  • get_analyticsGet 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_assetGet 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_insightsGet 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_commentsGet 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_insightsGet 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_messagesGet Instagram messagesread-only

    Read the messages in an Instagram direct-message conversation.

  • get_instagram_profileGet Instagram profileread-only

    Get an Instagram account's profile stats: followers, follows, media count, bio.

  • get_postGet postread-only

    Get one post including its delivery state and provider identifiers.

  • get_profileGet 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_commentHide Instagram comment

    Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.

Show 19 more tools
  • list_accountsList 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_assetsList 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_conversationsList 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_mediaList 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_mentionsList Instagram mentionsread-only

    List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).

  • list_postsList postsread-only

    List posts in the workspace with optional filters.

  • post_attemptsPost attemptsread-only

    List publish attempts for a post, including provider errors. Use this to debug failed posts.

  • preview_campaignPreview campaignread-only

    Preview how a campaign schedule document expands into concrete posts and steps without creating anything.

  • publish_draftPublish draft

    Publish a previously created draft run, optionally at a given ISO-8601 start time.

  • react_instagram_messageReact Instagram message

    React to a received Instagram direct message (e.g. love).

  • refresh_analyticsRefresh 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_commentReply Instagram comment

    Reply to an Instagram comment on the user's media.

  • retry_postRetry post

    Retry a failed post.

  • run_statusRun statusread-only

    Get the status summary of a publishing run and its posts.

  • send_instagram_messageSend 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_assetUpload 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_scheduleValidate 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_healthWorkspace healthread-only

    Get workspace health, including connection state across providers. Pass provider to check one provider's connections.

  • workspace_usageWorkspace usageread-only

    Get workspace usage counters and plan entitlement consumption.

Signals

Stars
98
Forks
28
Open issues
0
Contributors
1
Last commit
Aug 24, 2026 (2 months ago)
Last release
Aug 4, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.ndesv21/socialclaw
Version
0.1.20
Auth
Bearer token, API key
Packages
npm socialclaw
License
MIT
Repository
github.com/ndesv21/socialclaw
Website
getsocialclaw.com
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from ndesv21

Cite this page

Socialclaw MCP server. Agent Mart. https://agentmart.dev/connectors/ndesv21-socialclaw (last updated 2026-10-24)