Fans API · APIs and developer tools
OnlyFans MCP: Connect Claude, ChatGPT, Manus
TL;DR
- OnlyFans MCP is a hosted Fans API server that lets Claude, ChatGPT, Manus or Cursor read and act on the creator accounts you connect, in plain English.
- It's included on every Fans API plan, Free included. Your AI client may cost extra; Fans API says ChatGPT needs a Pro, Business or Enterprise plan.
- Start with a read-only key on one creator. Skip it if nobody on your team will check what the agent does before it messages fans.
- Price
- Fans API plans: free, $69 or $299/mo
- Product
- Fans API
- Platforms
- OnlyFans and Fansly on one server; Fanvue for teams that have it enabled
- Free trial
- Included on the Free plan, with 1 account and 100 welcome credits
What OnlyFans MCP is
OnlyFans MCP is a hosted server from Fans API that connects your OnlyFans creator accounts to an AI assistant. MCP, short for Model Context Protocol, is an open standard for giving AI tools access to outside data and actions. You add one URL to Claude, ChatGPT, Manus or Cursor, approve access, and then ask questions in plain English.
Behind the scenes, every documented Fans API endpoint becomes a tool the assistant can call. Ask for “today’s PPV revenue per creator” and the model picks the right tools, fetches the data and writes the answer. The server is part of the same account as the OnlyFans API, so you connect creators once and use them everywhere. It sits in our APIs and developer tools category, although most of its users never write code.
Key features of the OnlyFans MCP server
The server’s value is breadth: whatever the API can do, the assistant can do too, inside whichever AI client your team already uses. Fans API lists the use cases it aims at on its agency advantage overview.
350+ tools across chats, fans and money
Fans API’s docs count more than 350 tools, about 290 of them for OnlyFans and the rest for Fansly. They cover chats, mass messaging, fans and labels, posts, the media vault, earnings, payouts, chargebacks, tracking links and Smart Links. The OnlyFans tools map one-to-one to the API reference, so new endpoints show up as new tools.
One URL for every AI client
Claude, ChatGPT, Manus, Cursor and VS Code Copilot all use the same server address over Streamable HTTP. Desktop clients sign in through OAuth, so you approve access in a browser and never paste a key. Your own backend can skip OAuth and send a Fans API key instead. The Claude setup guide walks through each screen.
Plain-English prompts
The docs suggest prompts you can paste straight into a chat. Three of them show the range:
- “Find every chat with no reply in 24h and surface them.”
- “Tag whales spending over $500 with the
viplabel.” - “Mass-message expired subs with a 50% reactivation offer. Draft it, don’t send.”
The last one matters. You can tell the agent to prepare work and leave the sending to a person.
Scheduled agents in Manus and ChatGPT
Manus can run agents on a schedule, such as a daily revenue digest or a whale watch, with no one at the keyboard. ChatGPT’s Agent Mode can do the same, and its Deep Research mode can work through churn patterns across hundreds of fans. Fans API advises requiring a human OK for write actions while read-only lookups run unattended.
Fansly and Fanvue on the same server
Fansly tools carry a fansly_ prefix, and teams with Fanvue enabled get fanvue_ tools, all on one connection. An agent can compare an OnlyFans creator with a Fansly one in a single conversation. Our Fansly API page covers that side in more detail.
Connecting OnlyFans MCP: a real config
There are two ways in. Operators use the connector screen of their AI client; developers pass a key from their own code. For Claude, open Settings, then Customize, then Connectors, add a custom connector and paste the server URL https://app.fansapi.com/mcp/onlyfans-mcp. Leave the advanced OAuth fields empty, click Connect and approve access on Fans API.
Fans API also offers an optional skill, installed with npx skills add https://github.com/onlyfansapi/skill --skill onlyfansapi-skill, which gives the model extra instructions for these tools.
For your own product, the request below calls Anthropic’s Messages API with the server attached. It comes from Fans API’s embed guide. The model name is the one printed in that guide, so swap in whichever model you use.
{
"model": "claude-opus-4-7",
"max_tokens": 4096,
"mcp_servers": [
{
"type": "url",
"url": "https://app.fansapi.com/mcp/onlyfans-mcp?platforms=onlyfans",
"name": "onlyfans",
"authorization_token": "ofapi_xxx_your_api_key"
}
],
"messages": [{ "role": "user", "content": "List the accounts on my team." }]
}
The authorization_token is your Fans API key; Anthropic forwards it to the server as a Bearer token. The ?platforms=onlyfans filter is optional and keeps the Fansly tools out of the model’s context. Most tools also take an account ID such as acct_XXXXXXXXXXXXXXX, so pin it in your system prompt when the agent works on one creator. If your product serves several agencies, Fans API says to use one key per customer team and never share a key between them.
Is OnlyFans MCP safe to use?
OnlyFans MCP gives the assistant exactly what its API key allows, and you set those limits. The key decides which team the agent works for. Keys can be restricted to specific endpoints, so a read-only analyst key and a write-enabled operations key can sit side by side. They can also be limited to one creator or a defined roster, so an agent working for one creator can’t touch another.
Each call the agent makes is written to an audit log, and revoking the key in the dashboard ends access at once. Fans API says it stores no media; photos, videos and voice notes pass through to the AI client only when a tool needs them. Fans API says two-factor login on the dashboard is mandatory for write-scoped keys. In Claude, every tool starts at “Needs approval”, grouped as read-only, write or destructive, until you choose “Always allow”.
The real risk is the agent’s judgement, not the plumbing. A model can misread a prompt, and a mass message can’t be unsent. If a send times out, it may already have been delivered, so the agent should check the chat before retrying.
The service is also unofficial: OnlyFans’ terms restrict third-party tools, and any action OnlyFans takes on an account is your responsibility. We know of no independent security audit of the server.
Pricing
OnlyFans MCP costs nothing on top of a Fans API plan, and the Fans API pricing page lists it on every tier, including Free. The Free plan gives you 1 account and 100 welcome credits, which is enough for a first test.
Basic costs $69 a month for 1 account and 20,000 monthly credits. Pro costs $299 a month for 5 accounts and 100,000 credits, plus 10,000 credits per extra account. Enterprise is quoted on request.
Fans API’s MCP page says there are no per-seat, per-tool or per-call fees on top of the plan. Budget for your AI client separately, because that’s where the extra cost usually sits. Fans API says Claude supports custom connectors on all plans, with Free limited to one connector. ChatGPT needs a Pro, Business or Enterprise plan for custom connectors.
Who it’s for, and who should skip it
OnlyFans MCP suits agency owners and operations leads who want answers without a dashboard project. Typical questions are which whales went quiet, which chatter turned conversations into revenue, or which creator’s earnings dropped yesterday. It also suits developers who want an agent inside their own product, since the same server takes a key from a backend. If your team already pays for Claude or ChatGPT, it’s the cheapest way to try AI on your real numbers.
Skip it if no one will review what the agent does before it reaches fans. A ready-made assistant may fit better: FansBot delivers reports and chatter checks in Telegram, Slack or Discord and never messages fans. Skip it as well if you need events as they happen rather than answers on request; OnlyFans webhooks push those to your server. For AI image and video batches instead of account data, look at the FansCreator API.
Pros and cons
Pros
- Every documented endpoint is a tool, so the assistant can reach chats, fans, earnings, posts and mass messages
- Works with Claude, ChatGPT, Manus, Cursor and VS Code Copilot through one server URL
- API keys can be limited to specific endpoints and to one creator or a roster
- Every tool call is logged, and revoking the key cuts the agent off
- No extra fee on top of your Fans API plan, and it's on the Free plan too
Cons
- An agent with write access can send real messages and paid PPVs to real fans, and a timed-out send may already have gone through
- Your AI client may need a paid plan; Fans API says ChatGPT custom connectors need Pro, Business or Enterprise, and Claude Free allows only one custom connector
- With 350+ tools loaded, some clients refuse the full list, so you may need to filter the server to one platform
- It runs on the same unofficial connection as the Fans API, so OnlyFans' terms on third-party tools still apply
- There's no sandbox, so even your first test prompt runs against a real creator account
Frequently Asked Questions
Short answers to the questions agencies ask most.
What is OnlyFans MCP?
OnlyFans MCP is a Model Context Protocol server hosted by Fans API. MCP is an open standard that lets an AI assistant call outside tools. Once you add the server to Claude, ChatGPT, Manus or another MCP client, the assistant can look up chats, fans and earnings on the creator accounts connected to your Fans API team, and take actions such as drafting or sending messages.
Which AI assistants can use it?
Fans API publishes install guides for Claude (Desktop, web, Claude Code and the Anthropic API), ChatGPT and Manus. Its docs say Cursor, VS Code Copilot and any custom agent that speaks Streamable HTTP MCP work too. All of them use the same server URL. ChatGPT needs a Pro, Business or Enterprise plan for custom connectors, according to Fans API.
Can the AI send messages to fans?
Yes, if the key allows it. The server includes sending tools such as single messages, mass messages and PPVs. Claude groups the tools as read-only, write and destructive, and asks before each call by default. Fans API recommends a read-only key first, draft-then-approve for mass messages, and never letting an agent retry a send that timed out.
Do I need to write code?
No. For Claude, you paste the server URL into Settings, Customize, Connectors, click Connect and approve access on Fans API. ChatGPT and Manus have similar connector screens. Code only comes in if you want the tools inside your own product, where your backend passes a Fans API key to the server, as in the example on this page.
Does OnlyFans MCP work with Fansly?
Yes. The same server carries Fansly tools with a fansly_ prefix next to the unprefixed OnlyFans tools, and teams with Fanvue enabled also get fanvue_ tools. If you only manage OnlyFans creators, add ?platforms=onlyfans to the server URL. Fans API says the filter limits which tools can run, not only which ones are listed.
How is this different from FansBot?
FansBot is a ready-made AI operations assistant that works in Telegram, Slack or Discord and never messages fans. OnlyFans MCP is a raw connection: it hands Fans API's tools to an AI client you already pay for, and you decide what it may do. Pick FansBot for finished reports and chatter checks; pick MCP if you want your own assistant or agent.
Verdict
OnlyFans MCP is the quickest way to put an AI assistant on your agency's real numbers. An owner can ask Claude or ChatGPT about yesterday's revenue or quiet whales without waiting for a developer. It costs nothing extra on a Fans API plan. Its risk is the agent itself, so begin with a read-only key on one creator and keep sends behind human approval.
Best for: Agencies that want Claude, ChatGPT or Manus to work on their data