MisarPost MCP Server

Official85 tools

by Misar-AI · TypeScript

Plan, generate, schedule and repurpose posts across every channel, and track what performs.

io.github.Misar-AI/misarpost-mcp MCP Server

The io.github.Misar-AI/misarpost-mcp Model Context Protocol (MCP) server supports workflows to plan, generate, schedule, and repurpose posts across multiple channels. It also tracks performance to inform what content performs best.

🛠️ Key Features

Plan posts
Generate posts
Schedule posts
Repurpose posts across every channel
Track what performs

🚀 Use Cases

Multi-channel post planning and generation
Scheduling posts for later publishing
Repurposing existing posts for other channels
Monitoring post performance outcomes

⚡ Developer Benefits

Provides a structured approach to post lifecycle tasks (plan, generate, schedule, repurpose)
Includes performance tracking as part of the workflow

⚠️ Limitations

No additional capabilities, tool details, or constraints were provided in the available source data.

Captured live from the server via tools/list.

list_connections

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_publish_options

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.

Parameters3

kind	string	required	Which list to fetch; it must match the connected account's platform.
account_id	string	required	Connected account UUID — from list_connections.
subreddit	string	optional	Subreddit name (without r/). Required for kind=reddit_flairs.

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "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"
      ],
      "description": "Which list to fetch; it must match the connected account's platform."
    },
    "account_id": {
      "type": "string",
      "description": "Connected account UUID — from list_connections."
    },
    "subreddit": {
      "type": "string",
      "description": "Subreddit name (without r/). Required for kind=reddit_flairs."
    }
  },
  "required": [
    "kind",
    "account_id"
  ]
}

list_account_plugs

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.

Parameters1

account_id

string

required

Connected account UUID — from list_connections.

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Connected account UUID — from list_connections."
    }
  },
  "required": [
    "account_id"
  ]
}

configure_account_plug

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.

Parameters4

account_id	string	required	Connected account UUID — from list_connections.
plug_key	string	required	Plug key — from list_account_plugs definitions.
activated	boolean	required	true to activate the plug, false to switch it off.
config	object	optional	The plug's configuration as flat key → string/number/boolean values, using the configFields list_account_plugs returns. Replaces the existing configuration.

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Connected account UUID — from list_connections."
    },
    "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."
    },
    "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."
    }
  },
  "required": [
    "account_id",
    "plug_key",
    "activated"
  ]
}

list_posts

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.

Parameters3

status	string	optional	Only posts in this status. Omit for every status except archived and cancelled.
tag_id	string	optional	Only posts carrying this post tag (UUID).
page	number	optional	1-indexed page number (default 1, 20 posts per page).

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "queued",
        "publishing",
        "published",
        "failed",
        "rejected",
        "cancelled",
        "archived"
      ],
      "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)."
    },
    "page": {
      "type": "number",
      "description": "1-indexed page number (default 1, 20 posts per page)."
    }
  }
}

schedule_post

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).

Parameters10

connected_account_id	string	required	Connected account UUID — from list_connections.
platform	string	required	Platform of that connected account (must match it).
content_text	string	required	Post text, 1–5000 characters.
scheduled_at	string	required	ISO 8601 datetime with timezone (e.g. 2030-01-01T09:00:00Z), or "now" to publish immediately.
media_urls	array	optional	Up to 10 publicly reachable media URLs to attach.
first_comment	string	optional	Optional first comment posted under the post (max 2200 characters).
variant_id	string	optional	UUID of the draft (from list_drafts or generate_posts) this post was made from; marks that draft as scheduled.
platform_meta	object	optional	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.
tag_ids	array	optional	Up to 20 post tag UUIDs to apply.
post_batch_id	string	optional	UUID shared by every call that posts the same content to different accounts, so they can later be managed together.

Raw schema

{
  "type": "object",
  "properties": {
    "connected_account_id": {
      "type": "string",
      "description": "Connected account UUID — from list_connections."
    },
    "platform": {
      "type": "string",
      "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"
      ],
      "description": "Platform of that connected account (must match it)."
    },
    "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."
    },
    "media_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 10 publicly reachable media URLs to attach."
    },
    "first_comment": {
      "type": "string",
      "description": "Optional first comment posted under the post (max 2200 characters)."
    },
    "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."
    },
    "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."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 20 post tag UUIDs to apply."
    },
    "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."
    }
  },
  "required": [
    "connected_account_id",
    "platform",
    "content_text",
    "scheduled_at"
  ]
}

cancel_post

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.

Parameters1

post_id

string

required

Post UUID — from list_posts.

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Post UUID — from list_posts."
    }
  },
  "required": [
    "post_id"
  ]
}

get_calendar

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.

Parameters3

from	string	optional	Start date, YYYY-MM-DD (default 7 days ago).
to	string	optional	End date, YYYY-MM-DD, inclusive (default 30 days from now).
tag_id	string	optional	Only posts carrying this post tag (UUID).

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start date, YYYY-MM-DD (default 7 days ago)."
    },
    "to": {
      "type": "string",
      "description": "End date, YYYY-MM-DD, inclusive (default 30 days from now)."
    },
    "tag_id": {
      "type": "string",
      "description": "Only posts carrying this post tag (UUID)."
    }
  }
}

update_post

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.

Parameters5

post_id	string	required	Post UUID — from list_posts or get_calendar.
content_text	string	optional	New post text.
scheduled_at	string	optional	New ISO 8601 datetime with timezone offset, e.g. 2030-01-01T09:00:00+05:30.
first_comment	string \| null	optional	New first comment, or null to remove it.
tag_ids	array	optional	Replace the post's tags with these post tag UUIDs (max 20); [] removes all.

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Post UUID — from list_posts or get_calendar."
    },
    "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."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Replace the post's tags with these post tag UUIDs (max 20); [] removes all."
    }
  },
  "required": [
    "post_id"
  ]
}

reply_to_post

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.

Parameters2

