# socialclaw MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-ndesv21-socialclaw
- Repository: https://github.com/ndesv21/socialclaw

## Install
- Command: `npx -y socialclaw`
- Endpoint: https://getsocialclaw.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- Package: Npm socialclaw v0.1.18
- Environment variable: SOCIALCLAW_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://getsocialclaw.com/mcp
- Header: Authorization

## Tools
- list_accounts - List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, youtube, reddit, wordpress). Endpoint: https://getsocialclaw.com/mcp
- account_capabilities - 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. Endpoint: https://getsocialclaw.com/mcp
- connect_account - 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. Endpoint: https://getsocialclaw.com/mcp
- upload_asset - 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 schedules. Endpoint: https://getsocialclaw.com/mcp
- validate_schedule - Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule. Endpoint: https://getsocialclaw.com/mcp
- preview_campaign - Preview how a campaign schedule document expands into concrete posts and steps without creating anything. Endpoint: https://getsocialclaw.com/mcp
- apply_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. Endpoint: https://getsocialclaw.com/mcp
- publish_draft - Publish a previously created draft run, optionally at a given ISO-8601 start time. Endpoint: https://getsocialclaw.com/mcp
- list_posts - List posts in the workspace with optional filters. Endpoint: https://getsocialclaw.com/mcp
- list_assets - 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. Endpoint: https://getsocialclaw.com/mcp
- get_post - Get one post including its delivery state and provider identifiers. Endpoint: https://getsocialclaw.com/mcp
- post_attempts - List publish attempts for a post, including provider errors. Use this to debug failed posts. Endpoint: https://getsocialclaw.com/mcp
- retry_post - Retry a failed post. Endpoint: https://getsocialclaw.com/mcp
- cancel_post - Cancel a scheduled post before it publishes. Endpoint: https://getsocialclaw.com/mcp
- run_status - Get the status summary of a publishing run and its posts. Endpoint: https://getsocialclaw.com/mcp
- get_analytics - Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier. Endpoint: https://getsocialclaw.com/mcp
- workspace_usage - Get workspace usage counters and plan entitlement consumption. Endpoint: https://getsocialclaw.com/mcp
- workspace_health - Get workspace health, including connection state across providers. Pass provider to check one provider's connections. Endpoint: https://getsocialclaw.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.ndesv21
- Version: 0.1.18
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 27, 2026
- Source: https://registry.modelcontextprotocol.io