stripe-insights

Stripe Revenue Intelligence for AI Agents — MRR, churn, forecasts & customer insights without leaving your AI workflow.

Works with: Claude Desktop | Claude Code | Cursor | Windsurf | Cline | Any MCP client

Quick Start

Add this to your MCP client config:

{
  "mcpServers": {
    "stripe-insights": {
      "command": "npx",
      "args": ["-y", "stripe-insights@latest"],
      "env": {
        "STRIPE_API_KEY": "sk_live_..."
      }
    }
  }
}

Claude Desktop: Settings > Developer > Edit Config Cursor: Settings > MCP > Add Server Claude Code: claude mcp add stripe-insights -- npx -y stripe-insights@latest

Tools

| Tool | Description | |------|-------------| | get_mrr | Current MRR with breakdown by plan, ARPU, subscriber count | | get_mrr_trend | MRR growth over N months — new, expansion, contraction, churn breakdown | | get_churn_rate | Customer & revenue churn rates with churned customer details | | get_failed_payments | Failed payments, at-risk revenue, recovery status | | get_top_customers | Top customers by LTV/MRR with concentration risk analysis | | get_revenue_forecast | 3-scenario revenue projection (optimistic/base/pessimistic) | | get_revenue_summary | Executive health check — score + flags + natural language summary |

Examples

Ask your AI assistant:

"What's my current MRR?"

"Show me MRR growth over the last 6 months"

"What's my churn rate? Which customers churned recently?"

"Are there any failed payments I should worry about?"

"Give me a revenue health check"

Configuration

| Variable | Required | Description | |----------|----------|-------------| | STRIPE_API_KEY | Yes | Your Stripe Secret Key (sk_live_... or sk_test_...) |

Your API key needs read access to: Subscriptions, Invoices, Charges, Customers.

Why stripe-insights?

| | Stripe Dashboard | Baremetrics ($108+/mo) | stripe-insights | |---|---|---|---| | MRR + trend | Basic | Yes | Yes | | Churn analysis | Limited | Yes | Yes | | Revenue forecast | No | Yes | Yes | | AI-native (MCP) | No | No | Yes | | Price | Free | $108+/mo | Free |

Development

git clone https://github.com/your-username/stripe-insights.git
cd stripe-insights
npm install

npm run build
npm test              # unit tests
npm run test:e2e      # end-to-end tests
npm run test:all      # both

npm run inspect       # debug with MCP Inspector
npm run dev           # watch mode

License

MIT