MCP Setup Guide
Connect PostPlanify to your AI assistant in under a minute.
Prerequisites
- 1.An active PostPlanify subscription — see plans
- 2.ChatGPT only needs the server URL. You sign in with your PostPlanify account when you connect, so there is no key to copy or paste.
- 3.For the config-file clients below (Claude Code, Claude Desktop), an API key from your API Keys dashboard
Claude Code
Add this to your ~/.claude/settings.json:
{
"mcpServers": {
"postplanify": {
"type": "http",
"url": "https://api.postplanify.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_your_api_key_here"
}
}
}
}Replace sk_live_your_api_key_here with your actual API key.
Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"postplanify": {
"command": "npx",
"args": [
"mcp-remote",
"https://api.postplanify.com/api/mcp",
"--header",
"Authorization: Bearer sk_live_your_api_key_here"
]
}
}
}Requires Node.js. The mcp-remote package bridges HTTP to stdio transport.
ChatGPT
No API key needed. You sign in with your PostPlanify account and approve the connection, the same way you would connect any other app.
- 1.In ChatGPT, open Settings → Security and login and turn on Developer mode.
- 2.Go to chatgpt.com/plugins and click the + button.
- 3.Fill in the fields below, choosing OAuth for authentication.
- 4.Click connect. You will be sent to PostPlanify to sign in, then shown exactly what ChatGPT is asking for. Approve it and you are returned to ChatGPT, connected.
PostPlanifyhttps://api.postplanify.com/api/mcpAlready 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.
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? |
get_post | Get post details | postId |
edit_post | Update a scheduled post | postId, caption?, scheduledAt? |
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 all uploaded media files | None |
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 nothing but the server URL.