Posthell

Official4 toolsLive

by Rohan27s

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

io.github.Rohan27s/posthell (MCP Server)

The io.github.Rohan27s/posthell MCP server is a social media scheduler for AI agents. It drafts posts and places them into a human-approved queue for distribution across 15 networks. The server is implemented as a toolset with 4 available tools.

🛠️ Key Features

Social media scheduling for AI agents
Draft-post workflow
Human-approved queue
Targeting across 15 networks

🚀 Use Cases

Preparing social posts generated by AI for review
Coordinating publication across multiple social networks
Human-in-the-loop publishing for agent-generated content

⚡ Developer Benefits

4-tool interface for integrating the scheduling workflow into MCP clients
Supports a review gate before publishing

⚠️ Limitations

Described functionality focuses on drafting and queuing for approval for 15 networks; additional capabilities are not specified.

social media schedulingcontent draftingmulti-platform postingapproval workflowtwitter facebook instagram

Captured live from the server via tools/list.

shape_post

Turn rough notes about what the user did (shipped a feature, fixed a bug, hit a number) into 2-3 finished social-post angles in the user's voice. Grounded only in the notes - never invents facts. Uses one AI generation from the user's monthly quota.

Parameters1

notes

string

required

Raw notes about what the user did. Rough is fine.

Raw schema

{
  "type": "object",
  "properties": {
    "notes": {
      "type": "string",
      "minLength": 8,
      "maxLength": 4000,
      "description": "Raw notes about what the user did. Rough is fine."
    }
  },
  "required": [
    "notes"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_draft

Save a post as a DRAFT in the user's posthell queue. It is never published by this tool - the user approves it in the dashboard. Optionally propose a publish time (pre-fills their scheduler) and limit which platforms it targets (default: every connected account).

Parameters3

body	string	required	The post text
platforms	array	optional	Limit to these platforms (default: all connected accounts)
proposedTime	string	optional	Suggested publish time, ISO 8601. Only a suggestion - pre-fills the user's scheduler.

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "The post text"
    },
    "platforms": {
      "description": "Limit to these platforms (default: all connected accounts)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "x",
          "linkedin",
          "instagram",
          "threads",
          "bluesky",
          "facebook",
          "tiktok",
          "youtube",
          "pinterest",
          "reddit",
          "telegram",
          "discord",
          "snapchat",
          "googlebusiness",
          "whatsapp"
        ]
      }
    },
    "proposedTime": {
      "description": "Suggested publish time, ISO 8601. Only a suggestion - pre-fills the user's scheduler.",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    }
  },
  "required": [
    "body"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_posts

Read the user's recent posts and drafts with per-platform status. Published posts include engagement metrics (likes, comments, shares, engagementRate - impressions on plans with full analytics) once analytics have synced. Use it to avoid duplicating a topic AND to learn which topics performed before drafting the next post.

Parameters2

status	string	optional	Filter by status (posted and published are synonyms)
limit	integer	optional	Max results (default 15)

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Filter by status (posted and published are synonyms)",
      "type": "string",
      "enum": [
        "draft",
        "scheduled",
        "posted",
        "published",
        "failed",
        "partly_posted"
      ]
    },
    "limit": {
      "description": "Max results (default 15)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_growth

The user's follower counts and 7-day growth per connected network, plus which network is growing fastest. Use this to decide where a post matters most or to report progress.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (4)

shape_postcreate_draftlist_postsget_growth

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.posthell.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.Rohan27s/posthell (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

shape_post

create_draft

list_posts

get_growth

Install

Remote endpoint

Related servers