← All guides
MCP for AI agents

Shossip MCP server

The Shossip MCP server lets an AI agent — Claude Code, Claude Desktop, Cursor, or any other MCP client — post to your social accounts through Shossip, with no browser involved. It calls the same REST API described in the API guide, using your Shossip API key.

Tools

The server exposes five tools:

shossip_list_channels

List your Shossip brand channels (named groups of accounts). Post to a channel id to reach every account in it.

No parameters.
shossip_list_accounts

List your connected social accounts (Facebook, Instagram, LinkedIn, YouTube, TikTok) with their ids and platforms.

No parameters.
shossip_post

Publish or schedule a post to brand channels and/or individual accounts. Provide channelIds, accountIds, or both. A video posts as a Reel on Instagram and straight to your TikTok profile.

Key params: content (required), mediaUrl, channelIds, accountIds, scheduledAt (epoch ms — omit to send now), instagramAsStory, youtubeTitle, youtubeDescription, youtubeTags, youtubePrivacy (public/unlisted/private), youtubeThumbnail, draft.
shossip_list_posts

List recent posts (the queue) with status, content, schedule, and target accounts.

No parameters.
shossip_post_status

Get the status and per-account results of a post by id.

Key params: id (required — the post id shossip_post returned).

Install

You’ll need Node.js 18+ and a Shossip API key from Settings → API & MCP (see the API guide for how to create one). The package isn’t on the npm registry, so every client below installs it straight from the tarball Shossip serves:

https://shossip.com/downloads/shossip-mcp-1.0.0.tgz

Every client needs the same two environment variables: SHOSSIP_API_KEY (required — your key from Settings) and, optionally, SHOSSIP_BASE_URL (defaults to https://shossip.com).

Claude Code

claude mcp add shossip \
  --env SHOSSIP_API_KEY=sk_shossip_… \
  -- npx -y https://shossip.com/downloads/shossip-mcp-1.0.0.tgz

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "shossip": {
      "command": "npx",
      "args": ["-y", "https://shossip.com/downloads/shossip-mcp-1.0.0.tgz"],
      "env": { "SHOSSIP_API_KEY": "sk_shossip_…" }
    }
  }
}

Cursor

In Cursor’s MCP settings (or a project .cursor/mcp.json), add the same server — the shape is identical to Claude Desktop’s:

{
  "mcpServers": {
    "shossip": {
      "command": "npx",
      "args": ["-y", "https://shossip.com/downloads/shossip-mcp-1.0.0.tgz"],
      "env": { "SHOSSIP_API_KEY": "sk_shossip_…" }
    }
  }
}

Example prompts

  • “List my connected Shossip accounts and channels.”
  • “Post ‘Launch day! 🚀’ to my Instagram and LinkedIn accounts right now via Shossip.”
  • “Schedule a Shossip post for tomorrow at 9am to my main channel with this caption: … — then tell me the post id so I can check on it later.”