Schedule social media posts with MCP

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Cursor auto-detects Streamable HTTP from the url field.

{
  "mcpServers": {
    "crosspostingpal": {
      "url": "https://api.crosspostingpal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer cpp_pat_YOUR_TOKEN"
      }
    }
  }
}

Claude Code

claude mcp add --transport http crosspostingpal https://api.crosspostingpal.com/api/mcp \
  --header "Authorization: Bearer cpp_pat_YOUR_TOKEN"

Claude (claude.ai / Desktop)

Settings → Connectors → Add custom connector → enter the endpoint URL above → under Request headers add Authorization: Bearer cpp_pat_…. If request headers are unavailable on your plan, Claude Desktop can bridge through mcp-remote in claude_desktop_config.json:

{
  "mcpServers": {
    "crosspostingpal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.crosspostingpal.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer cpp_pat_YOUR_TOKEN"
      }
    }
  }
}

Codex

Codex stores the environment-variable name, not the token — export CPP_MCP_TOKEN in the environment where you run Codex.

# ~/.codex/config.toml
[mcp_servers.crosspostingpal]
url = "https://api.crosspostingpal.com/api/mcp"
bearer_token_env_var = "CPP_MCP_TOKEN"

Or via the CLI:

codex mcp add crosspostingpal --url https://api.crosspostingpal.com/api/mcp \
  --bearer-token-env-var CPP_MCP_TOKEN

Hermes Agent

Add CPP to the configuration of the Hermes profile running your assistant:

# ~/.hermes/config.yaml (merge with your existing entries)
mcp_servers:
  crosspostingpal:
    url: "https://api.crosspostingpal.com/api/mcp"
    auth: oauth

Run this in a fresh terminal on the Hermes host and complete the CPP OAuth sign-in:

hermes mcp login crosspostingpal

Start a new session or restart your messaging gateway, then ask Hermes to list your CPP accounts and create a draft. Follow the Hermes workflow and remote-host setup links.

ChatGPT (developer mode)

ChatGPT connects with OAuth — no token to copy. Verified end-to-end: any ChatGPT user on a paid plan can connect in under a minute:

1. In ChatGPT, go to Settings → Apps → Advanced settings and enable Developer mode (on Business/Enterprise workspaces an admin enables it first).
2. Back in Apps, click Create → Create MCP app.
3. Name it (e.g. CrossPostingPal), set the URL to https://api.crosspostingpal.com/api/mcp and choose OAuth as authentication.
4. ChatGPT registers itself automatically (no client ID to copy) and opens a CrossPostingPal sign-in page — approve the permissions and you're connected.

The same OAuth flow works for Claude custom connectors. Disconnect anytime under Settings → Developer / AI Agents → Connected apps. Publishing immediately (posts:publish) and writing comment automations (automations:write) are off by default on the consent screen.

OpenClaw

Install the CPP publishing skill. Download and extract the skill below. Install the directory containing SKILL.md with the command shown below, then start a new OpenClaw session.

openclaw skills install /absolute/path/to/crosspostingpal --as crosspostingpal

# In an interactive terminal on the agent host:
python3 /absolute/path/to/crosspostingpal/scripts/cpp_mcp.py configure
python3 /absolute/path/to/crosspostingpal/scripts/cpp_mcp.py accounts

Claude Cowork

Install the CPP plugin and connect with OAuth. Download the plugin below. In Claude Desktop, open Cowork → Customize → Plugins and upload the custom plugin file. Workspace settings may control plugin installation.

/crosspostingpal:campaign
/crosspostingpal:release
/crosspostingpal:queue

Claude Code mods

Install the CPP release plugin with a Code mod. Download and extract the release mod package. Start a trusted Claude Code session with the --plugin-dir command below. Workspace policies may control whether mods can load.

claude --plugin-dir /absolute/path/to/extracted/crosspostingpal-release

# Inside Claude Code:
/mcp
/crosspostingpal-release:release
/cpp-activity
/crosspostingpal-release:queue

OpenCode

Connect through remote MCP with OAuth. Merge the configuration below into your OpenCode opencode.json. Use the global config location for access across projects; preserve existing entries.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "crosspostingpal": {
      "type": "remote",
      "url": "https://api.crosspostingpal.com/api/mcp",
      "enabled": true
    }
  }
}

Cursor

Connect through remote MCP with OAuth. Merge the configuration below into ~/.cursor/mcp.json for global access or .cursor/mcp.json for this project.

{
  "mcpServers": {
    "crosspostingpal": {
      "url": "https://api.crosspostingpal.com/api/mcp"
    }
  }
}

Gemini CLI

Connect through HTTP MCP with OAuth. Merge the configuration below into ~/.gemini/settings.json or your project’s .gemini/settings.json. Use httpUrl for CPP and preserve existing entries.

{
  "mcpServers": {
    "crosspostingpal": {
      "httpUrl": "https://api.crosspostingpal.com/api/mcp"
    }
  }
}

How do I schedule social media posts with MCP?

Connect your social accounts in CrossPostingPal, add the MCP endpoint to your AI client (OAuth for ChatGPT and Claude connectors, a personal access token for Cursor, Claude Code and Codex), then ask the agent to list your accounts, create drafts and schedule the ones you approve.

Which AI clients can schedule posts through CrossPostingPal MCP?

Any client that supports remote MCP. Setup is documented for Claude, ChatGPT in developer mode, Cursor, Claude Code, Codex and Hermes Agent, with additional guides for OpenClaw, OpenCode, Gemini CLI and Cue.

Can an AI agent publish without my approval?

Agents create drafts and scheduled posts by default, and a scheduled post publishes at its chosen time. Publishing immediately requires the separate posts:publish permission, which is off by default on the OAuth consent screen. Revoking a token takes effect immediately.

Do I need to write code to connect an agent?

No. ChatGPT and Claude connectors need only the endpoint URL and an OAuth sign-in. Cursor, Claude Code and Codex need a short configuration snippet and a personal access token.

What can an agent not do yet?

Agents cannot edit or delete posts, manage account connections or read analytics. Instagram, TikTok and Dribbble posts need public media URLs.