Smart Post Studio MCP Server

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: support@smartpoststudio.com

License

Documentation and examples in this repository: MIT. The Smart Post Studio service is proprietary.