OnlyFans MCP server — Claude / ChatGPT / Cursor / Manus

The official Model Context Protocol server for the OFMAPI OnlyFans API. Run your OnlyFans agency from your favourite AI assistant.

---

🚧 Preview release. General availability launching shortly. Sign up at ofmapi.com to be notified.

What is this

@ofmapi/mcp is a Model Context Protocol server that exposes the OFMAPI OnlyFans API as a set of tools your AI assistant can use. Plug it into Claude Desktop, ChatGPT, Cursor, Manus — or any MCP-compatible client — and your assistant can:

• Read and reply to OnlyFans chats in plain English
• Schedule mass-messaging campaigns across your connected accounts
• Pull earnings, transactions, payouts, and chargebacks for analysis
• Manage fans, lists, subscription bundles, and promotions
• Create posts, vault uploads, and stories
• Search the public OnlyFans creator profile database

No glue code. No prompt engineering for tool-calling. The MCP server exposes hundreds of typed tools auto-generated from our OpenAPI spec.

Install (5 seconds)

# Run the latest version on demand — no install needed
npx @ofmapi/mcp@latest --api-key ofmapi_...

# Or install globally
npm install -g @ofmapi/mcp

Get an OnlyFans API key at ofmapi.com — free, no credit card required.

Add to Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ofmapi": {
      "command": "npx",
      "args": ["-y", "@ofmapi/mcp@latest"],
      "env": {
        "OFMAPI_API_KEY": "ofmapi_..."
      }
    }
  }
}

Restart Claude Desktop. Type "list my connected OnlyFans accounts" — Claude will call the MCP server and show your accounts.

Add to ChatGPT

ChatGPT's custom-tools support consumes the same MCP server. See docs.ofmapi.com/integrations/mcp/chatgpt for the step-by-step setup.

Add to Cursor

Cursor's Settings → MCP panel accepts the same JSON shape as Claude Desktop. See docs.ofmapi.com/integrations/mcp/cursor.

Add to Manus

Manus consumes MCP servers natively. Drop the same @ofmapi/mcp config in its agent definition.

Tools exposed

The server exposes a typed tool for every endpoint of the OFMAPI OnlyFans API:

• Account management — list, connect, disconnect OnlyFans accounts
• Messaging — list chats, read messages, send (with PPV/media/GIF), mass message, queue management, schedule
• Posts & vault — full post lifecycle, vault media management, stories, polls
• Fans — search, filter, segment, restrict, block, list management, subscription history
• Earnings & analytics — transactions, payouts, chargebacks, profit history, period comparisons
• Smart Links & tracking — server-side conversion tracking
• Webhooks — endpoint management directly from your AI assistant

Hundreds of tools, every one type-checked, every one safe with idempotency keys on writes.

Example prompts

Once connected, try these in Claude / ChatGPT / Cursor:

• "Show me my OnlyFans earnings for the last 7 days, broken down by account."
• "Send 'Happy Friday 💖' to every fan who hasn't messaged in the last 14 days."
• "Find OnlyFans creators in my niche with 1k–10k followers and a free trial active."
• "Reply to every unread chat with a personalised greeting."
• "Schedule a mass-message for Saturday 8pm with this PPV image at $9.99."
• "Show me chargeback patterns this month — which fans triggered them?"

Build the next generation of OnlyFans software

Use the OFMAPI MCP server to give your AI assistant the same surface that powers products in the spirit of:

• 🤖 AI chat platforms like Botly, Supercreator, Substy, ChatPersona
• 📊 Creator CRMs like Infloww, OnlyMonster, CreatorHero
• 📈 Analytics & metrics tools like FansMetric, FansIQ
• 🎯 Traffic & attribution platforms like CreatorTraffic
• 🔗 Link-in-bio + deeplink products like Juicy Bio, Hello Butter
• 🛠️ Agency back-offices managing hundreds of accounts from a single dashboard

Whatever your assistant is doing — chat triage, mass-message scheduling, fan segmentation, earnings analysis — OFMAPI handles the OnlyFans plumbing and ships continuous updates as the platform evolves, so the model gets clean tools instead of brittle scrapers.

Configuration

npx @ofmapi/mcp@latest \
  --api-key ofmapi_... \
  --account-filter acct_xxx,acct_yyy \    # restrict to specific accounts
  --read-only                              # disable write tools
  --log-level info

Full options: docs.ofmapi.com/integrations/mcp/configuration.

Trust & safety

• 🔒 OnlyFans API keys never leave your machine — the MCP server runs locally as a stdio process.
• 🚫 The --read-only flag disables every state-changing tool, useful for exploratory chats with an AI you don't fully trust yet.
• 🛡️ Per-account scope filter so an assistant can only see specific accounts.
• 🔐 OFMAPI itself: AES-256-GCM credentials at rest, bank-grade account safety architecture, SOC 2 Type II preparation underway.

Documentation

• 📚 MCP integration guide: docs.ofmapi.com/integrations/mcp
• 📖 OnlyFans API reference: docs.ofmapi.com/api

Contributing

See CONTRIBUTING.md. Issues + PRs welcome.

License

MIT — see LICENSE.

---

_{OFMAPI is an independent organisation, not affiliated with OnlyFans.com or Fenix International Limited. "OnlyFans" is a registered trademark of Fenix International Limited.}