# Postify MCP server

Connect ChatGPT, Claude or any MCP client to your Postify workspace. Ask it to draft posts, read your schedule and analytics, or move a post to a better time. Nothing goes live until you say so.

## Connect your assistant

Server URL (OAuth sign-in, no API key):

```
https://app.usepostify.com/api/mcp
```

- ChatGPT: https://chatgpt.com/plugins/plugin_asdk_app_6a7ae2565a148191802be85a9bf06ab2
- Claude: https://claude.ai/directory/79805368-b72a-4946-9a49-49b140bf64f2
- Claude Code: `claude mcp add --transport http Postify https://app.usepostify.com/api/mcp`
- Any client with a JSON config:

```json
{
  "mcpServers": {
    "Postify": {
      "type": "http",
      "url": "https://app.usepostify.com/api/mcp"
    }
  }
}
```

## The 161 tools it exposes

- `list_posts` (scope: posts:read): Lists recent posts with their status and per-channel delivery outcomes.
- `get_post` (scope: posts:read): Reads one post in full: its variants, schedule and delivery attempts.
- `get_schedule` (scope: posts:read): Lists the posts scheduled inside a date window.
- `list_inbox_items` (scope: inbox:read): Reads mentions, comments, replies and DMs synced from connected channels.
- `list_channels` (scope: channels:read): Lists the connected social accounts with their network and handle.
- `get_channel_options` (scope: channels:read): Shows what each connected account lets a post set, such as a TikTok audience or a YouTube privacy, so the assistant can ask you and fill it in.
- `get_connect_links` (scope: channels:write): Gives you the link to connect a social account. You approve it in your own browser, and no password goes through the chat.
- `get_analytics` (scope: analytics:read): Reads workspace numbers: posts published, posts scheduled and delivery success rate.
- `search_media_library` (scope: posts:read): Finds images and videos in the workspace media library.
- `search_docs` (available to every connection): Searches Postify's public API docs: endpoints, error codes, webhooks and scopes.
- `create_draft` (scope: posts:write): Saves a draft for you to review before anything goes out, with the per-network settings you chose. It never publishes or schedules anything.
- `schedule_post` (scope: posts:write): Schedules a post for a time you choose, with your photos or videos and the per-network settings you picked, Instagram trial reels included.
- `create_media_upload` (scope: posts:write): Gives your AI a one-time link to upload a photo or video straight into your Postify media library.
- `complete_media_upload` (scope: posts:write): Finishes an upload and says when a video is processed and ready to post.
- `import_media_from_url` (scope: posts:write): Copies a photo or video into your media library from a public link, for an AI that can't upload files itself.
- `reschedule_post` (scope: posts:write): Moves a post to a new time, and can set the network settings it still needs, such as the audience you picked for a TikTok draft.
- `suggest_optimal_time` (scope: ai:generate): Suggests the best times to post on the networks you pick.
- `publish_now` (scope: posts:publish): Publishes a post to its channels now. Every call is previewed and needs your confirmation first.
- `delete_post` (scope: posts:delete): Deletes a post and keeps its history. Every call is previewed and needs your confirmation first.
- `list_workspaces` (available to every connection): Lists the workspaces this connection may use, with your role in each.
- `draft_inbox_reply` (scope: ai:generate): Drafts a reply to a comment or message in your brand voice for you to review. It never sends anything.
- `get_brand_voice` (scope: workspace:read): Reads the workspace's brand voice, so drafts sound like you.
- `search_image` (scope: posts:read): Finds free stock photos for a post.
- `generate_week` (scope: posts:write): Plans a week of post ideas for your channels, and can save them as drafts for you to review.
- `billing_status` (scope: billing:read): Reads your plan, renewal date, trial and how much of each limit is used.
- `list_plans` (scope: billing:read): Lists Postify's plans and their limits.
- `upgrade_plan` (scope: billing:write): Switches your trial's plan, or gives you a one-time link to a prefilled checkout. You pay there.
- `manage_subscription` (scope: billing:write): Cancels or refunds after you confirm, or gives you a one-time link to your billing portal.
- `get_profile` (scope: account:read): Reads your name, email and workspaces.
- `update_profile` (scope: account:write): Changes your display name or avatar.
- `get_notification_prefs` (scope: account:read): Reads which notifications you get.
- `update_notification_prefs` (scope: account:write): Turns individual notifications on or off.
- `export_data` (scope: account:write): Exports your data as JSON, or gives you a one-time download link.
- `delete_account` (scope: account:write): Deletes your account after you confirm. Support can restore it from backups.
- `list_members` (scope: team:read): Lists the workspace's members, roles and pending invites.
- `invite_member` (scope: team:write): Emails an invitation to join the workspace.
- `change_role` (scope: team:write): Makes a member an admin, member or owner.
- `remove_member` (scope: team:write): Removes a member after you confirm.
- `revoke_invite` (scope: team:write): Cancels a pending invitation.
- `create_team` (scope: team:write): Creates a new workspace you own.
- `delete_team` (scope: team:write): Deletes a workspace you own after you confirm. Support can restore it from backups.
- `create_support_ticket` (scope: support:write): Sends a message to Postify support; replies go to your email.
- `list_support_tickets` (scope: support:read): Lists your support requests.
- `list_connections` (scope: channels:read): Lists your connected social accounts and their health.
- `disconnect` (scope: channels:write): Disconnects a social account after you confirm.
- `reverify` (scope: channels:write): Checks an account is still signed in, with a reconnect link if not.
- `list_api_keys` (scope: keys:read): Lists the workspace's API keys, never their secrets.
- `create_api_key` (scope: keys:write): Creates an API key with permissions up to the assistant's own.
- `rotate_api_key` (scope: keys:write): Issues a new secret for a key, optionally keeping the old one for a while.
- `rename_api_key` (scope: keys:write): Renames an API key; its secret and permissions stay the same.
- `revoke_api_key` (scope: keys:write): Revokes an API key after you confirm.
- `list_connected_apps` (scope: keys:read): Lists the AI assistants you connected and what each may do.
- `revoke_connected_app` (scope: keys:write): Disconnects an AI assistant after you confirm.
- `list_api_logs` (scope: keys:read): Shows recent API requests and their results.
- `list_granted_scopes` (available to every connection): Shows what the assistant is allowed to do.
- `request_scopes` (available to every connection): Gives you a one-time link to let the assistant do more.
- `list_webhooks` (scope: webhooks:read): Lists your webhook endpoints.
- `create_webhook` (scope: webhooks:write): Sends Postify events to a URL.
- `update_webhook` (scope: webhooks:write): Changes a webhook's URL or events, or pauses it.
- `delete_webhook` (scope: webhooks:write): Deletes a webhook after you confirm.
- `get_webhook_secret` (scope: webhooks:write): Shows a webhook's signing secret.
- `rotate_webhook_secret` (scope: webhooks:write): Issues a new signing secret with a 24-hour overlap.
- `test_webhook` (scope: webhooks:write): Sends a sample event to a webhook.
- `replay_failed_webhook_deliveries` (scope: webhooks:write): Sends failed deliveries again.
- `list_webhook_deliveries` (scope: webhooks:read): Shows a webhook's recent deliveries.
- `replay_webhook_delivery` (scope: webhooks:write): Sends one delivery again.
- `get_slack_alerts` (scope: webhooks:read): Shows where failure alerts go in Slack.
- `set_slack_alerts` (scope: webhooks:write): Sends failure alerts to a Slack channel.
- `test_slack_alerts` (scope: webhooks:write): Sends a test alert to Slack.
- `delete_slack_alerts` (scope: webhooks:write): Stops Slack alerts.
- `list_review_links` (scope: posts:read): Lists your client review links.
- `create_review_link` (scope: posts:publish): Makes a link a client opens to review and approve posts, after you confirm.
- `revoke_review_link` (scope: posts:write): Turns off a review link.
- `approve_post` (scope: posts:publish): Approves a post after you confirm; a post past its time publishes.
- `reject_post` (scope: posts:write): Sends a post back to its author.
- `list_post_comments` (scope: posts:read): Shows the comments on a post.
- `add_post_comment` (scope: posts:write): Adds a comment or edit request to a post.
- `update_post` (scope: posts:write): Edits a post's text, channels, media or time.
- `duplicate_post` (scope: posts:write): Copies a post into a new draft.
- `get_post_deliveries` (scope: posts:read): Shows how a post went out on each channel.
- `retry_delivery` (scope: posts:publish): Retries a failed delivery after you confirm.
- `list_failed_deliveries` (scope: posts:read): Lists deliveries that used up their retries.
- `replay_failed_delivery` (scope: posts:publish): Publishes a dead-lettered delivery again after you confirm.
- `batch_create_posts` (scope: posts:write): Creates many posts at once.
- `get_post_set` (scope: posts:read): Shows a set of posts created together.
- `schedule_post_set` (scope: posts:write): Schedules a whole set, spaced out.
- `delete_post_set` (scope: posts:delete): Deletes a set and its posts after you confirm.
- `list_queue_categories` (scope: posts:read): Lists the categories that feed your queue.
- `create_queue_category` (scope: posts:write): Creates a queue category.
- `update_queue_category` (scope: posts:write): Changes a queue category.
- `delete_queue_category` (scope: posts:write): Deletes a queue category.
- `list_queue_slots` (scope: posts:read): Lists a category's weekly slots.
- `add_queue_slot` (scope: posts:write): Adds a weekly posting slot.
- `update_queue_slot` (scope: posts:write): Moves or pauses a slot.
- `delete_queue_slot` (scope: posts:write): Removes a slot.
- `list_queue_pool` (scope: posts:read): Lists your evergreen posts.
- `set_post_evergreen` (scope: posts:write): Adds a post to the evergreen pool or takes it out.
- `preview_queue` (scope: posts:read): Shows what the queue will post next.
- `list_channel_presets` (scope: posts:read): Lists your saved channel groups.
- `create_channel_preset` (scope: posts:write): Saves a group of channels.
- `set_default_channel_preset` (scope: posts:write): Sets the composer's default channel group.
- `delete_channel_preset` (scope: posts:write): Deletes a channel group.
- `reply_to_inbox_item` (scope: inbox:reply): Replies to a comment after you confirm the exact text.
- `update_inbox_item` (scope: inbox:read): Marks an inbox item read or archives it.
- `sync_inbox` (scope: inbox:read): Fetches new comments and mentions now.
- `list_templates` (scope: posts:read): Lists your saved templates.
- `create_template` (scope: posts:write): Saves reusable post text.
- `delete_template` (scope: posts:write): Deletes a template.
- `list_hashtag_groups` (scope: posts:read): Lists your saved hashtag sets.
- `create_hashtag_group` (scope: posts:write): Saves a set of hashtags.
- `update_hashtag_group` (scope: posts:write): Changes a hashtag set.
- `delete_hashtag_group` (scope: posts:write): Deletes a hashtag set.
- `get_media` (scope: posts:read): Shows one media item.
- `set_video_poster` (scope: posts:write): Picks a video's cover frame.
- `delete_media` (scope: posts:delete): Removes a media item after you confirm.
- `bulk_import_posts` (scope: posts:write): Imports many posts at once.
- `get_workspace` (scope: workspace:read): Shows the workspace's name, logo and plan.
- `update_workspace` (scope: workspace:write): Renames the workspace or changes its logo.
- `get_timezone` (scope: workspace:read): Shows the workspace timezone.
- `set_timezone` (scope: workspace:write): Sets the workspace timezone.
- `set_brand_voice` (scope: workspace:write): Saves the brand voice AI writing follows.
- `delete_brand_voice` (scope: workspace:write): Removes the saved brand voice.
- `train_brand_voice` (scope: ai:generate): Learns a brand voice from samples, or rewrites text in it.
- `plan_content` (scope: ai:generate): Plans a theme day by day across your platforms.
- `research_hashtags` (scope: ai:generate): Finds relevant hashtags for a topic.
- `optimize_length` (scope: ai:generate): Trims or expands a post to fit a platform.
- `recycle_post` (scope: ai:generate): Rewrites an old post with a fresh angle.
- `suggest_channels` (scope: ai:generate): Suggests which connected channels suit a post.
- `transcribe_media` (scope: ai:generate): Transcribes a video or audio file from your library.
- `get_transcript` (scope: ai:generate): Shows a transcription's status and text.
- `edit_transcript` (scope: ai:generate): Corrects a transcript's text.
- `get_transcription_usage` (scope: ai:generate): Shows transcription minutes used and left.
- `caption_from_transcript` (scope: ai:generate): Writes a caption from a transcript.
- `fields_from_transcript` (scope: ai:generate): Writes a video post's title, caption and description from its transcript.
- `post_from_url` (scope: ai:generate): Writes a post from a web page.
- `generate_variants` (scope: ai:generate): Writes alternative versions of a post.
- `writing_prompts` (scope: ai:generate): Suggests fresh post ideas for your niche.
- `export_analytics_csv` (scope: analytics:read): Exports per-post results as CSV.
- `list_sessions` (scope: account:read): Lists the devices signed in to your account.
- `revoke_sessions` (scope: account:write): Signs out a device or every browser, after you confirm.
- `get_referral_summary` (scope: account:read): Shows your referral link and rewards.
- `seed_demo_content` (scope: posts:write): Adds three sample draft posts to explore.
- `get_bioflow_connection` (scope: workspace:read): Shows whether BioFlow is linked.
- `connect_bioflow` (scope: workspace:write): Links your BioFlow account with its API key.
- `disconnect_bioflow` (scope: workspace:write): Unlinks BioFlow.
- `list_bioflow_pages` (scope: workspace:read): Lists your BioFlow pages.
- `choose_bioflow_page` (scope: workspace:write): Creates or picks the BioFlow page for your posts.
- `sync_bioflow` (scope: workspace:write): Puts your latest posts on the BioFlow page.
- `render_hook_variants` (scope: posts:write): Renders a video once per opening hook.
- `create_hook_test` (scope: posts:write): Schedules one trial reel per hook to compare them.
- `list_hook_tests` (scope: posts:read): Lists your hook tests and how their reels did.
- `get_hook_test` (scope: posts:read): Compares a hook test's versions side by side.
- `share_hook_test` (scope: posts:write): Saves the winning hook as a reel draft for your grid.
- `get_slack_install_link` (scope: webhooks:write): Gives you a link that adds the Postify app to Slack.
- `disconnect_slack_app` (scope: webhooks:write): Uninstalls the Postify Slack app, after you confirm.
- `get_analytics_insights` (scope: analytics:read): Shows follower growth and your best posts.
- `list_activity_log` (scope: posts:read): Lists what happened in your workspace and when.
- `get_api_usage_by_key` (scope: keys:read): Shows this period's API requests by key.
- `update_channel_settings` (scope: channels:write): Changes a channel's defaults, like its Pinterest board.
- `list_tiktok_drafts_needing_audience` (scope: posts:read): Lists TikTok drafts that still need an audience.
- `set_tiktok_audience_on_drafts` (scope: posts:write): Sets the audience you choose on TikTok drafts.

