logoPostPlanify
Back to MCP

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

Claude Code

Add this to your ~/.claude/settings.json:

~/.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

Claude Desktop

Add this to your claude_desktop_config.json:

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

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. 1.In ChatGPT, open Settings → Security and login and turn on Developer mode.
  2. 2.Go to chatgpt.com/plugins and click the + button.
  3. 3.Fill in the fields below, choosing OAuth for authentication.
  4. 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.
NamePostPlanify
Server URLhttps://api.postplanify.com/api/mcp
AuthenticationOAuth

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.

GeminiGrok

Other MCP Clients

Endpointhttps://api.postplanify.com/api/mcp
Auth

If 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_key
TransportHTTP (Streamable HTTP)
Stdio bridgenpx mcp-remote https://api.postplanify.com/api/mcp --header "Authorization: Bearer sk_live_..."

Tool Reference

22 tools — your AI discovers these automatically once connected.

ToolDescriptionKey Parameters
Posts· 6
list_postsList posts with filtersworkspaceId, status?, platform?, from?, to?
create_postCreate and schedule a new postworkspaceId, socialAccountId, scheduledAt, caption?, mediaIds?, youtubeParams?, tiktokParams?, pinterestParams?, googleBusinessParams?
get_postGet post detailspostId
edit_postUpdate a scheduled postpostId, caption?, scheduledAt?
cancel_postCancel a scheduled postpostId
delete_postPermanently delete a postpostId
Media· 4
upload_media_from_urlUpload media from a public URLurl, filename?
upload_media_from_base64Upload a local file via base64 (max 20MB)data, filename, mimeType
list_mediaList all uploaded media filesNone
delete_mediaDelete an uploaded media filemediaId
Analytics· 3
get_account_analyticsGet analytics for a social accountworkspaceId, socialAccountId
get_analytics_trendsGet historical trends (followers, engagement)workspaceId, socialAccountId, days?
get_brand_overviewGet aggregated analytics across all accountsworkspaceId
Inbox· 3
list_commentsList synced comments from Instagram, Facebook, LinkedIn, Google BusinessworkspaceId, socialAccountId?, platform?, unreadOnly?, page?, limit?
list_comment_repliesFetch direct replies to a specific commentplatformCommentId
reply_to_commentPost a public reply to a comment on its originating platformplatformCommentId, message
Accounts & Workspaces· 6
get_current_userGet your profile infoNone
list_workspacesList all your workspacesNone
get_workspaceGet workspace detailsworkspaceId
list_social_accountsList all connected social accountsNone
get_social_accountGet social account detailsaccountId
list_pinterest_boardsList Pinterest boards for an accountaccountId

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.