Skip to content
postpeg
Hosted

The postpeg MCP server

Ask Claude, Cursor or VS Code what’s breaking out on TikTok in your niche and why, then post your version and see how it did, with 32 tools on a hosted server. Nothing to install for most clients: add one URL and your key.

One prompt, the whole loop

Prompt
What's breaking out on TikTok in my "Specialty coffee"
niche this week? Break down the best one, write my
version for @ourcafe, and tell me when to post it.

The assistant calls find_top_tiktoks for the niche’s breakouts, break_down_tiktok on the best one, writes your version with write_tiktok_script, asks best_times_to_post when to put it up, and runs check_post on the caption. Once you have recorded the video, it shows you the post and publishes only after you say yes, with inspired_by set so benchmark_post can tell you next week how it did. See TikTok competitor analysis.

No time to film? Ask for a carousel instead. The assistant calls make_tiktok_carousel, checks get_tiktok_carousel until the slides are ready (about a minute), changes any words you want with edit_tiktok_carousel, and posts the slides as a TikTok photo post with create_post once you say yes. See Carousels.

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 32 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
list_nichesThe TikTok niches you watch: competitors, keywords, hashtags.Read only
create_nicheStart watching a TikTok niche; refreshed once a day.Changes your postpeg account
find_top_tiktoksThe videos beating their creator’s usual views in a niche this week.Read only
break_down_tiktokWhy a TikTok worked: hook, format, call to action and reasons.Read only
write_tiktok_scriptYour version of a video that worked: hook, beats, call to action and caption. Counts against your monthly scripts.Changes your postpeg account
make_tiktok_carouselAn educational TikTok photo carousel from a breakdown or a topic: slides, caption and hashtags. Takes about a minute; counts against your monthly carousels once ready.Changes your postpeg account
get_tiktok_carouselA carousel’s status and, once ready, its slides and the media for a photo post.Read only
edit_tiktok_carouselNew words on some slides, or a new caption or hashtags. Free; only changed slides are re-rendered.Changes your postpeg account
regenerate_carousel_backgroundPaint one background again and re-render its slides. Uses the carousel’s included regeneration.Changes your postpeg account
best_times_to_postThe hours when a niche’s over-performing videos were posted, in your time zone.Read only
benchmark_postHow your TikTok did against its niche at 24 hours and 7 days.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. It also posts to Instagram, YouTube, LinkedIn and more through your own Zernio account (its first 2 accounts are free). On TikTok, postpeg also shows what’s working in your niche: TikTok growth.