posterly
MCP Server + REST API + Agent Skills

Schedule posts from any AI agent

posterly works with ChatGPT, Claude, Hermes, Grok Bot, Cursor, OpenClaw, Muse, and any tool that supports MCP or REST APIs. Manus and Cue setup pages cover Custom MCP by URL. A verified live connect is still being validated. Tell your AI to post - posterly handles the rest across 18 platforms.

Agent signup flowView MCP setup

Always keep a human in the loop when using AI agents to post. See how Webserv does it across 100 Google Business Profiles.

Find posterly in your agent ecosystem

These public listings are available now. Choose your client, connect your own posterly account, and keep drafts, scheduling, and analytics in the tools you already use.

Editor plugin

Cursor community directory

Open the listing to add the MCP server to Cursor and find the posterly skills and setup command.

Open Cursor listing

OpenClaw skill

ClawHub

Install the posterly skill for OpenClaw, then connect your API key to draft and schedule social posts.

Get the OpenClaw skill

Hosted MCP connection

Smithery

Connect the hosted posterly MCP server through Smithery with your own posterly OAuth sign-in.

Connect on Smithery

Hosted MCP listing

Glama

Browse the tool catalog, inspect the server, and find client install options on our listing with verified ownership.

Explore on Glama

Developers can also find posterly in the official MCP Registry and install the Claude Code plugin or Gemini CLI extension from our public repository.

The Cursor listing is a community directory listing. Official directory submissions for ChatGPT and Claude are under review. The Muse directory application is submitted, with requirements still outstanding. Our client setup guides explain the custom connections available today. API and MCP access requires a paid posterly plan with API access.

What it looks like in chat

Draft, validate, then approve. Your AI never publishes until you say so.

your AI · connected to posterly MCP

Never posts without approval · validate_post before create_post

View in posterly

Works with Claude, ChatGPT, Gemini, Cursor, OpenClaw, Hermes, Grok Bot, Muse, Poke, Manus, Cue, and any MCP client.

How it works

Connect your AI agent to posterly with MCP, Claude plugin, CLI, or REST.

1

Claude Code plugin

Install the posterly-maintained Claude Code plugin from our public marketplace: skill, guided setup, and bundled MCP in one package.

/plugin marketplace add awpthorp/posterly-agent
Claude plugin docs →
2

MCP Server

Run the posterly MCP server with npx or use the HTTP endpoint from Claude Desktop, Cursor, Windsurf, or Cline.

npx -y posterly-mcp-server@latest
MCP setup guide →
3

REST API

Use the posterly API with any agent that can make HTTP requests: ChatGPT, custom GPTs, or your own scripts.

POST /api/v1/posts
API reference →
4

CLI

Use @posterly/cli from a terminal or CI job when a human or script needs the same API surface without an AI client.

npx -y @posterly/cli@latest doctor --pretty
CLI page →
5

OpenClaw Skill

Install the posterly skill for OpenClaw. Schedule posts from WhatsApp, Telegram, Slack, or Discord.

npx clawhub@0.23.3 install posterly
OpenClaw setup →

Built for agents that need to onboard a user

Agents can start paid signup, hand the user to checkout, then guide them through account authorization with live connection status.

POST /api/v1/signup

Paid API signup

Start a required-payment signup from the public API. Posterly returns checkout_redirect_url and poll_url so the chat can keep the user informed.

GET /api/v1/signup/sessions/{id}

Signup status polling

Report payment, password setup, and authorization progress while the user completes safe browser steps.

POST /api/v1/connect/{platform}/sessions

Browser OAuth handoff

Create a connection session for Instagram, Meta, YouTube, LinkedIn, X, Telegram, Bluesky, and the rest of the supported targets.

GET /api/v1/connect/sessions/{id}

Progress the agent can report

Poll the session while the user opens posterly, approves provider OAuth, enters credentials, or hits an error.

Works with your favourite AI tools

Any tool that supports MCP or HTTP requests can control posterly.

Claude Desktop

MCP Server

Connect via MCP server. Say "schedule a post to Instagram for tomorrow at 9am" and Claude handles it.

Claude walkthrough

ChatGPT

MCP + API

Connect via custom MCP in ChatGPT web (writes need Business, Enterprise, or Edu) or Codex stdio.

ChatGPT walkthrough

Gemini

CLI extension + web preview

Install the Gemini CLI extension with MCP and guided setup. The Gemini web Spark connection is still being validated.

Gemini setup guide

Cursor

Plugin + MCP

