Social MCP: Multi-Agent Social Media Automation

Name: Social MCP: Multi-Agent Social Media Automation
Author: kitadmin01

@kitadmin01

Repository

About Social MCP: Multi-Agent Social Media Automation

Socail MCP Server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "social_mcp": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Social MCP: Multi-Agent Social Media Automation?

Social MCP is a multi‑agent system that automates content extraction, tweet generation, posting, and engagement on platforms like Twitter and Bluesky. It uses LLMs for content generation, Playwright for browser automation, and platform APIs for integration.

How to use Social MCP: Multi-Agent Social Media Automation?

Clone the repository, create a Python virtual environment, install dependencies (including Playwright), and configure a .env file with Twitter credentials, Playwright session directory, and Google Sheets API / OAuth settings. Start the MCP server from /social_mcp with python mcp_server/server.py, then run the MCP client with python mcp_client/client.py.

Key features of Social MCP: Multi-Agent Social Media Automation

Persistent Twitter session management with automatic login detection
Tweet posting with retry logic and navigation recovery
LLM‑powered tweet generation and content scheduling
Hashtag‑based content discovery and engagement automation
Robust browser automation with page state verification
Google Sheets integration and shared retry / secrets utilities

Use cases of Social MCP: Multi-Agent Social Media Automation

Automate content extraction, LLM‑driven tweet generation, and multi‑platform posting
Schedule and publish content across Twitter and Bluesky
Perform hashtag‑based search, liking, and general social engagement
Orchestrate multi‑agent workflows that coordinate content creation and publishing

FAQ from Social MCP: Multi-Agent Social Media Automation

What are the runtime dependencies?

Python 3, Playwright (installed via playwright install), and all packages in requirements.txt. A .env file with Twitter credentials and a Playwright session directory is required.

How do I configure authentication?

Store Twitter username/password, Playwright session directory, and any other secrets in the .env file. For Google Sheets and Bluesky, set up OAuth credentials separately.

Where is browser session data stored?

Persistent browser session data is stored in the directory specified by PLAYWRIGHT_SESSION_DIR in the .env file (default ./playwright_session).

Can Social MCP run in headless mode?

Yes. Set HEADLESS=true in the .env file to enable headless browser operation.

Which social media platforms are supported?

Twitter (via Playwright browser automation) and Bluesky (via API integration).

Comments

More AI & Agents MCP servers

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622