Postproxy MCP Server

MCP server for Postproxy API integration with Claude Code

Local serverstdio

What is the Postproxy MCP MCP server?

MCP server for Postproxy API integration with Claude Code. That is what the postproxy mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

MCP (Model Context Protocol) server for integrating PostProxy API with Claude Code. This server provides tools for publishing posts, checking statuses, and managing social media profiles through Claude Code.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • auth_status — Check authentication status, API configuration, and workspace information
  • profile_groups_list — List all profile groups accessible with your API key. Profile groups are organizational containers (e.g. per brand or client) that hold related
  • profiles_list — The profiles_list tool exposed by this server
  • profiles_placements — List available placements for a profile. For Facebook profiles, placements are business pages. For LinkedIn profiles, placements include the personal
  • profiles_stats — Get the follower/engagement timeseries for a profile. Snapshots are captured roughly every 23 hours, so you can plot follower growth and other trends
  • post_publish — Example: json { "instagram": { "format": "reel", "collaborators": ["username1", "username2"], "first_comment": "Link in bio!" }, "youtube": {
  • post_status — The post_status tool exposed by this server
  • post_publish_draft — Publish a draft post. Only posts with draft: true status can be published using this endpoint
  • post_delete — The post_delete tool exposed by this server
  • post_stats — Get stats snapshots for one or more posts. Returns all matching snapshots so you can see trends over time. Supports filtering by profiles/networks
  • queues_list — List all posting queues. Queues automatically schedule posts into recurring weekly timeslots with priority-based ordering
  • queues_get — Get details of a single posting queue including its timeslots and post count

Getting it running

Installation goes through your MCP client rather than a global install: point it at postproxy-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: POSTPROXY_API_KEY, POSTPROXY_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Postproxy MCP's toolset — auth_status, profile_groups_list, profiles_list and 11 more — is a fair guide to whether it matches your workflow. It is maintained by postproxy; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Postproxy MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
auth_statusCheck authentication status, API configuration, and workspace information.
profile_groups_listList all profile groups accessible with your API key. Profile groups are organizational containers (e.g. per brand or client) that hold related profiles. Use a group's id to filter profiles_list by profile_group_id.
profiles_listThe profiles_list tool exposed by this server.
profiles_placementsList available placements for a profile. For Facebook profiles, placements are business pages. For LinkedIn profiles, placements include the personal profile and organizations. For Pinterest profiles, placements are boar
profiles_statsGet the follower/engagement timeseries for a profile. Snapshots are captured roughly every 23 hours, so you can plot follower growth and other trends over time. The stats fields are platform-native (not normalized) — see
post_publishExample: json { "instagram": { "format": "reel", "collaborators": ["username1", "username2"], "first_comment": "Link in bio!" }, "youtube": { "title": "My Video Title", "privacy_status": "public" }, "tiktok": { "privacy_
post_statusThe post_status tool exposed by this server.
post_publish_draftPublish a draft post. Only posts with draft: true status can be published using this endpoint.
post_deleteThe post_delete tool exposed by this server.
post_statsGet stats snapshots for one or more posts. Returns all matching snapshots so you can see trends over time. Supports filtering by profiles/networks and timespan.
queues_listList all posting queues. Queues automatically schedule posts into recurring weekly timeslots with priority-based ordering.
queues_getGet details of a single posting queue including its timeslots and post count.
queues_createThe queues_create tool exposed by this server.
queues_updateUpdate a queue's settings, timeslots, or pause/unpause it. Changes to timezone or timeslots trigger rearrangement of all queued posts.

How to install the Postproxy MCP MCP server

{
  "mcpServers": {
    "postproxy": {
      "command": "npx",
      "args": ["-y", "postproxy-mcp"],
      "env": {
        "POSTPROXY_API_KEY": "your-value",
        "POSTPROXY_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
POSTPROXY_API_KEYCredential the server authenticates with.Yes
POSTPROXY_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Postproxy MCP to auth status.
  • Use Postproxy MCP to profile groups list.
  • Use Postproxy MCP to profiles list.

Frequently asked questions

It connects Postproxy MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (auth_status, profile_groups_list, profiles_list, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Postproxy MCP directly.