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
22 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?, 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· 4 | ||
upload_media_from_url | Upload media from a public URL | url, filename? |
upload_media_from_base64 | Upload a local file via base64 (max 20MB) | data, filename, mimeType |
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· 3 | ||
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 |
| 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.