post_id	string	required	Post UUID — from list_posts (status published).
message	string	required	The reply text.

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Post UUID — from list_posts (status published)."
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The reply text."
    }
  },
  "required": [
    "post_id",
    "message"
  ]
}

revert_post

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.

Parameters1

post_id

string

required

Post UUID — from list_posts (status published).

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Post UUID — from list_posts (status published)."
    }
  },
  "required": [
    "post_id"
  ]
}

revert_post_batch

"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.

Parameters1

post_batch_id

string

required

Batch UUID — post_batch_id from list_posts, or postBatchId from revert_post.

Raw schema

{
  "type": "object",
  "properties": {
    "post_batch_id": {
      "type": "string",
      "description": "Batch UUID — post_batch_id from list_posts, or postBatchId from revert_post."
    }
  },
  "required": [
    "post_batch_id"
  ]
}

share_post

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.

Parameters1

post_id

string

required

Post UUID — from list_posts.

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Post UUID — from list_posts."
    }
  },
  "required": [
    "post_id"
  ]
}

unshare_post

Revoke a post's public preview link, so the old link stops working. Safe to call when no link exists.

Parameters1

post_id

string

required

Post UUID — from list_posts.

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Post UUID — from list_posts."
    }
  },
  "required": [
    "post_id"
  ]
}

list_drafts

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

review_drafts

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.

Parameters2

action	string	required	What to do with the drafts.
ids	array	required	Draft UUIDs — from list_drafts.

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "approve",
        "reject"
      ],
      "description": "What to do with the drafts."
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Draft UUIDs — from list_drafts."
    }
  },
  "required": [
    "action",
    "ids"
  ]
}

get_stats

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).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_analytics_trends

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.

Parameters1

days

number

optional

Window in days (default 30).

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "enum": [
        7,
        30,
        90
      ],
      "description": "Window in days (default 30)."
    }
  }
}

get_growth_overview

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.

Parameters1

days

number

optional

Window in days (default 30).

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "enum": [
        7,
        30,
        90
      ],
      "description": "Window in days (default 30)."
    }
  }
}

list_growth_opportunities

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_growth_playbooks

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_next_growth_opportunity

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_contentripple_usage

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

repurpose_content

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.

Parameters5

source_type	string	required	url: fetch source_url. text or docforge: use raw_content (pasted text or markdown). rss: pass the item's URL as source_url.
source_url	string	optional	Source URL (required for source_type=url).
raw_content	string	optional	Source text or markdown, up to 20,000 characters (required for text/docforge).
formats	array	optional	Which variants to write. Omit for all of them.
tone	string	optional	Writing tone (default professional).

Raw schema

{
  "type": "object",
  "properties": {
    "source_type": {
      "type": "string",
      "enum": [
        "url",
        "text",
        "docforge",
        "rss"
      ],
      "description": "url: fetch source_url. text or docforge: use raw_content (pasted text or markdown). rss: pass the item's URL as source_url."
    },
    "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)."
    },
    "formats": {
      "type": "array",
      "items": {
        "type": "string",
        "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"
        ]
      },
      "description": "Which variants to write. Omit for all of them."
    },
    "tone": {
      "type": "string",
      "description": "Writing tone (default professional)."
    }
  },
  "required": [
    "source_type"
  ]
}

update_content_variant

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.

Parameters3

variant_id	string	required	Content variant UUID — from repurpose_content.
content	string	optional	New variant text, up to 20,000 characters.
status	string	optional	New status. At least one of content or status is required.

Raw schema

{
  "type": "object",
  "properties": {
    "variant_id": {
      "type": "string",
      "description": "Content variant UUID — from repurpose_content."
    },
    "content": {
      "type": "string",
      "description": "New variant text, up to 20,000 characters."
    },
    "status": {
      "type": "string",
      "enum": [
        "generated",
        "edited",
        "queued",
        "posted"
      ],
      "description": "New status. At least one of content or status is required."
    }
  },
  "required": [
    "variant_id"
  ]
}

schedule_content_variant

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.

Parameters4

variant_id	string	required	Content variant UUID — from repurpose_content.
connected_account_id	string	required	Connected account UUID on the variant's platform — from list_connections.
scheduled_at	string	required	ISO 8601 datetime (UTC, e.g. 2030-01-01T09:00:00Z).
post_batch_id	string	optional	Optional UUID shared with sibling posts of the same content, for managing them together.

Raw schema

{
  "type": "object",
  "properties": {
    "variant_id": {
      "type": "string",
      "description": "Content variant UUID — from repurpose_content."
    },
    "connected_account_id": {
      "type": "string",
      "description": "Connected account UUID on the variant's platform — from list_connections."
    },
    "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."
    }
  },
  "required": [
    "variant_id",
    "connected_account_id",
    "scheduled_at"
  ]
}

fetch_content_feed

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.

Parameters1

feed_url

string

required

URL of the RSS or Atom feed.

Raw schema

{
  "type": "object",
  "properties": {
    "feed_url": {
      "type": "string",
      "format": "uri",
      "description": "URL of the RSS or Atom feed."
    }
  },
  "required": [
    "feed_url"
  ]
}

parse_content_source

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.

Parameters4

type	string	required	What kind of source: a URL, plain text, or Markdown (docforge).
url	string	optional	Required when type is url.
text	string	optional	Required when type is text.
markdown	string	optional	Required when type is docforge.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "url",
        "text",
        "docforge"
      ],
      "description": "What kind of source: a URL, plain text, or Markdown (docforge)."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Required when type is url."
    },
    "text": {
      "type": "string",
      "minLength": 50,
      "maxLength": 20000,
      "description": "Required when type is text."
    },
    "markdown": {
      "type": "string",
      "minLength": 50,
      "maxLength": 20000,
      "description": "Required when type is docforge."
    }
  },
  "required": [
    "type"
  ]
}

list_repurpose_history

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.

Parameters1

limit

integer

optional

How many sources (default 20, at most 50).

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many sources (default 20, at most 50)."
    }
  }
}

delete_repurpose_source

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.

Parameters1

