MCP Tools Reference

PlanSched exposes 20+ MCP tools so your AI agents can plan, publish, analyze, and respond across every connected network. All tools respect the same permissions as the API key that authorizes the MCP session.

Publishing

• create_post — draft or schedule a post across one or many accounts.
• bulk_schedule — queue up to 500 posts from a CSV or JSON array in one call.
• reschedule_post — move a scheduled post to a new time without re-uploading media.
• duplicate_post — clone an existing post as a new draft on the same or other accounts.
• delete_post — cancel a scheduled post or remove a draft by ID.
• list_posts — list posts with filters for status, platform, date range, and workspace.
• create_thread — post a native X or Threads thread from an ordered array of items.
• get_best_time — return the highest-engagement publish window for a given account.

Accounts & networks

• list_accounts — return every connected social account with platform, handle, and status.
• get_account — deep info for one account: token freshness, permissions, and rate-limit budget.
• list_workspaces — enumerate workspaces the agent has access to.

Media

• upload_media — upload an image or video directly from bytes or a base64 payload.
• upload_media_from_url — fetch a remote asset and register it in the media library.
• list_media — browse the media library with tag and workspace filters.
• delete_media — remove a media asset by ID.

Analytics & insights

• get_post_analytics — impressions, engagement, and link clicks for a published post.
• get_account_analytics — follower growth, top posts, and reach cohorts for a date range.
• compare_posts — A/B compare metrics across two or more posts or hooks.

AI content

• generate_caption — draft a caption for a topic, tone, and target platform.
• repurpose_content — turn one long source into native variants for every selected platform.
• suggest_hooks — return top-performing opening hooks from the PlanSched hook library.

Research & trends

• search_hashtags — discover trending hashtags scoped to a platform and niche.
• analyze_competitor — summarize a competitor handle's recent posting cadence and top formats.

Engagement

• list_inbox — stream comments, mentions, and DMs across every connected account.
• reply_to_message — send a native reply to a comment or DM by inbox item ID.

Notes

Tool signatures mirror the REST endpoints one-to-one — anything documented in the API Reference works identically through MCP. Tools that mutate data (create, delete, reply) respect the workspace's approval-flow settings and will return a pending_approval status when a human gate is active.