PostPiper MCP

Verwalte Social-Media-Konten, erstelle Entwürfe, lade Bilder hoch und veröffentliche oder plane Beiträge auf X und LinkedIn über deinen KI-Assistenten.

Gehosteter MCP-Server

npx add-mcp 'https://mcp.postpiper.ai/mcp'

Installiert in Claude Code, Codex, Cursor und mehr

Dokumentation

PostPiper MCP Server

PostPiperDocs

IntroductionQuickstartMCPAPI Reference

Get API key

Documentation

Introduction

Quickstart

MCP

API Reference

Accounts

Posts

Media

MCP

Copy for AIOpen in

MCP setup

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

See the PostPiper MCP overview for supported platforms and pricing.

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.

Read the MCP overview as Markdown.

Connect your client

ChatGPT setup is shown below. Other clients link to their guides further down the page.

ChatGPTClaudeGeminiGrok BotCodexClaude CodeCursorGrokOther

ChatGPT

PostPiper isn't in the public directory yet. Add it as a custom MCP server in ChatGPT:

  1. Open ChatGPT Plugins, select +, then Add custom MCP server.
  2. Name it PostPiper, enter https://mcp.postpiper.ai/mcp, and choose OAuth.
  3. Create the plugin, then install it from your personal plugins.
  4. Complete authorization, then use @PostPiper in a ChatGPT chat.

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.

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.

prepare_tiktok_video_upload

Get a signed upload URL for one MP4 or MOV video. After uploading, use the returned media URL in the TikTok draft.

create_draft

Create a draft with text or images for X or LinkedIn, or attach one MP4 or MOV video to a TikTok draft.

update_draft

Edit a draft's text or attachments.

get_tiktok_creator_info

Check the creator’s available visibility and interaction settings before confirming a TikTok post.

publish_post

Publish an approved X or LinkedIn draft or TikTok video now.

schedule_post

Schedule an approved X or LinkedIn draft or TikTok video for later.

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.

Client setup guides

Setup steps for other clients (ChatGPT is above). Server URL: https://mcp.postpiper.ai/mcp

Claude

In Claude (web, desktop or mobile), open Settings, then Connectors, then Add custom connector:

  • Name: PostPiper
  • URL: https://mcp.postpiper.ai/mcp

Click Add. Claude redirects you to sign in with your PostPiper account, then the connector activates. No API key is needed.

Claude connector docs ↗

Gemini

Connect PostPiper as a custom MCP app in Gemini Developer Mode:

  1. Open Gemini Developer Mode, or enable Gemini Apps Developer Mode from Gemini's Settings.

  2. In the app picker, choose + Create new.

  3. In Connect to an MCP server, paste the URL below into MCP Server URL, then click Next.

    MCP server URLCopy

    https://mcp.postpiper.ai/mcp
    
  4. Click Connect to complete authorization.

  5. Start a Gemini chat, type @PostPiper, and ask it to list your connected social accounts.

Try in GeminiCopy

@PostPiper list my connected social media accounts

Gemini Developer Mode docs ↗

Grok Bot

  1. Copy and paste this message to Grok Bot:

    Message to Grok BotCopy

    Visit https://postpiper.ai and setup for me
    
  2. Follow the prompts to add the connector and authorize access.

Grok Bot connectors ↗

Codex

Add PostPiper in the Codex CLI, then start OAuth sign-in. Codex CLI and the IDE extension share this configuration.

TerminalCopy

codex mcp add postpiper --url https://mcp.postpiper.ai/mcp
codex mcp login postpiper

Codex MCP docs ↗

Claude Code

Run this command to add PostPiper for all your Claude Code projects.

TerminalCopy

claude mcp add --transport http --scope user postpiper https://mcp.postpiper.ai/mcp

Use /mcp select PostPiper and sign in with your PostPiper account:

> /mcp

Select > PostPiper

Select > Authenticate

Claude Code MCP docs ↗

Cursor

Add a remote server in Cursor, or put this in ~/.cursor/mcp.json (or a project's .cursor/mcp.json).

~/.cursor/mcp.jsonCopy

{
  "mcpServers": {
    "postpiper": {
      "url": "https://mcp.postpiper.ai/mcp"
    }
  }
}

Cursor prompts you to sign in with your PostPiper account. To use an API key instead, pass it as a header:

~/.cursor/mcp.jsonCopy

{
  "mcpServers": {
    "postpiper": {
      "url": "https://mcp.postpiper.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POSTPIPER_API_KEY}"
      }
    }
  }
}

Cursor MCP docs ↗

Grok

  1. Sign in to PostPiper.
  2. Open grok.com/connectors.
  3. Click New Connector, select Custom, and name it PostPiper.
  4. Paste https://mcp.postpiper.ai/mcp as the MCP server URL.
  5. Complete OAuth sign-in with your PostPiper account.

Grok can then list accounts, create drafts, schedule posts, and publish from your chats. Confirm publishing and scheduling when prompted.

Grok connector docs ↗

Other clients

Add https://mcp.postpiper.ai/mcp as a remote Streamable HTTP MCP server. Your client must support OAuth discovery and browser sign-in.

MCP authorization spec ↗

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.

Explore the social media scheduling API for supported platforms, pricing, and code examples.

Read the API quickstart

On this page

Connect your clientTest the connectionToolsClient setup guidesChatGPTClaudeGeminiGrok BotCodexClaude CodeCursorGrokOtherIf it fails