Posthell MCP Server

The official MCP server for Posthell, a social media scheduler built for solo founders. Connect Claude Code, Cursor, Claude Desktop, VS Code, Gemini CLI, Windsurf, or any MCP client, and your AI agent can run the drafting side of your posting pipeline.

Tell your agent what you shipped today, and a finished draft lands in your Posthell queue with a suggested time. You review and approve; Posthell publishes to up to 15 networks with per-network tailoring.

This is a hosted remote server (streamable HTTP). There is nothing to install or run locally.

Endpoint:  https://www.posthell.com/api/mcp
Auth:      Authorization: Bearer 
Docs:      https://www.posthell.com/mcp
Registry:  io.github.Rohan27s/posthell

Tools

The safety line

Agents propose, humans approve. There is no publish tool, on purpose. No MCP tool can publish, schedule for real, or spend credits. Every draft waits in your Posthell queue until you approve it.

Setup

1. Start a trial at posthell.com and connect your networks.

2. Create an API key in the dashboard's Agents tab (shown once, revocable anytime, up to 5 active keys).

3. Add the server to your client.

Claude Code

claude mcp add --transport http posthell https://www.posthell.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor / any JSON-config client

{
  "mcpServers": {
    "posthell": {
      "url": "https://www.posthell.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop (via mcp-remote bridge)

{
  "mcpServers": {
    "posthell": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.posthell.com/api/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

Per-client instructions for VS Code, Gemini CLI, and Windsurf: https://www.posthell.com/mcp

Supported networks

X (Twitter), LinkedIn, Instagram, Facebook, Threads, Bluesky, TikTok, YouTube, Pinterest, Reddit, Telegram, Discord, Snapchat, Google Business Profile, WhatsApp.

Rate limits

Per user: `shape_post` 6/min (shares your plan's monthly AI draft quota), `create_draft` 12/min (max 30 queued drafts/day), reads 30/min. Reads are free on every plan.

About this repository

This repo holds the public metadata for the hosted Posthell MCP server: the `server.json` published to the official MCP registry, and this documentation. The server itself runs as part of the Posthell product and is not open source.