source_id

string

required

Source UUID — from list_repurpose_history.

Raw schema

{
  "type": "object",
  "properties": {
    "source_id": {
      "type": "string",
      "description": "Source UUID — from list_repurpose_history."
    }
  },
  "required": [
    "source_id"
  ]
}

generate_posts

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.

Parameters4

topic	string	required	Topic or brief for the posts (3–500 characters).
platforms	array	required	Platforms to write for (at least one).
tone	string	optional	Writing tone (default professional).
count	number	optional	Variants per platform, 1–5 (default 3).

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Topic or brief for the posts (3–500 characters)."
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "twitter",
          "linkedin",
          "instagram",
          "threads",
          "tiktok",
          "bluesky",
          "youtube"
        ]
      },
      "minItems": 1,
      "description": "Platforms to write for (at least one)."
    },
    "tone": {
      "type": "string",
      "enum": [
        "professional",
        "casual",
        "technical",
        "inspirational"
      ],
      "description": "Writing tone (default professional)."
    },
    "count": {
      "type": "number",
      "description": "Variants per platform, 1–5 (default 3)."
    }
  },
  "required": [
    "topic",
    "platforms"
  ]
}

enhance_topic

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.

Parameters4

raw_topic	string	required	Raw topic or idea (3–500 characters).
goal	string	optional	Content goal (default engagement).
audience	string	optional	Target audience, up to 200 characters.
platforms	array	required	Target platforms (at least one).

Raw schema

{
  "type": "object",
  "properties": {
    "raw_topic": {
      "type": "string",
      "description": "Raw topic or idea (3–500 characters)."
    },
    "goal": {
      "type": "string",
      "enum": [
        "awareness",
        "engagement",
        "conversion",
        "viral"
      ],
      "description": "Content goal (default engagement)."
    },
    "audience": {
      "type": "string",
      "description": "Target audience, up to 200 characters."
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "twitter",
          "linkedin",
          "instagram",
          "threads",
          "tiktok",
          "bluesky"
        ]
      },
      "minItems": 1,
      "description": "Target platforms (at least one)."
    }
  },
  "required": [
    "raw_topic",
    "platforms"
  ]
}

generate_plan

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.

Parameters2

enhanced_topic	string	required	Topic or content brief (3–1000 characters), e.g. from enhance_topic.
platforms	array	required	Target platforms (at least one).

Raw schema

{
  "type": "object",
  "properties": {
    "enhanced_topic": {
      "type": "string",
      "description": "Topic or content brief (3–1000 characters), e.g. from enhance_topic."
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "twitter",
          "linkedin",
          "instagram",
          "threads",
          "tiktok",
          "bluesky"
        ]
      },
      "minItems": 1,
      "description": "Target platforms (at least one)."
    }
  },
  "required": [
    "enhanced_topic",
    "platforms"
  ]
}

research_hashtags

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.

Parameters4

keyword	string	required	Primary keyword or topic (2–200 characters).
niche	string	optional	Content niche, up to 100 characters.
platforms	array	required	Target platforms (at least one).
goal	string	optional	Strategy goal (default awareness).

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Primary keyword or topic (2–200 characters)."
    },
    "niche": {
      "type": "string",
      "description": "Content niche, up to 100 characters."
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "twitter",
          "linkedin",
          "instagram",
          "threads",
          "tiktok",
          "bluesky",
          "youtube"
        ]
      },
      "minItems": 1,
      "maxItems": 7,
      "description": "Target platforms (at least one)."
    },
    "goal": {
      "type": "string",
      "enum": [
        "awareness",
        "engagement",
        "conversion",
        "viral"
      ],
      "description": "Strategy goal (default awareness)."
    }
  },
  "required": [
    "keyword",
    "platforms"
  ]
}

get_optimization_insights

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.

Parameters1

platform

string

optional

Only this platform's posts. Omit for all platforms.

Raw schema

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "twitter",
        "linkedin",
        "instagram",
        "threads",
        "tiktok",
        "bluesky",
        "youtube"
      ],
      "description": "Only this platform's posts. Omit for all platforms."
    }
  }
}

generate_image

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.

Parameters2

prompt	string	required	What the image should show.
platform	string	optional	Platform to size it for (default twitter).

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 10,
      "maxLength": 1000,
      "description": "What the image should show."
    },
    "platform": {
      "type": "string",
      "enum": [
        "twitter",
        "linkedin",
        "instagram",
        "threads",
        "tiktok",
        "youtube"
      ],
      "description": "Platform to size it for (default twitter)."
    }
  },
  "required": [
    "prompt"
  ]
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

queue_trend_drafts

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.

Parameters1

snapshot_ids

array

required

1–3 trend snapshot UUIDs — from get_trends.

Raw schema

{
  "type": "object",
  "properties": {
    "snapshot_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 3,
      "description": "1–3 trend snapshot UUIDs — from get_trends."
    }
  },
  "required": [
    "snapshot_ids"
  ]
}

schedule_trend_posts

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.

Parameters2

snapshot_ids	array	required	1–3 trend snapshot UUIDs — from get_trends.
connected_account_ids	array	required	Connected account UUIDs to post to — from list_connections.

Raw schema

{
  "type": "object",
  "properties": {
    "snapshot_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 3,
      "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."
    }
  },
  "required": [
    "snapshot_ids",
    "connected_account_ids"
  ]
}

refresh_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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

send_trend_digest

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_trend_hooks

Get the content hooks (opening lines and angles) for one trend snapshot — snapshot ids come from get_trends.

Parameters1

snapshot_id

string

required

Trend snapshot UUID — from get_trends.

Raw schema

{
  "type": "object",
  "properties": {
    "snapshot_id": {
      "type": "string",
      "description": "Trend snapshot UUID — from get_trends."
    }
  },
  "required": [
    "snapshot_id"
  ]
}

get_trend_platform_content

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.

Parameters1

snapshot_id

string

required

Trend snapshot UUID — from get_trends.

Raw schema

