# posthell - full reference > posthell is the social media scheduler built for AI agents: an MCP-native tool for agentic post scheduling. AI agents (Claude Code, Cursor, VS Code, Gemini CLI, and any MCP client) connect to posthell's remote MCP server and turn what a founder shipped into posts - shaped in the founder's voice, queued for human approval, then published to 15 social networks. It is also a full post scheduler for humans: write once, tailor per network, schedule everywhere. ## What posthell is - Supported networks (15): X (Twitter), Instagram, Facebook, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest, Reddit, Telegram, Discord, Snapchat, Google Business Profile, WhatsApp. - Pricing: Solo $12/mo (3 connected accounts, 200 X posts/mo) and Pro $29/mo (6 accounts, 600 X posts/mo). Yearly: $10/mo and $24/mo. Both plans start with a 7-day free trial (card required, monthly plans). - Only X is metered, because X's API charges per post; posthell passes that cost through at the exact rate with no markup (a post with a link costs 13x a plain post, mirroring X's own pricing). Every other network is unlimited. - AI drafting: rough notes are shaped into 2-3 post angles in the founder's own voice, then adapted per network. Solo includes 40 AI drafts/mo, Pro 150, trial 10. Writing by hand is always free and unlimited. - Scheduling is reliability-first: posts publish on time with automatic retries; failed X posts refund their credits automatically. ## The MCP server (agentic posting) - Endpoint: https://www.posthell.com/api/mcp (remote MCP, streamable HTTP). Auth: per-user API key as a Bearer token, created in the dashboard's Agents tab. - Tools: - 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. - publish_post: Publishes for real, now or scheduled, to ALL the user's connected networks including X - only when the user enables publishing for that key (off by default). X posts spend the user's X credits, and the credit wallet hard-caps that spend. - list_posts: Reads the queue and recent posts, with engagement metrics on published ones, so an agent never drafts the same thing twice and learns which topics perform. - get_growth: Follower growth per network, so an agent knows where posting matters most. - Safety model: agents draft and read by default; a human approves every post from the posthell queue. Autonomous publishing is a per-key opt-in ('posts without asking'); the credit wallet hard-caps X spend, so an agent can never run an open-ended bill. - Rate limits per user: shape_post 6/min, create_draft 12/min (max 30 drafts/day), reads 30/min. - CLI: posthell-cli on npm (npx posthell-cli) wraps the same MCP tools with the same auth and rules - for agents and scripts without an MCP client. ## How to connect an AI agent Create an API key in the posthell dashboard (Agents tab), then add posthell to your client (key shown as YOUR_API_KEY): ### Claude Code One command in your terminal. Works immediately in every project. ``` 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). ``` { "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: ``` { "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: ``` 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: ``` { "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: ``` { "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: ``` https://www.posthell.com/api/mcp ``` ``` Authorization: Bearer YOUR_API_KEY ``` Tools are self-describing: connect and call tools/list. ## What an agent can automate, per network - X (Twitter): Let your AI agent post X threads and updates on its own through posthell. X is metered at the exact passthrough rate, and your credit wallet caps the spend, so an agent can never run up an open-ended bill. (https://www.posthell.com/automate/x) - LinkedIn: Let your AI agent publish LinkedIn text posts on its own. Give it your build-in-public notes on a cron heartbeat and it ships a professional update to your feed. Unlimited, no credits. (https://www.posthell.com/automate/linkedin) - Instagram: Let your AI agent publish Instagram text captions and updates on its own through posthell. Autonomous, unlimited, never metered. The agent posts text, not Reels or images. (https://www.posthell.com/automate/instagram) - Threads: Let your AI agent publish Threads posts on its own through posthell. It writes in the calmer Threads voice and ships autonomously. Unlimited, never metered, text posts only. (https://www.posthell.com/automate/threads) - Bluesky: Let your AI agent publish Bluesky posts on its own through posthell. Stay early on a growing network with an agent posting text updates autonomously. Unlimited, never metered. (https://www.posthell.com/automate/bluesky) - Facebook: Let your AI agent keep your Facebook page active with autonomous text updates through posthell. No more stale page. Unlimited, never metered, text posts only. (https://www.posthell.com/automate/facebook) - TikTok: Let your AI agent publish TikTok text posts on its own through posthell. Unlimited and never metered. Be honest: the agent posts text, not videos or slideshows. (https://www.posthell.com/automate/tiktok) - YouTube: Let your AI agent publish YouTube community text posts on its own through posthell. Unlimited and never metered. The agent posts text updates, not videos. (https://www.posthell.com/automate/youtube) - Pinterest: Let your AI agent publish Pinterest text updates on its own through posthell. Unlimited and never metered. The agent posts text, not image pins. (https://www.posthell.com/automate/pinterest) - Reddit: Let your AI agent draft or publish Reddit text posts through posthell. Handle each subreddit's own rules and voice. Unlimited, never metered. Post carefully, Reddit is unforgiving. (https://www.posthell.com/automate/reddit) - Telegram: Let your AI agent broadcast to your Telegram channel on its own through posthell. Keep an opt-in audience fed on a rhythm. Unlimited, never metered, text broadcasts. (https://www.posthell.com/automate/telegram) - Discord: Let your AI agent post announcements to your Discord server on its own through posthell. Keep your community in the loop automatically. Unlimited, never metered, text posts. (https://www.posthell.com/automate/discord) - Snapchat: Let your AI agent publish Snapchat text posts on its own through posthell. Unlimited and never metered. The agent posts text, not Snaps or video. (https://www.posthell.com/automate/snapchat) - Google Business Profile: Let your AI agent keep your Google Business Profile fresh with autonomous text posts through posthell. An active profile helps local search. Unlimited, never metered. (https://www.posthell.com/automate/google-business) - WhatsApp: Let your AI agent broadcast to your WhatsApp channel on its own through posthell. Reach an opt-in audience on the app they check most. Unlimited, never metered, text broadcasts. (https://www.posthell.com/automate/whatsapp) ## Questions and answers Q: What is an MCP server? A: 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. Q: Is there an MCP server for social media posting? A: Yes. posthell is a remote MCP server for social media: agents shape notes into posts, queue drafts, and (if you opt a key in) publish to 15 networks including X, LinkedIn, Instagram, TikTok, Threads and Bluesky. Setup is one command per client. Q: Can Claude post to X or LinkedIn for me? A: Yes. Connect Claude Code (or Claude Desktop) to posthell's MCP server, tell it what you shipped, and it drafts the post into your queue; you approve and posthell publishes to X, LinkedIn and any other network you connected. Flip a key to autonomous publishing and Claude can post without asking, with X spend capped by your credit wallet. Q: Can my agent publish posts on its own? A: By default, no: agents draft and every draft waits in your queue until you approve it. If you want autopilot, autonomous publishing is a per-key opt-in you flip in the dashboard; the agent then publishes to all your connected networks, X included, and your credit wallet hard-caps what it can spend. Q: How do I get an API key? A: 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. Q: Is agent access included in every plan? A: 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. Q: What are the rate limits? A: 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. Q: Does it work with ChatGPT or custom agents? A: 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. Q: Which platforms can I post to? A: X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest, Reddit, Telegram, Discord, Snapchat, WhatsApp and Google Business. Connect the ones you want, up to your plan's account limit. Q: Can my AI agent post for me? A: Yes - posthell is built agent-first. Connect Claude Code, Cursor, VS Code, Gemini CLI or any MCP client with one command, and your agent shapes notes into posts and queues drafts while you work. By default agents only draft: nothing is published without your approval. If you want full autopilot, autonomous publishing is a per-key opt-in you can flip any time, and X spend always stays capped by your credit wallet. Q: What is posthell's MCP server? A: posthell is a remote MCP (Model Context Protocol) server. Connect any MCP client with one command and a personal API key, and your agent gets tools to shape rough notes into posts, queue drafts with a proposed time, list your posts and read your follower growth. Setup snippets for 7 clients and full tool docs live at posthell.com/mcp. Q: Is there a CLI for agents and scripts? A: Yes. posthell-cli on npm is a thin wrapper over the same MCP tools, so any agent or script can draft, publish and read growth from a terminal with npx posthell-cli. It inherits the same auth, approval rules and rate limits as the MCP server. Q: Will the AI posts sound like AI? A: That is the thing we obsess over. The AI only works from what you wrote: your facts, your numbers, your phrasing, even your lowercase if that is how you type. It never invents details, never adds hashtag spam or influencer cliches, and you edit every word before anything goes out. Q: How many AI drafts do I get? A: Solo includes 40 AI generations a month and Pro includes 150. Shaping a note into a post and tailoring a post per network each count as one. The 7 day trial includes 10. Writing by hand is always free and unlimited. Q: Why are only X posts metered? A: Posting to X costs us per request, and an X post with a link costs about 13 times a plain one. So we meter X with credits to keep your price honest. Every other network is free to serve, so it is unlimited. Q: How many posts do I get? A: Solo includes 200 X posts a month, Pro includes 600 (a post with a link counts as 13). Every other platform is unlimited on both plans. Q: Is there a free trial? A: Yes. Every plan on monthly billing starts with a 7 day free trial. You add a card up front, use the plan you picked, and cancel in two clicks if it is not for you. During the trial, X posting is capped at 56 plain posts; every other network is unlimited. Q: What happens when the trial ends? A: After day 7 your plan starts at the price you picked, and your full X allowance unlocks (200 posts on Solo, 600 on Pro). We email you the day before it converts, so there are no surprise charges. Q: Do you store my social passwords? A: No. You connect each account through its official login, and the access lives with our publishing partner, not in our database. Disconnect any time and it is wiped. Q: What happens if a post fails to publish? A: We retry with backoff. If it still cannot go out, the post is marked failed and any X credits it used are refunded automatically. More: https://www.posthell.com/llms.txt (index of every public page) · https://www.posthell.com/mcp (MCP docs) · https://www.posthell.com/automate (agent automation by network)