{"id":50111341,"url":"https://github.com/npow/stripe-analytics-mcp","last_synced_at":"2026-05-23T12:31:55.211Z","repository":{"id":340086487,"uuid":"1164467677","full_name":"npow/stripe-analytics-mcp","owner":"npow","description":"30-second Stripe morning check via MCP: MRR, churn, failed payments, and trial risk.","archived":false,"fork":false,"pushed_at":"2026-03-09T20:36:18.000Z","size":84,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-10T01:49:13.417Z","etag":null,"topics":["billing-analytics","churn-analytics","mcp","model-context-protocol","mrr","npm","saas-metrics","stripe","typescript"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/npow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-23T05:37:01.000Z","updated_at":"2026-03-09T20:36:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/npow/stripe-analytics-mcp","commit_stats":null,"previous_names":["npow/stripe-analytics-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/npow/stripe-analytics-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npow%2Fstripe-analytics-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npow%2Fstripe-analytics-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npow%2Fstripe-analytics-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npow%2Fstripe-analytics-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/npow","download_url":"https://codeload.github.com/npow/stripe-analytics-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npow%2Fstripe-analytics-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33396573,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["billing-analytics","churn-analytics","mcp","model-context-protocol","mrr","npm","saas-metrics","stripe","typescript"],"created_at":"2026-05-23T12:31:50.086Z","updated_at":"2026-05-23T12:31:55.205Z","avatar_url":"https://github.com/npow.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stripe-analytics-mcp\n\n[![CI](https://github.com/npow/stripe-analytics-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/npow/stripe-analytics-mcp/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/stripe-analytics-mcp)](https://www.npmjs.com/package/stripe-analytics-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node.js 18+](https://img.shields.io/badge/node-18+-blue.svg)](https://nodejs.org/) [![Docs](https://img.shields.io/badge/docs-mintlify-18a34a?style=flat-square)](https://mintlify.com/npow/stripe-analytics-mcp)\n\nAsk your AI assistant \"how's my business doing?\" and get your MRR, churn, failed payments, and expiring trials in one answer.\n\n## The problem\n\nYou check your Stripe dashboard for MRR, churn, and revenue breakdown every day. Stripe's official MCP server only does operations — create customers, send invoices. It can't tell you what your MRR is. ChartMogul and Baremetrics compute these metrics but cost $100+/month and have no MCP interface. You're switching between your editor and browser tabs just to check a number.\n\n## The morning check\n\n\u003e \"How's my business doing?\" / \"Morning check\" / \"What happened overnight?\"\n\nOne question, one answer, 30-second scan. Everything you'd normally check across 4 Stripe dashboard pages:\n\n```\nDashboard — 2026-02-24\n\nMRR: $4,280 (+$120 this week)\nSubscriptions: 42 active, 3 trialing, 1 past due\n\nMRR Movement (last 7 days)\n- New: +$198 (2 new customers)\n- Expansion: +$49 (1 upgrade)\n- Contraction: -$0\n- Churned: -$127 (1 cancellation)\n- Net: +$120\n\nQuick Ratio: 1.9 (healthy)\n\nFailed Payments (2 — $147 at risk)\n- alice@acme.com — $98 — card_declined — attempt 2\n- bob@startup.io — $49 — insufficient_funds — attempt 1\n\nTrials Expiring Soon (3 — $147 potential MRR)\n- carol@bigco.com — Pro — 2 days left — $49/mo\n- dave@agency.net — Basic — 1 day left — $19/mo\n- eve@freelance.co — Pro — 3 days left — $49/mo\n```\n\n## Recover failed payments\n\n\u003e \"Am I losing money to failed payments?\"\n\nFailed payments are the easiest revenue to recover — these customers already want to pay you. Get the list with failure reasons so you can reach out today:\n\n```\nFailed Payments\n\nTotal at risk: $245.00\nFailed invoices: 3\n\n| Customer          | Amount | Reason            | Attempts | Last Attempt | Plan |\n|-------------------|--------|-------------------|----------|--------------|------|\n| alice@acme.com    | $98.00 | card_declined     | 2        | 2026-02-23   | Pro  |\n| bob@startup.io    | $49.00 | insufficient_funds| 1        | 2026-02-22   | Pro  |\n| carol@agency.net  | $98.00 | expired_card      | 3        | 2026-02-21   | Pro  |\n```\n\n## Track MRR growth\n\n\u003e \"How did my MRR change this month?\"\n\nSee exactly where growth is coming from and where you're leaking:\n\n```\nMRR Movement — Last 30 days\n\nNet New MRR: +$840\n- New MRR: +$570 (from new customers)\n- Expansion MRR: +$390 (from upgrades)\n- Contraction MRR: -$49 (from downgrades)\n- Churned MRR: -$71 (from cancellations)\n```\n\n## Watch your trial funnel\n\nThe dashboard flags trials expiring within 3 days — customers about to decide whether to convert or leave. The highest-leverage moment to intervene.\n\n## Understand churn\n\n\u003e \"What's my churn rate?\"\n\nBoth customer churn and revenue churn — because losing one $500/mo customer hurts more than losing five $10/mo customers:\n\n```\nChurn Analysis — Last 30 days\n\nCustomer Churn Rate: 3.2%\nRevenue Churn Rate: 1.8%\nChurned Customers: 4\nChurned MRR: $127.00\n```\n\n## Know which plans work\n\n\u003e \"Which plan makes the most money?\"\n\n```\n| Plan       | Subscribers | MRR       | % of Total |\n|------------|-------------|-----------|------------|\n| Pro        | 28          | $2,744.00 | 64.1%      |\n| Basic      | 35          | $665.00   | 15.5%      |\n| Enterprise | 3           | $871.00   | 20.4%      |\n```\n\n## Quick start\n\n```bash\nSTRIPE_SECRET_KEY=sk_test_... npx stripe-analytics-mcp\n```\n\nThen ask your AI assistant: \"How's my business doing?\"\n\n## Install\n\n```bash\nnpx stripe-analytics-mcp\n```\n\nAdd to your Claude Code / Cursor / Windsurf MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"stripe-analytics\": {\n      \"command\": \"npx\",\n      \"args\": [\"stripe-analytics-mcp\"],\n      \"env\": {\n        \"STRIPE_SECRET_KEY\": \"sk_test_...\"\n      }\n    }\n  }\n}\n```\n\n## How it works\n\nConnects to Stripe (read-only), computes metrics from live subscription data, returns markdown your AI assistant renders naturally.\n\n- **MRR**: Sums subscription items, normalizes annual/weekly to monthly, applies discounts, excludes trials\n- **Movement**: Tracks new, expansion, contraction, and churn MRR from Stripe events\n- **Quick Ratio**: (New + Expansion) / (Contraction + Churn) — above 1.0 means growing\n- **Failed payments**: Scans open invoices with failed attempts\n- **Trials**: Identifies trialing subscriptions about to expire\n\nStateless — every query hits Stripe fresh. No data cached. No database. No account needed.\n\n## Configuration\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `STRIPE_SECRET_KEY` | Yes | Stripe secret key (`sk_test_...` or `sk_live_...`). Read-only access is sufficient. |\n\n## Development\n\n```bash\ngit clone https://github.com/npow/stripe-analytics-mcp\ncd stripe-analytics-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnpow%2Fstripe-analytics-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnpow%2Fstripe-analytics-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnpow%2Fstripe-analytics-mcp/lists"}