Stripe Founder Mcp

stripe-founder-mcp

個人で SaaS を運営する創業者向けの Stripe コパイロットです。MRR、解約率、決済失敗、離脱リスクのある顧客について、普段の英語で AI に質問できます。生の API 出力ではなく、創業者が実際に尋ねる質問に沿った回答が得られます。

ホスト型のマネージド版をお探しですか？ mcpize.com/mcp/stripe-founder からワンクリックでインストールできます。無料プランには月 200 件のリクエストが含まれます。

課題

Stripe の API は網羅的です。ダッシュボードで大半の質問には答えられますが、10 画面をクリックして回る必要があります。既存の Stripe MCP は薄い CRUD ラッパーで、AI が請求を一覧表示したり顧客オブジェクトを取得したりはできますが、創業者の質問には答えてくれません。

この MCP は、明確な方針に基づいて設計されています。各ツールは、創業者が朝起きて尋ねるような質問に対応しています。「MRR はいくら？」「解約しそうなのは誰？」「督促で決済失敗を回収できている？」といった質問です。計算はすべて自動で行われます。ツールは、LLM が自然に要約しやすい構造化データを返します。まず要点となる数値、次に補足情報、最後に明細データが並びます。

実際の利用イメージ

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 の手動呼び出しも不要です。

インストール

選択肢は 2 つあります。ワークフローに合う方を選んでください。

オプション A — ホスト型（推奨）

最も手軽に始められる方法です。Node のセットアップも、セルフホストも、インフラも不要です。

MCPize 経由でインストール →

Stripe キーを指定すれば、あとは MCPize が処理します。無料プランには有効期限なしで月 200 件のリクエストが含まれます。Pro プランは月額 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

その後、シェル環境またはプロジェクトの .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	1人の顧客の全体像：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クエリには対応していません。よくある質問への、あらかじめ用意された見解に基づく回答を提供します。
• ダッシュボードの代わりではありません。 Stripe Dashboardの代わりではなく、併用してください。

安全性

• 実行時に読み取り専用を強制します。 HTTPクライアントのレベルでガードがStripeへのGET以外のリクエストをブロックします。コードベースに書き込み経路は一切ありません。
• 制限付きキーを推奨します。 秘密鍵全体ではなく、読み取りアクセスのみに限定したrk_live_...を使用してください。
• テストモードを自動検出します。 キーがsk_test_またはrk_test_で始まる場合、すべてのツールの応答にstripe_mode: "test"が含まれるため、環境を取り違えることはありません。
• テレメトリーはありません。 StripeのAPIへの呼び出し以外で、データがマシンの外部に送信されることはありません。分析も外部ロギングもありません。

貢献

Issueやプルリクエストを歓迎します。バグを見つけた場合は、ツール名、渡した入力、期待した結果と実際の結果を添えてIssueを作成してください。ツールを追加する場合は、まずAGENTS.mdとSPEC.mdを読んでください。このプロジェクトには、ここに含める内容について明確な方針があります。

ライセンス

MIT