Smart Post Studio MCP — connect your AI to your social media queue

Smart Post Studio is a social media scheduler for 8 platforms (Instagram, Threads, TikTok, X, Facebook, YouTube, LinkedIn incl. Company Pages, Fanvue). It exposes a remote MCP server so any MCP-capable assistant — Claude, Claude Code, Cursor, VS Code + Copilot, Gemini CLI — can read your queue, draft posts and schedule them.

This repo is the public documentation and example configs for that server. The server itself is hosted; there is nothing to install or run.

Server URL:  https://app.smartpoststudio.com/v1/mcp
Transport:   Streamable HTTP
Auth:        OAuth (browser sign-in) or Bearer token
Plan:        included on every paid plan, from $8/mo · 14-day free trial, no card

Full guide: https://smartpoststudio.com/mcp

60-second setup

Claude (claude.ai or Claude Desktop)

Settings → Connectors → Add custom connector

• Name: Smart Post Studio
• URL: https://app.smartpoststudio.com/v1/mcp
• Leave OAuth Client ID / Secret empty

Click Add → sign in with your Smart Post Studio email/password → choose what the AI may do (read, draft, schedule) → Allow.

Claude Code

claude mcp add sps --transport http https://app.smartpoststudio.com/v1/mcp

Then run /mcp and finish the sign-in in your browser.

Cursor / VS Code / any client that uses headers

Create a token in the web app → AI access → Create token (shown once), then see examples/ for a ready-made config:

{ "mcpServers": { "sps": {
  "url": "https://app.smartpoststudio.com/v1/mcp",
  "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

Test it

Ask: "What's in my Smart Post Studio queue?"

Tools

Platform keys: instagram, threads, tiktok, x, facebook, youtube, linkedin (personal), linkedin_page (Company Page), fanvue.

Guardrails (by design)

• There is no "post now" tool. Everything an AI creates is a draft or a scheduled post at least 10 minutes out, visible in your Queue with an AI badge. That is a window to intervene, not an approval step.
• Permissions are per connection: read / draft / schedule. Start with read + draft.
• Rate limits: 30 requests/min, 100 AI-created posts/day.
• Media by URL only, public https, ≤ 25 MB each.
• Tokens last 90 days, max 5 per account, revocable instantly under AI access.
• A single post can't mix cloud-published and desktop-published platforms (mixed_fire_platforms) — split it in two.
• Every action is written to your account history.

Error reference

... View full README on GitHub