MCP Tools

The MisarPost MCP server exposes 21 tools grouped into five areas: connections, posts, drafts, generation, and ContentRipple. Tool names below match the server implementation exactly.

Connections

list_connections

Lists all active connected social accounts for the authenticated user. Returns the account IDs needed for scheduling posts.

Input — none

Output — array of { id, platform, display_name, avatar_url, status }.

---

get_stats

Gets dashboard overview stats.

Input — none

Output — { connectedAccounts, queuedPosts, publishedThisWeek, publishedThisMonth, drafts, lastPost, topPerformingPost, avgEngagementRate }

---

Posts

list_posts

Lists the authenticated user's scheduled/published posts with optional status filter and pagination.

Input

Output — array of posts with id, platform, content_text, status, scheduled_at, published_at.

---

update_post

Edits a pending or queued post's content, scheduled time, or first comment.

Input

Output — the updated post object.

---

cancel_post

Cancels a pending or queued post.

Input

Output — { ok: true }

---

schedule_post

Schedules a new post to a connected social account.

Input

Output — created post object with id, status, and queue_job_id.

---

Drafts

list_drafts

Lists draft and pending-review post variants (generated from GitHub webhooks or AI). Returns up to 50.

Input — none

Output — array of { id, platform, caption, hashtags, tone, status, source }.

---

bulk_action_drafts

Approves or rejects multiple draft variants by their IDs.

Input

Output — { updated: number }

---

Generation

generate_posts

Generates AI post variants for one or more platforms. Returns up to 5 variants per platform, saved as drafts.

Input

Output — { variants: [{ platform, variants: [{ caption, hashtags }] }] }

---

enhance_topic

Rewrites a raw topic into a structured content brief: enhanced topic, suggested tone, content angles, and key messages.

Input

Output — { enhancedTopic, suggestedTone, contentAngles, keyMessages }

---

generate_plan

Generates hook options, best time slots, and trending hashtags for a topic across platforms.

Input

Output — { hooks, bestTimeSlots, trendingHashtags, suggestedImageStyle }

---

get_optimization_insights

Gets AI-powered optimization insights based on post performance from the last 30 days. Returns best time of day, best tone, top hashtags, and platform-specific insights.

Input

Output — { bestTimeOfDay, bestTone, topHashtags, promptSuggestions, platformInsights }

---

research_hashtags

Generates a tiered hashtag strategy for a keyword across platforms, including per-platform algorithm signals.

Input

Output — tiered hashtag strategy keyed by platform.

---

ContentRipple

get_contentripple_usage

Gets the current month's ContentRipple repurpose usage and limit for the authenticated user.

Input — none

Output — { count, limit, tier }

---

repurpose_content

Repurposes a URL or raw text into multiple platform-native content variants. Requires a ContentRipple plan allowance.

Input

Output — { source: { id, title, core_message }, variants: [{ platform, content, hashtags }] }

---

update_content_variant

Edits a generated ContentRipple content variant — updates its text or sets its status.

Input

Output — { variant }

---

schedule_content_variant

Schedules a ContentRipple variant to a connected social account via the EchoForge queue.

Input

Output — { post }

---

get_trends

Fetches the latest trending hashtags and content hooks for the user's configured niches. Returns cached results (< 2 hours old) or triggers a live refresh.

Input — none

Output — { trends: [{ hashtag, niche, score, growth_pct, volume, lifecycle }], source }

---

queue_trend_drafts

Triggers the TrendPulse pipeline: takes trend snapshots and creates draft post variants in the EchoForge queue for each connected platform.

Input

Output — { queued: string[] }

---

get_calendar

Gets scheduled posts in a date range for the content calendar view.

Input

Output — { posts }