Developer Documentation

    Connect AI to Your Social Media

    Integrate Claude, ChatGPT, and other AI assistants with VibeMarketing using Model Context Protocol (MCP). Automate your social media scheduling, content creation, and account management with AI.

    AI-Powered Automation

    Let AI handle your social media scheduling while you focus on strategy and growth.

    Secure OAuth 2.0

    Enterprise-grade security with PKCE, token rotation, and revocable access control.

    Real-Time Integration

    Instantly schedule posts, check analytics, and manage multiple social accounts.

    MCP Server Setup Guide

    Overview

    VibeMarketing's Model Context Protocol (MCP) server allows AI assistants like Claude, ChatGPT, and other compatible tools to interact with your social media accounts and posts programmatically.

    Features

    The MCP server provides the following tools:

    • get_x_accounts: List connected X/Twitter accounts
    • get_linkedin_accounts: List connected LinkedIn accounts
    • get_posts: Retrieve scheduled or published posts
    • schedule_post: Schedule new social media posts
    • get_subscription_status: Check subscription status and usage

    Setup Instructions

    Claude Code (Recommended)

    Claude Code provides the simplest setup experience with automatic authentication.

    Step 1: Install MCP in Your Project Directory

    Navigate to your project directory where you want to install the MCP, then run:

    claude mcp add -s local -t http vibemarketing https://vibemarketing.ninja/mcp

    💡 Tip: Run this command in a directory where you store your marketing content and documents. Claude will have access to these files as context when generating posts.

    Step 2: Authenticate with VibeMarketing

    After running the command above:

    1. Start Claude Code by running claude in your terminal
    2. Run the command /mcp in Claude Code
    3. Select vibemarketing from the list of MCP servers
    4. Press Enter to confirm
    5. Choose "Authenticate" from the menu
    6. Your browser will open - log in to your VibeMarketing account
    7. Authorize the connection when prompted

    You're all set! Claude Code can now access your VibeMarketing account to schedule posts, view your social accounts, and manage your content.

    Best Practice: Create a dedicated folder for your marketing work (e.g., ~/marketing) and install the MCP there. Store your brand guidelines, previous posts, and other relevant documents in this folder for Claude to use as context.


    Claude Desktop

    For Claude Desktop users, add VibeMarketing as a custom connector:

    Step 1: Open Claude Desktop Settings

    Go to Settings → Connectors → Add custom connector

    Step 2: Add VibeMarketing Connector

    Enter the following details:

    • Name: VibeMarketing
    • Remote MCP server URL: https://vibemarketing.ninja/mcp

    Step 3: Click Add

    The connector will appear in your list. You'll be prompted to authenticate when you first use the MCP tools.

    Note: Claude Desktop will handle authentication automatically through OAuth. Just log in with your VibeMarketing account when prompted.


    ChatGPT (Developer Mode)

    ChatGPT Plus users with Developer Mode enabled can add VibeMarketing as an MCP server.

    Step 1: Open ChatGPT Settings

    1. Click on your profile picture in the bottom left
    2. Go to Settings & Beta
    3. Select Beta features
    4. Enable Developer mode if not already enabled

    Step 2: Add MCP Server

    1. In ChatGPT, click on the paperclip icon (attachment button)
    2. Select Configure MCP servers
    3. Click Add MCP Server
    4. Enter the following details:
    • Name: vibemarketing.ninja
    • Description (optional): Tweet and LinkedIn scheduler
    • MCP Server URL: https://vibemarketing.ninja/mcp
    • Authentication: Select OAuth
    1. Check the "I trust this application" checkbox
    2. Click Create

    Step 3: Authenticate

    1. When you first use the MCP server, you'll be prompted to authenticate
    2. Log in with your VibeMarketing account
    3. Authorize the connection

    ⚠️ Note: ChatGPT MCP support is in beta and may have limitations compared to Claude implementations.

    Available MCP Tools

    Once connected, your AI assistant will have access to these tools:

    Social Media Management

    • get_x_accounts - List your connected X/Twitter accounts
    • get_linkedin_accounts - List your connected LinkedIn accounts
    • schedule_post - Schedule posts to your social media accounts
    • get_posts - View your scheduled and published posts

    Account Management

    • get_subscription_status - Check your subscription plan and usage limits

    Example Usage

    Once configured, you can ask your AI assistant to:

    • "Show me my connected social media accounts"
    • "Schedule a post about our new product launch for tomorrow at 2pm"
    • "What posts do I have scheduled for this week?"
    • "Check my subscription status and remaining post quota"
    • "Help me write and schedule a LinkedIn post about industry trends"

    Security

    • OAuth 2.0 Authentication: Secure authentication flow with PKCE support
    • Token Expiration: Access tokens expire after 1 hour for security
    • Revocable Access: You can revoke MCP access at any time from your account settings
    • Encrypted Communications: All API calls use HTTPS

    Troubleshooting

    Common Issues

    Authentication Failed

    • Ensure you're logged in to VibeMarketing
    • Check that you've authorized the MCP client
    • Try logging out and back in to VibeMarketing

    Tools Not Available

    • Restart your AI assistant after adding the MCP server
    • Verify the MCP server URL is correct: https://vibemarketing.ninja/mcp
    • Check your internet connection

    Connection Errors

    • Ensure you're using the full URL including /mcp
    • Check if your firewall or VPN is blocking the connection
    • Try refreshing your authentication

    Need Help?

    Updates

    The MCP server is continuously improved. Check back regularly for new features and tools!

    Ready to Automate Your Social Media with AI?

    Join thousands of marketers using AI to grow their social media presence. Start free and upgrade as you grow.