English Français العربية

Smart Post Studio

السجل الرسمي التسويق والمبيعات

Read, draft and schedule social media posts to 8 platforms. No post-now tool by design.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http smart-post-studio 'https://app.smartpoststudio.com/v1/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "smart-post-studio": {
            "type": "http",
            "url": "https://app.smartpoststudio.com/v1/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Smart Post Studio MCP — connect your AI to your social media queue
  2. 60-second setup
  3. Tools
  4. Guardrails (by design)
  5. Error reference
  6. Example prompts
  7. Which clients can write?
  8. Links
  9. License

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

ToolWhat it doesNotes
get_connected_platformsLists the platforms you've connected and whether each publishes from the cloud or from your desktop appThe AI can never connect a platform itself
list_postsReads your queue, filterable by status (e.g. scheduled)Newest first
create_postCreates a draft or scheduled post: caption, platforms[], optional media_urls[], optional scheduled_atPer-platform limits enforced server-side (X ≤ 280 chars, Threads ≤ 500, Instagram requires media)
update_postEdits caption, platforms, media or timeRequires expected_updated_at — optimistic locking, so two agents can't clobber each other
cancel_postReturns a scheduled post to draftsNot a delete
get_post_resultsPer-platform publish result for a postUse it for "did yesterday's post go out?"

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

ErrorMeaning
mcp_not_enabledNo active paid plan on the account
platform_not_connectedConnect it in the web or desktop app first
scheduled_at_too_soonPick a time ≥ 10 minutes ahead
caption_too_longOver the platform limit (X 280 raw characters, Threads 500)
mixed_fire_platformsSplit into one cloud post and one desktop post
rate_limitedWait a minute and retry
media_url_too_largeImage/video over 25 MB
unauthorizedToken revoked or expired — create a new one

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?

License

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

الأسئلة الشائعة

ما هو Smart Post Studio؟

Read, draft and schedule social media posts to 8 platforms. No post-now tool by design.

كيف أثبّت Smart Post Studio؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http smart-post-studio 'https://app.smartpoststudio.com/v1/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Smart Post Studio إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Smart Post Studio مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Smart Post Studio؟

ينشره Thorarinsson22. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.