# pendpost

> pendpost is an open-source MCP server for marketing and seo. Local social media planner where an agent drafts posts and you approve each one. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, macOS, Windows, Linux, CLI
- **Website:** https://pendpost.com
- **Repository:** https://github.com/pendpost/pendpost
- **MCP Registry name:** io.github.pendpost/pendpost
- **Categories:** marketing and SEO, productivity
- **Listing updated:** 2026-11-14

## About

Every post begins as a draft and a post without approval will not publish. Each post records which actor drafted it, so drafting and approving stay separate. Auto-approve exists as a per-lane setting that only the owner can switch on and off.

Two safeguards are specific to it. A circuit breaker halts the Meta lane after a Meta error 368 action block and never resumes automatically; the owner clears it. A caption check against an editable rules.json flags length, hashtag count, all caps, broken links and regex-based AI-writing tells such as em-dash overuse, with errors blocking a publish.

It runs locally on 127.0.0.1 with secrets in your own .env and is MIT licensed. Channels listed include Instagram, Facebook, LinkedIn, YouTube, X, Telegram, Discord, Mastodon and Nostr. Start with npx -y pendpost on Node 22+.

## Features

- **Approval gate:** Fail-closed: unapproved posts never publish.
- **Actor tracking:** Records who drafted and who approved each post.
- **Anti-ban breaker:** Stops Meta sending after an action block until you clear it.
- **Caption lint:** Editable rules flag length, hashtags and AI-writing tells.
- **Local-first:** Runs on your machine with no phone-home.

## Good for

- Let an agent plan a week of posts for review
- Cross-post to many channels
- Block machine-sounding captions
- Run a social queue for several clients as an agency

## Install

### Claude Code (Terminal)

```sh
claude mcp add pendpost -- npx -y pendpost
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pendpost": {
      "command": "npx",
      "args": [
        "-y",
        "pendpost"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pendpost": {
      "command": "npx",
      "args": [
        "-y",
        "pendpost"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pendpost": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pendpost"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pendpost": {
      "command": "npx",
      "args": [
        "-y",
        "pendpost"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pendpost": {
      "command": "npx",
      "args": [
        "-y",
        "pendpost"
      ]
    }
  }
}
```

## Tools

- `plan_create_post`: Creates a draft post for scheduling.
- `approve_post`: Approves a draft post.
- `reject_post`: Rejects a draft post.

## FAQ

### Does anything publish without approval?

No, creating a post always yields a draft.

### Is it free?

Yes, open source under MIT.

### What does it need to run?

Node 22 or later, started with npx -y pendpost.

### Where is my data kept?

On your machine; secrets stay in your own .env.

### Is pendpost free?

Yes. pendpost is open source, so you can use and self-host it for free.

### How do I add pendpost to Claude Code?

Run this command in your terminal: claude mcp add pendpost -- npx -y pendpost

### What are the best alternatives to pendpost?

The closest alternatives to pendpost are Ha MCP, Google Ads + Meta Ads + SEO/GEO MCP, Concord MCP, Calven and note1.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.

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