Betterfans - API

@betterfans/mcp-server

BetterFans Link MCP 服务，面向通过 stdio 运行工具的客户端。

BetterFans Link 是面向代运营机构和开发者的 OnlyFans API 与 Fansly API，服务于他们管理的创作者账号。AI 客户端可以读取聊天、粉丝、消费和收入，也可以请求写入操作，例如发送消息。除非 API key 开启了自动批准，否则写入操作会等待你团队中的人批准。

大多数客户端应直接连接托管服务。 它无需安装，并支持 OAuth 登录：

https://mcp.betterfans.link/mcp

Claude Code、Claude、ChatGPT、Cursor、VS Code、Windsurf、Codex 和 Gemini CLI 的配置方法：betterfans.link/docs/mcp/clients。

这个软件包适用于只能启动本地命令的客户端，以及只需要文档的编码 Agent。

	工具
无 key	search_docs、get_doc、get_agent_setup，以及每个文档页面作为 bfl://docs/ 资源
设置了 BFL_KEY	托管服务的每个工具和提示词：list_accounts、list_chats、get_chat、find_fans、revenue_summary、send_message 等，通过 HTTPS 透传

配置

仅文档（无 key）

{
  "mcpServers": {
    "betterfans-link": {
      "command": "npx",
      "args": ["-y", "@betterfans/mcp-server"]
    }
  }
}

使用你的账号

1. 在 betterfans.link/sign-up 创建工作区。它一开始处于测试模式，带有 OnlyFans 和 Fansly 上的沙箱创作者，因此不会有任何内容触达真实粉丝。
2. 在 Developers 下创建一个测试 key。它以 bfl_test_ 开头。
3. 将它作为 BFL_KEY 传给服务：

{
  "mcpServers": {
    "betterfans-link": {
      "command": "npx",
      "args": ["-y", "@betterfans/mcp-server"],
      "env": { "BFL_KEY": "bfl_test_..." }
    }
  }
}

不要把该 key 放进你提交的文件中。大多数客户端可以从你的环境变量中读取它，例如在 Cursor 中使用 "BFL_KEY": "${env:BFL_KEY}"。该 key 的作用域和账号允许列表会生效，与 REST API 上完全一致。Dashboard key（bfl_dash_）会被拒绝。一旦创作者关联了真实账号，就切换到 bfl_live_ key。

如果该 key 被拒绝或无法访问托管服务，服务仍会以文档工具启动，并在 stderr 和其 instructions 中说明原因。

环境变量

变量	默认值
BFL_KEY	无	一个 bfl_test_ 或 bfl_live_ API key。开启托管工具。
BFL_MCP_URL	https://mcp.betterfans.link/mcp	托管服务。
BFL_SITE_URL	https://betterfans.link	读取文档的位置。

文档工具

• search_docs：按主题查找文档页面。返回 slug、标题、描述和链接。
• get_doc：以 markdown 读取一个页面，可通过 slug（webhooks/verify）、文档 URL 或 bfl://docs/ URI。
• get_agent_setup：为 Agent 编写的配置步骤。

有了 key 后，search_docs 和 get_doc 来自托管服务，它对相同输入给出相同回答。

资源：bfl://llms.txt（文档大纲）以及每个页面对应的 bfl://docs/{slug}。1.x 的 URI betterfans://docs/index、betterfans://docs/full 和 betterfans://docs/page/{path} 仍可读取。

链接

• MCP 文档和工具
• API 快速上手
• Agent 配置，markdown 版
• 支持：[email protected]

OnlyFans 是 Fenix International Limited 的注册商标。Fansly 是其所有者的商标。BetterFans Link 与二者均无关联，也未受其赞助或认可。

许可证

MIT