MCP quickstart

Connect an AI client to the BetterFans Link MCP server with OAuth or an API key, then ask it about your accounts.

The MCP server lets Claude, ChatGPT, Cursor and other AI clients read your accounts and ask for writes that a person approves. It has the same data and the same rules as the REST API.

The server URL

https://mcp.betterfans.link/mcp

The server speaks Streamable HTTP. Every client on the client setup page connects to this one URL.

Choose how to sign in

	OAuth	API key
How it works	The client opens a BetterFans Link page where you sign in and pick a workspace, test or live mode, and scopes.	You create a key in the dashboard and put it in the client's config as a bearer token.
Best for	Chat apps on your own account, like Claude.ai and ChatGPT.	Headless agents, shared machines and CI, where nobody can click through a sign-in page.
Scopes	Picked on the sign-in page.	Set on the key.
Revoke	Disconnect the client on the Developers, then MCP page.	Revoke the key on the Developers, then API keys page.

With OAuth the client gets an access token that lasts an hour and a refresh token that lasts 30 days. Each refresh returns a new refresh token, so a client in regular use stays signed in. You never copy a key. Start with a test key or test mode on the sign-in page, so the agent works on the sandbox creators first.

Connect Claude Code

With OAuth:

claude mcp add --transport http betterfans-link https://mcp.betterfans.link/mcp

Then run /mcp inside Claude Code, pick betterfans-link and sign in.

With an API key:

claude mcp add --transport http betterfans-link https://mcp.betterfans.link/mcp \
  --header "Authorization: Bearer $BFL_KEY"

For other clients, see client setup.

Ask your first question

Try these in order:

"Which BetterFans Link accounts can you see, and are they healthy?" The agent calls list_accounts.
"Who are my top five fans by spend on the first account?" The agent calls find_fans and get_fan.
"How much did that account make last week, gross and net?" The agent calls revenue_summary.

The server also offers three prompts, daily_briefing, whale_report and reply_suggestions. Clients show them as slash commands or in a prompt menu. See tools and prompts.

Ask for a write

Ask the agent to send a message to a fan. It calls send_message, which does not send anything. It creates a pending action and gives you an approval link. Open the link, read the summary and approve or reject it. With a test key the approved action records a simulated result and never reaches OnlyFans. See approvals for agents.

Teach the agent the rules

Install the BetterFans Link skills so the agent knows the money rule, how freshness works and what each error means before it makes its first call.