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/mcpThen 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:writeandoffline_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
429with aRetry-Afterheader. - 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.