MCP Server + REST API + Agent Skills

Schedule posts from any AI agent

posterly works with ChatGPT, Claude, Hermes, Cursor, OpenClaw, and any tool that supports MCP or REST APIs. Tell your AI to post - posterly handles the rest across 11 platforms.

Always keep a human in the loop when using AI agents to post.

How it works

Three ways to connect your AI agent to posterly.

1

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
2

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
3

OpenClaw Skill

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

npx skills add awpthorp/posterly-agent
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.

60 hosted MCP tools your AI agent can use

Every tool exposes structured inputs and returns MCP content backed by the same posterly API routes.

get_mcp_status

Check the MCP server version, endpoint health, API auth health, and update state

whoami

Show the user, workspaces, and scopes your key can access

create_api_key

Create a scoped API key after explicit confirmation from a dashboard-created key

delete_api_key

Revoke a user-created API key after explicit confirmation

list_accounts

See all connected social media accounts

disconnect_account

Disconnect an account after explicit user confirmation

get_connect_link

Open dashboard handoff links for new account connections

create_connect_session

Create a guided browser handoff so the user can authorize a new social account

get_connect_session

Poll connection progress while the user logs in, approves OAuth, or enters credentials

list_oauth_clients

List public OAuth 2.1 + PKCE developer clients owned by the account

create_oauth_client

Create a public OAuth client after explicit confirmation

update_oauth_client

Update redirect URIs, scopes, or client metadata after confirmation

delete_oauth_client

Delete a developer OAuth client after explicit confirmation

list_platforms

Discover supported platforms, post types, media limits, helper tools, and planned providers

get_platform_schema

Inspect composer-grade settings for one supported platform

trigger_platform_helper

Run provider helpers such as Pinterest boards, YouTube playlists, TikTok creator info, LinkedIn mentions, or X quota

list_brands

See all brands/clients available in the current workspace context

get_brand

Inspect one brand/client in detail, including workspace and assigned account count

list_brand_accounts

View the connected social accounts assigned to a specific brand/client

get_brand_profile

Read the saved brand profile: tone, audience, keywords, dos and don’ts, and visual guidance

get_learned_voice

Read the voice posterly learned from one account’s real published captions

create_post

Schedule or publish a post with text and media

create_posts_batch

Create up to 25 confirmed posts in one API request

upload_media

Upload images and videos for use in posts

upload_media_from_url

Copy a public image or video URL into posterly storage with SSRF protections

create_signed_upload

Create a direct upload URL for larger media files

generate_captions

Generate or adapt brand-aware caption suggestions without creating a post

generate_image

Create AI images with Nano Banana, up to 4K resolution

get_video_options

Inspect available Veo models, durations, input modes, and credit estimates

run_video_function

Estimate and validate Veo jobs before spending credits

generate_video

Queue cost-guarded Veo video generation jobs

get_video_job

Poll one Veo job or list recent video jobs until the video URL is ready

find_available_slot

Find optimal posting times with 1-hour gap enforcement

list_posts

View scheduled, published, and draft posts

get_post

Get details and status of a specific post

get_post_missing

Inspect missing content or platform settings before a post can publish

ask_support

Ask authenticated docs-backed support questions with read-only account and post diagnostics

update_post

Edit caption, schedule time, or media on draft/scheduled posts

update_post_status

Pause, resume, schedule, or draft posts after confirmation

update_post_release_id

Repair grouped-post release metadata after confirmation

delete_post

Remove draft or scheduled posts

delete_post_group

Delete grouped draft or scheduled posts after confirmation

get_x_posting_quota

Inspect workspace X posting allowance and URL-block status

get_account_analytics

Follower and reach summaries for social platforms, plus native Google Business dashboard metrics

get_post_analytics

Per-post likes, comments, reach, impressions, saves, shares, and plays

list_google_business_reviews

List Google Business Profile reviews for a connected location

get_google_business_review_link

Generate the public review request link for a Google Business Profile

audit_google_business_profile

Run a local-profile audit for a connected Google Business location

suggest_google_business_review_reply

Draft brand-aware Google Business review replies without posting

reply_google_business_review

Post or update a public Google Business review reply after confirmation

delete_google_business_review_reply

Delete a Google Business review reply after explicit confirmation

list_google_business_media

List photos and videos on a Google Business Profile gallery

add_google_business_media

Add a public photo or video URL to a Google Business Profile gallery after confirmation

delete_google_business_media

Remove Google Business Profile gallery media after explicit confirmation

list_activity

Read the agent notifications feed of post activity, failures, retries, and publishing events

list_webhooks

Inspect webhook subscriptions and delivery status

create_webhook

Create a signed webhook subscription after explicit confirmation

update_webhook

Update webhook URL, events, or status after confirmation

delete_webhook

Delete a webhook subscription after explicit confirmation

test_webhook

Send a signed test delivery to a webhook endpoint after confirmation

11 platforms, one command

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

InstagramTikTokLinkedInYouTubeX (Twitter)FacebookThreadsPinterestGoogle Business ProfileBlueskyTelegram

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

$3/month

Add-on to any posterly plan (from $7/mo)

  • MCP server + REST API + OpenClaw skill
  • 60 hosted HTTP MCP tools for status checks, scoped API keys, brands, schemas, connect sessions, account/post lifecycle, scheduling, support, media, analytics, activity & webhooks
  • 100 create-post requests/hour plus separate media/read limits
  • All 11 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 11 supported platforms.

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

Poll connection status

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

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, or OpenClaw. Schedule posts with a single message.