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
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.
Claude Code
Run in a terminal. Add
--scope userto use it in every project.Terminalclaude mcp add --transport http postpeg https://mcp.postpeg.com/mcp \ --header "Authorization: Bearer pp_live_your_key"Claude Desktop
Settings → Developer → Edit Config, then add this to
claude_desktop_config.jsonand 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-remotebridge (needs Node.js) forwards to the hosted server. The header value sits inenvbecause some systems split arguments on spaces.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" } } } }VS Code
Add to
.vscode/mcp.jsonin 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.
| Tool | What it does | Changes anything? |
|---|---|---|
list_platforms | The ten networks, what each supports and its text limit. | Read only |
get_me | The calling key, your plan and connected accounts. | Read only |
list_profiles | Your profiles (brands or end users). | Read only |
create_profile | Create a profile to connect accounts to. | Changes your postpeg account |
list_accounts | Connected accounts and their status, filtered by profile or network. | Read only |
connect_account | A hosted OAuth link the account’s owner opens to connect it. | Changes your postpeg account |
connect_bluesky | Connect a Bluesky account with a handle and app password. | Changes your postpeg account |
check_post | Check a post against every target network’s rules without publishing. | Read only |
create_post | Publish now or schedule a post to one or more accounts. | Acts in public |
get_post | A post and each account’s status, link or error. | Read only |
list_posts | Recent posts, filtered by status. | Read only |
cancel_post | Cancel a scheduled post’s targets that haven’t started. | Acts in public |
get_post_analytics | Impressions, reach, likes and more per account. | Read only (asks the network) |
get_account_analytics | Followers and daily growth for an account. | Read only (asks the network) |
list_comments | Comments on a published post. | Read only (asks the network) |
reply_to_comment | Reply to a comment, in public. | Acts in public |
hide_comment | Hide or unhide a comment. | Acts in public |
list_conversations | Instagram DM conversations. | Read only (asks the network) |
list_messages | Messages in a conversation. | Read only (asks the network) |
send_message | Reply to an Instagram DM within the 24-hour window. | Acts in public |
get_billing | Your plan, subscription and the plans on offer. | Read only |
list_niches | The TikTok niches you watch: competitors, keywords, hashtags. | Read only |
create_niche | Start watching a TikTok niche; refreshed once a day. | Changes your postpeg account |
find_top_tiktoks | The videos beating their creator’s usual views in a niche this week. | Read only |
break_down_tiktok | Why a TikTok worked: hook, format, call to action and reasons. | Read only |
write_tiktok_script | Your version of a video that worked: hook, beats, call to action and caption. Counts against your monthly scripts. | Changes your postpeg account |
make_tiktok_carousel | An 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_carousel | A carousel’s status and, once ready, its slides and the media for a photo post. | Read only |
edit_tiktok_carousel | New words on some slides, or a new caption or hashtags. Free; only changed slides are re-rendered. | Changes your postpeg account |
regenerate_carousel_background | Paint one background again and re-render its slides. Uses the carousel’s included regeneration. | Changes your postpeg account |
best_times_to_post | The hours when a niche’s over-performing videos were posted, in your time zone. | Read only |
benchmark_post | How your TikTok did against its niche at 24 hours and 7 days. | Read only |
Staying in control
create_postwithoutscheduled_atpublishes immediately to real audiences. Its description tells the assistant to runcheck_postfirst, show you the exact post and accounts, and wait for your go-ahead;reply_to_commentandsend_messagesay the same.- Keep your client’s “ask before running tools” setting on for postpeg. Approve each public action only after reading what it will send.
create_post,reply_to_commentandsend_messagetake an idempotency key, so if the assistant retries, it still happens once.- The server uses your key’s limits: 120 requests a minute, of which 30 can be writes. See Authentication → Rate limits.
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-remotebridge, 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. Usecheck_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.