Posthell

Social media scheduler for AI agents: draft posts into a human-approved queue, then publish to 15 networks.

Documentation

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 <your Posthell API key>
Docs:      https://www.posthell.com/mcp
Registry:  io.github.Rohan27s/posthell

Tools

Tool	What it does
`shape_post`	Turns rough notes into 2-3 post angles, in your voice. Grounded only in what you wrote; never invents facts.
`create_draft`	Queues a draft, optionally with a suggested publish time. Always requires human approval before anything publishes.
`list_posts`	Reads your queue and recent posts, so an agent never drafts the same thing twice.
`get_growth`	Follower growth per network, so an agent knows where posting matters most.

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

Start a trial at posthell.com and connect your networks.
Create an API key in the dashboard's Agents tab (shown once, revocable anytime, up to 5 active keys).
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.