Qpost MCP Server

qpost-mcp

MCP server for QPost — lets AI agents schedule and publish video/image posts to YouTube, TikTok, and Instagram through QPost's REST API.

Install

Connect your destination accounts and generate an API key at QPost API Keys, then pick one of the two options below.

Hosted (recommended — nothing to install)

QPost runs the same server at https://qpost.dev/mcp over Streamable HTTP:

claude mcp add --transport http qpost https://qpost.dev/mcp \
  --header "x-api-key: YOUR_API_KEY"

Any MCP client that speaks Streamable HTTP can point at that URL with an x-api-key (or Authorization: Bearer) header. The endpoint is stateless, so there is no session to manage.

Local (stdio) via npx

Use this to run the MCP bridge on your machine while QPost handles publishing:

claude mcp add qpost -e QPOST_API_KEY=your_key_here -- npx -y qpost-mcp

Claude Desktop / other MCP clients

{
  "mcpServers": {
    "qpost": {
      "command": "npx",
      "args": ["-y", "qpost-mcp"],
      "env": {
        "QPOST_API_KEY": "your_key_here"
      }
    }
  }
}

QPOST_BASE_URL defaults to https://qpost.dev. Running this MCP bridge locally still uses QPost’s hosted publishing service.

Tools

Media handling differs by transport

The local stdio server can read files from your machine, so create_post accepts mediaPath as well as mediaUrl. The hosted endpoint obviously cannot reach your disk — it takes mediaUrl/imageUrls, or mediaBase64 with an optional mediaFilename to set the MIME type.

Full request/response shapes and per-platform metadata options (YouTube category/privacy, TikTok privacy level, Instagram media type, etc.) are documented at qpost.dev/docs — this server is a thin wrapper over that same REST API.

Both the stdio server and the hosted endpoint speak MCP 2026-07-28 and still accept clients on 2025-era protocol versions. The stdio server needs Node 20+.

Publishing from n8n?

Use the tested n8n video-to-draft workflow. It uses built-in HTTP Request nodes, works without a community package, and saves a draft before you publish. The page includes the downloadable JSON and the settings to change.

For TikTok app-review restrictions, see self-hosted publishing options.

Local development

npm install
npm run dev   # runs src/index.ts directly via tsx
npm run build # compiles to dist/

License

MIT