# BlackTwist MCP

> BlackTwist MCP manages your entire social presence across Threads and Bluesky. Schedule posts, track performance metrics, and manage follow-up sequences for content creators. It also integrates B2B lead data enrichment to help you target specific companies using verified contact details.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** social-scheduling, engagement-analytics, content-management, social-media-monitoring, thread-management, b2b-lead-data

## Description

This connector gives you full control over your social media output without ever leaving your agent client. You can draft entire threads or schedule individual posts across multiple connected accounts in real time. Need to know how well the content performed? The MCP pulls detailed engagement metrics and provides daily activity summaries, so you don't have to manually check dashboards. It also lets you list all your current social providers and track your account quotas. Plus, it handles more than just posting; it allows you to enrich B2B leads with verified company information and contact details before you even start writing the first post. Everything is managed through a single point in Vinkius, letting your AI agent act like a dedicated social media manager for all your accounts.

## Tools

### create_post
Creates or schedules a new post to one of your connected social media accounts.

### delete_post
Removes a specific post, canceling it if it was scheduled for later.

### get_posting_consistency
Calculates and retrieves data showing how regularly you have been posting over time.

### get_daily_recap
Generates a summary of all activity that occurred on the previous day.

### get_thread_follow_up
Retrieves the specific follow-up settings configured for a multi-part thread.

### get_analytics_metrics
Pulls detailed engagement metrics (like views and likes) for your specified social media period.

### get_post
Fetches specific details for one post, allowing you to review its content and performance metrics.

### get_account_settings
Retrieves the current configuration details for your connected social media accounts.

### get_subscription_info
Reports your current plan status, usage quotas, and billing details.

### list_posts
Shows a list of all posts you have written or drafted, allowing for comprehensive review and filtering.

### list_accounts
Provides a list of all social media accounts you have connected to BlackTwist, useful for getting provider IDs.

### list_follow_up_templates
Lists the available auto-plug or follow-up templates that coordinate your brand's growth strategy.

## Prompt Examples

**Prompt:** 
```
List all social media accounts connected to BlackTwist.
```

**Response:** 
```
I've retrieved your social profiles. You currently have a Threads account (@user1, ID: 123) and a Bluesky account (ID: 456) connected. Which one should we use for a new post?
```

**Prompt:** 
```
Schedule a Threads post 'Check out our new API!' for tomorrow at 2 PM.
```

**Response:** 
```
Post scheduled! I've successfully queued your update 'Check out our new API!' on Threads for tomorrow at 2:00 PM. The run ID is 'post_789'. Shall I monitor the engagement once it's live?
```

**Prompt:** 
```
Show my engagement metrics and daily activity recap.
```

**Response:** 
```
Accessing analytics... Yesterday you reached 1,500 views and 120 likes across all accounts. Your consistency score is holding at 98%. Would you like the detailed breakdown per profile?
```

## Capabilities

### Schedule or remove posts
The system can create new content scheduled for future dates, and it can cancel drafts or already posted items.

### Track performance data
You get detailed engagement metrics like views and likes, plus a summary of your activity from the previous day.

### Manage account details
The MCP lists all linked social media providers, helping you keep track of which profiles are active and what settings they use.

### Automate follow-up sequences
It manages auto-plug templates and follow-up rules for your threads, ensuring consistent brand growth without manual intervention.

### Check billing status
You can retrieve current subscription details and post quotas to see exactly how much capacity you have remaining.

## Use Cases

### The Weekly Content Dump
A marketing manager has 50 posts to schedule across Threads for the coming week. Instead of logging into the web app five times, they ask their agent client to 'Schedule all draft content from folder X.' The MCP uses `create_post` and `list_accounts` to queue everything instantly.

### Analyzing Campaign Success
A growth lead wants to know if the recent campaign was successful. They ask their agent to 'Compare last week's metrics against this month’s.' The MCP retrieves data using `get_analytics_metrics` and provides a clear performance report.

### The Lead Nurturing Flow
An SDR finds an ideal target company name. Instead of manually searching LinkedIn, they prompt their agent to 'Find the tech stack and key contacts for Acme Corp.' The MCP uses its data tools to enrich the lead immediately.

### Cleaning Up Old Content
A social media manager realizes a post from last month was incorrect. They use their agent client to prompt 'Delete my Threads post with ID 123.' The MCP handles this using `delete_post` securely.

## Benefits

- Schedule content effortlessly. You can draft and schedule high-fidelity posts or entire threads to Threads and Bluesky programmatically, without leaving your agent client.
- Know what works. Use the MCP to pull detailed engagement metrics and access daily performance recaps so you always know where your audience attention is going.
- Manage everything from one place. The tool lets you list all connected social media providers and coordinate your brand's voice across multiple profiles.
- Stay in compliance. Check your current subscription status and post quotas using the MCP to prevent running out of posting capacity mid-campaign.
- Optimize growth flows. You can manage auto-plug templates and follow-up settings, automating the crucial next steps after a user engages with your content.

## How It Works

The bottom line is, you tell the AI what you want done, and it executes the required steps across all connected services for you.

1. Subscribe to this MCP, then grab your API Key from the BlackTwist dashboard settings.
2. Provide that API key to your agent client so it can talk directly to your social accounts.
3. Ask your agent to perform an action—like 'Schedule a post about our new product'—and it handles everything else.

## Frequently Asked Questions

**How do I schedule multiple posts using the create_post tool?**
You must specify all necessary provider IDs and content for each post you want to schedule in a single prompt. The MCP handles queuing them up efficiently.

**Can get_analytics_metrics track cross-platform performance?**
Yes, it aggregates detailed engagement metrics across your linked accounts. This lets you compare how Threads performed against Bluesky for the same time period.

**Do I need to use list_accounts before creating content?**
It's smart to run `list_accounts` first. It confirms all your connected social media providers are active and gives you the IDs needed for scheduling posts.

**What does get_daily_recap show me?**
The MCP pulls a full summary of yesterday's activity across all linked accounts. It saves you from having to run multiple reports manually.

**How do I check my current posting quota or plan limits using the get_subscription_info tool?**
The tool returns your active subscription tier, remaining post quotas, and account status. This is crucial for preventing failed posts due to hitting service limits.

**If I use the delete_post tool, does it only remove scheduled content or also draft posts?**
It cancels any pending scheduled post immediately. While primarily designed for scheduling cleanup, calling this function on a draft will mark it as deleted and remove it from your drafts.

**What can I do with the list_posts tool if I need to find an old draft?**
The `list_posts` command retrieves both published posts and unscheduled drafts. You can filter this output by status or date to locate any content you were working on previously.

**How do I check the automated follow-up settings for a specific thread using get_thread_follow_up?**
This tool pulls up all configured auto-plug templates and rules attached to that thread. It lets you see exactly when and how your brand will automatically engage after the initial post goes live.

**How do I find my BlackTwist API Key?**
Log in to your account, navigate to **Settings** > **API**, and click **Generate New API Key** to get your token.

**Can I schedule threads with media?**
The current toolset is optimized for text-based post and thread orchestration to maintain high-fidelity engagement.

**How do I check my remaining post quota?**
Use the `get_subscription_info` tool to retrieve your current plan details and remaining publication credits directly from the platform.