Skip to content
postpeg
Hosted

The postpeg MCP server

Ask Claude, Cursor or VS Code to check a post against every network, publish or schedule it, see how it did and answer comments, with 21 tools on a hosted server. Nothing to install for most clients: add one URL and your key.

What MCP is

The Model Context Protocol is an open standard that lets an AI assistant use tools from outside the chat. An MCP server describes its tools; the assistant decides when to call one and, in good clients, asks you first. postpeg’s server wraps the same REST API the docs describe, with your key, so the assistant sees the same accounts, rules and errors you would.

Server URL: https://mcp.postpeg.com/mcp. Transport: Streamable HTTP. Auth: your key as Authorization: Bearer pp_live_…, created under API keys.

Set it up in your client

Replace pp_live_your_key with your key. Config files hold it in plain text, so keep them out of version control.

  1. Claude Code

    Run in a terminal. Add --scope user to use it in every project.

    Terminal
    claude mcp add --transport http postpeg https://mcp.postpeg.com/mcp \
      --header "Authorization: Bearer pp_live_your_key"
  2. Claude Desktop

    Settings → Developer → Edit Config, then add this to claude_desktop_config.json and restart Claude Desktop.

    JSON
    {
      "mcpServers": {
        "postpeg": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://mcp.postpeg.com/mcp",
            "--header",
            "Authorization:${POSTPEG_AUTH}"
          ],
          "env": {
            "POSTPEG_AUTH": "Bearer pp_live_your_key"
          }
        }
      }
    }

    Claude Desktop’s config file starts local servers, so the mcp-remote bridge (needs Node.js) forwards to the hosted server. The header value sits in env because some systems split arguments on spaces.

  3. Cursor

    Add to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project).

    JSON
    {
      "mcpServers": {
        "postpeg": {
          "url": "https://mcp.postpeg.com/mcp",
          "headers": {
            "Authorization": "Bearer pp_live_your_key"
          }
        }
      }
    }
  4. VS Code

    Add to .vscode/mcp.json in your workspace, or run “MCP: Open User Configuration”.

    JSON
    {
      "servers": {
        "postpeg": {
          "type": "http",
          "url": "https://mcp.postpeg.com/mcp",
          "headers": {
            "Authorization": "Bearer pp_live_your_key"
          }
        }
      }
    }

Other clients that support remote MCP servers with custom headers work the same way: the URL above, and the Authorization header. Then try: “List my postpeg accounts, then check this post for X and LinkedIn without publishing it.”

The 21 tools

Each tool is labelled with what it changes, so clients can ask before anything public. “Acts in public” means real people can see the result on a social network.

ToolWhat it doesChanges anything?
list_platformsThe ten networks, what each supports and its text limit.Read only
get_meThe calling key, your plan and connected accounts.Read only
list_profilesYour profiles (brands or end users).Read only
create_profileCreate a profile to connect accounts to.Changes your postpeg account
list_accountsConnected accounts and their status, filtered by profile or network.Read only
connect_accountA hosted OAuth link the account’s owner opens to connect it.Changes your postpeg account
connect_blueskyConnect a Bluesky account with a handle and app password.Changes your postpeg account
check_postCheck a post against every target network’s rules without publishing.Read only
create_postPublish now or schedule a post to one or more accounts.Acts in public
get_postA post and each account’s status, link or error.Read only
list_postsRecent posts, filtered by status.Read only
cancel_postCancel a scheduled post’s targets that haven’t started.Acts in public
get_post_analyticsImpressions, reach, likes and more per account.Read only (asks the network)
get_account_analyticsFollowers and daily growth for an account.Read only (asks the network)
list_commentsComments on a published post.Read only (asks the network)
reply_to_commentReply to a comment, in public.Acts in public
hide_commentHide or unhide a comment.Acts in public
list_conversationsInstagram DM conversations.Read only (asks the network)
list_messagesMessages in a conversation.Read only (asks the network)
send_messageReply to an Instagram DM within the 24-hour window.Acts in public
get_billingYour plan, subscription and the plans on offer.Read only

Staying in control

Questions

Do I need to install anything?
Not for Claude Code, Cursor or VS Code: they connect to the hosted server over HTTP with your key as a header. Claude Desktop’s config file uses the small mcp-remote bridge, which needs Node.js.
Will my assistant publish without asking?
Publishing, replying, hiding comments and sending messages are marked as public actions, and publishing, replying and sending each tell the assistant to show you exactly what will be sent and get your go-ahead first. Good clients also ask before any tool runs. Read what it proposes before you approve.
Can I try it without posting for real?
Not with a test key: pp_test_ keys currently publish for real, like live keys. Use check_post, which validates without publishing, or schedule a post and cancel it.
What does it cost?
Nothing extra. The MCP server calls the same API with your key, under the same plan and the same rate limits.
MCP or the Agent Skill?
Use MCP when an assistant should act for you (publish, check, reply). Use the skill when a coding agent writes code that calls the API. They work together.

Other integrations

Send your first post in a few minutes

The 7-day trial has every feature and 3 connected accounts, with no card. The quickstart takes you from a key to a published post.