BlackTwist

Create a new post or thread. A thread is multiple posts linked together. Supports text content, topic tags, media attachments, auto-repost configuration, and scheduling. If scheduleAt is not provided, the post is saved as a draft. IMPORTANT: Always send scheduleAt as a local time WITHOUT a timezone offset (e.g. '2025-03-15T09:00:00', never with Z or +00:00). The server automatically converts it to UTC using the user's configured timezone.

Delete a thread and all its posts. This action cannot be undone.

Edit the text content, topic, or media of a single post by its ID. Only posts with status READY (drafts or scheduled) can be edited. Use get_thread first to retrieve post IDs.

Edit a thread by adding, removing, or reordering its posts. Provide the full desired list of posts — existing posts (with id) are updated, new posts (without id) are created, and existing posts not in the list are removed. Only threads where all posts have status READY can be edited.

Get posting consistency data for the past 365 days. Returns a heatmap-style array of daily post counts, total posts, and number of days with posts.

Get yesterday's daily recap for a social account. Returns new followers gained and number of posts published.

Get follower count over time for a social account. Returns daily follower count data points.

Get all follow-up (auto-plug) templates for a specific provider. These are reusable templates that define what reply to attach to a post after it reaches engagement thresholds.

Get live engagement metrics for a social account over a date range. Returns views, likes, replies, reposts, and quotes with percentage change vs. the previous period. Works with both Threads and Bluesky.

Get time-series data points for a specific metric. Available metrics: VIEWS, LIKES, REPLIES, REPOSTS, QUOTES, ENGAGEMENT_RATE, FOLLOWERS_COUNT. Returns daily data points.

Get analytics for individual posts published within a date range. Returns engagement metrics (views, likes, replies, reposts, quotes, engagement rate) for each post.

Get AI-generated posting recommendations based on your analytics and performance patterns. Returns best posting times and content suggestions.

Get the current user's subscription and plan information. Returns plan type, remaining posts, account limits, and team limits.

Get a specific thread by its thread ID. Returns all posts in the thread with their content, media, scheduling info, and analytics.

Get the follow-up (auto-plug) configuration for a specific thread.

Get the current user's settings including timezone, date format, auto-repost configuration, and reminder preferences.

List all draft posts (posts that have not been scheduled yet). Returns threads with their posts and content.

List scheduled and published posts within a date range. Returns threads with their posts, scheduled time, provider info, and analytics. IMPORTANT: Always send from/to as local times WITHOUT a timezone offset (e.g. '2025-03-01T00:00:00'). The server converts to UTC using the user's configured timezone.

List all connected social media accounts (Threads and Bluesky) for the authenticated user. Returns provider ID, platform, username, display name, and profile picture for each account.

List all teams the authenticated user belongs to, including their role and which team is currently active. Use the team ID as the teamId parameter in other tools. To access the personal workspace (no team), pass teamId "personal".

List all configured posting time slots for a provider. Time slots define the preferred times when posts should be scheduled. Each slot has an hour, minute, and array of weekdays (0=Sunday, 6=Saturday).

Reschedule a thread to a new date/time. Updates all posts in the thread. IMPORTANT: Always send scheduledAt as a local time WITHOUT a timezone offset. The server converts to UTC using the user's configured timezone.

Set or update the follow-up (auto-plug) for a thread. The follow-up is a reply that gets posted after the original post reaches engagement thresholds. IMPORTANT: This creates an AutoPlug record (not a DefaultAutoPlug template). The autoPlugId on posts references this record.