How do I install Smart Post Studio?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Smart Post Studio need an API key?

No required environment variable is listed on this record.

What transport does Smart Post Studio use?

Smart Post Studio is reached over HTTP.

When was Smart Post Studio last checked?

Last checked 2026-11-09. Read, draft and schedule social media posts to 8 platforms. No post-now tool by design.

Smart Post Studio MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://app.smartpoststudio.com/v1/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.thorarinsson22-smart-post-studio https://app.smartpoststudio.com/v1/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.thorarinsson22-smart-post-studio": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://app.smartpoststudio.com/v1/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Smart Post Studio?

Does Smart Post Studio need an API key?

What transport does Smart Post Studio use?

When was Smart Post Studio last checked?

Documentation

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

60-second setup

Claude (claude.ai or Claude Desktop)

Claude Code

Cursor / VS Code / any client that uses headers

Test it

Tools

Guardrails (by design)

Error reference

Example prompts

Which clients can write?

Links

License