MCP quick start

Prerequisites

Social0 account with at least one connected platform
API key (sk_live_…)
Node.js 20+
An MCP host (Claude Desktop, Cursor, or VS Code)

Step 1 — Get an API key

Open Developer → API Keys
Click Create key → name it (e.g. "Cursor MCP")
Copy sk_live_… — shown once

Step 2 — Install the MCP server

git clone https://github.com/Abhishek-B-R/social0.git
cd social0/social0-mcp
cp .env.example .env

Edit .env:

SOCIAL0_API_KEY=sk_live_your_key_here
SOCIAL0_API_URL=https://api.social0.app/v1

Build:

npm install && npm run build

Note the absolute path to dist/index.js — you'll need it for MCP config.

Step 3 — Configure your MCP host

Pick your host:

Host	Guide
Claude Desktop	Setup
Cursor	Setup
VS Code	Setup
ChatGPT	Setup

Minimal Cursor config (.cursor/mcp.json or Cursor Settings → MCP):

{
  "mcpServers": {
    "social0": {
      "command": "node",
      "args": ["/absolute/path/to/social0-mcp/dist/index.js"],
      "env": {
        "SOCIAL0_API_KEY": "sk_live_your_key_here",
        "SOCIAL0_API_URL": "https://api.social0.app/v1"
      }
    }
  }
}

Replace /absolute/path/to/social0-mcp with your actual install path.

Step 4 — Restart and verify

Restart your MCP host, then run this prompt:

Use the Social0 MCP list_accounts tool to show my connected accounts.

Expected: a list of platforms with IDs and token status.

Step 5 — Publish your first post

Create a LinkedIn post that says "Hello from Social0 MCP!" and publish it now.

The assistant should:

Call list_accounts to find your LinkedIn account
Call publish_now with content and platform
Return a tracking_id
Call get_publish_status until the job completes

Example multi-step flow

1. upload_media({ file_path: "./logo.png" })           → mediaId
2. create_post({ content: "...", platforms: ["linkedin", "twitter_x"], media: [mediaId] })
3. publish_post({ post_id: "..." })                    → tracking_id
4. get_publish_status({ tracking_id: "..." })          → poll until completed | failed | partial
5. get_post({ post_id: "..." })                        → final per-platform URLs and errors

Multi-platform publishes run in parallel. Poll every 2–5 seconds. Video uploads may take minutes.

Dev mode

Run with verbose logging:

SOCIAL0_MCP_VERBOSE=true SOCIAL0_API_KEY=sk_live_xxx node dist/index.js

Or use tsx for development (Cursor):

{
  "command": "npx",
  "args": ["tsx", "/absolute/path/to/social0-mcp/src/index.ts"],
  "env": { "SOCIAL0_API_KEY": "sk_live_...", "SOCIAL0_MCP_VERBOSE": "true" }
}

MCP Inspector

Test the server without an AI host:

npx @modelcontextprotocol/inspector node dist/index.js

Next steps

Tools reference — all 13 tools
Troubleshooting
REST API — underlying endpoints

On this page