{
  "type": "object",
  "properties": {
    "snapshot_id": {
      "type": "string",
      "description": "Trend snapshot UUID — from get_trends."
    }
  },
  "required": [
    "snapshot_id"
  ]
}

generate_trend_platform_content

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.

Parameters2

snapshot_id	string	required	Trend snapshot UUID — from get_trends.
platforms	array	optional	Platforms to generate for. Omit for all of them.

Raw schema

{
  "type": "object",
  "properties": {
    "snapshot_id": {
      "type": "string",
      "description": "Trend snapshot UUID — from get_trends."
    },
    "platforms": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "string",
        "enum": [
          "twitter",
          "linkedin",
          "instagram",
          "mastodon",
          "bluesky",
          "youtube",
          "medium"
        ]
      },
      "description": "Platforms to generate for. Omit for all of them."
    }
  },
  "required": [
    "snapshot_id"
  ]
}

use_trend_platform_content

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.

Parameters2

snapshot_id	string	required	Trend snapshot UUID — from get_trends.
platform	string	required	Which platform's content to draft.

Raw schema

{
  "type": "object",
  "properties": {
    "snapshot_id": {
      "type": "string",
      "description": "Trend snapshot UUID — from get_trends."
    },
    "platform": {
      "type": "string",
      "enum": [
        "twitter",
        "linkedin",
        "instagram",
        "mastodon",
        "bluesky",
        "youtube",
        "medium"
      ],
      "description": "Which platform's content to draft."
    }
  },
  "required": [
    "snapshot_id",
    "platform"
  ]
}

get_trend_performance

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_post_templates

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_post_template

Get one saved post template in full, by id — to reuse its text, accounts and settings in schedule_post.

Parameters1

template_id

string

required

Template UUID — from list_post_templates.

Raw schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "type": "string",
      "description": "Template UUID — from list_post_templates."
    }
  },
  "required": [
    "template_id"
  ]
}

create_post_template

Save a reusable post template: default text, optional per-platform text, target accounts, platform settings, media and first comment. Saving publishes nothing.

Parameters7

name	string	required	Template name (1–120 characters).
content	string	optional	Default post text, up to 20,000 characters.
content_overrides	object	optional	Per-platform text that replaces content for that platform, as platform → text.
account_ids	array	optional	Connected account UUIDs the template targets (max 50) — from list_connections.
platform_settings	object	optional	Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta).
media	array	optional	Up to 10 media attachments.
first_comment	string	optional	First comment text (max 2200 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name (1–120 characters)."
    },
    "content": {
      "type": "string",
      "description": "Default post text, up to 20,000 characters."
    },
    "content_overrides": {
      "type": "object",
      "description": "Per-platform text that replaces content for that platform, as platform → text."
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Connected account UUIDs the template targets (max 50) — from list_connections."
    },
    "platform_settings": {
      "type": "object",
      "description": "Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta)."
    },
    "media": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "kind",
          "file_name"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Public media URL."
          },
          "kind": {
            "type": "string",
            "enum": [
              "image",
              "video"
            ]
          },
          "file_name": {
            "type": "string",
            "description": "Display file name (max 300 characters)."
          }
        }
      },
      "description": "Up to 10 media attachments."
    },
    "first_comment": {
      "type": "string",
      "description": "First comment text (max 2200 characters)."
    }
  },
  "required": [
    "name"
  ]
}

update_post_template

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).

Parameters8

template_id	string	required	Template UUID — from list_post_templates.
name	string	optional	Template name (1–120 characters).
content	string	optional	Default post text, up to 20,000 characters.
content_overrides	object	optional	Per-platform text that replaces content for that platform, as platform → text.
account_ids	array	optional	Connected account UUIDs the template targets (max 50) — from list_connections.
platform_settings	object	optional	Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta).
media	array	optional	Up to 10 media attachments.
first_comment	string	optional	First comment text (max 2200 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "type": "string",
      "description": "Template UUID — from list_post_templates."
    },
    "name": {
      "type": "string",
      "description": "Template name (1–120 characters)."
    },
    "content": {
      "type": "string",
      "description": "Default post text, up to 20,000 characters."
    },
    "content_overrides": {
      "type": "object",
      "description": "Per-platform text that replaces content for that platform, as platform → text."
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Connected account UUIDs the template targets (max 50) — from list_connections."
    },
    "platform_settings": {
      "type": "object",
      "description": "Per-platform publish settings, as platform → settings object (same keys as schedule_post's platform_meta)."
    },
    "media": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "kind",
          "file_name"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Public media URL."
          },
          "kind": {
            "type": "string",
            "enum": [
              "image",
              "video"
            ]
          },
          "file_name": {
            "type": "string",
            "description": "Display file name (max 300 characters)."
          }
        }
      },
      "description": "Up to 10 media attachments."
    },
    "first_comment": {
      "type": "string",
      "description": "First comment text (max 2200 characters)."
    }
  },
  "required": [
    "template_id"
  ]
}

delete_post_template

Permanently delete a saved post template. Posts already scheduled from it are not affected. Confirm with the user first.

Parameters1

template_id

string

required

Template UUID — from list_post_templates.

Raw schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "type": "string",
      "description": "Template UUID — from list_post_templates."
    }
  },
  "required": [
    "template_id"
  ]
}

list_post_tags

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_post_tag

Create a post tag with a name and colour, for grouping posts by campaign or theme. Names must be unique per user.

Parameters2

name	string	required	Tag name (1–60 characters).
color	string	required	Tag colour.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Tag name (1–60 characters)."
    },
    "color": {
      "type": "string",
      "enum": [
        "red",
        "orange",
        "amber",
        "green",
        "teal",
        "blue",
        "indigo",
        "purple",
        "pink",
        "slate"
      ],
      "description": "Tag colour."
    }
  },
  "required": [
    "name",
    "color"
  ]
}

update_post_tag

Rename and/or recolour a post tag. Posts keep the tag.

Parameters3

tag_id	string	required	Tag UUID — from list_post_tags.
name	string	optional	New name (1–60 characters).
color	string	optional	New colour.

