vipsallowed

# vips

[![npm version](https://img.shields.io/npm/v/vipsallowed.svg)](https://www.npmjs.com/package/vipsallowed)
[![MCP](https://img.shields.io/badge/MCP-local%20%2B%20remote-blue)](#mcp-server)
[![Platform fee](https://img.shields.io/badge/platform%20fee-1%25-brightgreen)](#the-1-fee)

**The creator economy platform your agent runs — posts, paid content, subscriptions, live streams, DMs, payouts. As easy as git. 1% fee.**

> **git for your code. vips for your creator business.**

Creator platforms take 20% of your income and give you a web dashboard your agent can't touch. VIPsAllowed flips both: a **1% platform fee**, and a platform that is *agent-first* — every feature (posting, pricing, subscriber management, analytics, payouts, even going live) is a CLI command or an MCP tool. Your agent doesn't screenshot a dashboard; it runs your whole creator operation while you create.

**Works with:** Claude Code · Cursor · Cline · Windsurf · Aider · Codex · any MCP client — or just your terminal.

## The 1% fee

| Platform | Cut of your income |
|---|---|
| OnlyFans | 20% |
| Fansly | 20% |
| Patreon | 8–12% |
| Gumroad | 10% |
| Ko-fi | 5% |
| **VIPsAllowed** | **1%** |

Card payments settle **directly into your own Stripe Express account** (destination charges) — the platform never holds your money hostage. On a $10 tip you keep $9.32 after card processing; via wallet, $9.90.

## Install

```bash
npm install -g vipsallowed
```

The npm package is `vipsallowed`; the command is `vips`.

## Quick Start

```bash
# Create an account (returns your API key)
vips signup myname --email me@example.com --local

# Start your 7-day free trial
vips billing start

# Post free content
vips post "Hello from the CLI!"

# Post paid content
vips post "Subscriber-only drop" --paid 4.99

# Set your subscription rates
vips rates --1mo 9.99 --3mo 24.99

# Connect Stripe and get paid
vips stripe connect

# See the money
vips earnings
vips dashboard

# Full reference
vips --help
```

## Your agent as your manager

The commands are built for delegation, not just convenience. Tell your agent *"grow my subscriber revenue"* and it has everything it needs:

```bash
vips earnings breakdown --type subs      # where the money comes from
vips earnings top-tippers                # who to look after
vips earnings forecast                   # 30-day projection
vips subscribers new --period week       # who just joined
vips subscribers message USER_ID "Welcome! Here's what's coming this month…"
vips analytics best-times                # when to post
vips plan create "Friday drop 🔥" --schedule 2026-08-01T18:00:00Z
```

Audience lists, PPV DMs, pinned posts, bookmarks, per-platform analytics, CSV subscriber export — all scriptable, all structured JSON under the hood.

## Go live from the terminal

```bash
vips stream create "Friday AMA"     # returns RTMP ingest + HLS playback
vips stream encoder ID              # copy-paste OBS settings
vips stream chat ID "starting in 5!"
vips stream stop ID
```

## Paid DMs & tips

```bash
vips dm send USER_ID "here's the uncut version" --price 4.99
vips pay tip USER_ID --amount 5.00
vips pay withdraw --amount 50.00    # payout to your Stripe account
```

## MCP Server

Prefer tools over a CLI? `vips` ships an MCP server — your agent gets native tools for feed, posting, profiles, wallet, notifications and support.

```bash
claude mcp add vips -- vips mcp-serve
```

For JSON-config clients (Cline, Cursor, Windsurf):

```json
{
  "mcpServers": {
    "vips": {
      "command": "vips",
      "args": ["mcp-serve"],
      "env": { "VIPS_API_KEY": "vips_your_key_here" }
    }
  }
}
```

### Remote MCP — zero install

Claude Web, Claude Desktop, Raycast, or any hosted MCP client can connect straight to our remote server. Nothing to install:

```
URL:  https://mcp.vipsallowed.com/sse
Auth: Authorization: Bearer YOUR_API_KEY
```

No key yet? Connect **without** one: the server boots in onboarding mode with a `vips_signup` tool that provisions your account and unlocks the full toolset in the same session.

## Pricing

7-day free trial. Card required (secure Stripe checkout), nothing charged during the trial — cancel before it ends and you pay nothing. After that, a flat platform-access subscription plus the **1% fee on earnings**. No per-seat pricing, no cut escalation as you grow.

```bash
vips billing status     # trial/access state
vips billing start      # begin the trial
vips billing cancel     # cancel any time
```

## Per-Project Config

```bash
vips login --local --key YOUR_KEY   # saves to .vips/config.json (project-local)
vips config                         # show active config
```

Add `.vips/` to your `.gitignore`.

## Agent Integration

Add to your CLAUDE.md, .cursorrules, .clinerules, .windsurfrules, or AGENTS.md:

```
## VIPsAllowed
This project uses the `vips` CLI to run the creator account.
Config is in .vips/config.json (auto-loaded).
If not configured: vips login --local --key YOUR_KEY
Run `vips --help` for the full command reference.
```

## Why this exists

Every creator platform assumes a human clicking a dashboard — and charges 20% for the privilege. Agents changed the game: your AI can schedule content, manage subscribers, price posts, and reconcile payouts better than a dashboard ever let you. So we built the platform where the agent is a first-class citizen and the fee is 1%. It's early and we're iterating fast — if something's rough or missing, [open an issue](https://github.com/jyswee/vipsallowed/issues). We read every one.

## Documentation

- [VIPsAllowed](https://vipsallowed.com)
- [Full agent reference](https://vipsallowed.com/llms.txt)

## License

Proprietary — Tyga.Cloud Ltd. See [LICENSE](./LICENSE).