MCP Setup Guide
Connect PostPlanify to your AI assistant in under a minute.
Prerequisites
- 1.An active PostPlanify subscription: see plans
- 2.Only for clients without OAuth sign-in (see Other MCP Clients): an API key from your API Keys dashboard. ChatGPT, Claude, Claude Code and Cursor sign in with your PostPlanify account instead.
ChatGPT
Nothing to install and no API key needed. PostPlanify is listed in the ChatGPT plugin directory, so you sign in with your PostPlanify account and approve the connection.
- 1.Go to chatgpt.com/plugins and search for PostPlanify.
- 2.Click install on the PostPlanify app.
- 3.You will be sent to PostPlanify to sign in, then shown exactly what ChatGPT is asking for. Authorize it and you are returned to ChatGPT, connected.
Already signed in to PostPlanify in the same browser? Then it is two clicks. You can revoke access at any time from Connected apps in your dashboard.
Claude (web, desktop and mobile)
Nothing to install and no API key needed. PostPlanify is an official connector in Claude's connector directory.
- 1.Open the PostPlanify connector, or in Claude go to Customize, then Connectors, and search for PostPlanify.
- 2.Click Connect.
- 3.Sign in to PostPlanify, review what Claude is asking for and authorize it. You are returned to Claude, connected.
On Team and Enterprise plans, an organization owner may need to allow the connector first. You can revoke access at any time from Connected apps in your dashboard.
Claude Code
Add the server from your terminal:
claude mcp add --transport http postplanify https://api.postplanify.com/api/mcpThen start Claude Code, run /mcp, select postplanify and choose Authenticate to sign in with your PostPlanify account.
Other MCP Clients
https://api.postplanify.com/api/mcpIf your client supports OAuth, point it at the endpoint and it will handle sign-in for you. No key required.
Otherwise, send an API key:
Authorization: Bearer sk_live_your_api_keynpx mcp-remote https://api.postplanify.com/api/mcp --header "Authorization: Bearer sk_live_..."Tool Reference
30 tools. Your AI discovers these automatically once connected.
| Tool | Description | Key Parameters |
|---|---|---|
| Posts· 6 | ||
list_posts | List posts with filters | workspaceId, status?, platform?, from?, to? |
create_post | Create and schedule a new post | workspaceId, socialAccountId, scheduledAt, caption?, mediaIds?, youtubeParams?, tiktokParams?, pinterestParams?, googleBusinessParams?, igTrialGraduationStrategy?, shortenLinks?, utmCampaign? |
get_post | Get post details | postId |
edit_post | Update a scheduled post | postId, caption?, scheduledAt?, shortenLinks?, utmCampaign? |
cancel_post | Cancel a scheduled post | postId |
delete_post | Permanently delete a post | postId |
| Media· 8 | ||
upload_media_from_url | Upload media from a public URL | url, filename? |
upload_media_from_base64 | Upload a local file via base64 (max 7MB) | data, filename, mimeType |
upload_attached_file | Upload an image or video attached in ChatGPT | file |
open_upload_box | Show an upload box in Claude or ChatGPT to pick files from your device (up to 300MB each) | None |
create_upload_url | Get a one-time URL to upload a local file directly, e.g. with curl (up to 300MB) | fileName, mimeType, size? |
finish_upload | Turn a direct upload into a media ID for posts | uploadId |
list_media | List your API uploads, plus a workspace's dashboard media library when workspaceId is given | workspaceId?, type?, page?, pageSize? |
delete_media | Delete an uploaded media file | mediaId |
| Analytics· 3 | ||
get_account_analytics | Get analytics for a social account | workspaceId, socialAccountId |
get_analytics_trends | Get historical trends (followers, engagement) | workspaceId, socialAccountId, days? |
get_brand_overview | Get aggregated analytics across all accounts | workspaceId |
| Inbox· 7 | ||
list_comments | List synced comments from Instagram, Facebook, LinkedIn, Google Business | workspaceId, socialAccountId?, platform?, unreadOnly?, page?, limit? |
list_comment_replies | Fetch direct replies to a specific comment | platformCommentId |
reply_to_comment | Post a public reply to a comment on its originating platform | platformCommentId, message |
list_conversations | List Instagram and Facebook DM conversations, with reply status and the 24-hour reply window | workspaceId, needsReply?, unreadOnly?, socialAccountId?, assignedToUserId?, search?, page?, limit? |
list_conversation_messages | Read the messages in a DM conversation | conversationId, page?, limit? |
reply_to_conversation | Send a DM reply (within 24 hours of the customer's last message) | conversationId, message |
mark_conversation_read | Mark a DM conversation as read in PostPlanify | conversationId |
| Accounts & Workspaces· 6 | ||
get_current_user | Get your profile info | None |
list_workspaces | List all your workspaces | None |
get_workspace | Get workspace details | workspaceId |
list_social_accounts | List all connected social accounts | None |
get_social_account | Get social account details | accountId |
list_pinterest_boards | List Pinterest boards for an account | accountId |
Need an API key?
Only for clients that cannot sign in with OAuth, like the config-file setups above. Connecting ChatGPT needs no key at all.
