# postfast-mcp

Connect an AI assistant to PostFast to schedule social posts and handle comments. Use it when PostFast is part of your publishing workflow.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: peturgeorgievv-factory
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/peturgeorgievv-factory/postfast-mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/postfast-mcp

## What it does

The server gives an assistant access to PostFast tools for listing connected accounts, creating scheduled posts, and uploading media. It can also retrieve analytics for published posts and follower history. Comment tools cover inbox conversations, replies, and conversation status changes.

For a local setup, you need `npx` and a `POSTFAST_API_KEY` value in the MCP configuration. Claude Code supports adding the server with `claude mcp add` or installing the plugin. Remove any hand-written PostFast entry before adding the plugin; otherwise Claude Code displays duplicate sets of PostFast tools.

The comments inbox covers TikTok, Instagram, Facebook Pages, and Threads, but it handles comments rather than direct messages. It does not backfill comments from before the account was connected. Deleting a comment through the server cannot be undone, while deleting a published post from PostFast does not remove it from the social platform.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `POSTFAST_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add postfast-mcp -e POSTFAST_API_KEY=<POSTFAST_API_KEY> -- npx -y postfast-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add postfast-mcp --env POSTFAST_API_KEY=<POSTFAST_API_KEY> -- npx -y postfast-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postfast-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "postfast-mcp"
            ],
            "env": {
                "POSTFAST_API_KEY": "<POSTFAST_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "postfast-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "postfast-mcp"
            ],
            "env": {
                "POSTFAST_API_KEY": "<POSTFAST_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e POSTFAST_API_KEY=<POSTFAST_API_KEY> postfast-mcp npx -y postfast-mcp
```
Replace <…> with your own values

## When to use it
- schedule a post for a connected social account
- upload an image and attach it to a post
- find posts scheduled within a date range
- review comment threads and reply to a comment
- retrieve metrics for published posts

## Example prompts
- List the social accounts connected to PostFast.
- Schedule an Instagram post for tomorrow at 9am.
- Show comments that need a reply and draft a public response.

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7132
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4963
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2329
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3228
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md