Raw schema

{
  "type": "object",
  "properties": {
    "tag_id": {
      "type": "string",
      "description": "Tag UUID — from list_post_tags."
    },
    "name": {
      "type": "string",
      "description": "New name (1–60 characters)."
    },
    "color": {
      "type": "string",
      "enum": [
        "red",
        "orange",
        "amber",
        "green",
        "teal",
        "blue",
        "indigo",
        "purple",
        "pink",
        "slate"
      ],
      "description": "New colour."
    }
  },
  "required": [
    "tag_id"
  ]
}

delete_post_tag

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.

Parameters1

tag_id

string

required

Tag UUID — from list_post_tags.

Raw schema

{
  "type": "object",
  "properties": {
    "tag_id": {
      "type": "string",
      "description": "Tag UUID — from list_post_tags."
    }
  },
  "required": [
    "tag_id"
  ]
}

list_media

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.

Parameters1

page

number

optional

1-indexed page (default 1, 24 items per page).

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "1-indexed page (default 1, 24 items per page)."
    }
  }
}

delete_media

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.

Parameters1

media_id

string

required

Media UUID — from list_media.

Raw schema

{
  "type": "object",
  "properties": {
    "media_id": {
      "type": "string",
      "description": "Media UUID — from list_media."
    }
  },
  "required": [
    "media_id"
  ]
}

list_video_avatars

List the stock presenter avatars available for AI video generation. Pass an avatar's id to generate_video.

Parameters1

provider

string

optional

Video provider (default heygen, currently the only one).

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "description": "Video provider (default heygen, currently the only one)."
    }
  }
}

list_video_voices

List the stock voices available for AI video generation. Pass a voice's id to generate_video.

Parameters1

provider

string

optional

Video provider (default heygen, currently the only one).

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "description": "Video provider (default heygen, currently the only one)."
    }
  }
}

create_video_script

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.

Parameters1

post_text

string

required

Post text to base the script on (1–4000 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "post_text": {
      "type": "string",
      "description": "Post text to base the script on (1–4000 characters)."
    }
  },
  "required": [
    "post_text"
  ]
}

generate_video

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.

Parameters6

script	string	required	What the presenter says (1–5000 characters).
avatar_id	string	required	Avatar id — from list_video_avatars.
voice_id	string	required	Voice id — from list_video_voices.
aspect_ratio	string	required	Video shape.
captions	boolean	optional	Burn in captions (default true).
provider	string	optional	Video provider (default heygen, currently the only one).

Raw schema

{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "description": "What the presenter says (1–5000 characters)."
    },
    "avatar_id": {
      "type": "string",
      "description": "Avatar id — from list_video_avatars."
    },
    "voice_id": {
      "type": "string",
      "description": "Voice id — from list_video_voices."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "portrait",
        "story"
      ],
      "description": "Video shape."
    },
    "captions": {
      "type": "boolean",
      "description": "Burn in captions (default true)."
    },
    "provider": {
      "type": "string",
      "description": "Video provider (default heygen, currently the only one)."
    }
  },
  "required": [
    "script",
    "avatar_id",
    "voice_id",
    "aspect_ratio"
  ]
}

get_video_status

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.

Parameters1

job_id

string

required

Job id — from generate_video.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job id — from generate_video."
    }
  },
  "required": [
    "job_id"
  ]
}

list_personas

List the user's PersonaForge personas — writing styles learned from a real account — plus extraction jobs still running and recent failures.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_persona

Get one persona in full: its name, cover image, source account, and the style profile used when writing in it.

Parameters1

persona_id

string

required

Persona UUID — from list_personas.

Raw schema

{
  "type": "object",
  "properties": {
    "persona_id": {
      "type": "string",
      "description": "Persona UUID — from list_personas."
    }
  },
  "required": [
    "persona_id"
  ]
}

create_persona

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.

Parameters5

source_kind	string	required	Learn from one of the user's connected accounts, or from a public profile.
platform	string	required	connected_account: instagram, twitter, youtube. public_profile: youtube, medium, mastodon, bluesky.
connected_account_id	string	optional	Required for connected_account — from list_connections.
identifier	string	optional	Required for public_profile — the profile handle or URL (max 300 characters).
name	string	optional	Optional persona name (max 60 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "source_kind": {
      "type": "string",
      "enum": [
        "connected_account",
        "public_profile"
      ],
      "description": "Learn from one of the user's connected accounts, or from a public profile."
    },
    "platform": {
      "type": "string",
      "enum": [
        "instagram",
        "twitter",
        "youtube",
        "medium",
        "mastodon",
        "bluesky"
      ],
      "description": "connected_account: instagram, twitter, youtube. public_profile: youtube, medium, mastodon, bluesky."
    },
    "connected_account_id": {
      "type": "string",
      "description": "Required for connected_account — from list_connections."
    },
    "identifier": {
      "type": "string",
      "description": "Required for public_profile — the profile handle or URL (max 300 characters)."
    },
    "name": {
      "type": "string",
      "description": "Optional persona name (max 60 characters)."
    }
  },
  "required": [
    "source_kind",
    "platform"
  ]
}

get_persona_job_status

Check a persona extraction job started by create_persona: its status, the new persona's id once done, or the error.

Parameters1

job_id

string

required

Job id — from create_persona.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job id — from create_persona."
    }
  },
  "required": [
    "job_id"
  ]
}

rename_persona

Rename a persona. Its learned voice is unchanged.

Parameters2

persona_id	string	required	Persona UUID — from list_personas.
name	string	required	New name (1–60 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "persona_id": {
      "type": "string",
      "description": "Persona UUID — from list_personas."
    },
    "name": {
      "type": "string",
      "description": "New name (1–60 characters)."
    }
  },
  "required": [
    "persona_id",
    "name"
  ]
}

delete_persona

Permanently delete a persona and its learned voice. Recreating it means re-running create_persona. Confirm with the user first.

Parameters1

persona_id

