# PlanVortex

> PlanVortex is a freemium MCP server for marketing and seo. Schedule posts, read comments and reply to messages across 14 social networks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://planvortex.com/en/developers
- **Repository:** https://github.com/taliasoftworks/planvortexmcp
- **MCP Registry name:** io.github.taliasoftworks/planvortex
- **Categories:** marketing and SEO, communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/planvortex
