MCP

MCP setup

Connect your AI client to PostPiper. The server is hosted, so there is nothing to install.

MCP server URL

https://mcp.postpiper.ai/mcp

Connect your client

Choose your client and use the hosted server URL.

In ChatGPT on the web, open Plugins, add a custom MCP server, enter the PostPiper URL, and choose OAuth. Create and install the plugin, then sign in to PostPiper.

ChatGPT MCP docs ↗

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.

Prompt

@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: Check a post and its status.
list_scheduled_posts: List your scheduled posts.

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.

Read the API quickstart