Find posterly in the Cursor community directory, with an MCP install link, skills, and a setup command. Schedule posts without leaving your IDE.

Cursor walkthrough

OpenClaw

OpenClaw Skill

Get the posterly skill from ClawHub and manage social media from WhatsApp, Telegram, Slack, or any chat app.

OpenClaw walkthrough

Hermes

MCP + API

Connect Hermes to posterly with MCP or REST API access so your agent can schedule social posts.

Hermes walkthrough

Grok Bot

Hosted MCP + API

Connect xAI's Grok Bot to posterly over hosted HTTP MCP or the REST API so your cloud agent can schedule social posts.

Grok Bot Marketplace walkthrough

Muse

Custom Connector

Add posterly as a Muse Custom Connector. Start with OpenAPI and a Bearer key. Hosted MCP is optional. The directory application is submitted with requirements still outstanding. Use custom setup while it is pending.

Poke

MCP Server

Add posterly as a custom MCP integration in Poke, then text Poke to schedule posts across 18 platforms.

Poke walkthrough

Manus

Custom MCP by URL

Add posterly as a Custom MCP Server by URL in Settings, Integrations. OAuth is preferred, with a Bearer pst_live_ key as fallback. A verified live connect is still being validated. Not a directory listing.

Cue

Custom MCP by URL

Ask your Cue agent to add posterly as a custom MCP by URL. Same connector infra as Manus. A verified live connect is still being validated. Not a directory listing.

Windsurf

MCP Server

Configure the posterly MCP server in Windsurf to schedule posts alongside your development workflow.

Cline

MCP Server

Add posterly to your Cline MCP configuration for AI-powered social media management in VS Code.

61 MCP tools covering 97 actions

The hosted HTTP endpoint at /api/mcp exposes 61 tools covering 97 actions, grouped into sets. Tools that read take a view and tools that change things take an action, listed under each tool. Public replies and deletes show a preview first and only run after you approve.

Core

29 tools

Accounts, posting, media, schedule, analytics, and support. What most assistants need.

  • whoamiWho am I
    • You, your scopes, and your workspaces
    • MCP server and connection status
  • list_accountsConnected accounts
    • Connected accounts
    • Learned voice of an account
    • Performance profile of an account
    • Check a connect session
  • disconnect_accountDisconnect an account
  • connect_accountConnect with credentials
  • create_connect_sessionStart a connect session
  • list_platformsPlatforms
    • Supported platforms
    • Platform or account schema
    • Connection links
  • trigger_platform_helperRun a platform helper
  • list_brandsBrands
    • All brands
    • One brand
    • Brand accounts
    • Brand profile
  • list_postsPosts
    • Posts, one page at a time
    • Post counts by day, status, account, and brand
  • get_postOne post
    • One post
    • What a post is missing
  • ask_supportAsk support
  • find_available_slotFind a free slot
  • submit_agent_feedbackAgent feedback
  • submit_product_feedbackProduct feedback
  • validate_postValidate a post
  • create_postCreate a post
  • create_posts_batchCreate posts in bulk
  • update_postEdit a post
    • Edit caption, media, schedule, or settings
    • Pause, resume, schedule, or move to draft
    • Set a release or group ID
    • Request, approve, request changes, or reject client review
  • delete_postDelete posts
    • Delete one post
    • Delete a post group
  • get_x_posting_quotaX posting quota
  • upload_mediaUpload media
    • Upload a file
    • Upload from a URL
  • create_signed_uploadSigned upload link
  • create_media_dropMedia drop link
  • list_mediaMedia library
  • generate_captionsGenerate captions
  • list_analyticsAnalytics
    • Account analytics
    • Post analytics
    • Post insights
  • list_activityActivity feed
  • get_creditsAI credits
  • get_updatesProduct updates

Creative

7 tools

AI image and video generation, jobs, and post suggestions.

  • list_post_suggestionsPost suggestions
  • dismiss_suggestionDismiss a suggestion
  • get_video_optionsVideo options
  • run_video_functionVideo helper
  • generate_videoGenerate a video
  • list_jobsAI jobs
    • Image jobs
    • Video jobs
  • generate_imageGenerate an image

Inbox

4 tools

Social inbox comments and DMs.

  • list_conversationsConversations
    • List conversations
    • One conversation with its messages
  • manage_conversationManage conversations
    • Send a DM
    • Sync the inbox
  • list_commentsComments
    • List comments
    • One comment with its replies
  • manage_commentManage comments
    • Reply to a comment
    • Hide or mark read
    • Delete a comment

Google Business

