Plan, generate, schedule and repurpose posts across every channel, and track what performs.
Call this server's tools from your browser. Nothing to install.
MisarPost API key. Format: Bearer mpk_… — create one at https://post.misar.io/dashboard/api-keys
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Analyse a competitor's public X (Twitter) or LinkedIn account — posting frequency, content pillars, gaps, engagement and best posting time — and save it (re-analysing the same handle updates it). Needs a plan that includes competitor analysis; otherwise it returns an upgrade message.
The competitor's handle on that platform.
Platform the handle is on.
The competitor's niche, for context.
Name to show for this competitor.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Analyse a competitor's public X (Twitter) or LinkedIn account — posting frequency, content pillars, gaps, engagement and best posting time — and save it (re-analysing the same handle updates it). Needs a plan that includes competitor analysis; otherwise it returns an upgrade message.
| Argument | Type | Description |
|---|---|---|
| niche | string | The competitor's niche, for context. |
| handle* | string | The competitor's handle on that platform. |
| platform* | string | Platform the handle is on. |
| display_name | string | Name to show for this competitor. |
{
"type": "object",
"required": [
"handle",
"platform"
],
"properties": {
"niche": {
"type": "string",
"description": "The competitor's niche, for context."
},
"handle": {
"type": "string",
"minLength": 1,
"description": "The competitor's handle on that platform."
},
"platform": {
"enum": [
"twitter",
"linkedin"
],
"type": "string",
"description": "Platform the handle is on."
},
"display_name": {
"type": "string",
"description": "Name to show for this competitor."
}
}
}Cancel a post that is still pending or queued, so it never publishes. Posts that are already publishing or published cannot be cancelled, and a cancelled post cannot be re-queued — it must be scheduled again. To change a post instead, use update_post. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| post_id* | string | Post UUID — from list_posts. |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post UUID — from list_posts."
}
}
}Turn a plug on or off for one connected account and set its configuration, replacing the plug's previous configuration. An activated plug later acts on that account's published posts automatically, in public, without asking again — confirm the exact plug and settings with the user first. Get valid plug keys and config fields from list_account_plugs.
| Argument | Type | Description |
|---|---|---|
| config | object | The plug's configuration as flat key → string/number/boolean values, using the configFields list_account_plugs returns. Replaces the existing configuration. |
| plug_key* | string | Plug key — from list_account_plugs definitions. |
| activated* | boolean | true to activate the plug, false to switch it off. |
| account_id* | string | Connected account UUID — from list_connections. |
{
"type": "object",
"required": [
"account_id",
"plug_key",
"activated"
],
"properties": {
"config": {
"type": "object",
"description": "The plug's configuration as flat key → string/number/boolean values, using the configFields list_account_plugs returns. Replaces the existing configuration."
},
"plug_key": {
"type": "string",
"description": "Plug key — from list_account_plugs definitions."
},
"activated": {
"type": "boolean",
"description": "true to activate the plug, false to switch it off."
},
"account_id": {
"type": "string",
"description": "Connected account UUID — from list_connections."
}
}
}Start learning a writing persona from recent posts — either a connected account (instagram, twitter, youtube) or a public profile (youtube, medium, mastodon, bluesky). Fetches the posts and analyses them with AI in the background (counts against the plan's AI image allowance, for the persona cover); returns a job id to poll with get_persona_job_status.
| Argument | Type | Description |
|---|---|---|
| name | string | Optional persona name (max 60 characters). |
| platform* | string | connected_account: instagram, twitter, youtube. public_profile: youtube, medium, mastodon, bluesky. |
| identifier | string | Required for public_profile — the profile handle or URL (max 300 characters). |
| source_kind* | string | Learn from one of the user's connected accounts, or from a public profile. |
| connected_account_id | string | Required for connected_account — from list_connections. |
{
"type": "object",
"required": [
"source_kind",
"platform"
],
"properties": {
"name": {
"type": "string",
"description": "Optional persona name (max 60 characters)."
},
"platform": {
"enum": [
"instagram",
"twitter",
"youtube",
"medium",
"mastodon",
"bluesky"
],
"type": "string",
"description": "connected_account: instagram, twitter, youtube. public_profile: youtube, medium, mastodon, bluesky."
},
"identifier": {
"type": "string",
"description": "Required for public_profile — the profile handle or URL (max 300 characters)."
},
"source_kind": {
"enum": [
"connected_account",
"public_profile"
],
"type": "string",
"description": "Learn from one of the user's connected accounts, or from a public profile."
},
"connected_account_id": {
"type": "string",
"description": "Required for connected_account — from list_connections."
}
}
}Create a post tag with a name and colour, for grouping posts by campaign or theme. Names must be unique per user.
| Argument | Type | Description |
|---|---|---|
| name* | string | Tag name (1–60 characters). |
| color* | string | Tag colour. |
{
"type": "object",
"required": [
"name",
"color"
],
"properties": {
"name": {
"type": "string",
"description": "Tag name (1–60 characters)."
},
"color": {
"enum": [
"red",
"orange",
"amber",
"green",
"teal",
"blue",
"indigo",
"purple",
"pink",
"slate"
],
"type": "string",
"description": "Tag colour."
}
}
}Save a reusable post template: default text, optional per-platform text, target accounts, platform settings, media and first comment. Saving publishes nothing.
| Argument | Type | Description |
|---|---|---|
| name* | string | Template name (1–120 characters). |
| media | array | Up to 10 media attachments. |
| content | string | Default post text, up to 20,000 characters. |
| account_ids | array | Connected account UUIDs the template targets (max 50) — from list_connections. |
| first_comment | string | First comment text (max 2200 characters). |
| content_overrides | object | Per-platform text that replaces content for that platform, as platform → text. |
| platform_settings | object | Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta). |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Template name (1–120 characters)."
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"kind",
"file_name"
],
"properties": {
"url": {
"type": "string",
"description": "Public media URL."
},
"kind": {
"enum": [
"image",
"video"
],
"type": "string"
},
"file_name": {
"type": "string",
"description": "Display file name (max 300 characters)."
}
}
},
"description": "Up to 10 media attachments."
},
"content": {
"type": "string",
"description": "Default post text, up to 20,000 characters."
},
"account_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Connected account UUIDs the template targets (max 50) — from list_connections."
},
"first_comment": {
"type": "string",
"description": "First comment text (max 2200 characters)."
},
"content_overrides": {
"type": "object",
"description": "Per-platform text that replaces content for that platform, as platform → text."
},
"platform_settings": {
"type": "object",
"description": "Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta)."
}
}
}Write a short talking-presenter video script from a post's text. Saves nothing; counts against the monthly AI allowance. Show the script to the user before generate_video.
| Argument | Type | Description |
|---|---|---|
| post_text* | string | Post text to base the script on (1–4000 characters). |
{
"type": "object",
"required": [
"post_text"
],
"properties": {
"post_text": {
"type": "string",
"description": "Post text to base the script on (1–4000 characters)."
}
}
}Register an outbound webhook: MisarPost will POST signed payloads for the chosen events to this URL from now on. The response carries the signing secret exactly once — tell the user to store it; it cannot be shown again. Sending account data to a new URL needs the user's explicit approval of that URL.
| Argument | Type | Description |
|---|---|---|
| url* | string | The user's public HTTPS endpoint (max 2048 characters). |
| events* | array | Events to deliver: post.published, post.failed, account.disconnected. |
{
"type": "object",
"required": [
"url",
"events"
],
"properties": {
"url": {
"type": "string",
"description": "The user's public HTTPS endpoint (max 2048 characters)."
},
"events": {
"type": "array",
"items": {
"enum": [
"post.published",
"post.failed",
"account.disconnected"
],
"type": "string"
},
"minItems": 1,
"description": "Events to deliver: post.published, post.failed, account.disconnected."
}
}
}Permanently delete a file from the media library and storage. Posts that already include its URL keep their own copy of the URL, but the file behind it is gone. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| media_id* | string | Media UUID — from list_media. |
{
"type": "object",
"required": [
"media_id"
],
"properties": {
"media_id": {
"type": "string",
"description": "Media UUID — from list_media."
}
}
}Permanently delete a persona and its learned voice. Recreating it means re-running create_persona. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| persona_id* | string | Persona UUID — from list_personas. |
{
"type": "object",
"required": [
"persona_id"
],
"properties": {
"persona_id": {
"type": "string",
"description": "Persona UUID — from list_personas."
}
}
}Permanently delete a post tag and remove it from every post that carries it. The posts themselves are not affected. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| tag_id* | string | Tag UUID — from list_post_tags. |
{
"type": "object",
"required": [
"tag_id"
],
"properties": {
"tag_id": {
"type": "string",
"description": "Tag UUID — from list_post_tags."
}
}
}Permanently delete a saved post template. Posts already scheduled from it are not affected. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| template_id* | string | Template UUID — from list_post_templates. |
{
"type": "object",
"required": [
"template_id"
],
"properties": {
"template_id": {
"type": "string",
"description": "Template UUID — from list_post_templates."
}
}
}Delete one repurposed source and its variants from ContentRipple history. Posts already scheduled or published from it are not touched. This cannot be undone — confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| source_id* | string | Source UUID — from list_repurpose_history. |
{
"type": "object",
"required": [
"source_id"
],
"properties": {
"source_id": {
"type": "string",
"description": "Source UUID — from list_repurpose_history."
}
}
}Permanently remove an outbound webhook; events stop being delivered to its URL. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| webhook_id* | string | Webhook UUID — from list_webhooks. |
{
"type": "object",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "string",
"description": "Webhook UUID — from list_webhooks."
}
}
}Rewrite a raw topic or idea into a structured content brief: a sharper topic, suggested tone, content angles and key messages for the chosen platforms. Saves nothing; counts against the monthly AI allowance. Feed the result to generate_plan or generate_posts.
| Argument | Type | Description |
|---|---|---|
| goal | string | Content goal (default engagement). |
| audience | string | Target audience, up to 200 characters. |
| platforms* | array | Target platforms (at least one). |
| raw_topic* | string | Raw topic or idea (3–500 characters). |
{
"type": "object",
"required": [
"raw_topic",
"platforms"
],
"properties": {
"goal": {
"enum": [
"awareness",
"engagement",
"conversion",
"viral"
],
"type": "string",
"description": "Content goal (default engagement)."
},
"audience": {
"type": "string",
"description": "Target audience, up to 200 characters."
},
"platforms": {
"type": "array",
"items": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"bluesky"
],
"type": "string"
},
"minItems": 1,
"description": "Target platforms (at least one)."
},
"raw_topic": {
"type": "string",
"description": "Raw topic or idea (3–500 characters)."
}
}
}Read an RSS or Atom feed and return its entries, so the user can pick one to repurpose with repurpose_content (source_type rss). Nothing is saved.
| Argument | Type | Description |
|---|---|---|
| feed_url* | string | URL of the RSS or Atom feed. |
{
"type": "object",
"required": [
"feed_url"
],
"properties": {
"feed_url": {
"type": "string",
"format": "uri",
"description": "URL of the RSS or Atom feed."
}
}
}Generate two profile-bio variants for one platform in the user's trained voice — A authority-focused, B curiosity-focused — and save them as a bio A/B test. Optionally pass the current bio to improve on. Uses one AI text action. Nothing is changed on the platform itself.
| Argument | Type | Description |
|---|---|---|
| platform* | string | Platform the bio is for, e.g. twitter or linkedin. |
| current_bio | string | The bio the user has now, to improve on. |
{
"type": "object",
"required": [
"platform"
],
"properties": {
"platform": {
"type": "string",
"minLength": 1,
"description": "Platform the bio is for, e.g. twitter or linkedin."
},
"current_bio": {
"type": "string",
"maxLength": 500,
"description": "The bio the user has now, to improve on."
}
}
}Generate an image for a post from a text prompt, sized for the platform (16:9 for X, LinkedIn and YouTube, square for Instagram and Threads, 9:16 for TikTok), and store it in the user's media. Returns its URL to attach to a post. Uses one AI image action from the plan's quota. Nothing is posted.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | What the image should show. |
| platform | string | Platform to size it for (default twitter). |
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"maxLength": 1000,
"minLength": 10,
"description": "What the image should show."
},
"platform": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"youtube"
],
"type": "string",
"description": "Platform to size it for (default twitter)."
}
}
}Write a post about a topic in a persona's voice (or the user's own trained voice when no persona is given), with a voice-match score. The post is saved for review, not scheduled. Counts against the monthly PersonaForge post allowance.
| Argument | Type | Description |
|---|---|---|
| topic* | string | What the post is about (1–500 characters). |
| platform* | string | Platform to write for, e.g. linkedin or twitter. |
| persona_id | string | Persona UUID — from list_personas. Omit to use the user's own trained voice. |
{
"type": "object",
"required": [
"topic",
"platform"
],
"properties": {
"topic": {
"type": "string",
"description": "What the post is about (1–500 characters)."
},
"platform": {
"type": "string",
"description": "Platform to write for, e.g. linkedin or twitter."
},
"persona_id": {
"type": "string",
"description": "Persona UUID — from list_personas. Omit to use the user's own trained voice."
}
}
}Draft a reply, in the user's trained voice, to an inbound comment or message on one of their posts. The draft is saved as pending for review (list_persona_replies) — nothing is sent. Needs a plan with PersonaForge replies.
| Argument | Type | Description |
|---|---|---|
| platform* | string | Platform the conversation is on. |
| inbound_text* | string | The comment or message to reply to (max 2000 characters). |
| source_post_id* | string | Platform id of the user's post being replied under. |
| source_post_text* | string | Text of that post (max 1000 characters). |
{
"type": "object",
"required": [
"platform",
"source_post_id",
"source_post_text",
"inbound_text"
],
"properties": {
"platform": {
"type": "string",
"description": "Platform the conversation is on."
},
"inbound_text": {
"type": "string",
"description": "The comment or message to reply to (max 2000 characters)."
},
"source_post_id": {
"type": "string",
"description": "Platform id of the user's post being replied under."
},
"source_post_text": {
"type": "string",
"description": "Text of that post (max 1000 characters)."
}
}
}For a topic or brief, suggest hook options, the best posting time slots, and trending hashtags per platform. Saves nothing and schedules nothing; counts against the monthly AI allowance.
| Argument | Type | Description |
|---|---|---|
| platforms* | array | Target platforms (at least one). |
| enhanced_topic* | string | Topic or content brief (3–1000 characters), e.g. from enhance_topic. |
{
"type": "object",
"required": [
"enhanced_topic",
"platforms"
],
"properties": {
"platforms": {
"type": "array",
"items": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"bluesky"
],
"type": "string"
},
"minItems": 1,
"description": "Target platforms (at least one)."
},
"enhanced_topic": {
"type": "string",
"description": "Topic or content brief (3–1000 characters), e.g. from enhance_topic."
}
}
}Write AI post variants about a topic for one or more platforms — up to 5 per platform — and save them as drafts (visible in list_drafts). Nothing is scheduled or published. Each call counts against the plan's monthly AI generation allowance.
| Argument | Type | Description |
|---|---|---|
| tone | string | Writing tone (default professional). |
| count | number | Variants per platform, 1–5 (default 3). |
| topic* | string | Topic or brief for the posts (3–500 characters). |
| platforms* | array | Platforms to write for (at least one). |
{
"type": "object",
"required": [
"topic",
"platforms"
],
"properties": {
"tone": {
"enum": [
"professional",
"casual",
"technical",
"inspirational"
],
"type": "string",
"description": "Writing tone (default professional)."
},
"count": {
"type": "number",
"description": "Variants per platform, 1–5 (default 3)."
},
"topic": {
"type": "string",
"description": "Topic or brief for the posts (3–500 characters)."
},
"platforms": {
"type": "array",
"items": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"bluesky",
"youtube"
],
"type": "string"
},
"minItems": 1,
"description": "Platforms to write for (at least one)."
}
}
}Generate per-platform content (hashtags, and titles where a platform needs them) for one trend snapshot, for the platforms asked (default: all seven). Regenerating replaces the earlier content for those platforms. Nothing is posted — turn one into a draft with use_trend_platform_content.
| Argument | Type | Description |
|---|---|---|
| platforms | array | Platforms to generate for. Omit for all of them. |
| snapshot_id* | string | Trend snapshot UUID — from get_trends. |
{
"type": "object",
"required": [
"snapshot_id"
],
"properties": {
"platforms": {
"type": "array",
"items": {
"enum": [
"twitter",
"linkedin",
"instagram",
"mastodon",
"bluesky",
"youtube",
"medium"
],
"type": "string"
},
"minItems": 1,
"description": "Platforms to generate for. Omit for all of them."
},
"snapshot_id": {
"type": "string",
"description": "Trend snapshot UUID — from get_trends."
}
}
}Start rendering an AI presenter video from a script, avatar and voice. Returns a job id immediately; poll get_video_status until it completes. Rendering is metered and spends the user's video allowance — confirm the script first.
| Argument | Type | Description |
|---|---|---|
| script* | string | What the presenter says (1–5000 characters). |
| captions | boolean | Burn in captions (default true). |
| provider | string | Video provider (default heygen, currently the only one). |
| voice_id* | string | Voice id — from list_video_voices. |
| avatar_id* | string | Avatar id — from list_video_avatars. |
| aspect_ratio* | string | Video shape. |
{
"type": "object",
"required": [
"script",
"avatar_id",
"voice_id",
"aspect_ratio"
],
"properties": {
"script": {
"type": "string",
"description": "What the presenter says (1–5000 characters)."
},
"captions": {
"type": "boolean",
"description": "Burn in captions (default true)."
},
"provider": {
"type": "string",
"description": "Video provider (default heygen, currently the only one)."
},
"voice_id": {
"type": "string",
"description": "Voice id — from list_video_voices."
},
"avatar_id": {
"type": "string",
"description": "Avatar id — from list_video_avatars."
},
"aspect_ratio": {
"enum": [
"portrait",
"story"
],
"type": "string",
"description": "Video shape."
}
}
}Get per-channel daily trends for the last 7, 30 or 90 days: posts published and failed, engagement and impressions, totals, and the change against the previous period. Each channel's metric field says whether real engagement data exists for it (engagement) or only publish volume (posts) — never present a posts-only channel's zero engagement as a real result.
| Argument | Type | Description |
|---|---|---|
| days | number | Window in days (default 30). |
{
"type": "object",
"properties": {
"days": {
"enum": [
7,
30,
90
],
"type": "number",
"description": "Window in days (default 30)."
}
}
}Get every post scheduled between two dates (default: 7 days ago to 30 days ahead), oldest first, with platform, status, time, text, media, first comment and tags — the content calendar view. Optionally only posts with one tag. Needs a plan that includes the content calendar; otherwise it returns an upgrade message.
| Argument | Type | Description |
|---|---|---|
| to | string | End date, YYYY-MM-DD, inclusive (default 30 days from now). |
| from | string | Start date, YYYY-MM-DD (default 7 days ago). |
| tag_id | string | Only posts carrying this post tag (UUID). |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "End date, YYYY-MM-DD, inclusive (default 30 days from now)."
},
"from": {
"type": "string",
"description": "Start date, YYYY-MM-DD (default 7 days ago)."
},
"tag_id": {
"type": "string",
"description": "Only posts carrying this post tag (UUID)."
}
}
}Show how many ContentRipple repurposes the user has run this month, their monthly limit (null means unlimited), and their plan tier. Check before a large repurposing run so it does not stop halfway.
No arguments.
{
"type": "object",
"properties": {}
}Get the Growth Hub overview for the last 7, 30 or 90 days: per-platform engagement trend lines, the weakest-performing platforms (bottlenecks), which post formats perform best, and which platforms have real trend data behind their suggestions. Requires the Empire plan; on other plans it returns an upgrade message.
| Argument | Type | Description |
|---|---|---|
| days | number | Window in days (default 30). |
{
"type": "object",
"properties": {
"days": {
"enum": [
7,
30,
90
],
"type": "number",
"description": "Window in days (default 30)."
}
}
}Get the single best next content opportunity for the user's connected platforms and niches — a compact version of list_growth_opportunities. Returns `{ opportunity: null }` rather than an invented one when there is no real signal. Requires the Empire plan; on other plans it returns an upgrade message.
No arguments.
{
"type": "object",
"properties": {}
}Analyse the last 30 days of post metrics with AI and return the best time of day, best tone, top hashtags, prompt suggestions and per-platform insights. Changes nothing, but each call counts against the monthly AI allowance.
| Argument | Type | Description |
|---|---|---|
| platform | string | Only this platform's posts. Omit for all platforms. |
{
"type": "object",
"properties": {
"platform": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"bluesky",
"youtube"
],
"type": "string",
"description": "Only this platform's posts. Omit for all platforms."
}
}
}Get one persona in full: its name, cover image, source account, and the style profile used when writing in it.
| Argument | Type | Description |
|---|---|---|
| persona_id* | string | Persona UUID — from list_personas. |
{
"type": "object",
"required": [
"persona_id"
],
"properties": {
"persona_id": {
"type": "string",
"description": "Persona UUID — from list_personas."
}
}
}Check a persona extraction job started by create_persona: its status, the new persona's id once done, or the error.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Job id — from create_persona. |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "Job id — from create_persona."
}
}
}Get one saved post template in full, by id — to reuse its text, accounts and settings in schedule_post.
| Argument | Type | Description |
|---|---|---|
| template_id* | string | Template UUID — from list_post_templates. |
{
"type": "object",
"required": [
"template_id"
],
"properties": {
"template_id": {
"type": "string",
"description": "Template UUID — from list_post_templates."
}
}
}Get the account overview: connected accounts, posts queued, published this week and this month, drafts waiting, the last published post, the top performing post of the month, and the average engagement rate (null when no metrics exist yet).
No arguments.
{
"type": "object",
"properties": {}
}Get the content hooks (opening lines and angles) for one trend snapshot — snapshot ids come from get_trends.
| Argument | Type | Description |
|---|---|---|
| snapshot_id* | string | Trend snapshot UUID — from get_trends. |
{
"type": "object",
"required": [
"snapshot_id"
],
"properties": {
"snapshot_id": {
"type": "string",
"description": "Trend snapshot UUID — from get_trends."
}
}
}Show how the user's trend-sourced posts actually performed: each TrendPulse draft (last 100) joined to whether it was scheduled or published and its likes, comments, reposts, impressions and reach.
No arguments.
{
"type": "object",
"properties": {}
}Get the per-platform content already generated for one trend snapshot — hashtags, plus title/description for YouTube and title/subtitle for Medium. Empty until generate_trend_platform_content has run for it.
| Argument | Type | Description |
|---|---|---|
| snapshot_id* | string | Trend snapshot UUID — from get_trends. |
{
"type": "object",
"required": [
"snapshot_id"
],
"properties": {
"snapshot_id": {
"type": "string",
"description": "Trend snapshot UUID — from get_trends."
}
}
}Get the latest trending hashtags and content hooks for the user's TrendPulse niches, each with a snapshot id. Returns cached results under two hours old, or refreshes them live from the trend sources.
No arguments.
{
"type": "object",
"properties": {}
}Check an AI video job: processing, failed (with the error), or completed with the video's URL in the media storage — ready for schedule_post's media_urls.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Job id — from generate_video. |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "Job id — from generate_video."
}
}
}Get the user's own trained voice model — tone breakdown, signature phrases, emoji patterns, average post length, preferred hooks, hashtag style and how many posts it learned from. `model` is null until train_voice_model has run.
No arguments.
{
"type": "object",
"properties": {}
}Show the plugs (automatic follow-up actions — e.g. reposting or resharing a post once it passes a likes or reactions threshold, on X, Bluesky, Threads and LinkedIn) available for one connected account, how each is currently configured and activated, and the account's 20 most recent plug runs.
| Argument | Type | Description |
|---|---|---|
| account_id* | string | Connected account UUID — from list_connections. |
{
"type": "object",
"required": [
"account_id"
],
"properties": {
"account_id": {
"type": "string",
"description": "Connected account UUID — from list_connections."
}
}
}List the competitor accounts the user has analysed, newest first, with posting frequency, content pillars, gaps, average engagement and best posting time.
No arguments.
{
"type": "object",
"properties": {}
}List the user's active connected social accounts with their account ID, platform and display name. Call this before scheduling: schedule_post needs the connected_account_id, and a post can only go to an account that is connected and active.
No arguments.
{
"type": "object",
"properties": {}
}List up to 50 draft post variants awaiting review (status draft or pending_review), newest first — including AI-generated drafts from generate_posts — with platform, caption, hashtags, tone and source.
No arguments.
{
"type": "object",
"properties": {}
}List rising trends worth posting about now, limited to the user's niches and to platforms they have connected, each with the hashtag, its growth, and a posting suggestion. Returns an empty list — never an invented one — when no real signal exists. Requires the Empire plan; on other plans it returns an upgrade message.
No arguments.
{
"type": "object",
"properties": {}
}Get per-platform growth playbooks for the user's connected platforms — cadence, format, timing and anti-spam guidance compiled from each platform's official creator documentation, with source links. Requires the Empire plan; on other plans it returns an upgrade message.
No arguments.
{
"type": "object",
"properties": {}
}List the user's uploaded media library, newest first, 24 per page, with each file's public URL — usable directly in schedule_post's media_urls.
| Argument | Type | Description |
|---|---|---|
| page | number | 1-indexed page (default 1, 24 items per page). |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "1-indexed page (default 1, 24 items per page)."
}
}
}List the user's MisarPost notifications (publish results, account problems and the like), newest first, with the unread count.
| Argument | Type | Description |
|---|---|---|
| page | number | 1-indexed page (default 1). |
| page_size | number | Items per page (default 20, max 50). |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "1-indexed page (default 1)."
},
"page_size": {
"type": "number",
"description": "Items per page (default 20, max 50)."
}
}
}List AI-drafted replies to inbound comments and messages, by status (default pending — the ones waiting for review).
| Argument | Type | Description |
|---|---|---|
| status | string | Which replies to list (default pending). |
{
"type": "object",
"properties": {
"status": {
"enum": [
"pending",
"approved",
"edited",
"posted",
"skipped"
],
"type": "string",
"description": "Which replies to list (default pending)."
}
}
}List the user's PersonaForge personas — writing styles learned from a real account — plus extraction jobs still running and recent failures.
No arguments.
{
"type": "object",
"properties": {}
}List the user's post tags (id, name, colour). Tag ids filter list_posts and get_calendar and are applied with schedule_post or update_post.
No arguments.
{
"type": "object",
"properties": {}
}List the user's saved post templates, most recently updated first — reusable composer states with text, per-platform overrides, target accounts, platform settings, media and first comment.
No arguments.
{
"type": "object",
"properties": {}
}List the user's scheduled and published posts, newest-scheduled first, 20 per page, with platform, status, scheduled/published time, post URL, tags and engagement metrics. Filter by status (e.g. queued or pending for what is coming up — the content calendar — or published for what went out) or by tag.
| Argument | Type | Description |
|---|---|---|
| page | number | 1-indexed page number (default 1, 20 posts per page). |
| status | string | Only posts in this status. Omit for every status except archived and cancelled. |
| tag_id | string | Only posts carrying this post tag (UUID). |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "1-indexed page number (default 1, 20 posts per page)."
},
"status": {
"enum": [
"pending",
"queued",
"publishing",
"published",
"failed",
"rejected",
"cancelled",
"archived"
],
"type": "string",
"description": "Only posts in this status. Omit for every status except archived and cancelled."
},
"tag_id": {
"type": "string",
"description": "Only posts carrying this post tag (UUID)."
}
}
}Look up the destinations a connected account can publish into — Discord or Slack channels, Pinterest boards, Reddit post flairs, Hashnode or Medium publications, Hashnode tags, Lemmy communities, Listmonk lists or templates, Skool groups, Whop forums, or WordPress categories and tags. Use the returned ids in schedule_post's platform_meta. Reads live from the platform, so an empty list can also mean the platform could not be reached.
| Argument | Type | Description |
|---|---|---|
| kind* | string | Which list to fetch; it must match the connected account's platform. |
| subreddit | string | Subreddit name (without r/). Required for kind=reddit_flairs. |
| account_id* | string | Connected account UUID — from list_connections. |
{
"type": "object",
"required": [
"kind",
"account_id"
],
"properties": {
"kind": {
"enum": [
"discord_channels",
"slack_channels",
"pinterest_boards",
"reddit_flairs",
"hashnode_publications",
"hashnode_tags",
"medium_publications",
"lemmy_communities",
"listmonk_lists",
"listmonk_templates",
"skool_groups",
"whop_forums",
"wordpress_taxonomies"
],
"type": "string",
"description": "Which list to fetch; it must match the connected account's platform."
},
"subreddit": {
"type": "string",
"description": "Subreddit name (without r/). Required for kind=reddit_flairs."
},
"account_id": {
"type": "string",
"description": "Connected account UUID — from list_connections."
}
}
}List past ContentRipple repurposes, newest first: each source (type, URL, title, core message) with its variants and, for variants that were scheduled, the post's status, URL and engagement.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many sources (default 20, at most 50). |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many sources (default 20, at most 50)."
}
}
}List the stock presenter avatars available for AI video generation. Pass an avatar's id to generate_video.
| Argument | Type | Description |
|---|---|---|
| provider | string | Video provider (default heygen, currently the only one). |
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "Video provider (default heygen, currently the only one)."
}
}
}List the stock voices available for AI video generation. Pass a voice's id to generate_video.
| Argument | Type | Description |
|---|---|---|
| provider | string | Video provider (default heygen, currently the only one). |
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "Video provider (default heygen, currently the only one)."
}
}
}List the user's outbound webhooks — the URLs MisarPost sends signed event payloads to — with their events and whether each is active. Signing secrets are never returned.
No arguments.
{
"type": "object",
"properties": {}
}List the workspaces the user belongs to. When workspace scoping is on, posts, accounts and stats are limited to the active workspace.
No arguments.
{
"type": "object",
"properties": {}
}Mark every unread notification as read. There is no way to mark them unread again.
No arguments.
{
"type": "object",
"properties": {}
}Mark one notification as read, e.g. after relaying it to the user. It drops out of the unread count.
| Argument | Type | Description |
|---|---|---|
| notification_id* | string | Notification UUID — from list_notifications. |
{
"type": "object",
"required": [
"notification_id"
],
"properties": {
"notification_id": {
"type": "string",
"description": "Notification UUID — from list_notifications."
}
}
}Extract the core message, key points and structure from a URL, pasted text (50-20,000 characters) or Markdown, without generating any variants — a preview of what repurpose_content would work from. Counts against the monthly repurpose limit and uses one AI text action, so prefer repurpose_content when the user wants variants anyway.
| Argument | Type | Description |
|---|---|---|
| url | string | Required when type is url. |
| text | string | Required when type is text. |
| type* | string | What kind of source: a URL, plain text, or Markdown (docforge). |
| markdown | string | Required when type is docforge. |
{
"type": "object",
"required": [
"type"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Required when type is url."
},
"text": {
"type": "string",
"maxLength": 20000,
"minLength": 50,
"description": "Required when type is text."
},
"type": {
"enum": [
"url",
"text",
"docforge"
],
"type": "string",
"description": "What kind of source: a URL, plain text, or Markdown (docforge)."
},
"markdown": {
"type": "string",
"maxLength": 20000,
"minLength": 50,
"description": "Required when type is docforge."
}
}
}Turn 1–3 trend snapshots (from get_trends) into draft posts — one per snapshot for each platform the user has connected — saved to the draft queue (list_drafts). Nothing is scheduled or published.
| Argument | Type | Description |
|---|---|---|
| snapshot_ids* | array | 1–3 trend snapshot UUIDs — from get_trends. |
{
"type": "object",
"required": [
"snapshot_ids"
],
"properties": {
"snapshot_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"description": "1–3 trend snapshot UUIDs — from get_trends."
}
}
}Force a fresh fetch of trending hashtags from every trend source for the user's niches and store new snapshots, instead of waiting for the scheduled refresh. Needs a plan that includes manual refresh; otherwise it returns an upgrade message. Use get_trends afterwards to read them.
No arguments.
{
"type": "object",
"properties": {}
}Rename a persona. Its learned voice is unchanged.
| Argument | Type | Description |
|---|---|---|
| name* | string | New name (1–60 characters). |
| persona_id* | string | Persona UUID — from list_personas. |
{
"type": "object",
"required": [
"persona_id",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "New name (1–60 characters)."
},
"persona_id": {
"type": "string",
"description": "Persona UUID — from list_personas."
}
}
}Post a public reply/comment on one of the user's ALREADY-PUBLISHED posts, on the platform it was published to. It goes live immediately and cannot be recalled from here. Show the user the exact text and get their explicit approval before calling. Not every platform supports replies; an unsupported one returns an error.
| Argument | Type | Description |
|---|---|---|
| message* | string | The reply text. |
| post_id* | string | Post UUID — from list_posts (status published). |
{
"type": "object",
"required": [
"post_id",
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The reply text."
},
"post_id": {
"type": "string",
"description": "Post UUID — from list_posts (status published)."
}
}
}Turn one source — a URL, pasted text or markdown, or an RSS item — into channel-native variants such as an X thread, LinkedIn post or carousel, Instagram caption or reel script, newsletter, or YouTube description. Fetches the URL, extracts the core message, writes each variant with AI, and saves source and variants. Returns each saved variant with its id. Nothing is scheduled or published. Counts against the monthly ContentRipple allowance.
| Argument | Type | Description |
|---|---|---|
| tone | string | Writing tone (default professional). |
| formats | array | Which variants to write. Omit for all of them. |
| source_url | string | Source URL (required for source_type=url). |
| raw_content | string | Source text or markdown, up to 20,000 characters (required for text/docforge). |
| source_type* | string | url: fetch source_url. text or docforge: use raw_content (pasted text or markdown). rss: pass the item's URL as source_url. |
{
"type": "object",
"required": [
"source_type"
],
"properties": {
"tone": {
"type": "string",
"description": "Writing tone (default professional)."
},
"formats": {
"type": "array",
"items": {
"enum": [
"twitter_thread",
"linkedin_post",
"linkedin_carousel",
"instagram_caption",
"instagram_reel_script",
"email_newsletter",
"youtube_description",
"slack_announcement",
"reddit_post",
"notion_page",
"threads_post",
"mastodon_post",
"bluesky_post"
],
"type": "string"
},
"description": "Which variants to write. Omit for all of them."
},
"source_url": {
"type": "string",
"description": "Source URL (required for source_type=url)."
},
"raw_content": {
"type": "string",
"description": "Source text or markdown, up to 20,000 characters (required for text/docforge)."
},
"source_type": {
"enum": [
"url",
"text",
"docforge",
"rss"
],
"type": "string",
"description": "url: fetch source_url. text or docforge: use raw_content (pasted text or markdown). rss: pass the item's URL as source_url."
}
}
}Build a tiered hashtag strategy for a keyword across platforms — broad, mid and niche tags plus each platform's algorithm signals. Saves nothing; counts against the monthly AI allowance.
| Argument | Type | Description |
|---|---|---|
| goal | string | Strategy goal (default awareness). |
| niche | string | Content niche, up to 100 characters. |
| keyword* | string | Primary keyword or topic (2–200 characters). |
| platforms* | array | Target platforms (at least one). |
{
"type": "object",
"required": [
"keyword",
"platforms"
],
"properties": {
"goal": {
"enum": [
"awareness",
"engagement",
"conversion",
"viral"
],
"type": "string",
"description": "Strategy goal (default awareness)."
},
"niche": {
"type": "string",
"description": "Content niche, up to 100 characters."
},
"keyword": {
"type": "string",
"description": "Primary keyword or topic (2–200 characters)."
},
"platforms": {
"type": "array",
"items": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"bluesky",
"youtube"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1,
"description": "Target platforms (at least one)."
}
}
}Delete an ALREADY-PUBLISHED post from the platform it went out on (unlike cancel_post, which only stops a post that has not published yet). This removes it from the user's live profile and cannot be undone. Get the user's explicit approval for this exact post first. The response includes the post's postBatchId, for revert_post_batch.
| Argument | Type | Description |
|---|---|---|
| post_id* | string | Post UUID — from list_posts (status published). |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post UUID — from list_posts (status published)."
}
}
}"Delete everywhere": delete every published post from one batch (one compose or repurpose action sent to several accounts) from all of its platforms. Each platform is attempted separately and reported separately; some platforms (e.g. TikTok) have no delete API and need manual clean-up. Cannot be undone — get the user's explicit approval first.
| Argument | Type | Description |
|---|---|---|
| post_batch_id* | string | Batch UUID — post_batch_id from list_posts, or postBatchId from revert_post. |
{
"type": "object",
"required": [
"post_batch_id"
],
"properties": {
"post_batch_id": {
"type": "string",
"description": "Batch UUID — post_batch_id from list_posts, or postBatchId from revert_post."
}
}
}Approve or reject several drafts at once by ID. Approving does NOT schedule or publish anything — use schedule_post for that. Rejected drafts drop out of list_drafts. Returns how many drafts were updated.
| Argument | Type | Description |
|---|---|---|
| ids* | array | Draft UUIDs — from list_drafts. |
| action* | string | What to do with the drafts. |
{
"type": "object",
"required": [
"action",
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Draft UUIDs — from list_drafts."
},
"action": {
"enum": [
"approve",
"reject"
],
"type": "string",
"description": "What to do with the drafts."
}
}
}Approve, edit or reject one pending AI-drafted reply. Approving or editing adds the final text to the draft queue (list_drafts) — it is not posted. Reject marks it skipped. Act only on the user's decision.
| Argument | Type | Description |
|---|---|---|
| action* | string | Decision. |
| reply_id* | string | Reply UUID — from list_persona_replies. |
| edited_text | string | Required for action=edit: the corrected reply (max 2000 characters). |
{
"type": "object",
"required": [
"reply_id",
"action"
],
"properties": {
"action": {
"enum": [
"approve",
"edit",
"reject"
],
"type": "string",
"description": "Decision."
},
"reply_id": {
"type": "string",
"description": "Reply UUID — from list_persona_replies."
},
"edited_text": {
"type": "string",
"description": "Required for action=edit: the corrected reply (max 2000 characters)."
}
}
}Schedule a saved ContentRipple variant (its text plus hashtags) to a connected account of the matching platform at a given time. Only these formats can be published: twitter_thread, linkedin_post, linkedin_carousel, instagram_caption, instagram_reel_script, threads_post, mastodon_post, bluesky_post — the rest are copy-only. This queues real content for a real audience; confirm the text, account and time with the user first.
| Argument | Type | Description |
|---|---|---|
| variant_id* | string | Content variant UUID — from repurpose_content. |
| scheduled_at* | string | ISO 8601 datetime (UTC, e.g. 2030-01-01T09:00:00Z). |
| post_batch_id | string | Optional UUID shared with sibling posts of the same content, for managing them together. |
| connected_account_id* | string | Connected account UUID on the variant's platform — from list_connections. |
{
"type": "object",
"required": [
"variant_id",
"connected_account_id",
"scheduled_at"
],
"properties": {
"variant_id": {
"type": "string",
"description": "Content variant UUID — from repurpose_content."
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 datetime (UTC, e.g. 2030-01-01T09:00:00Z)."
},
"post_batch_id": {
"type": "string",
"description": "Optional UUID shared with sibling posts of the same content, for managing them together."
},
"connected_account_id": {
"type": "string",
"description": "Connected account UUID on the variant's platform — from list_connections."
}
}
}Schedule a post to ONE connected account at a given time, or publish it immediately with scheduled_at="now". This queues real content for a real audience — show the user the exact text, account and time and get explicit approval first. To post the same content to several accounts, call once per account with the same post_batch_id. The user's post signature is appended server-side, and the safety gateway may refuse a post (account health, daily limits, duplicates).
| Argument | Type | Description |
|---|---|---|
| tag_ids | array | Up to 20 post tag UUIDs to apply. |
| platform* | string | Platform of that connected account (must match it). |
| media_urls | array | Up to 10 publicly reachable media URLs to attach. |
| variant_id | string | UUID of the draft (from list_drafts or generate_posts) this post was made from; marks that draft as scheduled. |
| content_text* | string | Post text, 1–5000 characters. |
| scheduled_at* | string | ISO 8601 datetime with timezone (e.g. 2030-01-01T09:00:00Z), or "now" to publish immediately. |
| first_comment | string |
Publish posts about 1–3 trend snapshots to the given connected accounts, scheduled five minutes from now — one post per content hook per account, written from the trend's hooks. This puts real content in front of a real audience almost immediately and the user does not see the text first: show them get_trends' hooks and get explicit approval. Prefer queue_trend_drafts when they want to review.
| Argument | Type | Description |
|---|---|---|
| snapshot_ids* | array | 1–3 trend snapshot UUIDs — from get_trends. |
| connected_account_ids* | array | Connected account UUIDs to post to — from list_connections. |
{
"type": "object",
"required": [
"snapshot_ids",
"connected_account_ids"
],
"properties": {
"snapshot_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"description": "1–3 trend snapshot UUIDs — from get_trends."
},
"connected_account_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Connected account UUIDs to post to — from list_connections."
}
}
}Email the user their trend digest (top recent trends for their niches) now. It always goes to the account owner's own address — never anyone else. Returns `skipped` when the digest is turned off or there are no recent trends.
No arguments.
{
"type": "object",
"properties": {}
}Create (or return the existing) public preview link for one of the user's posts. Anyone with the link can view the post without signing in, so get the user's explicit approval before sharing. Revoke it with unshare_post.
| Argument | Type | Description |
|---|---|---|
| post_id* | string | Post UUID — from list_posts. |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post UUID — from list_posts."
}
}
}Train (or retrain) the user's own voice model from their last 50 published posts. Replaces the existing voice model. Uses one AI text action from the plan's quota and fails with a clear message when the user has no published posts yet. Confirm with the user before retraining.
No arguments.
{
"type": "object",
"properties": {}
}Revoke a post's public preview link, so the old link stops working. Safe to call when no link exists.
| Argument | Type | Description |
|---|---|---|
| post_id* | string | Post UUID — from list_posts. |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post UUID — from list_posts."
}
}
}Edit a saved ContentRipple variant's text (which marks it edited) and/or set its status. Use the variant id returned by repurpose_content. Publishes nothing.
| Argument | Type | Description |
|---|---|---|
| status | string | New status. At least one of content or status is required. |
| content | string | New variant text, up to 20,000 characters. |
| variant_id* | string | Content variant UUID — from repurpose_content. |
{
"type": "object",
"required": [
"variant_id"
],
"properties": {
"status": {
"enum": [
"generated",
"edited",
"queued",
"posted"
],
"type": "string",
"description": "New status. At least one of content or status is required."
},
"content": {
"type": "string",
"description": "New variant text, up to 20,000 characters."
},
"variant_id": {
"type": "string",
"description": "Content variant UUID — from repurpose_content."
}
}
}Edit a post that has not gone out yet (status pending, queued or draft): its text, its scheduled time, its first comment, or its tags. Changing the time moves when it publishes, so confirm the new text and time with the user first. Published posts cannot be edited.
| Argument | Type | Description |
|---|---|---|
| post_id* | string | Post UUID — from list_posts or get_calendar. |
| tag_ids | array | Replace the post's tags with these post tag UUIDs (max 20); [] removes all. |
| content_text | string | New post text. |
| scheduled_at | string | New ISO 8601 datetime with timezone offset, e.g. 2030-01-01T09:00:00+05:30. |
| first_comment | string | null | New first comment, or null to remove it. |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "Post UUID — from list_posts or get_calendar."
},
"tag_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the post's tags with these post tag UUIDs (max 20); [] removes all."
},
"content_text": {
"type": "string",
"description": "New post text."
},
"scheduled_at": {
"type": "string",
"description": "New ISO 8601 datetime with timezone offset, e.g. 2030-01-01T09:00:00+05:30."
},
"first_comment": {
"type": [
"string",
"null"
],
"description": "New first comment, or null to remove it."
}
}
}Rename and/or recolour a post tag. Posts keep the tag.
| Argument | Type | Description |
|---|---|---|
| name | string | New name (1–60 characters). |
| color | string | New colour. |
| tag_id* | string | Tag UUID — from list_post_tags. |
{
"type": "object",
"required": [
"tag_id"
],
"properties": {
"name": {
"type": "string",
"description": "New name (1–60 characters)."
},
"color": {
"enum": [
"red",
"orange",
"amber",
"green",
"teal",
"blue",
"indigo",
"purple",
"pink",
"slate"
],
"type": "string",
"description": "New colour."
},
"tag_id": {
"type": "string",
"description": "Tag UUID — from list_post_tags."
}
}
}Change a saved post template. Only the fields passed are changed, and each one passed replaces the stored value entirely (e.g. account_ids replaces the whole list).
| Argument | Type | Description |
|---|---|---|
| name | string | Template name (1–120 characters). |
| media | array | Up to 10 media attachments. |
| content | string | Default post text, up to 20,000 characters. |
| account_ids | array | Connected account UUIDs the template targets (max 50) — from list_connections. |
| template_id* | string | Template UUID — from list_post_templates. |
| first_comment | string | First comment text (max 2200 characters). |
| content_overrides | object | Per-platform text that replaces content for that platform, as platform → text. |
| platform_settings | object | Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta). |
Change an outbound webhook's URL or events, or pause/resume it with active. Only the fields passed change.
| Argument | Type | Description |
|---|---|---|
| url | string | New public HTTPS endpoint. |
| active | boolean | false pauses delivery, true resumes it. |
| events | array | Events to deliver: post.published, post.failed, account.disconnected. |
| webhook_id* | string | Webhook UUID — from list_webhooks. |
{
"type": "object",
"required": [
"webhook_id"
],
"properties": {
"url": {
"type": "string",
"description": "New public HTTPS endpoint."
},
"active": {
"type": "boolean",
"description": "false pauses delivery, true resumes it."
},
"events": {
"type": "array",
"items": {
"enum": [
"post.published",
"post.failed",
"account.disconnected"
],
"type": "string"
},
"minItems": 1,
"description": "Events to deliver: post.published, post.failed, account.disconnected."
},
"webhook_id": {
"type": "string",
"description": "Webhook UUID — from list_webhooks."
}
}
}Turn one platform's generated trend content into a draft post (generating it first if needed). The draft lands in the review queue (list_drafts) — nothing is published or scheduled.
| Argument | Type | Description |
|---|---|---|
| platform* | string | Which platform's content to draft. |
| snapshot_id* | string | Trend snapshot UUID — from get_trends. |
{
"type": "object",
"required": [
"snapshot_id",
"platform"
],
"properties": {
"platform": {
"enum": [
"twitter",
"linkedin",
"instagram",
"mastodon",
"bluesky",
"youtube",
"medium"
],
"type": "string",
"description": "Which platform's content to draft."
},
"snapshot_id": {
"type": "string",
"description": "Trend snapshot UUID — from get_trends."
}
}
}| Optional first comment posted under the post (max 2200 characters). |
| platform_meta | object | Platform-specific publish settings, passed through to the publisher. Examples: Reddit { subreddit, flairId }, Pinterest { board }, Discord/Slack { channelId }, YouTube { title, privacyStatus }, Hashnode/Medium { publicationId }, Listmonk { listId, templateId }, Lemmy { communityId }, Skool { groupId }. Look up valid ids with list_publish_options. |
| post_batch_id | string | UUID shared by every call that posts the same content to different accounts, so they can later be managed together. |
| connected_account_id* | string | Connected account UUID — from list_connections. |
{
"type": "object",
"required": [
"connected_account_id",
"platform",
"content_text",
"scheduled_at"
],
"properties": {
"tag_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 20 post tag UUIDs to apply."
},
"platform": {
"enum": [
"twitter",
"linkedin",
"instagram",
"threads",
"tiktok",
"bluesky",
"mastodon",
"youtube",
"reddit",
"pinterest",
"dribbble",
"slack",
"discord",
"facebook",
"telegram",
"devto",
"farcaster",
"gmb",
"hashnode",
"lemmy",
"listmonk",
"medium",
"mewe",
"moltbook",
"nostr",
"skool",
"tumblr",
"twitch",
"vk",
"linkedin_page",
"instagram_standalone",
"tiktok_business",
"whop",
"wordpress",
"kick"
],
"type": "string",
"description": "Platform of that connected account (must match it)."
},
"media_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 10 publicly reachable media URLs to attach."
},
"variant_id": {
"type": "string",
"description": "UUID of the draft (from list_drafts or generate_posts) this post was made from; marks that draft as scheduled."
},
"content_text": {
"type": "string",
"description": "Post text, 1–5000 characters."
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 datetime with timezone (e.g. 2030-01-01T09:00:00Z), or \"now\" to publish immediately."
},
"first_comment": {
"type": "string",
"description": "Optional first comment posted under the post (max 2200 characters)."
},
"platform_meta": {
"type": "object",
"description": "Platform-specific publish settings, passed through to the publisher. Examples: Reddit { subreddit, flairId }, Pinterest { board }, Discord/Slack { channelId }, YouTube { title, privacyStatus }, Hashnode/Medium { publicationId }, Listmonk { listId, templateId }, Lemmy { communityId }, Skool { groupId }. Look up valid ids with list_publish_options."
},
"post_batch_id": {
"type": "string",
"description": "UUID shared by every call that posts the same content to different accounts, so they can later be managed together."
},
"connected_account_id": {
"type": "string",
"description": "Connected account UUID — from list_connections."
}
}
}{
"type": "object",
"required": [
"template_id"
],
"properties": {
"name": {
"type": "string",
"description": "Template name (1–120 characters)."
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"kind",
"file_name"
],
"properties": {
"url": {
"type": "string",
"description": "Public media URL."
},
"kind": {
"enum": [
"image",
"video"
],
"type": "string"
},
"file_name": {
"type": "string",
"description": "Display file name (max 300 characters)."
}
}
},
"description": "Up to 10 media attachments."
},
"content": {
"type": "string",
"description": "Default post text, up to 20,000 characters."
},
"account_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Connected account UUIDs the template targets (max 50) — from list_connections."
},
"template_id": {
"type": "string",
"description": "Template UUID — from list_post_templates."
},
"first_comment": {
"type": "string",
"description": "First comment text (max 2200 characters)."
},
"content_overrides": {
"type": "object",
"description": "Per-platform text that replaces content for that platform, as platform → text."
},
"platform_settings": {
"type": "object",
"description": "Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta)."
}
}
}