BillDog

BillDog は、iOS、Android、React Native、Flutter、Expo、ウェブ向けの単一 SDK で、ペイウォール、アプリ内購入、サブスクリプション、分析、メッセージ配信、アンケート、ユーザージャーニーを提供します。このリポジトリを使って、AI エージェントを BillDog に接続できます。

• ホスト型 MCP サーバー。 55 個のツールで、インテグレーションの診断、プロダクトカタログの作成、ペイウォールの設計と公開、収益や継続率の照会ができます。
• Claude Code プラグイン。 サーバーに加えて、アプリへの SDK の組み込みと、RevenueCat、Superwall、Adapty などからの移行を支援する 2 つのスキルが含まれます。

お使いのマシン上で実行されるものはありません。サーバーは BillDog がホストしており、すべてのクライアントが同じ URL に接続します。

インストール

BillDog の無料アカウントと、少なくとも 1 つのプロジェクトが必要です。

ツールが初めて実行されると、ブラウザーで BillDog にサインイン が開きます。これだけで設定は完了です。

{
  "mcpServers": {
    "billdog": { "url": "https://api.billdog.io/mcp" }
  }
}

{
  "servers": {
    "billdog": { "type": "http", "url": "https://api.billdog.io/mcp" }
  }
}

{
  "mcpServers": {
    "billdog": { "serverUrl": "https://api.billdog.io/mcp" }
  }
}

{
  "mcpServers": {
    "billdog": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.billdog.io/mcp"]
    }
  }
}

BillDog にサインイン

サーバーは PKCE と動的クライアント登録を使用する OAuth 2.1 を採用しているため、クライアントが自身を登録して認証します。

1. クライアントは、サーバーからの 401 を使って認可サーバーを検出します（RFC 9728）。
2. クライアントが自身を登録し、ブラウザーで BillDog を開きます。
3. サインインして、1 つのプロジェクトを選び、エージェントに許可する操作を選択します。
4. エージェントは、そのプロジェクト専用の短期間有効なトークンを取得します。トークンは自動的に更新され、いつでも接続を解除できます。

キーを使用する場合

スクリプト、CI、または OAuth に対応していないクライアントでは、**ダッシュボード → AI アシスタント (MCP) キー**でキーを作成してください。MCP キーは bd_mcp_ で始まり、読み取り専用です。

claude mcp add --transport http billdog https://api.billdog.io/mcp \
  --header "Authorization: Bearer bd_mcp_YOUR_KEY"

重要

bd_public_… と bd_secret_… のキーは、アプリ用の SDK キーであり、ここでは使用できません。いずれかを貼り付けると、サーバーがその旨を通知します。

質問できること

「iOS でペイウォールが表示されないのはなぜですか？」 → get_setup_status と resolve_placement_preview で、不足しているものをダッシュボードへのリンクとともに正確に確認できます。

「7 日間のトライアルと onboarding プレースメントを含む、月間および年間の Pro プランを設定してください。」 → apply_setup_plan で、商品、エンタイトルメント、オファリング、プレースメントを一度に作成できます。すべて非アクティブの状態で開始します。

「テンプレートから年間プラン用のダークなペイウォールを作成して、プレビューを見せてから公開してください。」 → list_templates → create_paywall_from_template → update_paywall → preview_paywall → publish_paywall

「先月の MRR はいくらで、最もコンバージョン率の高いペイウォールはどれですか？」 → run_analytics_query

「このアプリを RevenueCat から移行してください。」 → billdog-migration スキル（Claude Code プラグイン）が呼び出し箇所を書き換え、カタログを再作成します。

ツール

読み取り 27 件 · 書き込み 28 件 · 公開すると、本番ユーザーに表示される内容が変更され、公開権限が必要になります。 機械可読な一覧：tools.json。

セットアップと診断

分析

カタログ：製品、エンタイトルメント、オファリング、プレースメント

ペイウォール

実験と機能フラグ

プロジェクトと SDK キー

エンゲージメント：アンケート、キャンペーン、ジャーニー、メッセージ

権限と安全性

Claude Code プラグイン

/plugin install billdog@billdog を実行すると、サーバーと2つのスキルがインストールされます。

• billdog-integration：アプリ（Web、React Native、Expo、iOS、Android）に SDK を追加するか、すでに接続されているアプリの問題を診断します。識別子の注意点（@billdog.io であり @billdog ではないこと、io.billdog であり com.billdog ではないこと）、設定、プレースメント、検証チェックリストを扱います。
• billdog-migration：アプリを RevenueCat、Superwall、Adapty、Mixpanel、Amplitude、OneSignal、Braze、Typeform、SurveyMonkey から移行します。コードとデータの両方を扱います。

トラブルシューティング

リポジトリの構成

リポジトリのルートに1つのプラグインを、すべてのクライアントが読み取れるよう2つの形式で配置しています。

plugin.json                       Agent Plugins / Open Plugins manifest (Cursor, cursor.directory, other clients)
mcp.json                          Agent Plugins MCP config (streamable-http)
skills/                           billdog-integration, billdog-migration (shared by both formats)
.claude-plugin/marketplace.json   Claude Code marketplace (this repo)
.claude-plugin/plugin.json        Claude Code plugin manifest
.mcp.json                         Claude Code MCP config
server.json                       official MCP Registry entry
smithery.yaml                     Smithery (stdio bridge via mcp-remote)
glama.json                        Glama ownership claim
tools.json                        all 55 tools, grouped, with access level
assets/icon.png                   listing icon

リンク

• 📖 ドキュメント：billdog.io/docs/mcp-server
• 🧭 エージェント向け SDK 完全リファレンス：billdog.io/SKILL.md
• 🐛 課題：github.com/billdogai/billdog-mcp/issues