Smart Post Studio

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)

Claude Code

claude mcp add --transport http smart-post-studio 'https://app.smartpoststudio.com/v1/mcp'

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "smart-post-studio": {
            "type": "http",
            "url": "https://app.smartpoststudio.com/v1/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

Smart Post Studio MCP — connect your AI to your social media queue
60-second setup
Tools
Guardrails (by design)
Error reference
Example prompts
Which clients can write?
Links
License

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

Tool	What it does	Notes
`get_connected_platforms`	Lists the platforms you've connected and whether each publishes from the cloud or from your desktop app	The AI can never connect a platform itself
`list_posts`	Reads your queue, filterable by `status` (e.g. `scheduled`)	Newest first
`create_post`	Creates a draft or scheduled post: `caption`, `platforms[]`, optional `media_urls[]`, optional `scheduled_at`	Per-platform limits enforced server-side (X ≤ 280 chars, Threads ≤ 500, Instagram requires media)
`update_post`	Edits caption, platforms, media or time	Requires `expected_updated_at` — optimistic locking, so two agents can't clobber each other
`cancel_post`	Returns a scheduled post to drafts	Not a delete
`get_post_results`	Per-platform publish result for a post	Use 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

Error	Meaning
`mcp_not_enabled`	No active paid plan on the account
`platform_not_connected`	Connect it in the web or desktop app first
`scheduled_at_too_soon`	Pick a time ≥ 10 minutes ahead
`caption_too_long`	Over the platform limit (X 280 raw characters, Threads 500)
`mixed_fire_platforms`	Split into one cloud post and one desktop post
`rate_limited`	Wait a minute and retry
`media_url_too_large`	Image/video over 25 MB
`unauthorized`	Token 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.

Frequently asked questions

What is Smart Post Studio?

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

How do I install Smart Post Studio?

It runs as a remote server. In Claude Code: claude mcp add --transport http smart-post-studio 'https://app.smartpoststudio.com/v1/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Smart Post Studio need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Smart Post Studio open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Smart Post Studio?

It is published by Thorarinsson22. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: Thorarinsson22
Category: Marketing and sales
Runs: Remote
GitHub stars: ★ 0
License: MIT
Last commit: Oct 14, 2026
Open issues: 0
Version: 1.0.0
Published: Oct 14, 2026

io.github.Thorarinsson22/smart-post-studio

Similar servers

GhostPaw Affinity Local relationship model and social CRM for contacts, relationships, evidence, and comm...
Web Validator by DigestSEO Audit public webpages and supplied markup for HTML, CSS, SEO, JSON-LD, and link issues.
Quattr AI Visibility MCP SEO MCP for Claude and ChatGPT: GSC, market share, AI citations, and CWV.
PublishBuddy Schedule social posts, read analytics and make AI images and video for 10+ networks.
Oktio.app Instagram analytics, media kits, bio link and brand deals for creators, from your AI as...
Ssemble AI Clipping Create AI-powered short-form video clips from YouTube videos. Supports webhook callbacks.
AdRails Open-source, self-hosted Google Ads MCP server: guarded writes for AI agents. Your keys...
HeyLead — AI agent for LinkedIn outreach AI agent for LinkedIn outreach: finds the right people, writes in your voice, follows u...

Marketing and sales

Smart Post Studio

Install

Documentation