# ChatGPT x OnlyFans (/onlyfans-ai/mcp/chatgpt)





import { Accordion, Accordions } from "fumadocs-ui/components/accordion";

<img alt="ChatGPT × OnlyFans MCP" src={__img0} placeholder="blur" />

## What this does

ChatGPT can call OnlyFans API endpoints directly through the OnlyFans MCP server. Add it once as a custom connector, then build a **Custom GPT** for your team or fire off **Agent Mode** to run scheduled work overnight.

Works with **Custom GPTs**, **Agent Mode**, **Deep Research**, and any chat with the connector enabled.

<Callout type="warn">
  ChatGPT custom connectors require a paid plan with MCP support — **Pro**, **Business**, or **Enterprise**. Free and Plus do not yet support custom MCP connectors.
</Callout>

## Prerequisites

* An [OnlyFans API](https://app.onlyfansapi.com) account
* A paid ChatGPT plan (**Pro**, **Business**, or **Enterprise**)
* At least one [connected OnlyFans account](/introduction/guides/connect-onlyfans-account)

<Callout>
  On **Business** and **Enterprise**, an admin can approve the connector once and roll it out to every seat in your workspace.
</Callout>

## Step-by-step

### 1. Open ChatGPT Settings → Connectors

In ChatGPT, click your profile → **Settings** → **Connectors** → **Create**.

### 2. Add a custom connector

Enter these details:

* **Name** — `OnlyFans MCP` (or any label you prefer)
* **MCP server URL**:

```
https://app.onlyfansapi.com/mcp/onlyfans-mcp
```

* **Authentication** — set to **OAuth**

<Callout type="warn">
  The OnlyFans MCP server expects **OAuth** for ChatGPT connectors. Don't pick "No authentication" — the connector will fail.
</Callout>

### 3. Click "Connect" and finish OAuth

ChatGPT redirects you to **app.onlyfansapi.com**. Click **Authorize**.

You'll land back in ChatGPT with the connector marked as connected. Done — your agent now has 200+ tools across chats, fans, and earnings.

<Callout>
  Sign in to [app.onlyfansapi.com](https://app.onlyfansapi.com) in a separate tab first, so the OAuth flow doesn't stall on the sign-in page.
</Callout>

### 4. Enable the connector in a chat

Open a new chat. Click the tools picker → toggle **OnlyFans MCP** on.

## Build a Custom GPT for your agency

In ChatGPT, go to **Explore GPTs** → **Create** → **Configure**. Drop this into **Instructions**, attach the OnlyFans MCP connector under **Tools**, and share with your team.

Replace `{{Agency Name}}` with your agency:

```
You are an OnlyFans agency analyst working for {{Agency Name}}.

You have access to:
- The OnlyFans MCP server — search the docs for endpoints, schemas, and webhook events.
- The onlyfansapi-skill — call REST endpoints to read chats, fans, earnings, and trigger mass messages.

Rules:
- Always check the docs first when unsure of a parameter.
- Use UTC timestamps. Always quote the source endpoint and parameters in your final answer.
- For revenue questions, group by creator account unless the user says otherwise.
- For mass-message drafts, output text only — never auto-send. The user reviews and dispatches.
- Surface chargebacks, refunds, and unusual spend patterns proactively.

Tone: concise, numeric, agency-operator-friendly. No emojis unless asked.
```

<Callout>
  A Custom GPT replaces a recurring n8n / Zapier workflow with one URL your team can open from any device.
</Callout>

## Run scheduled work in Agent Mode

Agent Mode is ChatGPT's autonomous workspace — it can plan, run tools, and iterate over multi-step tasks. Use it to ship a daily revenue digest with zero human touch:

```
Every morning at 8am UTC, draft a Slack-ready report of last 24h revenue per creator.
Flag any chargeback over $50, any creator whose revenue dropped >25% vs yesterday,
and any whale who didn't message yesterday. Output as markdown.
```

<Callout type="warn">
  Configure tool approvals so **write actions** (mass-message, label updates) require a human OK. Read-only actions (earnings, fan lookups) can run unattended.
</Callout>

## Run cohort analysis in Deep Research

Deep Research is ChatGPT's long-form research agent — perfect for cohort analysis across hundreds of fans:

```
Research churn drivers across my top 100 fans this quarter.
Pull last_active, total_spend, message_count, and tags from the OnlyFans API REST endpoints.
Cluster the churned cohort vs the retained cohort and surface 3 hypotheses ranked by lift.
```

## Example use cases

8 prompts that replace daily ops grunt work. Drop them into your Custom GPT or any ChatGPT conversation with the connector enabled:

* *"Pull this week's revenue per creator and chart it."* — replaces the Monday-morning spreadsheet build
* *"List my top 50 spenders with their last message timestamp."* — no more switching dashboards per creator
* *"Find every fan flagged for chargeback in the last 30 days."* — catch chargeback patterns before finance does
* *"Draft a renewal DM for fans churning in the next 7 days. No auto-send."* — agent drafts, your team approves and ships
* *"Compare PPV conversion rates across my creators this month."* — see which creator's offers are working
* *"Build a daily report for Slack: revenue, top fans, chat backlog."* — one Custom GPT replaces a recurring n8n workflow
* *"Identify whales who haven't messaged in 14 days — draft a re-engagement."* — reactivate dormant high-spenders before they unsub
* *"Export all transactions over $200 from last quarter as CSV."* — accounting stops chasing you for reports

<Callout>
  Most tools are **account-scoped** and need the account id in the form `acct_XXXXXXXXXXXXXXX`. If you omit it, ChatGPT will ask — or it will call `list_accounts` first to find one.
</Callout>

## Troubleshooting

<Accordions type="single">
  <Accordion title="Connector won't connect — 'Authentication failed'">
    Check that **Authentication** is set to **OAuth** (not "No authentication"). Sign in to [app.onlyfansapi.com](https://app.onlyfansapi.com) in a separate tab first, then retry.
  </Accordion>

  <Accordion title="Tool calls return 429 Too Many Requests">
    MCP calls are rate-limited to **120 requests/minute** per API key. Wait a minute and retry. If you hit this often, split work across multiple API keys.
  </Accordion>

  <Accordion title="ChatGPT doesn't see the OnlyFans tools">
    The connector is toggled off in that conversation. Open the tools picker and toggle **OnlyFans MCP** on.
  </Accordion>

  <Accordion title="I'm on Free or Plus and don't see Connectors">
    Custom MCP connectors require **Pro**, **Business**, or **Enterprise**. Upgrade your plan, or use [Claude](/onlyfans-ai/mcp/claude) instead — Claude supports custom connectors on every paid plan.
  </Accordion>
</Accordions>

## See also

* [OnlyFans MCP overview](/onlyfans-ai/mcp) — what MCP is, how it works, and supported clients
* [Claude MCP install guide](/onlyfans-ai/mcp/claude)
* [Manus MCP install guide](/onlyfans-ai/mcp/manus)
* [Develop with AI Agents](/introduction/guides/develop-with-ai-agents) — `llms.txt`, OpenAPI schema, `onlyfansapi-skill`
* [API Reference](/api-reference) — every endpoint exposed as an MCP tool
