PostStage MCP server

Connect Claude, Claude Code or any Model Context Protocol client to PostStage. It reads your accounts, posts, stats and media library, and writes drafts. Nothing goes out until a person schedules it in PostStage.

Endpoint

https://trypoststage.com/api/mcp
  • Streamable HTTP, stateless: each tool call is one request.
  • Any PostStage account, on every plan.
  • There is no separate sandbox: try it on PostStage's Free plan. Drafts never publish on their own.

In Claude Code

claude mcp add --transport http poststage https://trypoststage.com/api/mcp

Then run /mcp to sign in. For Claude on the web, desktop or phone, see Connect PostStage to Claude.

Sign-in

OAuth 2.1, so there is no API key to request: the client sends you to PostStage, you sign in and approve, and it gets a token. A request without one gets 401 with a WWW-Authenticate header pointing at the metadata below, which is how clients start sign-in.

  • Authorization code with PKCE (S256). Clients identify themselves with a Client ID Metadata Document.
  • Scopes: read, drafts:write and offline_access.
  • Protected resource: https://trypoststage.com/.well-known/oauth-protected-resource/api/mcp
  • Authorization server: https://trypoststage.com/.well-known/oauth-authorization-server
  • Disconnect any time in PostStage under Settings → Connected apps.

Tools

Read

list_workspaces · List workspaces
The workspaces you belong to, your role in each, and which is the default.
list_accounts · List social accounts
Connected accounts in a workspace: platform, handle, timezone, caption limit and how many images a post can take.
list_posts · List posts
Drafts, scheduled, pending, published, failed and paused posts, newest first, filtered by status, dates, account or caption text.
get_post · Get a post
One post in full by its ID or PS- reference: caption, hashtags, first comment, media, times, stats and any failure reason.
get_performance · Get post performance
How published posts did over a date range: totals per account, the 10 best posts and the best times to post.
get_brand_profile · Get brand profile
What the workspace sells, its audience, its tone and its brand hashtags, for writing in its voice.
list_media · List media library
Photos and videos in your PostStage media library, newest first.

Write (drafts and media only)

import_media · Import media from a link
Download a JPEG or PNG photo (up to 10 MB) or an MP4 or MOV video (up to 100 MB) from a public https link into the media library.
create_draft · Create drafts
One draft per chosen account (1 to 10), with caption, hashtags, first comment, bio-page link, media and a suggested time. Nothing is scheduled or published.
update_draft · Change a draft
Change a draft's caption, hashtags, first comment, bio-page link, media or suggested time.
delete_draft · Delete a draft
Delete a draft; its media stays in the library. Scheduled, pending and published posts can't be changed or deleted.

What it can't do

  • Schedule, publish or approve posts: drafts open in PostStage, where a person schedules them
  • Change or delete scheduled, pending or published posts
  • Connect, remove or change social accounts
  • See billing, passwords or the social accounts' access
  • Read Inbox messages or comments

Limits

  • 200 drafts and 30 photo or video imports a day.
  • 60 requests a minute per person; more gets 429 with a Retry-After header.
  • The workspace's plan and the person's role apply, as they do in PostStage.

More

Connect PostStage to Claude

Step by step, with things to ask and how photos work.

Everything PostStage does

Scheduling, the Inbox, links and more.