Automate Idea to Social - MCP Server

Overview

An MCP (Model Context Protocol) server that provides tools to publish content to various social media platforms. This server is based on the automate-idea-to-social project and exposes its functionality through a standardized MCP interface.

Prerequisites

• Docker

Usage

• In the json configuration below, replace <MY_HOME_DIRECTORY> with your home directory (e.g., /home/thomas or C:\Users\jana).

• Add the json configuration below to your MCP client or IDE.

{
  "mcpServers": {
    "automate-idea-to-social-mcp": {
      "command": "docker",
      "args": [
        "run", "-u", "0", "-i", "--rm",
        "-v", "/var/run/docker.sock:/var/run/docker.sock",
        "-e", "APP_PROFILES=docker",
        "-e", "USER_HOME=<MY_HOME_DIRECTORY>",
        "poshjosh/aideas-mcp:0.0.1"
      ],
      "env": { }
    }
  }
}

• Depending on the agents, you may need to provide additional environment variables. For example for instagram we add the following to the args section above:

{
  "mcpServers": {
    "automate-idea-to-social-mcp": {
      "args": [
        "-e", "INSTAGRAM_USER_EMAIL=<MY_INSTAGRAM_EMAIL>",
        "-e", "INSTAGRAM_USER_PASS=<MY_INSTAGRAM_PASSWORD>"
      ]
    }
  }
}

See the full list of environment variables.

VS Code

See Use MCP servers in VS Code

Supported Social Media (and other) Agents

The server provides automation capabilities for:

• YouTube: Video upload, metadata, playlists, subtitles
• Twitter: Tweet posting with media support
• Facebook: Post creation and publishing
• Instagram: Image and story posting
• TikTok: Video upload and publishing
• Reddit: Subreddit post submission
• Blog: Content publishing to blog platforms
• Translation: Multi-language content support

Key Features Implemented

1. Agent Management

• list_agents: Lists all available automation agents with optional filtering
• get_agent_config: Retrieves detailed configuration for specific agents
• Supports various agents: YouTube, Twitter, Facebook, Instagram, TikTok, Reddit, Blog, etc.

2. Task Management

• create_automation_task: Creates and executes automation tasks
• get_task_status: Monitors task progress and results
• list_tasks: Lists all tasks with status filtering
• Asynchronous task execution with proper error handling

3. System Validation

• validate_setup: Comprehensive system health checks
• Validates Python environment, project structure, and dependencies
• Provides actionable feedback for configuration issues

Technical Implementation

Architecture

• Language: TypeScript with Node.js runtime
• Protocol: Model Context Protocol (MCP) using official SDK
• Transport: Standard I/O (stdio) for communication
• Integration: Runs docker to execute automation tasks

Dependencies

• @modelcontextprotocol/sdk: MCP server framework
• zod: Schema validation and type safety
• js-yaml: YAML configuration parsing
• axios: HTTP client for potential API integrations
• node-html-parser: HTML parsing capabilities

Related pages

• Available tools
• Usage examples

Related Projects

• automate-idea-to-social - The underlying automation system
• Model Context Protocol - The protocol specification
• MCP SDK - TypeScript SDK for MCP servers