Stripe Founder Mcp

stripe-founder-mcp

为独立 SaaS 创始人打造的 Stripe 副驾驶。用通俗的语言向 AI 询问 MRR、客户流失、付款失败和高风险客户，获得的回答会围绕创始人真正会问的问题展开，而不是原始 API 数据倾倒。

更喜欢托管服务？ 从 mcpize.com/mcp/stripe-founder 一键安装。免费套餐每月包含 200 次请求。

问题所在

Stripe 的 API 面面俱到。控制面板能回答大多数问题，但需要点击十个页面。现有的 Stripe MCP 都只是简单的 CRUD 包装器——它们能让 AI 列出付款或检索客户对象，却无法回答创始人的问题。

这个 MCP 有明确的设计主张。每个工具都对应创始人醒来后会问的问题：“我的 MRR 是多少？”“谁快要流失了？”“催款流程挽回了多少失败的付款？”计算由工具代劳。工具返回结构化数据，便于大模型自然地总结——先给出关键数字，再提供背景信息，最后列出原始明细。

实际使用效果

你正在使用 Claude Code 或 Cursor。提出问题后，AI 会调用合适的工具，并用通俗的语言回答：

You: What's my MRR right now and how does it compare to last month?

AI: Your MRR is $4,820, up 12.3% from $4,292 last month. You have 47 active
    subscriptions. There are also 3 trials in progress worth an additional
    $147/mo if they convert.

You: Who's at risk of churning this week?

AI: 4 customers, $680 MRR at risk. Top concern is acme-corp.com ($290/mo,
    3 failed payment attempts, last retry failed 6 hours ago). Two others
    are past-due, one has a payment method that just expired.

You: How well is dunning recovering failed payments this month?

AI: 50% recovery rate on 14 failed payments — but only 4 have reached a
    final outcome. 2 recovered ($310 in revenue), 2 final failures, 10
    still in retry. Top unrecovered: $290 from acme-corp.com.

无需 SQL，无需点击控制面板，也无需手动调用 API。

安装

有两种方式可选。选择最适合你工作流的一种。

选项 A — 托管服务（推荐）

最快的入门方式。无需配置 Node，无需自托管，也无需基础设施。

通过 MCPize 安装 →

提供 Stripe 密钥后，其余工作由 MCPize 处理。免费套餐每月包含 200 次请求，且永不过期。专业版套餐为每月 14 美元，包含 5,000 次请求，超额费用可预期。

选项 B — 自托管

自行运行，永久免费，完全掌控。

需要 Node 20 或更高版本。

1. 创建 Stripe 受限密钥，并在 dashboard.stripe.com/apikeys 设置只读权限。MCP 需要读取账单数据：客户、订阅、付款、发票、付款意图、产品、价格和争议。

2. 添加到 MCP 客户端配置中：

Claude Desktop

配置文件：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）

{
  "mcpServers": {
    "stripe-founder": {
      "command": "npx",
      "args": ["-y", "stripe-founder-mcp"],
      "env": {
        "STRIPE_API_KEY": "rk_live_..."
      }
    }
  }
}

Cursor

配置文件：~/.cursor/mcp.json

{
  "mcpServers": {
    "stripe-founder": {
      "command": "npx",
      "args": ["-y", "stripe-founder-mcp"],
      "env": {
        "STRIPE_API_KEY": "rk_live_..."
      }
    }
  }
}

Claude Code

claude mcp add stripe-founder -- npx -y stripe-founder-mcp

然后在 shell 环境或项目 .env 文件中设置 STRIPE_API_KEY=rk_live_...。

从源代码进行开发

git clone https://github.com/PrimeEcto/stripe-founder-mcp.git
cd stripe-founder-mcp
npm install
cp .env.example .env   # then fill in your STRIPE_API_KEY
npm run dev

工具

工具	可回答的问题
get_mrr	当前 MRR 与对比时段的变化量，以及单独跟踪的试用订阅潜在 MRR
get_growth_metrics	某时段的新 MRR、流失 MRR、扩张、净新增 MRR 和增长率
get_churn_summary	流失数量、自愿与非自愿流失、总流失率／净流失率，以及主要取消原因
get_failed_payment_recovery_rate	催款效果如何——追回率、追回收入，以及主要未追回的付款失败
list_at_risk_customers	因逾期或多次付款失败而面临流失风险的客户
list_recent_signups	指定日期范围内的新客户，以及其 MRR 贡献和付款方式状态
list_disputes	有待处理的拒付及其证据提交期限，也可筛选已胜诉／败诉的拒付
get_customer_profile	单个客户的完整信息：LTV、套餐、付款状态和近期时间线
get_support_context	处理支持工单所需的全部信息：风险标记、符合退款条件的扣款，以及按优先级排序的时间线

所有基于时间的工具都接受易读的日期范围："last_30_days"、"this_month"、"2026-Q1"、"March 2026" 或明确的 ISO 范围。

get_customer_profile 和 get_support_context 接受电子邮件、姓名或 Stripe 客户 ID——无需先查找 ID。

本工具不是什么

• 不是写入工具。 它无法创建产品、发放退款或取消订阅。其设计为只读。
• 不是 Stripe Sigma。 不支持 SQL 查询——这些工具针对常见问题提供预先构建的、观点明确的答案。
• 不是 Dashboard 的替代品。 请搭配 Stripe Dashboard 使用，而非取而代之。

安全

• 运行时强制只读。 防护机制会在 HTTP 客户端层拦截任何非 GET 的 Stripe 请求。代码库中没有任何写入路径。
• 建议使用受限密钥。 使用仅限读取权限的 rk_live_...，而非完整的密钥。
• 自动检测测试模式。 如果密钥以 sk_test_ 或 rk_test_ 开头，每个工具响应都会包含 stripe_mode: "test"，避免混淆环境。
• 无遥测。 除了向 Stripe API 发出的请求，不会有任何数据离开你的计算机。没有分析，也没有外部日志记录。

贡献

欢迎提交问题和拉取请求。如果发现 Bug，请提交问题，并注明工具名称、传入的输入以及预期结果与实际结果。如果想添加工具，请先阅读 AGENTS.md 和 SPEC.md——本项目对适合纳入的内容有明确要求。

许可证

MIT