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:
List your Shossip brand channels (named groups of accounts). Post to a channel id to reach every account in it.
List your connected social accounts (Facebook, Instagram, LinkedIn, YouTube, TikTok) with their ids and platforms.
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.
content (required), mediaUrl, channelIds, accountIds, scheduledAt (epoch ms — omit to send now), instagramAsStory, youtubeTitle, youtubeDescription, youtubeTags, youtubePrivacy (public/unlisted/private), youtubeThumbnail, draft.List recent posts (the queue) with status, content, schedule, and target accounts.
Get the status and per-account results of a post by id.
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.”