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.

52 tools your AI agent can use

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

whoami

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

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_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

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

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

run_video_function

Estimate and validate Veo jobs before spending credits

generate_video

Queue cost-guarded Veo video generation jobs

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

update_post

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

update_post_status

Pause, resume, schedule, or draft posts after confirmation

delete_post

Remove draft or scheduled posts

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

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
  • 52 authenticated tools for brands, schemas, connect sessions, account/post lifecycle, scheduling, batch creation, AI captions/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

Four public endpoints to onboard a user to paid API and MCP access. Poll for progress. 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/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.