SocialSchedule MCP Server — Let AI Agents Schedule Social Posts

The SocialSchedule MCP server exposes draft, schedule, queue, and analytics tools over the Model Context Protocol so Claude, Cursor, ChatGPT agents, and other MCP clients can operate your social calendar with permissions—not paste-and-pray.

Start free

Code samples

Samples stay in English — copy into your terminal, MCP client, or skill file.

MCP server config

{
  "mcpServers": {
    "socialschedule": {
      "command": "npx",
      "args": ["-y", "@socialschedule/mcp-server"],
      "env": {
        "SOCIALSCHEDULE_API_KEY": "ssk_live_xxx"
      }
    }
  }
}

draft_post tool

{
  "tool": "draft_post",
  "arguments": {
    "platforms": ["instagram", "linkedin"],
    "brief": "Announce spring product drop",
    "tone": "friendly-professional"
  }
}

schedule_post tool

{
  "tool": "schedule_post",
  "arguments": {
    "postId": "post_123",
    "publishAt": "optimal",
    "requireApproval": true
  }
}

CLI API Skills

What the SocialSchedule MCP server exposes

MCP tools map to real scheduling actions: draft posts, schedule, list queues, and fetch analytics. Agents discover tools through the MCP schema instead of brittle prompt-only automation. For developers and AI agents, “What the SocialSchedule MCP server exposes” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Workspace scopes keep client or brand data isolated. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

This is category-defining agent infrastructure most legacy schedulers lack. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Install and configure MCP in your agent client

Add the SocialSchedule MCP server to your client config with an API key env var. Works with popular MCP-capable agent clients. For developers and AI agents, “Install and configure MCP in your agent client” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Keep keys in env—not in chat transcripts. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Start in draft-only mode for safer rollouts. JSON config samples below stay in English on purpose. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Conceptual MCP config

Add a server entry in your MCP client pointing at `@socialschedule/mcp-server` with `SOCIALSCHEDULE_API_KEY` in the environment. Start with draft-only tool permissions.

Typical tools agents discover: draft_post, schedule_post, list_queue, and analytics helpers. Require approval for publish-capable tokens in client work.

Verify tool calls by opening the SocialSchedule calendar UI—MCP should create the same drafts marketers already review.

Tools: draft, schedule, list queue, fetch analytics

Typical tools include draft_post, schedule_post, list_queue, and analytics helpers. Draft first when brand risk is high. For developers and AI agents, “Tools: draft, schedule, list queue, fetch analytics” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Schedule with optimal-time or explicit timestamps. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Pull analytics to close the loop on what to create next. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Safe defaults: drafts vs auto-publish permissions

Never give a new agent unconstrained publish rights on day one. Prefer requireApproval and dry-run patterns. For developers and AI agents, “Safe defaults: drafts vs auto-publish permissions” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Separate tokens for read/draft vs publish. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Log tool calls for agency and enterprise governance. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Example agent workflows (weekly calendar generation)

A weekly workflow: analyze winners → draft seven posts → queue at optimal times → await approval. Compose with Skills for reusable playbooks. For developers and AI agents, “Example agent workflows (weekly calendar generation)” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Use CLI for CI-adjacent steps when needed. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Keep humans in the loop for client work. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

MCP vs API vs Skills: architecture guide

MCP is ideal for interactive agents; API for deterministic backends; Skills for packaged playbooks. Many stacks use all three. For developers and AI agents, “MCP vs API vs Skills: architecture guide” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Choose based on who is calling—model, server, or human-operated agent UI. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

See sibling docs for samples. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Platforms available through MCP tools

MCP can target the same platforms connected in your SocialSchedule workspace. Including Instagram, TikTok, LinkedIn, X, and more. For developers and AI agents, “Platforms available through MCP tools” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Platform-native fields still matter—agents should rewrite, not clone. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Compare with Buffer-style queues to see the agent-ready gap. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Security, tokens, and workspace scopes

Treat MCP credentials like production API keys. Rotate tokens, scope by workspace, and revoke quickly. For developers and AI agents, “Security, tokens, and workspace scopes” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Do not paste secrets into prompts. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Combine with approval workflows for defense in depth. Configure MCP, then open the app to verify drafts appear in your calendar. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Frequently asked questions

What is an MCP server for social media scheduling?+

An MCP server lets AI agents call structured tools—draft, schedule, list queues—against your SocialSchedule workspace via the Model Context Protocol.

How do I add the SocialSchedule MCP server?+

Install/run `@socialschedule/mcp-server` and add it to your MCP client config with a SocialSchedule API key.

Which agent clients are supported?+

Any client that supports MCP tool servers (for example Claude-compatible and Cursor-style agent setups).

Can an agent publish without approval?+

Only if you grant publish permissions. We recommend draft-only or requireApproval defaults.

What tools does the MCP server provide?+

Core tools cover drafting, scheduling, queue listing, and analytics retrieval—see schema in your MCP client.

Is MCP more convenient than REST API for agents?+

Usually yes for interactive agents, because tools are discovered and called without custom HTTP glue.

Can I restrict the agent to draft-only mode?+

Yes. Use scoped tokens and approval-required scheduling.

Which social platforms work through MCP?+

Platforms connected in your workspace, matching SocialSchedule’s multi-platform support.

How are API keys and OAuth handled?+

Your SocialSchedule API key authenticates the MCP server; social network OAuth remains managed inside SocialSchedule.

Where is the MCP schema / tool list documented?+

In your MCP client after connecting, plus this page and the API reference for underlying resources.

Connect MCP and let agents draft safely

Tool-calling for calendars and queues—with approval-aware defaults.