string

required

Persona UUID — from list_personas.

Raw schema

{
  "type": "object",
  "properties": {
    "persona_id": {
      "type": "string",
      "description": "Persona UUID — from list_personas."
    }
  },
  "required": [
    "persona_id"
  ]
}

generate_persona_post

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.

Parameters3

topic	string	required	What the post is about (1–500 characters).
platform	string	required	Platform to write for, e.g. linkedin or twitter.
persona_id	string	optional	Persona UUID — from list_personas. Omit to use the user's own trained voice.

Raw schema

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "topic",
    "platform"
  ]
}

list_persona_replies

List AI-drafted replies to inbound comments and messages, by status (default pending — the ones waiting for review).

Parameters1

status

string

optional

Which replies to list (default pending).

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "edited",
        "posted",
        "skipped"
      ],
      "description": "Which replies to list (default pending)."
    }
  }
}

generate_persona_reply

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.

Parameters4

platform	string	required	Platform the conversation is on.
source_post_id	string	required	Platform id of the user's post being replied under.
source_post_text	string	required	Text of that post (max 1000 characters).
inbound_text	string	required	The comment or message to reply to (max 2000 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "description": "Platform the conversation is on."
    },
    "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)."
    },
    "inbound_text": {
      "type": "string",
      "description": "The comment or message to reply to (max 2000 characters)."
    }
  },
  "required": [
    "platform",
    "source_post_id",
    "source_post_text",
    "inbound_text"
  ]
}

review_persona_reply

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.

Parameters3

reply_id	string	required	Reply UUID — from list_persona_replies.
action	string	required	Decision.
edited_text	string	optional	Required for action=edit: the corrected reply (max 2000 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "reply_id": {
      "type": "string",
      "description": "Reply UUID — from list_persona_replies."
    },
    "action": {
      "type": "string",
      "enum": [
        "approve",
        "edit",
        "reject"
      ],
      "description": "Decision."
    },
    "edited_text": {
      "type": "string",
      "description": "Required for action=edit: the corrected reply (max 2000 characters)."
    }
  },
  "required": [
    "reply_id",
    "action"
  ]
}

get_voice_model

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

train_voice_model

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

generate_bio_variants

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.

Parameters2

platform	string	required	Platform the bio is for, e.g. twitter or linkedin.
current_bio	string	optional	The bio the user has now, to improve on.

Raw schema

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "platform"
  ]
}

list_competitor_personas

List the competitor accounts the user has analysed, newest first, with posting frequency, content pillars, gaps, average engagement and best posting time.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

analyze_competitor

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.

Parameters4

handle	string	required	The competitor's handle on that platform.
platform	string	required	Platform the handle is on.
display_name	string	optional	Name to show for this competitor.
niche	string	optional	The competitor's niche, for context.

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "The competitor's handle on that platform."
    },
    "platform": {
      "type": "string",
      "enum": [
        "twitter",
        "linkedin"
      ],
      "description": "Platform the handle is on."
    },
    "display_name": {
      "type": "string",
      "description": "Name to show for this competitor."
    },
    "niche": {
      "type": "string",
      "description": "The competitor's niche, for context."
    }
  },
  "required": [
    "handle",
    "platform"
  ]
}

list_notifications

List the user's MisarPost notifications (publish results, account problems and the like), newest first, with the unread count.

Parameters2

page	number	optional	1-indexed page (default 1).
page_size	number	optional	Items per page (default 20, max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "1-indexed page (default 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (default 20, max 50)."
    }
  }
}

mark_notification_read

Mark one notification as read, e.g. after relaying it to the user. It drops out of the unread count.

Parameters1

notification_id

string

required

Notification UUID — from list_notifications.

Raw schema

{
  "type": "object",
  "properties": {
    "notification_id": {
      "type": "string",
      "description": "Notification UUID — from list_notifications."
    }
  },
  "required": [
    "notification_id"
  ]
}

mark_all_notifications_read

Mark every unread notification as read. There is no way to mark them unread again.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_webhooks

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_webhook

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.

Parameters2

url	string	required	The user's public HTTPS endpoint (max 2048 characters).
events	array	required	Events to deliver: post.published, post.failed, account.disconnected.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The user's public HTTPS endpoint (max 2048 characters)."
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "post.published",
          "post.failed",
          "account.disconnected"
        ]
      },
      "minItems": 1,
      "description": "Events to deliver: post.published, post.failed, account.disconnected."
    }
  },
  "required": [
    "url",
    "events"
  ]
}

update_webhook

Change an outbound webhook's URL or events, or pause/resume it with active. Only the fields passed change.

Parameters4

webhook_id	string	required	Webhook UUID — from list_webhooks.
url	string	optional	New public HTTPS endpoint.
events	array	optional	Events to deliver: post.published, post.failed, account.disconnected.
active	boolean	optional	false pauses delivery, true resumes it.

Raw schema

{
  "type": "object",
  "properties": {
    "webhook_id": {
      "type": "string",
      "description": "Webhook UUID — from list_webhooks."
    },
    "url": {
      "type": "string",
      "description": "New public HTTPS endpoint."
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "post.published",
          "post.failed",
          "account.disconnected"
        ]
      },
      "minItems": 1,
      "description": "Events to deliver: post.published, post.failed, account.disconnected."
    },
    "active": {
      "type": "boolean",
      "description": "false pauses delivery, true resumes it."
    }
  },
  "required": [
    "webhook_id"
  ]
}

delete_webhook

Permanently remove an outbound webhook; events stop being delivered to its URL. Confirm with the user first.

Parameters1

webhook_id

string

required

Webhook UUID — from list_webhooks.

Raw schema

{
  "type": "object",
  "properties": {
    "webhook_id": {
      "type": "string",
      "description": "Webhook UUID — from list_webhooks."
    }
  },
  "required": [
    "webhook_id"
  ]
}

list_workspaces

List the workspaces the user belongs to. When workspace scoping is on, posts, accounts and stats are limited to the active workspace.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

