Socialclaw

by ndesv21

346 downloads

Not rated

GitHub

Communication

About

Social media scheduling MCP for AI agents posting to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.

Details

Author: ndesv21
Downloads: 346
Categories: Communication

- 17 validation-first tools for publishing and inspection
- Works with X, LinkedIn, Instagram, Facebook, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest
- Idempotency-key deduplication for safe schedule application
- Draft preview and human approval before posting
- Per-attempt delivery state for debugging failed posts
- Upload media once and reuse hosted URLs across posts

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Socialclaw

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

From the repository

Sign in at getsocialclaw.com/dashboard (Google), connect your social accounts, and create a workspace API key. Then add the server to your MCP client using the npx -y socialclaw mcp command with the SOCIALCLAW_API_KEY environment variable, or use the hosted streamable HTTP endpoint at https://getsocialclaw.com/mcp with an Authorization: Bearer <key> header. A typical agent flow is: list_accounts → account_capabilities → upload_asset → validate_schedule → apply_schedule → run_status.

`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).

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

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

`upload_asset`

Upload a local media file (image or video) to SocialClaw hosted storage. Returns an asset id and a public URL that can be used as media_link in schedules.

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

`preview_campaign`

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

`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; one is generated when omitted.

`publish_draft`

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

`list_posts`

List posts in the workspace with optional filters.

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

`get_post`

Get one post including its delivery state and provider identifiers.

`post_attempts`

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

`retry_post`

Retry a failed post.

`cancel_post`

Cancel a scheduled post before it publishes.

`run_status`

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

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

`workspace_usage`

Get workspace usage counters and plan entitlement consumption.

`workspace_health`

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "socialclaw": {
            "socialclaw": {
                "command": "npx",
                "args": [
                    "-y",
                    "socialclaw",
                    "mcp"
                ],
                "env": {
                    "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "socialclaw": {
        "command": "npx",
        "args": [
            "-y",
            "socialclaw",
            "mcp"
        ],
        "env": {
            "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
        }
    }
}

SocialClaw MCP Server

Social media scheduling and publishing for AI agents. SocialClaw gives any MCP client (Claude Code, Claude Desktop, Cursor, and others) 17 validation-first tools to publish through real connected social accounts on X, LinkedIn (profiles + pages), Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest — all from one workspace. Unlike direct posting integrations, SocialClaw is built so agents don't post blindly: schedules are validated against provider rules (media limits, account types, publish times) before anything goes live, drafts can be previewed and approved by a human, and every post exposes per-attempt delivery state for debugging. ## Tools - Accounts — list_accounts, account_capabilities, connect_account - Media — upload_asset (upload once, get a hosted URL reusable across posts) - Publishing — validate_schedule, preview_campaign, apply_schedule (idempotency-key deduplication), publish_draft - Inspection — list_posts, get_post, post_attempts, retry_post, cancel_post, run_status - Workspace — get_analytics, workspace_usage, workspace_health ## Setup 1. Sign in at getsocialclaw.com/dashboard (Google), connect your social accounts, and create a workspace API key. 2. Add the server to your MCP client: ``

json
  {
    "mcpServers": {
      "socialclaw": {
2. Add the server to your MCP client:

json
{
  "mcpServers": {
    "socialclaw": {
      "command": "npx",
      "args": ["-y", "socialclaw", "mcp"],
      "env": {
        "SOCIALCLAW_API_KEY": "<YOUR_WORKSPACE_API_KEY>"
      }
    }
  }
}

`` Hosted endpoint (no install) The same server runs hosted over streamable HTTP at https://getsocialclaw.com/mcp — send your key as Authorization: Bearer <key>: claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp \ --header "Authorization: Bearer <YOUR_WORKSPACE_API_KEY>" Typical agent flow list_accounts → account_capabilities → upload_asset → validate_schedule → apply_schedule → run_status Links Website (https://getsocialclaw.com) · MCP docs (https://getsocialclaw.com/mcp) · API reference (https://getsocialclaw.com/docs/api) · npm (https://www.npmjs.com/package/socialclaw) · GitHub (https://github.com/ndesv21/socialclaw)

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_accounts

account_capabilities

connect_account

upload_asset

validate_schedule

preview_campaign

apply_schedule

publish_draft

list_posts

list_assets

get_post

post_attempts

retry_post

cancel_post

run_status

get_analytics

workspace_usage

workspace_health

Claude Desktop / Cursor

McpServers

SocialClaw MCP Server

Install

More like this

Slack

Inbox Zero

Production-ready MCP integrations for AI applications

whatsapp-mcp

Apple Native Tools

WeChat Summarizer

`list_accounts`

`account_capabilities`

`connect_account`

`upload_asset`

`validate_schedule`

`preview_campaign`

`apply_schedule`

`publish_draft`

`list_posts`

`list_assets`

`get_post`

`post_attempts`

`retry_post`

`cancel_post`

`run_status`

`get_analytics`

`workspace_usage`

`workspace_health`