PostSpread MCP Server

Claude (Desktop & Web)

Requirements:

• Claude account (Desktop app or claude.ai)
• PostSpread account

Setup Steps:

1. 1 In Claude, click the Settings icon (⚙️)
2. 2 Go to Connectors → Custom connectors
3. 3 Click Add custom connector
4. 4 Enter the connector URL:

https://mcp.postspread.com/mcp/sse

5. 5 Click Connect — a browser window will open for OAuth authentication
6. 6 Log in to your PostSpread account and click Allow to authorize

Schedule a post about our new product for tomorrow at 3pm across Instagram and Facebook

Show me last week's engagement metrics for all my posts

ChatGPT

Requirements:

• ChatGPT account (ChatGPT free or paid)
• Developer Mode enabled
• PostSpread account

Step 1: Enable Developer Mode

1. 1 Open ChatGPT
2. 2 Click Settings (gear icon)
3. 3 Go to Developer tab
4. 4 Turn Developer Mode on

Step 2: Connect PostSpread

1. 1 Go to ChatGPT Plugins
2. 2 Click the + (New Plugin) button
3. 3 Fill in the plugin details:

• Name: PostSpread
• Description: Manage and schedule social media posts across all platforms
• Connection: Select "Server URL"
• Server URL: https://mcp.postspread.com/mcp/sse
• Authentication: Select "OAuth"

4. 4 Check "I understand and want to continue"
5. 5 Click Create
6. 6 You'll be redirected to log in to your PostSpread account
7. 7 Click Allow to authorize ChatGPT to access your PostSpread account

Step 3: Start Using

Once connected, start a new chat and type:

@PostSpread  Show my connected social accounts.

Or ask naturally:

Schedule a post about our new product for tomorrow at 3pm on Instagram and Facebook

Grok

Requirements:

• Grok account (access at grok.com)
• PostSpread account

Setup Steps:

1. 1 Go to grok.com/connectors
2. 2 Click New Connector and select "Custom"
3. 3 Give it a preferred name: PostSpread
4. 4 Enter the connector URL:

https://mcp.postspread.com/mcp/sse

5. 5 Click Connect — a browser window will open for OAuth sign-in
6. 6 Log in to your PostSpread account and click Allow to grant permissions

Claude Code (CLI)

Requirements:

• Claude Code CLI installed
• PostSpread account
• Your PostSpread API Token

Setup Steps:

1. 1 Open your terminal and navigate to your Claude Code project directory
2. 2 Create or edit your Claude Code configuration file (.claude/config.json or via Claude Code settings)
3. 3 Add the PostSpread MCP server to your configuration:

{
  "mcpServers": {
    "postspread": {
      "command": "npx",
      "args": ["-y", "postspread-mcp"],
      "env": {
        "POSTSPREAD_API_TOKEN": "your-postspread-api-token-here"
      }
    }
  }
}

4. 4 Restart Claude Code CLI or reload your configuration

Create a post announcing our new feature release and schedule it for tomorrow at 2pm on Twitter and LinkedIn

Setup Steps:

1. 1 Open your editor's Settings (e.g. Cursor Settings → Features → MCP)
2. 2 Click + Add New MCP Server
3. 3 Set the type to command
4. 4 Name it postspread and set the command to:

npx -y postspread-mcp

5. 5 You will be prompted to enter your environment variables. Add your POSTSPREAD_API_TOKEN

Setup Steps:

1. 1 Clone this repository and deploy it to a Node.js server (e.g. Heroku, Vercel, Railway)
2. 2 Start the server using node server.js (Defaults to Port 2407)
3. 3 Point your @modelcontextprotocol/sdk client to http://your-server.com/mcp/sse
4. 4 Pass your user's PostSpread API Token in the HTTP Authorization headers when establishing the SSE connection