README.md19 KBView on GitHub

MisarPost MCP Server

Plan, generate, schedule and repurpose posts across every connected channel, and track what performs — from any AI assistant.

85 tools · 8 prompts · 6 resources · 8 agent skills

Works with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or Streamable HTTP.

Install

Smithery (recommended)

bash

npx -y @smithery/cli install misar/misarpost-mcp --client claude

Claude Code

bash

claude mcp add misarpost -- npx -y @misarpost/mcp@latest

Manual (any client)

json

{
  "mcpServers": {
    "misarpost": {
      "command": "npx",
      "args": ["-y", "@misarpost/mcp@latest"],
      "env": { "MISARPOST_API_KEY": "mpk_your_key_here" }
    }
  }
}

Ready-made configs for every client live in connectors/.

Remote (no install)

json

{
  "mcpServers": {
    "misarpost": {
      "type": "streamable-http",
      "url": "https://api.misar.io/post/mcp",
      "headers": { "Authorization": "Bearer mpk_your_key_here" }
    }
  }
}

Authentication

Create an API key at https://post.misar.io/dashboard/api-keys (Dashboard → API keys) — it starts with mpk_ — and give it to the server in one of three ways: the MISARPOST_API_KEY environment variable, your MCP client's env block, or { "api_key": "mpk_…" } in ~/.misarpost/config.json.

Self-hosted instances: set MISARPOST_BASE_URL.

Tools

Tool	Description
`list_connections`	List the user's active connected social accounts with their account ID, platform and display name.
`list_publish_options`	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.
`list_account_plugs`	Show the plugs (automatic follow-up actions — e.g.
`configure_account_plug`	Turn a plug on or off for one connected account and set its configuration, replacing the plug's previous configuration.
`list_posts`	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.
`schedule_post`	Schedule a post to ONE connected account at a given time, or publish it immediately with scheduled_at="now".
`cancel_post`	Cancel a post that is still pending or queued, so it never publishes.
`get_calendar`	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.
`update_post`	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.
`reply_to_post`	Post a public reply/comment on one of the user's ALREADY-PUBLISHED posts, on the platform it was published to.
`revert_post`	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).
`revert_post_batch`	"Delete everywhere": delete every published post from one batch (one compose or repurpose action sent to several accounts) from all of its platforms.
`share_post`	Create (or return the existing) public preview link for one of the user's posts.
`unshare_post`	Revoke a post's public preview link, so the old link stops working.
`list_drafts`	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..
`review_drafts`	Approve or reject several drafts at once by ID.
`get_stats`	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)..
`get_analytics_trends`	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.
`get_growth_overview`	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.
`list_growth_opportunities`	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.
`list_growth_playbooks`	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.
`get_next_growth_opportunity`	Get the single best next content opportunity for the user's connected platforms and niches — a compact version of list_growth_opportunities.
`get_contentripple_usage`	Show how many ContentRipple repurposes the user has run this month, their monthly limit (null means unlimited), and their plan tier.
`repurpose_content`	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.
`update_content_variant`	Edit a saved ContentRipple variant's text (which marks it edited) and/or set its status.
`schedule_content_variant`	Schedule a saved ContentRipple variant (its text plus hashtags) to a connected account of the matching platform at a given time.
`fetch_content_feed`	Read an RSS or Atom feed and return its entries, so the user can pick one to repurpose with repurpose_content (source_type rss).
`parse_content_source`	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.
`list_repurpose_history`	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..
`delete_repurpose_source`	Delete one repurposed source and its variants from ContentRipple history.
`generate_posts`	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).
`enhance_topic`	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.
`generate_plan`	For a topic or brief, suggest hook options, the best posting time slots, and trending hashtags per platform.
`research_hashtags`	Build a tiered hashtag strategy for a keyword across platforms — broad, mid and niche tags plus each platform's algorithm signals.
`get_optimization_insights`	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.
`generate_image`	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.
`get_trends`	Get the latest trending hashtags and content hooks for the user's TrendPulse niches, each with a snapshot id.
`queue_trend_drafts`	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).
`schedule_trend_posts`	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.
`refresh_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.
`send_trend_digest`	Email the user their trend digest (top recent trends for their niches) now.
`get_trend_hooks`	Get the content hooks (opening lines and angles) for one trend snapshot — snapshot ids come from get_trends..
`get_trend_platform_content`	Get the per-platform content already generated for one trend snapshot — hashtags, plus title/description for YouTube and title/subtitle for Medium.
`generate_trend_platform_content`	Generate per-platform content (hashtags, and titles where a platform needs them) for one trend snapshot, for the platforms asked (default: all seven).
`use_trend_platform_content`	Turn one platform's generated trend content into a draft post (generating it first if needed).
`get_trend_performance`	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..
`list_post_templates`	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..
`get_post_template`	Get one saved post template in full, by id — to reuse its text, accounts and settings in schedule_post..
`create_post_template`	Save a reusable post template: default text, optional per-platform text, target accounts, platform settings, media and first comment.
`update_post_template`	Change a saved post template.
`delete_post_template`	Permanently delete a saved post template.
`list_post_tags`	List the user's post tags (id, name, colour).
`create_post_tag`	Create a post tag with a name and colour, for grouping posts by campaign or theme.
`update_post_tag`	Rename and/or recolour a post tag.
`delete_post_tag`	Permanently delete a post tag and remove it from every post that carries it.
`list_media`	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..
`delete_media`	Permanently delete a file from the media library and storage.
`list_video_avatars`	List the stock presenter avatars available for AI video generation.
`list_video_voices`	List the stock voices available for AI video generation.
`create_video_script`	Write a short talking-presenter video script from a post's text.
`generate_video`	Start rendering an AI presenter video from a script, avatar and voice.
`get_video_status`	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..
`list_personas`	List the user's PersonaForge personas — writing styles learned from a real account — plus extraction jobs still running and recent failures..
`get_persona`	Get one persona in full: its name, cover image, source account, and the style profile used when writing in it..
`create_persona`	Start learning a writing persona from recent posts — either a connected account (instagram, twitter, youtube) or a public profile (youtube, medium, mastodon, bluesky).
`get_persona_job_status`	Check a persona extraction job started by create_persona: its status, the new persona's id once done, or the error..
`rename_persona`	Rename a persona.
`delete_persona`	Permanently delete a persona and its learned voice.
`generate_persona_post`	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.
`list_persona_replies`	List AI-drafted replies to inbound comments and messages, by status (default pending — the ones waiting for review)..
`generate_persona_reply`	Draft a reply, in the user's trained voice, to an inbound comment or message on one of their posts.
`review_persona_reply`	Approve, edit or reject one pending AI-drafted reply.
`get_voice_model`	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.
`train_voice_model`	Train (or retrain) the user's own voice model from their last 50 published posts.
`generate_bio_variants`	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.
`list_competitor_personas`	List the competitor accounts the user has analysed, newest first, with posting frequency, content pillars, gaps, average engagement and best posting time..
`analyze_competitor`	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).
`list_notifications`	List the user's MisarPost notifications (publish results, account problems and the like), newest first, with the unread count..
`mark_notification_read`	Mark one notification as read, e.g.
`mark_all_notifications_read`	Mark every unread notification as read.
`list_webhooks`	List the user's outbound webhooks — the URLs MisarPost sends signed event payloads to — with their events and whether each is active.
`create_webhook`	Register an outbound webhook: MisarPost will POST signed payloads for the chosen events to this URL from now on.
`update_webhook`	Change an outbound webhook's URL or events, or pause/resume it with active.
`delete_webhook`	Permanently remove an outbound webhook; events stop being delivered to its URL.
`list_workspaces`	List the workspaces the user belongs to.

Prompts

Reusable workflows your client exposes as slash-commands.

Prompt	Description
`plan_content_week`	Plan a week of posts grounded in past performance and what is already scheduled.
`repurpose_a_post`	Turn one piece of content into channel-native variants and schedule the approved ones.
`performance_review`	Report what performed, what did not, and the single most useful change.
`draft_queue_triage`	Review waiting drafts and decide what to schedule, edit or drop.
`cross_post`	Publish one message to several connected accounts, adapted per platform, after approval.
`trend_response`	Find a trend worth responding to and draft credible posts about it.
`reply_queue_review`	Review AI-drafted replies to comments and decide which to approve, edit or skip.
`growth_opportunities`	Find what to post next from Growth Hub signals (Empire plan).

Resources

Read-only context an agent can attach without spending a tool call.

URI	Description
`misarpost://connections`	Active connected accounts with their IDs and platforms.
`misarpost://queue`	The first page of queued posts — what is already scheduled — so new posts do not collide with it..
`misarpost://drafts`	Drafts awaiting review, so work in progress is resumed rather than restarted..
`misarpost://stats`	Queued, published and draft counts, the top performing post of the month, and the average engagement rate..
`misarpost://tags`	The user's post tags (id, name, colour), for tagging and filtering posts..
`misarpost://templates`	Saved post templates — reusable text, target accounts and platform settings..

