English Français العربية

io.github.arslan2012/qpost-mcp

Official registry Marketing and sales

MCP server for QPost — lets AI agents publish video and image posts to YouTube, TikTok, Instagram.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http qpost-mcp 'https://qpost.dev/mcp' --header 'x-api-key: <API key from your QPost dashboard (Settings > API Keys)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "qpost-mcp": {
            "type": "http",
            "url": "https://qpost.dev/mcp",
            "headers": {
                "x-api-key": "<API key from your QPost dashboard (Settings > API Keys)>"
            }
        }
    }
}
NPM package qpost-mcp
Claude Code 
claude mcp add qpost-mcp -e 'QPOST_API_KEY=<your qpost_api_key>' -e 'QPOST_BASE_URL=<QPOST_BASE_URL>' -- npx -y qpost-mcp@0.4.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "qpost-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "qpost-mcp@0.4.0"
            ],
            "env": {
                "QPOST_API_KEY": "<your qpost_api_key>",
                "QPOST_BASE_URL": "<QPOST_BASE_URL>"
            }
        }
    }
}

Environment variables

  • QPOST_API_KEY required secret API key from your QPost dashboard (Settings > API Keys)
  • QPOST_BASE_URL QPost instance URL, for self-hosted deployments (defaults to https://qpost.dev)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. qpost-mcp
  2. Install
  3. Tools
  4. Local development
  5. License

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

Generate an API key from your QPost dashboard (Settings → API Keys), then pick one of the two options below.

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 if you self-host QPost or would rather run the server yourself:

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"
      }
    }
  }
}

Set QPOST_BASE_URL too if you're self-hosting QPost (defaults to https://qpost.dev).

Tools

ToolDescription
list_connected_accountsList connected YouTube/TikTok/Instagram accounts and their status
create_postCreate and publish (or schedule) a post, with video or image media from a URL or local path
list_postsList posts, optionally filtered by status/platform
get_postGet a single post by ID
update_postUpdate a post's caption/schedule/timezone/status
delete_postDelete a post
retry_postRetry a failed post
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.

Local development

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

License

MIT

Frequently asked questions

What is io.github.arslan2012/qpost-mcp?

MCP server for QPost — lets AI agents publish video and image posts to YouTube, TikTok, Instagram.

How do I install io.github.arslan2012/qpost-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http qpost-mcp 'https://qpost.dev/mcp' --header 'x-api-key: <API key from your QPost dashboard (Settings > API Keys)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.arslan2012/qpost-mcp need an API key?

Yes. It expects QPOST_API_KEY, x-api-key, which you set in its configuration.

Is io.github.arslan2012/qpost-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.arslan2012/qpost-mcp?

It is published by arslan2012. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.