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.
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 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.
| 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 |
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. The quickstart takes you from a key to a published post.