Skip to content
MCP server

PlanVortex

Schedule posts, read comments and reply to messages across 14 social networks

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally
Version
0.14.0
Listing updated
3 days ago

About PlanVortex

PlanVortex is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Here a social inbox and scheduler are handed to an assistant. It covers Facebook, Instagram, Threads, LinkedIn, TikTok, X, WhatsApp, YouTube, Google Business, Bluesky, Discord, Telegram, Slack and Pinterest.

It authenticates with a client id and secret from a PlanVortex app, and every plan has apps, the free one included: one on Free, two on Basic, five on Pro and ten on Custom. Nine write tools can be removed by setting a read-only switch. Media uploads can only read from directories you allow, and an optional create_ai_plan tool, which generates a week of posts and spends AI credits, stays off unless enabled.

The wider PlanVortex API also writes copy and images and sends webhooks. This server runs locally over stdio with npx.

Install

Run in a terminal

claude mcp add planvortex --env PLANVORTEX_CLIENT_ID='<PLANVORTEX_CLIENT_ID>' --env PLANVORTEX_CLIENT_SECRET='<PLANVORTEX_CLIENT_SECRET>' -- npx -y planvortex-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "planvortex": {
      "command": "npx",
      "args": [
        "-y",
        "planvortex-mcp"
      ],
      "env": {
        "PLANVORTEX_CLIENT_ID": "<PLANVORTEX_CLIENT_ID>",
        "PLANVORTEX_CLIENT_SECRET": "<PLANVORTEX_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "planvortex": {
      "command": "npx",
      "args": [
        "-y",
        "planvortex-mcp"
      ],
      "env": {
        "PLANVORTEX_CLIENT_ID": "<PLANVORTEX_CLIENT_ID>",
        "PLANVORTEX_CLIENT_SECRET": "<PLANVORTEX_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "planvortex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "planvortex-mcp"
      ],
      "env": {
        "PLANVORTEX_CLIENT_ID": "<PLANVORTEX_CLIENT_ID>",
        "PLANVORTEX_CLIENT_SECRET": "<PLANVORTEX_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "planvortex": {
      "command": "npx",
      "args": [
        "-y",
        "planvortex-mcp"
      ],
      "env": {
        "PLANVORTEX_CLIENT_ID": "<PLANVORTEX_CLIENT_ID>",
        "PLANVORTEX_CLIENT_SECRET": "<PLANVORTEX_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "planvortex": {
      "command": "npx",
      "args": [
        "-y",
        "planvortex-mcp"
      ],
      "env": {
        "PLANVORTEX_CLIENT_ID": "<PLANVORTEX_CLIENT_ID>",
        "PLANVORTEX_CLIENT_SECRET": "<PLANVORTEX_CLIENT_SECRET>"
      }
    }
  }
}

Configuration

  • PLANVORTEX_CLIENT_IDClient id of a PlanVortex app. Every plan has apps, the free one included. Panel: Settings > Apps.Required
  • PLANVORTEX_CLIENT_SECRETSecret of that app.Required
  • PLANVORTEX_ORGANIZATION_IDDefault organization id. Optional: saves a discovery call per conversation.
  • PLANVORTEX_MCP_UPLOAD_DIRSDirectories upload_media may read from. Empty means none.
  • PLANVORTEX_MCP_READ_ONLYSet to 1 to remove the nine write tools.
  • PLANVORTEX_MCP_ALLOW_AISet to 1 to add create_ai_plan, which generates a week of posts and spends AI credits.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

upload_media
Uploads media from allowed directories.
create_ai_plan
Generates a week of posts; optional and costs AI credits.

What it does

Multi-network scheduling
Schedule posts across many social networks.
Comment inbox
Read comments in one place.
Private message replies
Answer direct messages from the assistant.
Read-only switch
Removes the nine write tools.
Upload allowlist
upload_media reads only from approved folders.
Optional AI planning
create_ai_plan generates a week of posts at credit cost.

Good for

  • Schedule a week of posts from a chat
  • Triage new comments
  • Reply to messages across networks
  • Run a read-only audit of social activity

Pricing

Freemium

Free plan includes one app; paid prices not published

Prices change. Check planvortex.com before you buy.

PlanVortex FAQ

What credentials are needed?

A client id and secret from a PlanVortex app.

Can I stop it writing?

Yes, set PLANVORTEX_MCP_READ_ONLY to 1.

Does AI generation run by default?

No, create_ai_plan needs PLANVORTEX_MCP_ALLOW_AI set to 1.

How many apps does Free allow?

One.

Is PlanVortex free?

PlanVortex has a free plan, with paid plans for more usage or features.

How do I add PlanVortex to Claude Code?

Run this command in your terminal: claude mcp add planvortex --env PLANVORTEX_CLIENT_ID='<PLANVORTEX_CLIENT_ID>' --env PLANVORTEX_CLIENT_SECRET='<PLANVORTEX_CLIENT_SECRET>' -- npx -y planvortex-mcp

What are the best alternatives to PlanVortex?

The closest alternatives to PlanVortex are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, BoardAgent and Callout.

Alternatives to PlanVortex

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO