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

Nothing to install and no API key needed. PostPlanify is listed in the ChatGPT app directory, so you sign in with your PostPlanify account and approve the connection.

  1. 1.Go to chatgpt.com/plugins and search for PostPlanify.
  2. 2.Click install on the PostPlanify app.
  3. 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.

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 no key at all.