Social Media MCP Server v1.0

Unified Multi-Platform Social Posting for AI Assistants by John Rippy | johnrippy.link

MCP Server providing AI assistants with unified access to 8 social media platforms through a single interface. Post to GBP, Facebook, Instagram, LinkedIn, Twitter/X, Reddit, Pinterest, and TikTok with consistent tool schemas.

Supported Platforms

Platform	Actor	Post Type
Google Business Profile	gbp-poster	Updates, Events, Offers
Facebook	facebook-poster	Page posts with media
Instagram	instagram-poster	Photo/video posts
LinkedIn	linkedin-poster	Personal & company posts
Twitter/X	twitter-poster	Tweets with media
Reddit	reddit-poster	Text & link posts
Pinterest	pinterest-poster	Pins with images
TikTok	tiktok-poster	Video posts

MCP Tools Available

1. post_to_gbp

Post content to Google Business Profile.

{
  "tool": "post_to_gbp",
  "toolInput": {
    "accessToken": "ya29...",
    "businessAccountId": "accounts/123/locations/456",
    "content": "Check out our holiday special!",
    "callToAction": { "actionType": "LEARN_MORE", "url": "https://..." }
  }
}

2. post_to_facebook

Post to a Facebook Page.

{
  "tool": "post_to_facebook",
  "toolInput": {
    "accessToken": "EAAxx...",
    "pageId": "123456789",
    "message": "Exciting news from our team!",
    "link": "https://example.com"
  }
}

3. post_to_instagram

Post photos/videos to Instagram.

{
  "tool": "post_to_instagram",
  "toolInput": {
    "accessToken": "IGxx...",
    "userId": "17841400...",
    "imageUrl": "https://example.com/image.jpg",
    "caption": "New product launch! #excited"
  }
}

4. post_to_linkedin

Post to LinkedIn (personal or company page).

{
  "tool": "post_to_linkedin",
  "toolInput": {
    "accessToken": "AQVxx...",
    "organizationId": "urn:li:organization:12345",
    "text": "Proud to announce our latest milestone!",
    "link": "https://company.com/news"
  }
}

5. post_to_twitter

Tweet to Twitter/X.

{
  "tool": "post_to_twitter",
  "toolInput": {
    "apiKey": "xxx",
    "apiSecret": "xxx",
    "accessToken": "xxx",
    "accessSecret": "xxx",
    "tweet": "Just launched something amazing! 🚀"
  }
}

6. post_to_reddit

Post to a subreddit.

{
  "tool": "post_to_reddit",
  "toolInput": {
    "clientId": "xxx",
    "clientSecret": "xxx",
    "username": "yourusername",
    "password": "xxx",
    "subreddit": "smallbusiness",
    "title": "How we grew our local business",
    "text": "Full story here..."
  }
}

7. post_to_pinterest

Create a Pin on Pinterest.

{
  "tool": "post_to_pinterest",
  "toolInput": {
    "accessToken": "xxx",
    "boardId": "123456",
    "imageUrl": "https://example.com/image.jpg",
    "title": "DIY Home Decor Ideas",
    "description": "Transform your space with these tips",
    "link": "https://blog.example.com/decor"
  }
}

8. post_to_tiktok

Post videos to TikTok.

{
  "tool": "post_to_tiktok",
  "toolInput": {
    "accessToken": "xxx",
    "videoUrl": "https://storage.example.com/video.mp4",
    "description": "Behind the scenes! #bts #business"
  }
}

9. cross_post

Post the same content across multiple platforms at once.

{
  "tool": "cross_post",
  "toolInput": {
    "platforms": ["gbp", "facebook", "linkedin", "twitter"],
    "content": "Big announcement coming tomorrow! Stay tuned 🎉",
    "imageUrl": "https://example.com/teaser.jpg",
    "credentials": {
      "gbp": { "accessToken": "..." },
      "facebook": { "accessToken": "...", "pageId": "..." }
    }
  }
}

10. schedule_post

Schedule a post for future publishing.

{
  "tool": "schedule_post",
  "toolInput": {
    "platform": "gbp",
    "content": "Join us for our grand opening!",
    "scheduledTime": "2024-12-25T10:00:00Z",
    "credentials": { "accessToken": "..." }
  }
}

11. list_platforms

Get a list of all available platforms and tools.

{
  "tool": "list_platforms"
}

Use Cases

• Social Media Managers - Unified interface for multi-platform posting
• AI Assistants - Let Claude/GPT post to social media via MCP
• Marketing Automation - Integrate with workflows for scheduled posting
• Content Campaigns - Cross-post announcements to all platforms at once
• Agency Operations - Manage multiple client accounts efficiently

Pricing

This actor uses pay-per-event pricing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
platform_post	Per successful platform post	$0.05

Example costs:

• Post to 1 platform: $0.10 + $0.05 = $0.15
• Cross-post to 4 platforms: $0.10 + (4 × $0.05) = $0.30
• Cross-post to all 8 platforms: $0.10 + (8 × $0.05) = $0.50

Integration with AI Assistants

Claude Desktop / Cursor

Add to your Claude configuration:

{
  "mcpServers": {
    "social-media": {
      "url": "https://api.apify.com/v2/acts/localhowl~social-media-mcp-server/runs",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

n8n / Make / Zapier

Use the Apify integration to call this actor with the desired tool and inputs.

Demo Mode

Set demoMode: true to test without actually posting. Returns realistic sample responses.

---

Built by John Rippy | johnrippy.link

---

Keywords

social media mcp, multi-platform posting, social media api, cross-posting, facebook api, instagram api, linkedin api, twitter api, gbp posts, pinterest api, reddit api, tiktok api, ai social media, mcp server, social automation