{
  "openapi": "3.0.1",
  "info": {
    "title": "Social Media MCP Server - Unified Multi-Platform Posting API",
    "description": "MCP Server for AI assistants: post to GBP, Facebook, Instagram, LinkedIn, X, Reddit, Pinterest and TikTok with your own login, cross-post, use LinkedIn voice and content tools, research influencers, and send Discord, Slack, Telegram and WhatsApp messages.",
    "version": "1.0",
    "x-build-id": "QsNngDLAHrOkfuqzL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alizarin_refrigerator-owner~social-media-mcp-server/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-social-media-mcp-server",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/alizarin_refrigerator-owner~social-media-mcp-server/runs": {
      "post": {
        "operationId": "runs-sync-alizarin_refrigerator-owner-social-media-mcp-server",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/alizarin_refrigerator-owner~social-media-mcp-server/run-sync": {
      "post": {
        "operationId": "run-sync-alizarin_refrigerator-owner-social-media-mcp-server",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "apifyToken": {
            "title": "Apify API Token",
            "type": "string",
            "description": "Your Apify API token. Posting, LinkedIn, influencer and profile tools run public actors on your Apify account with it. Messaging tools do not need it."
          },
          "tool": {
            "title": "MCP Tool",
            "enum": [
              "post_to_gbp",
              "post_to_facebook",
              "post_to_instagram",
              "post_to_linkedin",
              "post_to_twitter",
              "post_to_reddit",
              "post_to_pinterest",
              "post_to_tiktok",
              "cross_post",
              "list_platforms",
              "scrape_linkedin_profile",
              "scrape_linkedin_posts",
              "analyze_linkedin_voice",
              "generate_linkedin_post",
              "improve_linkedin_draft",
              "suggest_linkedin_topics",
              "analyze_linkedin_performance",
              "discover_influencers",
              "analyze_influencer",
              "compare_influencers",
              "generate_influencer_strategy",
              "scrape_tiktok_profile",
              "scrape_youtube_channel",
              "scrape_instagram_profile",
              "send_discord_message",
              "send_slack_message",
              "send_telegram_message",
              "send_whatsapp_message",
              "list_messaging_platforms",
              "get_messaging_platform_status"
            ],
            "type": "string",
            "description": "The MCP tool to execute. Tools that are not available yet are listed in the README.",
            "default": "list_platforms"
          },
          "toolInput": {
            "title": "Tool Input",
            "type": "object",
            "description": "JSON input for the selected tool. Posting tools take your login for that platform here, for example {\"pageUrl\": \"https://facebook.com/yourpage\", \"message\": \"Hello\", \"cookies\": \"[...]\"} for post_to_facebook."
          },
          "demoMode": {
            "title": "Demo Mode",
            "type": "boolean",
            "description": "Return labeled sample data without posting, sending or scraping anything",
            "default": true
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Optional webhook URL to receive results when posting completes"
          },
          "linkedinCookies": {
            "title": "LinkedIn cookies",
            "type": "string",
            "description": "For scrape_linkedin_profile, scrape_linkedin_posts and the LinkedIn voice tools when they read a profile: the JSON cookie export (Cookie-Editor) from your logged-in LinkedIn session."
          },
          "linkedinEmail": {
            "title": "LinkedIn email",
            "type": "string",
            "description": "Alternative to LinkedIn cookies."
          },
          "linkedinPassword": {
            "title": "LinkedIn password",
            "type": "string",
            "description": "Alternative to LinkedIn cookies."
          },
          "linkedinCookieStorageKey": {
            "title": "LinkedIn cookie storage key",
            "type": "string",
            "description": "Alternative to LinkedIn cookies: key of a saved session in your 'cookie-sessions' key-value store."
          },
          "anthropicApiKey": {
            "title": "Anthropic API key",
            "type": "string",
            "description": "For the LinkedIn voice tools and generate_influencer_strategy (one AI key is required)."
          },
          "openaiApiKey": {
            "title": "OpenAI API key",
            "type": "string",
            "description": "For the LinkedIn voice tools and generate_influencer_strategy (one AI key is required)."
          },
          "geminiApiKey": {
            "title": "Gemini API key",
            "type": "string",
            "description": "For the LinkedIn voice tools."
          },
          "discordBotToken": {
            "title": "Discord bot token",
            "type": "string",
            "description": "For send_discord_message with a channelId (a webhookUrl in toolInput works without it)."
          },
          "slackBotToken": {
            "title": "Slack bot token",
            "type": "string",
            "description": "For send_slack_message."
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "For send_telegram_message."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp Cloud API access token",
            "type": "string",
            "description": "For send_whatsapp_message."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp phone number ID",
            "type": "string",
            "description": "For send_whatsapp_message."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}