# Qpost MCP

> Qpost MCP is a free MCP server for design and media. Publish or schedule videos and images to YouTube, TikTok and Instagram from an agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://qpost.dev
- **Repository:** https://github.com/arslan2012/qpost-mcp
- **MCP Registry name:** io.github.arslan2012/qpost-mcp
- **Categories:** design and media, marketing and SEO
- **Listing updated:** 2026-11-14

## About

QPost handles the awkward part of social publishing: platform approvals. The site explains that publishing to TikTok, Instagram and YouTube needs approvals that take weeks to obtain, and that QPost already holds them. It also points out that unaudited TikTok apps can only post private videos, which is why it routes TikTok posts through its audited app, subject to your account's privacy settings and TikTok's review.

The server wraps QPost's REST API. An agent can list connected accounts, create or schedule a post with video or image media, check stats such as views, likes, comments and shares, update captions or schedules, and retry a failed post. Run locally over stdio with npx, it can read media from your disk; the hosted endpoint takes a URL or base64 data instead. A scoped API key is required either way.

QPost is free with no usage cap while in beta, and says paid plans will come later with notice. The npm package is MIT licensed.

## Features

- **Three-platform publishing:** Posts video or images to YouTube, TikTok and Instagram.
- **Scheduling and retries:** Schedules posts and can retry failed ones.
- **Post statistics:** Returns views, likes, comments, shares and the public URL.
- **Hosted or local:** Hosted over Streamable HTTP or locally via npx qpost-mcp.
- **Scoped API keys:** Uses keys created in the QPost dashboard.

## Good for

- Publish a finished video to all three platforms from an agent
- Schedule a week of posts
- Check how a published video performed
- Retry a failed post
- Wire video publishing into an n8n workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http qpost-mcp https://qpost.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://qpost.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qpost-mcp": {
      "url": "https://qpost.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qpost-mcp": {
      "type": "http",
      "url": "https://qpost.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qpost-mcp": {
      "serverUrl": "https://qpost.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qpost-mcp": {
      "type": "http",
      "url": "https://qpost.dev/mcp"
    }
  }
}
```

## Tools

- `list_connected_accounts`: List connected YouTube, TikTok and Instagram accounts and their status
- `create_post`: Create and publish or schedule a post with video or image media
- `list_posts`: List posts, optionally filtered by status or platform
- `get_post`: Get a single post by ID
- `get_post_stats`: Views, likes, comments, shares and public URL for a published post
- `update_post`: Update a post's caption, schedule, timezone or status
- `delete_post`: Delete a post
- `retry_post`: Retry a failed post

## FAQ

### Does it cost anything?

QPost is free with no usage cap while in beta; paid plans are planned for later.

### How do I authenticate?

With an API key from the QPost dashboard, sent as x-api-key or a Bearer header.

### Can it read files from my computer?

Only the local stdio server can; the hosted endpoint takes URLs or base64 media.

### What licence is it?

MIT.

### Is Qpost MCP free?

Yes. Qpost MCP is free to use.

### How do I add Qpost MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http qpost-mcp https://qpost.dev/mcp

### What are the best alternatives to Qpost MCP?

The closest alternatives to Qpost MCP are HyperFrames by HeyGen, ffmpeg-skill, Google Ads + Meta Ads + SEO/GEO MCP, Calven and AvatarSay — Fictional Character & Talking Video MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/qpost-mcp