## You stay in control

### You choose the scopes

The consent screen lists every permission, and tools outside the scopes you approve are not even shown to the assistant.

### Publishing and deleting are confirmed

publish_now and delete_post need the 'Delete, publish or send' permission, which you can untick on the consent screen. Every call is previewed and needs a confirmation that expires after 10 minutes.

### Your workspaces, your choice

If you belong to several workspaces, the assistant may use all of them unless you pick only some. Access to a workspace ends when you leave it.

### Every call is on the record

Each tool call, allowed or denied, is written to the workspace audit trail, and each connected app is listed in settings next to its disconnect button.

## Questions

### What is the Postify MCP server URL?

The Postify MCP server URL is https://app.usepostify.com/api/mcp. In ChatGPT, open Postify's published ChatGPT app (https://chatgpt.com/plugins/plugin_asdk_app_6a7ae2565a148191802be85a9bf06ab2); in Claude, open Postify's listing in Claude's connector directory (https://claude.ai/directory/79805368-b72a-4946-9a49-49b140bf64f2). In any other client, or manually, add a custom connector (or remote MCP server) in your client's settings and paste that URL, then sign in to Postify when it asks. Sign-in happens on Postify's own OAuth consent screen, so there is no API key to create or copy.

### Can ChatGPT or Claude post to social media with Postify?

