MCP Tools
Complete reference for all MisarSocial MCP server tools — inputs, outputs, and usage examples.
list_posts
Lists the authenticated user's scheduled posts with optional status filter and pagination.
Input
| Field | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: pending, queued, published, failed, cancelled |
page | number | No | Page number (default: 1) |
Output — array of posts with id, platform, content_text, status, scheduled_at, published_at.
schedule_post
Schedules a post to a connected social account.
Input
| Field | Type | Required | Description |
|---|---|---|---|
connectedAccountId | string | Yes | UUID of the connected account |
platform | string | Yes | twitter, linkedin, instagram, threads, tiktok, bluesky |
contentText | string | Yes | Post content (max 5000 chars) |
scheduledAt | string | Yes | ISO 8601 datetime or "now" |
firstComment | string | No | First comment after post publishes |
Output — created post object with id, status: "queued", queue_job_id.
cancel_post
Cancels a pending or queued post.
Input
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | UUID of the post to cancel |
Output — { ok: true }
list_connections
Lists all active connected social accounts.
Input — none
Output — array of { id, platform, display_name, avatar_url, status }.
generate_post
Generates AI-powered post variants from a topic.
Input
| Field | Type | Required | Description |
|---|---|---|---|
topic | string | Yes | Topic or description (3–500 chars) |
platforms | string[] | Yes | Target platforms |
tone | string | No | professional, casual, technical, inspirational |
count | number | No | Variants per platform (1–5, default 3) |
Output — { variants: [{ platform, variants: [{ caption, hashtags }] }] }
list_drafts
Lists draft and pending-review post variants.
Input — none
Output — array of { id, platform, caption, hashtags, tone, status, source } (max 50).
approve_drafts
Bulk approves or rejects draft variants.
Input
| Field | Type | Required | Description |
|---|---|---|---|
action | string | Yes | "approve" or "reject" |
ids | string[] | Yes | Array of draft UUIDs |
Output — { updated: number }
get_stats
Gets dashboard overview stats.
Input — none
Output — { connectedAccounts, queuedPosts, publishedThisWeek, publishedThisMonth, drafts, lastPost, topPerformingPost, avgEngagementRate }
get_trends
Gets the latest TrendPulse trend snapshots.
Input — none
Output — { trends: [{ hashtag, niche, score, growth_pct, volume, lifecycle }], source }
repurpose_content
Repurposes a URL or raw text into platform-specific post variants.
Input
| Field | Type | Required | Description |
|---|---|---|---|
sourceType | string | Yes | "url" or "text" |
sourceUrl | string | Conditional | Required when sourceType is "url" |
rawContent | string | Conditional | Required when sourceType is "text" (max 20000 chars) |
platforms | string[] | No | Target platforms (defaults to all) |
tone | string | No | Writing tone (default "professional") |
Output — { source: { id, title, core_message }, variants: [{ platform, content, hashtags }] }