PostPiper MCP
Manage social accounts, create drafts, upload images, and publish or schedule posts on X and LinkedIn through your AI assistant.
Hosted MCP Server
npx add-mcp 'https://mcp.postpiper.ai/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
PostPiper MCP Server
Documentation
Accounts
Posts
- POSTCreate a draft
- PATCHEdit a draft
- GETGet a post
- GETList posts
- POSTPublish a post
- POSTSchedule a post
Media
MCP
Copy for AIOpen in
MCP setup
Connect your AI client to PostPiper. The server is hosted, so there is nothing to install.
MCP server URLCopy
https://mcp.postpiper.ai/mcp
PostPiper is listed in the official MCP Registry as ai.postpiper/mcp. View the server.json metadata for its version and connection details.
Connect your client
Choose your client and use the hosted server URL.
ChatGPTClaudeGeminiGrok BotCodexClaude CodeCursorGrokOther
PostPiper isn't in the public directory yet. Add it as a custom MCP server in ChatGPT:
- Open ChatGPT Plugins, select +, then Add custom MCP server.
- Name it PostPiper, enter
https://mcp.postpiper.ai/mcp, and choose OAuth. - Create the plugin, then install it from your personal plugins.
- Complete authorization, then use
@PostPiperin a ChatGPT chat.
Test the connection
Ask your assistant to list your connected social media accounts. It calls list_connected_accounts and returns each account's platform, username, and ID.
PromptCopy
@postpiper list my connected social media accounts
Example response
Found 1 connected account(s):
- X: acme (ID: 550e8400-e29b-41d4-a716-446655440000)
No accounts yet? Connect one and ask again.
Tools
Your assistant can use these tools after you connect.
whoami
Show your signed-in PostPiper profile.
list_connected_accounts
List your connected social accounts.
open_media_uploader
Open an image picker in clients that support MCP Apps.
upload_media
Upload a JPEG, PNG, or WebP image up to 2 MB from a client that can provide file bytes.
import_media_from_url
Import an image from a public HTTPS URL.
list_media_assets
List your uploaded images and their asset IDs.
get_media_asset
Get an image asset's details and a fresh preview URL.
create_draft
Create a post draft with text or images.
update_draft
Edit a draft's text or images.
publish_post
Publish a draft to X or LinkedIn now.
schedule_post
Schedule a draft for later on X or LinkedIn.
get_post
Get a post's content, media, platform, status, account, and scheduling or publication details.
list_posts
List posts by status, platform, account, or time range, with pagination.
Publishing and scheduling require your confirmation.
If it fails
- Sign-in: Reconnect and complete OAuth.
- No accounts: Connect an account.
- Missing tools: Refresh or restart your client.
Prefer direct HTTP?
Use the PostPiper REST API with an API key.
On this page