They can upload your photos and videos, draft and schedule posts, read your schedule, analytics and inbox, and move a scheduled post to a new time. Publishing right away needs the 'Delete, publish or send' permission, which you can untick when you connect, and every publish is previewed and confirmed first.

### Can the assistant schedule a new post?

Yes. schedule_post schedules a post for a future time on the channels you pick, with photos or videos the assistant uploaded with create_media_upload or copied from a link with import_media_from_url, and Instagram trial reels included. It never publishes right away, so it works without the 'Delete, publish or send' permission. To review first, ask for a draft: create_draft never schedules or publishes.

### Do I need an API key to connect?

No. Your AI client registers itself and opens Postify's sign-in and consent screen in your browser (OAuth 2.1 with PKCE). You approve which scopes and which workspaces it may use.

### Which AI assistants work with the Postify MCP server?

Any MCP client that supports remote servers over Streamable HTTP with OAuth sign-in, including ChatGPT, Claude, Claude Code and Cursor. Add a custom connector or remote server with the server URL on this page.

### Which Postify plans include the MCP server?

Every plan, Free included. Your plan's normal monthly limits still apply to what the assistant does.

### How do I disconnect an assistant?

Ask the assistant to call revoke_connected_app, or disconnect it yourself from Connected AI apps on the API keys page of your Postify settings. Consent and refresh tokens are revoked immediately, and Postify refuses any access token the client still holds on its next request.

MCP guide: https://usepostify.com/docs/connecting-ai-assistants · REST API, SDK and webhooks: https://usepostify.com/developers.md · Plans: https://usepostify.com/pricing.md
