Developer Docs

PostPublify MCP Server

The Model Context Protocol server lets your own AI agent — Claude Desktop, Claude Code, Cursor, or any MCP client — manage your PostPublify account: list connected accounts, create, schedule and publish posts, and read analytics. It talks to the PostPublify REST API with a single API key.

Requirements

Node.js 18 or newer.
A PostPublify API key (starts with pp_live_). API and MCP access is included on every plan — including Free.

Get an API key

Log in to PostPublify.
Go to Settings → API.
Create a new key and copy it — it's shown only once. It looks like pp_live_….

Your API key grants full control of your account. Treat it like a password, never commit it, and revoke it any time in Settings → API.

Available tools

Tool	Description
`list_accounts`	List connected social accounts (id, provider, handle, status).
`list_posts`	List posts, with optional status / limit / offset filters.
`create_post`	Create a draft or scheduled post targeting one or more accounts.
`schedule_post`	Create a post with status=scheduled and a scheduledAt ISO timestamp.
`get_post`	Fetch a single post by id, with its per-account targets.
`update_post`	Update a draft or scheduled post by id.
`delete_post`	Delete a post by id.
`publish_post`	Immediately publish an existing post to all its targets.
`get_analytics`	Aggregated dashboard analytics (counts, upcoming / recent / failed posts).

Configuration

The server reads two environment variables: PP_API_KEY (required) and PP_BASE_URL (optional, defaults to https://postpublify.com).

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop:

{
  "mcpServers": {
    "postpublify": {
      "command": "npx",
      "args": ["-y", "@postpublify/mcp-server"],
      "env": {
        "PP_API_KEY": "pp_live_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add postpublify \
  -e PP_API_KEY=pp_live_YOUR_KEY_HERE \
  -- npx -y @postpublify/mcp-server

Cursor

Add an entry to ~/.cursor/mcp.json (or a project .cursor/mcp.json) using the same command / args / env shape as the Claude Desktop snippet above.

Questions or feedback? Reach us at postpublify@outlook.de.