5 tools

Google Business Profile reviews, media, and audits.

  • list_google_business_reviewsGoogle reviews
    • Google reviews
    • Google review link
  • audit_google_business_profileAudit a Google profile
  • manage_google_business_reviewManage Google reviews
    • Suggest a reply (never posts)
    • Reply to a review
    • Delete a review reply
  • list_google_business_mediaGoogle profile media
  • manage_google_business_mediaManage Google profile media
    • Add a photo or video
    • Delete a photo or video

Admin

11 tools

API keys, OAuth clients, webhooks, workspace members, and the publishing pause.

  • create_api_keyCreate an API key
  • delete_api_keyRevoke an API key
  • list_workspace_membersWorkspace members
  • manage_workspace_memberManage a workspace member
    • Invite a colleague
    • Change role or brands
    • Remove a member or invite
  • list_publishing_pausesPublishing pause
  • manage_publishing_pausePause or resume publishing
    • Pause publishing
    • Resume publishing
    • Publish missed posts now
  • list_oauth_clientsOAuth clients
  • manage_oauth_clientManage an OAuth client
    • Create an OAuth client
    • Update an OAuth client
    • Delete an OAuth client
  • list_webhooksWebhooks
  • create_webhookCreate a webhook
  • manage_webhookManage a webhook
    • Update a webhook
    • Delete a webhook
    • Send a test delivery

Billing

5 tools

Subscription changes.

  • get_subscriptionSubscription
  • cancel_subscriptionCancel subscription
  • pause_subscriptionPause subscription
  • resume_subscriptionResume subscription
  • downgrade_subscriptionDowngrade subscription

Tool schemas are published in the MCP server card and returned by tools/list. Renamed tools: what moved where.

18 platforms, one command

Your AI agent can post to any of these from a single instruction.

InstagramFacebookTikTokXLinkedInYouTubePinterestThreadsGoogle BusinessTelegramBlueskyDiscordSlackMastodonDev.toHashnodeWordPressLemmy

Natural language, real results

Just tell your AI what to post. It figures out the rest.

“Post 'Just launched our new AI features! Check them out at poster.ly' to my LinkedIn and Twitter tomorrow at 9am”

Done! I've scheduled your post to LinkedIn and X (Twitter) for tomorrow at 9:00 AM. Post IDs: #1247, #1248.

“When's the next good time to post on my Instagram?”

Your next available slots are: Today 3:00 PM, Today 6:00 PM, Tomorrow 9:00 AM, Tomorrow 12:00 PM, Tomorrow 3:00 PM.

Pricing

API & agent access is an add-on to any posterly plan.

API, MCP & Agent Access

From $3/month

Starter/Pro $3, Power $5, Agency $29 per month, plus your base plan

  • MCP server + REST API + OpenClaw skill
  • 61 hosted HTTP MCP tools covering 97 actions for status checks, scoped API keys, subscription management, brands, schemas, connect sessions, account/post lifecycle, scheduling, support, media, analytics, activity & webhooks
  • 100 create-post requests/hour plus separate media/read limits
  • All 18 supported platforms
  • Media upload (images & video)
Agent signup flow
For AI agents

Agent signup quickstart

Public signup endpoints onboard a user to paid API and MCP access. After paid setup, authenticated agents can optionally create scoped keys with explicit confirmation. Posterly handles checkout, password setup, and provider OAuth in the user's browser.

POST /api/v1/signup

Start paid signup

Returns checkout_redirect_url and poll_url. No API key is issued before billing is active.

GET /api/v1/signup/sessions/{id}

Poll signup progress

Statuses: checkout_pending, payment_confirmed, password_required, api_access_active.

POST /api/v1/api-keys

Optional scoped key

After paid setup, a dashboard-key-authenticated agent can create a scoped follow-up key with confirm=true.

DELETE /api/v1/api-keys/{id}

Revoke scoped key

A dashboard-key-authenticated agent can revoke a user-created key with confirm=true.

POST /api/v1/connect/{platform}/sessions

Create connect session

Short-lived browser OAuth handoff for any of the 18 supported platforms.

GET /api/v1/connect/sessions/{id}

Poll connection status

Statuses: opened, awaiting_provider, connected, failed, cancelled, expired.

Full agent signup flowAPI reference

Always keep a human in the loop. Agents never collect cards or provider passwords.

Let your AI handle social media

Connect posterly to ChatGPT, Claude, Cursor, Grok Bot, OpenClaw, or Muse. Schedule posts with a single message.

Agent signup flowMCP setup guide