# socialclaw

Wires your agent to social accounts through a hosted service: schedule, publish, inspect. Needs a workspace key and an active plan.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 98
- Author: ndesv21
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ndesv21/socialclaw
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/socialclaw

## What it does

socialclaw is an MCP server that hands your agent 17 publishing tools tied to the accounts in your workspace: list accounts and their capabilities, upload media, validate and preview a schedule, apply it with idempotency keys, publish drafts, and inspect posts, attempts, runs, analytics, usage and workspace health. Everything runs against the hosted SocialClaw service, not on your machine.

The server starts with `npx -y socialclaw mcp`. Your key goes in through `SOCIALCLAW_API_KEY`. Ran `socialclaw login --api-key <key>` earlier? Then the saved credentials are picked up and the `env` block can be dropped. A key by itself won't get you far: the workspace also needs an active trial or paid plan, or commands come back with `plan_required` or `subscription_*`.

Account connections use browser OAuth, except Discord and Telegram, which are wired by hand — a webhook URL for one, a bot token plus `chat-id` for the other. Schedules are accepted as JSON or YAML. The package installs globally with `npm install -g socialclaw`, or as an agent skill via `npx skills add ndesv21/socialclaw`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://getsocialclaw.com/mcp`
- Environment variables: `SOCIALCLAW_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add socialclaw -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclaw
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add socialclaw --url https://getsocialclaw.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add socialclaw --env SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclaw
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "socialclaw": {
            "url": "https://getsocialclaw.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "socialclaw": {
            "command": "npx",
            "args": [
                "-y",
                "socialclaw"
            ],
            "env": {
                "SOCIALCLAW_API_KEY": "<SOCIALCLAW_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "socialclaw": {
            "type": "http",
            "url": "https://getsocialclaw.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "socialclaw": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "socialclaw"
            ],
            "env": {
                "SOCIALCLAW_API_KEY": "<SOCIALCLAW_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http socialclaw https://getsocialclaw.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> socialclaw npx -y socialclaw
```
Replace <…> with your own values

## When to use it
- queue posts to several networks from one schedule file
- upload an image and attach it to a post
- catch schedule errors before anything goes out
- check how a published post was delivered
- remove a published post on the provider side

## Example prompts
- List my connected accounts and what each one supports
- Validate `schedule.json` and show me the campaign preview
- Upload `./image.png` and queue a post with it

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md