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

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.

ChatGPT Claude Gemini Grok Bot Codex Claude Code Cursor Grok Other

ChatGPT

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 @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.

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: 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:

Open Gemini Developer Mode, or enable Gemini Apps Developer Mode from Gemini's Settings.
In the app picker, choose + Create new.
In Connect to an MCP server, paste the URL below into MCP Server URL, then click Next.
MCP server URL
```
https://mcp.postpiper.ai/mcp
```
Click Connect to complete authorization.
Start a Gemini chat, type @PostPiper, and ask it to list your connected social accounts.

Try in Gemini

@PostPiper list my connected social media accounts

Gemini Developer Mode docs ↗

Grok Bot

Copy and paste this message to Grok Bot:
Message to Grok Bot
```
Visit https://postpiper.ai and setup for me
```
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.

Terminal

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.

Terminal

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.json

{
  "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.json

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

Cursor MCP docs ↗

Grok

Sign in to PostPiper.
Open grok.com/connectors.
Click New Connector, select Custom, and name it PostPiper.
Paste https://mcp.postpiper.ai/mcp as the MCP server URL.
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.

Read the API quickstart