Quickstart

Use MCP only when you can’t run the social0 CLI — remote OAuth first, then local npx.

Use the CLI if you can. Agents with a shell should use social0 (npm install -g social0). Continue here only for chat hosts without a reliable shell (Claude.ai, ChatGPT connectors, etc.).

Option A — Remote URL (when you need MCP)

Works with Claude.ai, ChatGPT, and other hosts that accept a remote MCP URL (no shell).

Connect social accounts in Dashboard → Connections.
Open your AI app’s connectors / MCP settings:
- Claude.ai → Settings → Connectors → Add custom connector
- ChatGPT → Settings → Connectors (wording may vary)
- Other hosts → look for remote MCP / custom connector
Add this URL:

https://mcp.social0.app/mcp

Click Connect and authorize on social0.app (OAuth PKCE).
Ask: “Show my connected Social0 accounts.”

No Node.js. No SOCIAL0_API_KEY in config. OAuth creates a connector API key (the UI may show “Claude MCP Connector”). Revoke it anytime in Dashboard → API keys; reconnecting mints a new one.

Cursor (remote URL)

If your Cursor build supports HTTP MCP servers:

{
  "mcpServers": {
    "social0": {
      "url": "https://mcp.social0.app/mcp"
    }
  }
}

Authorize when prompted. If remote/OAuth isn’t available, use Option B.

Media tip (remote)

Use upload_media with a public url or base64 data. Do not pass file_path — sandbox paths fail on the hosted server.

Option B — Local npx (fallback)

Use this for stdio-only hosts (Cursor / Claude Desktop / VS Code, and ChatGPT Desktop only if remote isn’t available).

Install Node.js 20+.
Create an API key at Dashboard → API keys (sk_live_…).
Paste this into your host MCP config:

{
  "mcpServers": {
    "social0": {
      "command": "npx",
      "args": ["-y", "@social0/mcp"],
      "env": {
        "SOCIAL0_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Reload MCP / restart the app.
Ask: “Show my connected Social0 accounts.”

Unscoped npx -y social0-mcp still works as a deprecated alias — prefer @social0/mcp.

If the agent has a shell, stop and use the social0 CLI instead of MCP.

Where to paste

Host	Location
Cursor	Settings → MCP, or `.cursor/mcp.json`
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
VS Code	Copilot / MCP settings (stdio)
ChatGPT Desktop	Prefer Option A; local only if remote isn’t available

Try these prompts

“Show my connected Social0 accounts”
“Post this to LinkedIn and X”
“Schedule this for tomorrow at 9am UTC on Instagram and TikTok”
“Upload this image from a URL and publish it everywhere”

social0 CLI — preferred when you have a terminal or agent shell
Tools reference
Agent examples
Connections
REST API for custom backends only