Skip to main content

MCP Server Integration

Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools. The PostEverywhere MCP server gives any MCP-compatible AI tool — Claude Code, Cursor, Windsurf, and others — direct access to your social media accounts, letting you schedule and publish posts through natural language.

Prerequisites​

Setup for Claude Code​

Add this to your Claude Code MCP configuration (~/.claude/claude_code_config.json, or the project-level .claude/claude_code_config.json):

{
  "mcpServers": {
    "posteverywhere": {
      "command": "npx",
      "args": ["-y", "@posteverywhere/mcp"],
      "env": {
        "POSTEVERYWHERE_API_KEY": "pe_live_..."
      }
    }
  }
}

Restart Claude Code after saving. You should see PostEverywhere listed in your available tools.

Setup for Cursor​

Open Cursor's MCP settings (Settings > MCP) and add a new server with this configuration:

{
  "mcpServers": {
    "posteverywhere": {
      "command": "npx",
      "args": ["-y", "@posteverywhere/mcp"],
      "env": {
        "POSTEVERYWHERE_API_KEY": "pe_live_..."
      }
    }
  }
}

Alternatively, create a .cursor/mcp.json file in your project root with the same content.

Setup for Windsurf​

In Windsurf, go to Settings > Extensions > MCP and add:

{
  "mcpServers": {
    "posteverywhere": {
      "command": "npx",
      "args": ["-y", "@posteverywhere/mcp"],
      "env": {
        "POSTEVERYWHERE_API_KEY": "pe_live_..."
      }
    }
  }
}

What You Can Do​

Once connected, you can manage your social media entirely through natural language:

  • List accounts — see all connected social accounts and their status
  • Create posts — draft content for any combination of platforms
  • Schedule posts — set a specific date and time for publishing
  • Upload media — attach images or videos to your posts
  • Check results — see which platforms published successfully and which failed
  • Bulk schedule — create multiple posts in one conversation

Example Prompts​

Here are prompts you can use with any MCP-compatible AI tool:

Schedule a post:

"Schedule a post to Instagram and LinkedIn for tomorrow at 10am saying 'We just launched our new feature! Check it out at example.com'"

Cross-platform content:

"Create a post announcing our Q2 results. Put it on X, LinkedIn, and Threads. Schedule it for Monday at 9am EST. Keep X under 280 characters but make the LinkedIn version longer and more professional."

Check your accounts:

"Show me all my connected social media accounts and their status"

Review scheduled posts:

"What posts do I have scheduled for this week?"

Upload and post media:

"Upload the image at ./campaign-banner.png and schedule it to Instagram and Facebook for Friday at noon"

Environment Variables​

VariableRequiredDescription
POSTEVERYWHERE_API_KEYYesYour API key starting with pe_live_. Generate at Settings > Developers.

Troubleshooting​

"Tool not found" or MCP server not connecting​

  1. Make sure Node.js 18+ is installed: node --version
  2. Test the package is accessible: npx @posteverywhere/mcp --help
  3. Confirm your configuration file is valid JSON
  4. Restart your AI tool after changing MCP configuration

"Unauthorized" errors​

  • Double-check your API key is correct and starts with pe_live_
  • Make sure the key hasn't been revoked in Settings > Developers
  • Verify there are no extra spaces or quotes around the key in your config

Posts failing to publish​

  • Confirm the target accounts are still connected and healthy in your dashboard
  • Check platform-specific requirements (e.g., TikTok requires video, YouTube requires a title)
  • See the platform guides for media and content requirements

Rate limit errors​

The MCP server respects the same rate limits as direct API calls. If you're making many requests in quick succession, wait a moment and try again.

FAQ​

What AI tools support MCP?

MCP is supported by Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Continue, and a growing list of AI coding assistants. Any tool that implements the MCP client specification will work with the PostEverywhere MCP server.

Is my API key secure in the MCP config?

Your API key is stored locally in your MCP configuration file and passed as an environment variable to the MCP server process. It is never sent to the AI model itself — only the MCP server uses it to authenticate with the PostEverywhere API. Treat your config file like any other file containing secrets: don't commit it to public repositories.

Can I use MCP to bulk schedule?

Yes. You can ask your AI assistant to create multiple posts in a single conversation. The MCP server supports the same bulk schedule endpoint as the REST API, so you can schedule up to 100 posts at once.

Does it work with self-hosted or team accounts?

The MCP server uses your personal API key, which is scoped to your organization. Any accounts connected to your PostEverywhere organization are accessible through MCP.

Next Steps​