Blacktwist

by blacktwist

327 downloads

Not rated

GitHub

About

The BlackTwist MCP server allows AI assistants like Claude, Cursor, and other MCP-compatible clients to interact with your BlackTwist account — creating posts, checking analytics, managing drafts, and more.

Details

Author: blacktwist
Downloads: 327
Categories: Other, Automation

- Post creation and scheduling for Threads and Bluesky
- Draft management (view, edit, delete, schedule)
- Live engagement metrics (views, likes, replies, reposts)
- Time series analytics for any metric
- Post-level analytics to identify top performers
- Follower growth tracking with daily changes
- Posting consistency heatmap for 365 days
- Daily recap of new followers and posts
- AI-powered posting recommendations
- Automated follow‑up replies based on engagement thresholds
- Thread editing and rescheduling
- Multi‑account and team workspace support
- Time slot configuration and subscription info

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Blacktwist

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

From the repository

Create a free account at blacktwist.app, connect your Threads or Bluesky account, generate an API key from Settings > MCP, then connect your AI assistant using OAuth or the API key. Once connected, simply describe what you want—for example, "Schedule a post for tomorrow at 9am"—and the assistant does the rest.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "blacktwist": {
            "blacktwist": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://blacktwist.app/api/mcp",
                    "--header",
                    "Authorization:${BLACKTWIST_TOKEN}"
                ],
                "env": {
                    "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

McpServers

{
    "blacktwist": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-remote@latest",
            "https://blacktwist.app/api/mcp",
            "--header",
            "Authorization:${BLACKTWIST_TOKEN}"
        ],
        "env": {
            "BLACKTWIST_TOKEN": "Bearer YOUR_API_KEY"
        }
    }
}

What Is BlackTwist MCP Server?

BlackTwist MCP Server connects your Threads and Bluesky accounts to AI assistants like Claude, ChatGPT, Cursor, and VS Code. Instead of switching tabs and clicking through dashboards, you manage your social media by typing what you want in plain English. MCP stands for Model Context Protocol. It is an open standard created by Anthropic that lets AI assistants talk directly to external tools and services. Think of it as a bridge between your AI assistant and your BlackTwist account. With the BlackTwist MCP Server, your AI assistant can schedule posts, pull analytics, track followers, manage drafts, and set up automated replies. You describe what you want. The server handles the rest. The MCP Server is free on all BlackTwist plans, including the free tier. No credit card required. Setup takes about 30 seconds.

How It Works

1. Your AI assistant receives your request ("Schedule a post for tomorrow at 9am") 2. The assistant sends that request to the BlackTwist MCP Server 3. The server executes the action on your Threads or Bluesky account 4. The assistant confirms what happened No copy-pasting. No tab switching. No dashboard required.

Supported AI Clients

BlackTwist MCP Server works with 11 AI clients: | Client | Auth Method | Setup Time | |---|---|---| | Claude Desktop | OAuth or API Key | 30 seconds | | Claude Web (claude.ai) | OAuth | 30 seconds | | Claude Mobile | OAuth | 30 seconds | | Claude Code | API Key (CLI or config file) | 30 seconds | | ChatGPT Web | OAuth | 30 seconds | | Cursor | API Key | 30 seconds | | VS Code | API Key | 30 seconds | | Microsoft Copilot Studio | API Key | 30 seconds | | Lovable | OAuth | 30 seconds | | n8n | API Key | 30 seconds | | Notion | OAuth | 30 seconds | Any tool that supports the MCP standard will work with BlackTwist. ---

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Blacktwist

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

What Is BlackTwist MCP Server?

How It Works

Supported AI Clients

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

What Is BlackTwist MCP Server?

How It Works

Supported AI Clients

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Filesystem

EverArt