BillDog

BillDog 通过一个 SDK 为 iOS、Android、React Native、Flutter、Expo 和 Web 提供付费墙、应用内购买、订阅、分析、消息、问卷和用户旅程。此仓库介绍 AI Agent 如何连接到它：

• 托管的 MCP 服务。 55 个工具：诊断集成、构建产品目录、设计并发布付费墙，以及查询收入和留存情况。
• Claude Code 插件。 包含服务和两个技能：将 SDK 接入应用，以及从 RevenueCat、Superwall、Adapty 等迁移。

无需在你的计算机上运行任何内容。该服务由 BillDog 托管，所有客户端都连接到同一个 URL。

安装

你需要在 billdog.io 拥有一个免费的 BillDog 账户，并且至少有一个项目。

首次运行工具时，浏览器会打开 使用 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 登录

该服务使用 OAuth 2.1、PKCE 和动态客户端注册，因此你的客户端会自行注册并完成身份验证：

1. 客户端从服务的 401 响应中发现授权服务器（RFC 9728）。
2. 客户端注册自身，并在浏览器中打开 BillDog。
3. 你登录、选择一个项目，并选择允许 Agent 执行的操作。
4. Agent 会获得一个仅适用于该项目的短期令牌。令牌会自动刷新，你也可以随时断开连接。

改用密钥

对于脚本、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 会准确显示缺少哪些内容，并提供控制面板链接。

“设置月度和年度 Pro 套餐，提供 7 天试用期，并创建一个 onboarding placement。” → apply_setup_plan 一步创建产品、权益、产品方案和 placement。所有内容初始均为未启用状态。

“从模板为年度套餐设计一个深色付费墙，给我看看预览，然后发布。” → 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 会为你安装服务和两个技能：

• billdog-integration：将 SDK 添加到应用（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 迁移。涵盖代码和数据。

故障排除

仓库布局

仓库根目录中有一个插件，提供两种格式，方便所有客户端读取：

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
• 🧭 面向 Agent 的完整 SDK 参考：billdog.io/SKILL.md
• 🐛 问题反馈：github.com/billdogai/billdog-mcp/issues