protogrid

Search / io.github.ndesv21/socialclaw

socialclaw

R1· needs a key

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

v0.1.20 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds SOCIALCLAW_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality79good
Trust94of 100
Uptime, 30 days100%
Latency p50464 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "socialclaw": {
      "type": "http",
      "url": "https://getsocialclaw.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOCIALCLAW_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp --header "Authorization: Bearer ${SOCIALCLAW_TOKEN}"
[mcp_servers.socialclaw]
url = "https://getsocialclaw.com/mcp"
bearer_token_env_var = "SOCIALCLAW_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "socialclaw": {
      "type": "remote",
      "url": "https://getsocialclaw.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:SOCIALCLAW_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "socialclaw": {
      "type": "http",
      "url": "https://getsocialclaw.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOCIALCLAW_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=socialclaw&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZ2V0c29jaWFsY2xhdy5jb20vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7U09DSUFMQ0xBV19UT0tFTn0ifX0%3D"
}
{
  "servers": {
    "socialclaw": {
      "type": "http",
      "url": "https://getsocialclaw.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOCIALCLAW_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "socialclaw": {
      "httpUrl": "https://getsocialclaw.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOCIALCLAW_TOKEN}"
      }
    }
  }
}
extensions:
  "socialclaw":
    enabled: true
    name: "socialclaw"
    type: streamable_http
    uri: "https://getsocialclaw.com/mcp"
    headers:
      "Authorization": "Bearer ${SOCIALCLAW_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${SOCIALCLAW_TOKEN}. The registry never accepts secret values.

Quality 79 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations34 of 34 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 4,986 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability25 · weight 15
  • warn
    stability.changes35 tool changes in 30 days
  • fail
    stability.rug_pull3 tools kept their name but changed most of their description in 30 days; review before trusting them
dependencies100 · weight 15
  • pass
    deps.known_vulnsno known advisory in 1 resolved packages
  • n/a
    deps.mcp_sdk_versionthe official MCP SDK is not in the dependency graph
  • pass
    deps.resolvable[email protected] resolved: 1 packages

34 tools, about 4,986 tokens to load them all · tool set 5d6cd58dd2c8 · tools last changed 2026-10-07 · checked 2026-10-20 10:03 UTC

Tool changes

  • get_assetadded

    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.

  • upload_assetchangeddescription, input schemameaning changed
    before

    Upload an image or video the user wants to post, so it can be attached to a post. Provide either sourceUrl (a public http(s) URL of the media) or contentBase64. The file is stored in the user's SocialClaw media library and the result includes an asset id and a public URL to use as media_link in schedules.

    after · 39% of words in common

    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.

  • get_profileadded

    Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.

  • workspace_healthchangedtitle, annotations
  • workspace_usagechangedtitle, annotations
  • send_instagram_messagechangedtitle, annotations
  • get_instagram_messageschangedtitle, annotations
  • list_instagram_conversationschangedtitle, annotations
  • list_instagram_mentionschangedtitle, annotations
  • react_instagram_messagechangedtitle, annotations

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90
liveness100
freshness85
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-76d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm0 dependencies, resolved · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://getsocialclaw.com/mcp streamable-httpapi_key ${SOCIALCLAW_TOKEN}yes100%464 ms2025-11-252026-10-20
packageregistryversionruntimesecrets
socialclawnpm0.1.20npxSOCIALCLAW_API_KEY

Tools (34)

account_capabilitiesread-onlyGet 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_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.
cancel_postdestructiveCancel a scheduled post before it publishes.
connect_accountStart 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_commentdestructivePermanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.
get_analyticsread-onlyGet analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
get_assetread-onlyGet 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_insightsread-onlyGet an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
get_instagram_commentsread-onlyRead 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_insightsread-onlyGet analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
get_instagram_messagesread-onlyRead the messages in an Instagram direct-message conversation.
get_instagram_profileread-onlyGet an Instagram account's profile stats: followers, follows, media count, bio.
get_postread-onlyGet one post including its delivery state and provider identifiers.
get_profileread-onlyIdentify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
hide_instagram_commentHide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.
list_accountsread-onlyList 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_assetsread-onlyList 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_conversationsread-onlyList 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_mediaread-onlyList 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_mentionsread-onlyList recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
list_postsread-onlyList posts in the workspace with optional filters.
post_attemptsread-onlyList publish attempts for a post, including provider errors. Use this to debug failed posts.
preview_campaignread-onlyPreview how a campaign schedule document expands into concrete posts and steps without creating anything.
publish_draftPublish a previously created draft run, optionally at a given ISO-8601 start time.
react_instagram_messageReact to a received Instagram direct message (e.g. love).
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.
reply_instagram_commentReply to an Instagram comment on the user's media.
retry_postRetry a failed post.
run_statusread-onlyGet the status summary of a publishing run and its posts.
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.
upload_assetAdd 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_scheduleread-onlyValidate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
workspace_healthread-onlyGet workspace health, including connection state across providers. Pass provider to check one provider's connections.
workspace_usageread-onlyGet workspace usage counters and plan entitlement consumption.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.ndesv21/socialclaw",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "remotes": [
    {
      "url": "https://getsocialclaw.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer <SocialClaw workspace API key>"
        }
      ]
    }
  ],
  "version": "0.1.20",
  "packages": [
    {
      "version": "0.1.20",
      "transport": {
        "type": "stdio"
      },
      "identifier": "socialclaw",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "mcp",
          "isRequired": true
        }
      ],
      "environmentVariables": [
        {
          "name": "SOCIALCLAW_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "SocialClaw workspace API key from https://getsocialclaw.com/dashboard"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/ndesv21/socialclaw",
    "source": "github"
  },
  "websiteUrl": "https://getsocialclaw.com",
  "description": "Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP."
}