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
Example prompts
See examples/prompts.md for a full week. The short version:
- "What's scheduled across all my platforms for the next seven days? Group it by day and flag any empty day."
- "Draft posts about [topic] for Instagram, Threads and LinkedIn — same idea, different openings. Keep Threads under 500 characters. Save as drafts, don't schedule."
- "Schedule the Instagram draft for Tuesday 10:00 with this image: https://…"
- "Move that post to Friday." / "Cancel it."
- "Did yesterday's post go out everywhere?"
Which clients can write?
Tested: Claude (all tiers incl. free), Claude Code, Cursor — read + write. ChatGPT: full MCP including writes is Business/Enterprise/Edu only per OpenAI's docs; Pro is read-only. Details and dates: Which AI can actually schedule your posts over MCP?
Links
- Setup guide: https://smartpoststudio.com/mcp
- 7 copy-paste prompts: https://smartpoststudio.com/blog/claude-prompts-for-social-media-mcp
- How-to with every tool that supports MCP: https://smartpoststudio.com/blog/social-media-schedulers-with-mcp-2026
- Pricing: https://smartpoststudio.com/pricing
- Support: [email protected]
License
Documentation and examples in this repository: MIT. The Smart Post Studio service is proprietary.