MCP setup

The Socialit MCP server exposes the public API as Model Context Protocol tools, so AI agents can manage media, posts, social accounts, and social postings on your behalf.

You’ll need a workspace API key (sk_...).

The server supports two transports: stdio (default, local) and Streamable HTTP (remote).

Stdio transport

Claude Code

claude mcp add socialit -e SOCIALIT_API_KEY=sk_live_xxx -- npx -y @socialit/mcp

Cursor

Open Cursor Settings → MCP → Add new global MCP server:

{
  "mcpServers": {
    "socialit": {
      "command": "npx",
      "args": ["-y", "@socialit/mcp"],
      "env": { "SOCIALIT_API_KEY": "sk_live_xxx" }
    }
  }
}

Claude Desktop

Open Settings → Developer → Edit Config:

{
  "mcpServers": {
    "socialit": {
      "command": "npx",
      "args": ["-y", "@socialit/mcp"],
      "env": { "SOCIALIT_API_KEY": "sk_live_xxx" }
    }
  }
}

HTTP transport

Run the server over HTTP for remote integrations. Each client passes its API key as a Bearer token.

npx -y @socialit/mcp --http --port 3000

The MCP endpoint is served at http://127.0.0.1:3000/mcp using Streamable HTTP.

Claude Code

claude mcp add socialit --transport http http://127.0.0.1:3000/mcp \
  --header "Authorization: Bearer sk_live_xxx"

Cursor

{
  "mcpServers": {
    "socialit": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": { "Authorization": "Bearer sk_live_xxx" }
    }
  }
}

Options

Flag	Env var	Default	Description
--key	SOCIALIT_API_KEY	—	API key (required for stdio).
--base-url	SOCIALIT_BASE_URL	https://api.socialit.com/v1	API base URL.
--http	—	off	Use HTTP transport.
--port	MCP_PORT	3000	HTTP port.