PostFast MCP: an AI assistant drafts your YouTube and TikTok posts

Connect Claude, ChatGPT, Cursor or Gemini to your PostFast account. The assistant finds your channels, reads each channel's settings, uploads media and creates draft posts. It cannot publish: you open the draft in PostFast and press Post now or Add to calendar.

Endpoint: https://postfast.sh/api/mcp · Registry: sh.postfast/postfast

Connect

claude mcp add --transport http postfast https://postfast.sh/api/mcp

https://postfast.sh/api/mcp

https://postfast.sh/api/mcp

gemini extensions install https://github.com/airdropfi/postfast-gemini-extension

https://postfast.sh/api/mcp

Agent quickstart

Discover

• Server card: https://postfast.sh/.well-known/mcp/server-card.json
• Registry entry: sh.postfast/postfast in the Official MCP Registry
• Markdown for this page: https://postfast.sh/mcp.md; site summary: https://postfast.sh/llms.txt and https://postfast.sh/llms-full.txt
• Problem-to-solution guides: https://postfast.sh/solutions (each has a markdown twin at /solutions/<slug>.md)

Authenticate

• Endpoint: https://postfast.sh/api/mcp (Streamable HTTP, stateless JSON).
• OAuth 2.1: an unauthenticated request gets 401 with a WWW-Authenticate header pointing at the protected-resource metadata; clients register themselves (dynamic client registration, RFC 7591) and use authorization code with PKCE S256. The person signs in to PostFast and approves.
• API key: send Authorization: Bearer <key>. The person creates the key in PostFast, Settings, Public API. Keys act as the whole workspace, so prefer OAuth.

Minimal call sequence

1. integrationList {}: channel ids and platforms
2. integrationSchema {"platform":"youtube","isPremium":false}: rules, max length and the settings fields to fill
3. uploadFromUrlTool {"url":"https://…/clip.mp4"}: hosted media id and path to attach
4. createDraftPostTool {"socialPost":[{"integrationId":"…","date":"…","postsAndComments":[…],"settings":[…]}]}: the draft post ids
5. postsListTool {"startDate":"…","endDate":"…"}: drafts and their state, so the person can find them

Limits

• Drafts only: no tool publishes, schedules or deletes a post.
• Channels live today: YouTube, TikTok, Bluesky, WordPress, DEV and Hashnode. X, LinkedIn, Instagram, Facebook, Threads, Reddit, Pinterest and Telegram are not offered.
• Media must be an image or video from an allowed upload domain; use uploadFromUrlTool for external files.
• TikTok privacy, comment, duet, stitch and commercial-content settings can be filled in by the assistant in the draft; the person reviews and can change them in the PostFast composer before publishing.

Hand-off

After creating a draft, tell the person it is waiting in PostFast and that they must open it and press Post now or Add to calendar. Never say it was published.

Human oversight

• Approve every publication. The assistant only creates drafts. Nothing new goes live until the person opens the draft in PostFast and presses Post now or Add to calendar. One exception: postSettingsTool can change the provider settings (for example privacy) of a post the person has already scheduled, and it then publishes with the changed settings; content and date cannot be changed.
• Review what the assistant did. Drafts appear on the PostFast calendar with their content, media, channel and settings; the person can edit or delete them there.
• Withdraw access. The person can revoke the OAuth connection or rotate the API key in PostFast; the assistant loses access at once.
• Keep deletion with people. The assistant cannot delete posts; deleting is done in the PostFast calendar.

Not available today: a per-action approval queue for the assistant, a log of every tool call, and scoped read-only keys.

Tools (8)

• integrationList (read-only): Lists the connected channels (YouTube, TikTok, Bluesky, WordPress, DEV, Hashnode) with id, name and platform; can be limited to one customer group.
• groupList (read-only): Lists the customer groups of the workspace.
• integrationSchema (read-only): Returns the rules, maximum length and settings fields of a channel type, for example the YouTube title and privacy or the TikTok privacy, comment, duet, stitch and disclosure options.
• triggerTool: Runs a provider helper that returns ids, tags or search results needed by some settings (for example WordPress categories or Hashnode publications).
• createDraftPostTool: Creates a draft post on one or more channels. A draft is only saved: it is not published or scheduled until a person opens it in PostFast and publishes it.
• postsListTool (read-only): Lists posts between two UTC dates with state (draft, scheduled, published, errored), content, channel and settings.
• postSettingsTool: Changes the provider settings of a draft or scheduled post that has not been published; content and date stay as they are.
• uploadFromUrlTool: Copies a public image or video URL into the PostFast media library so it can be attached to a post.

PostFast is licensed AGPL-3.0; source on request from support@postfast.sh. Markdown version of this page: /mcp.md.