Agent skills

Bundled in skills/ — guidance an agent loads when a task matches.

Skill	Use when
`find-growth-opportunities`	Find what to post next from MisarPost Growth Hub signals — rising trends on the user's connected platforms, underperforming platforms and formats, and each platform's official playbook. Use when asked what to post next, what is trending for me, how to grow an account, or why a platform is underperforming.
`plan-and-schedule-content`	Plan a content calendar for the user's connected accounts and schedule it once approved. Use when asked to plan content, fill the calendar, map out a week or month of posts, or decide what to post when in MisarPost.
`repurpose-across-channels`	Turn one article, URL, announcement or block of text into channel-native variants with ContentRipple and schedule the approved ones. Use when asked to repurpose, adapt, cross-promote or turn a blog post into social posts in MisarPost.
`respond-to-trends`	Find trends the user's account can credibly join and turn the chosen ones into drafts or scheduled posts in MisarPost. Use when asked what is trending, to jump on a trend, to post about something current, or for trending hashtags.
`review-persona-replies`	Draft and review replies to comments and messages in the user's own voice with MisarPost PersonaForge, approving only what the user signs off. Use when asked to reply to comments, handle the reply queue, answer DMs in their voice, or review AI-drafted replies.
`review-post-performance`	Report what performed, what did not, and the single most useful change, from MisarPost's own post and engagement data. Use when asked about post performance, engagement, reach, stats, what is working, or for a weekly or monthly report.
`schedule-and-publish`	Schedule or immediately publish a post to one or more connected accounts in MisarPost, with explicit confirmation, the right platform settings, and an honest report of what went out. Use when asked to post, publish, schedule, cross-post, or cancel a scheduled post.
`triage-draft-queue`	Work through MisarPost drafts awaiting review — decide what to schedule, edit or drop — and act only on what the user approves. Use when asked to review drafts, clear the draft queue, or approve or reject generated posts.

Safety

Destructive and irreversible actions are annotated (destructiveHint) so clients can prompt before running them. The skills instruct agents to confirm before anything that sends mail, publishes content, or is otherwise visible to other people.

Discovery (initialize, tools/list, prompts/list, resources/list) never requires credentials, so registries can index the server without one. Every action does.

Install

Tools (85)

list_connectionslist_publish_optionslist_account_plugsconfigure_account_pluglist_postsschedule_postcancel_postget_calendar

Configuration

Environment variables

MISARPOST_API_KEYsecret

Your MisarPost API key (mpk_…). Create one at https://post.misar.io/dashboard/api-keys.

MISARPOST_BASE_URL

Override the API base URL. Only needed for self-hosted instances.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "misarpost-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@misarpost/mcp@3.0.0"
      ],
      "env": {
        "MISARPOST_API_KEY": "<YOUR_MISARPOST_API_KEY>",
        "MISARPOST_BASE_URL": "<YOUR_MISARPOST_BASE_URL>"
      }
    }
  }
}