For AI agents

The social media MCP server for your AI agent

Connect Claude Code, Cursor, or any MCP client to posthell. Your agent drafts posts from what you actually shipped, the drafts wait in your queue, and nothing publishes until you approve it. posthell then posts to up to 15 networks with per-network tailoring.

Start 3 days freeIncluded on every plan. Keys revocable any time.

Listed onOfficial MCP Registrymcp.so

posthell exposes a remote MCP server over streamable HTTP at https://www.posthell.com/api/mcp. Authenticate with a per-user API key (created in the dashboard) sent as a Bearer token. Connected agents get four tools: shape_post, create_draft, list_posts, and get_growth. Drafting is metered by your plan's AI quota; reads are free. No tool can publish, schedule for real, or spend credits.

What your agent can do

shape_post

Turns rough notes into 2-3 post angles, in the user's voice. Grounded only in the notes - never invents facts.

create_draft

Queues a draft, optionally with a suggested time. The user approves it in the dashboard before anything is published.

list_posts

Reads the 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.

How it works

  1. Create an agent key

    Start a posthell trial, connect your networks, then open the dashboard's Agents tab and create an API key. It is shown once; keep it somewhere safe.

  2. Add posthell to your client

    Run the one-liner (or paste the config) for your client below. That is the whole integration; the tools are self-describing.

  3. Ask, then approve

    Tell your agent what you shipped: "draft a post about the dark mode release". A draft lands in your posthell queue with a suggested time. You review, tweak if you want, and approve.

Set up your client

Replace YOUR_API_KEY with a key from your dashboard's Agents tab. One key works across every client.

Claude Code

One command in your terminal. Works immediately in every project.

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

Then just ask: “I shipped dark mode today - draft a post about it.”

Cursor

Add posthell to ~/.cursor/mcp.json (or Cursor Settings → MCP → Add new server).

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

Restart Cursor after saving; posthell appears under MCP tools.

Claude Desktop

Claude Desktop connects via the mcp-remote bridge. Settings → Developer → Edit Config, then add:

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

Restart Claude Desktop and posthell shows up in the tools menu.

VS Code

GitHub Copilot agent mode picks it up with one command:

Run this
code --add-mcp '{"name":"posthell","type":"http","url":"https://www.posthell.com/api/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'

Or add the same object under “servers” in .vscode/mcp.json.

Gemini CLI

Add posthell to ~/.gemini/settings.json:

~/.gemini/settings.json
{
  "mcpServers": {
    "posthell": {
      "httpUrl": "https://www.posthell.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart the CLI; check with /mcp.

Windsurf

Add posthell to ~/.codeium/windsurf/mcp_config.json:

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

Refresh MCP servers from Windsurf's Cascade settings.

Anything else

Any MCP client that speaks streamable HTTP works - point it here with your key as a Bearer token:

Endpoint
https://www.posthell.com/api/mcp
Header
Authorization: Bearer YOUR_API_KEY

Tools are self-describing: connect and call tools/list.

Frequently asked questions

What is an MCP server?

MCP (Model Context Protocol) is an open standard that lets AI agents call external tools. posthell runs a remote MCP server, so any MCP-capable agent (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Windsurf, and others) can work with your posthell account: shape rough notes into post drafts, queue drafts, read your post queue, and read your follower growth.

Can my agent publish posts on its own?

No, and that is deliberate. No MCP tool can publish, schedule for real, or spend X credits. Agents create drafts (optionally with a suggested time); every draft waits in your posthell queue until you approve it. You stay the only one who can put words on your own accounts.

How do I get an API key?

Sign in to posthell, open the Agents tab on the dashboard, and create a key. The key is shown once, you can hold up to 5 active keys, and any key can be revoked instantly. Use it as a Bearer token in the Authorization header.

Is agent access included in every plan?

Yes. The MCP server is included on Solo, Pro, and the free trial. AI drafting through shape_post shares your plan's monthly AI draft quota (10 on trial, 40 on Solo, 150 on Pro); reading the queue and growth stats is free.

What are the rate limits?

Per user: shape_post 6 calls/min, create_draft 12/min (and at most 30 queued drafts per day), reads 30/min. Enough for a daily posting workflow with plenty of headroom; the caps exist to keep one runaway loop from burning your AI quota.

Does it work with ChatGPT or custom agents?

Any client that speaks MCP over streamable HTTP works, including custom agents built with the Anthropic, OpenAI, or Vercel AI SDKs. Point the client at the endpoint, pass your key as a Bearer token, and call tools/list to discover the tools.

Give your agent a posting queue

3-day free trial, card required. Connect your networks, create a key, and your agent is drafting in five minutes.

Start 3 days freeSee pricing