Betterfans - API

@betterfans/mcp-server

stdio 経由でツールを実行するクライアント向けの BetterFans Link MCP サーバーです。

BetterFans Link は、代理店と開発者向けの OnlyFans API および Fansly API であり、彼らが管理するクリエイターアカウントを対象としています。AI クライアントはチャット、ファン、支出、収益を読み取ることができ、メッセージの送信などの書き込みを要求することもできます。API キーで自動承認が有効になっていない限り、書き込みはチーム内の誰かによる承認を待ちます。

ほとんどのクライアントは、ホスト型サーバーに直接接続する必要があります。 インストールは不要で、OAuth サインインをサポートしています:

https://mcp.betterfans.link/mcp

Claude Code、Claude、ChatGPT、Cursor、VS Code、Windsurf、Codex、Gemini CLI のセットアップ: betterfans.link/docs/mcp/clients。

このパッケージは、ローカルコマンドしか起動できないクライアントと、ドキュメントだけを必要とするコーディングエージェント向けです。

	ツール
キーなし	search_docs、get_doc、get_agent_setup、およびすべてのドキュメントページを bfl://docs/ リソースとして
BFL_KEY 設定済み	ホスト型サーバーのすべてのツールとプロンプト: list_accounts、list_chats、get_chat、find_fans、revenue_summary、send_message など、HTTPS 経由でパススルーされます

セットアップ

ドキュメントのみ (キーなし)

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

アカウントを使用する場合

1. betterfans.link/sign-up でワークスペースを作成します。OnlyFans と Fansly のサンドボックスクリエイターを使用したテストモードで開始されるため、実際のファンには何も届きません。
2. Developers の下で、テストキーを作成します。これは bfl_test_ で始まります。
3. それを BFL_KEY としてサーバーに渡します:

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

コミットするファイルにキーを含めないでください。ほとんどのクライアントは、代わりに環境からキーを読み取ることができます。たとえば Cursor では "BFL_KEY": "${env:BFL_KEY}" です。キーのスコープとアカウント許可リストは、REST API とまったく同じように適用されます。ダッシュボードキー (bfl_dash_) は拒否されます。クリエイターが実際のアカウントをリンクしたら、bfl_live_ キーに切り替えてください。

キーが拒否された場合、またはホスト型サーバーに到達できない場合でも、サーバーはドキュメントツールとともに起動し、その理由を stderr と自身の instructions に出力します。

環境変数

変数	デフォルト
BFL_KEY	なし	bfl_test_ または bfl_live_ の API キー。ホスト型ツールを有効にします。
BFL_MCP_URL	https://mcp.betterfans.link/mcp	ホスト型サーバーです。
BFL_SITE_URL	https://betterfans.link	ドキュメントを読み取る場所です。

ドキュメントツール

• search_docs: トピックでドキュメントページを検索します。スラッグ、タイトル、説明、リンクを返します。
• get_doc: スラッグ (webhooks/verify)、ドキュメント URL、または bfl://docs/ URI を指定して、1 ページを markdown として読み取ります。
• get_agent_setup: エージェント向けに書かれたセットアップ手順です。

キーがある場合、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 クイックスタート
• エージェントセットアップ (markdown として)
• サポート: [email protected]

OnlyFans は Fenix International Limited の登録商標です。Fansly はその所有者の商標です。BetterFans Link は、いずれとも提携、スポンサー、または推奨の関係にありません。

ライセンス

MIT