MCP Tools Reference

PlanSched exposes an OAuth 2.1 MCP server at https://plansched.com/mcp. Every tool call runs as the signed-in user — row-level security scopes results to their workspaces automatically. Three tools are live today; the rest are being hardened before they are advertised in the manifest.

Shipping today

• list_workspaces — returns every workspace the caller can access (RLS-scoped).
• list_posts — lists the caller's posts. Filter by status (draft / scheduled / published / failed) or workspace.
• create_post — creates a draft or scheduled post across one or more of the nine supported networks. Provide a future scheduled_at to schedule; omit for a draft.

Coming soon

These tools are already implemented in the app and are being wrapped into MCP. They will appear in the manifest once end-to-end testing is complete. Track progress on the public roadmap.

• delete_post — remove a draft, scheduled, or published post by ID.
• upload_media — upload an image or video to the PlanSched media library.
• upload_media_from_url — fetch an image from a public URL and store it in the media library.
• delete_media — remove an asset from the media library by ID.
• get_post_analytics — retrieve impressions, likes, comments, and shares for a published post.

Roadmap

Planned MCP tools that are not yet in production. These are listed for visibility, not because they are partially available.

• list_accounts — list connected social accounts.
• get_account — get metadata for one connected account.
• list_media — list assets in the media library.
• get_account_analytics — aggregate analytics across a connected account.
• list_inbox — fetch recent comments and messages.
• reply_to_message — post a reply to a comment or message.
• generate_caption — generate a caption with the workspace's brand voice.
• repurpose_content — rewrite a post for a different platform or tone.
• suggest_hooks — generate hook ideas from a topic or URL.
• bulk_schedule — create many scheduled posts from a CSV or JSON payload.
• search_hashtags — suggest trending hashtags for a topic.
• create_thread — create a multi-post thread for X or Threads.
• reschedule_post — move an existing post to a new time.

Notes

Tools that mutate data respect the workspace's approval-flow settings and land as drafts in the calendar when a human gate is active. A public REST API is planned but not yet available — today, MCP is the way in.