# @unpuzzle/vibemarketing-mcp

The Model Context Protocol server for [Vibe Marketing](https://vibemarketing.to).

Use Claude Code, Claude Desktop, or Cursor to draft, schedule, and publish social
posts on your Vibe Marketing workspace by chatting.

> If you're on **claude.ai**, you don't need this package — add
> `https://vibemarketing.to/mcp` as a Connector instead.
> See [vibemarketing.to/install/mcp](https://vibemarketing.to/install/mcp).

## Install

```sh
npm install -g @unpuzzle/vibemarketing-mcp
```

Then register it with your MCP client:

### Claude Code

```sh
claude mcp add vibemarketing-mcp -- vibemarketing-mcp
```

### Cursor / Claude Desktop

Add this to your MCP config (usually `~/.cursor/mcp.json` or your client's
settings):

```json
{
  "mcpServers": {
    "vibemarketing-mcp": {
      "command": "vibemarketing-mcp"
    }
  }
}
```

## First-run sign-in

The first time Claude calls a tool that needs your workspace, the MCP opens
your browser to the Vibe Marketing consent screen. Sign in, click **Allow**,
and that's it — tokens are saved locally (`~/.config/vibemarketing-mcp/auth.json`
on macOS/Linux, `%APPDATA%\vibemarketing-mcp\auth.json` on Windows, chmod 600)
and refreshed automatically.

To revoke access later, visit
[Settings → Connected Apps](https://vibemarketing.to/settings?tab=connected-apps).

## Tools

The MCP exposes 16 tools. Claude picks the right one based on what you ask —
you don't have to remember the names.

**Drafts** — `create_draft`, `create_bulk_drafts`, `list_drafts`, `get_draft`,
`get_draft_audit`

**Publishing** — `approve_and_publish_now`, `approve_and_schedule`,
`reject_draft`

**Media** — `upload_media` (accepts base64 from a Claude session, e.g. a Figma
export)

**Visibility** — `get_calendar_day`, `get_calendar_week`, `list_notifications`

**Connection** — `ping`, `connect`, `disconnect`, `whoami`

## Example workflows

The full guide with concrete recipes (Figma → 10 carousel posts, Shopify →
product spotlights, transcript → a week of posts) lives at
[vibemarketing.to/install/mcp](https://vibemarketing.to/install/mcp).

## License

MIT. See `LICENSE` (or the root of this repo on GitHub).

## Source

[github.com/muscled-clients/vibemarketing-mcp](https://github.com/muscled-clients/vibemarketing-mcp)