FREEDOM251

Freedom251 › Subscription Analytics Software

ChurnLens

Paid APILinuxMacSelf-hostedWindows

Visit ChurnLens Alternatives

ChurnLens's own site

What ChurnLens is

ChurnLens is a self-hosted SaaS metrics tool for analyzing subscription revenue and customer retention from Stripe or CSV billing data. Its reports cover current MRR, ARR run-rate, active customers, average customer churn, and monthly figures such as net-new MRR and LTV. The `mrr` command explains the latest month’s change in recurring revenue across new, expansion, reactivation, contraction, and churned MRR. Reports and commands can return JSON and accept a currency label, with USD as the default. You can recompute metrics as ledger data changes and publish the resulting JSON to a BI or dashboard pipeline. ChurnLens also supports SARIF output for code scanning, an MCP server for AI agents, and webhook forwarding for SIEM, Slack, and Jira. The README names Claude Desktop, Cursor, and Cognis.Studio as MCP clients, and LangChain, CrewAI, AutoGen, and LlamaIndex as compatible frameworks. It runs on Linux, macOS, and Windows, and can be installed through pip, pipx, uv, Docker, Homebrew, or a shell script. Cognis Digital is based in Sheridan, Wyoming. ChurnLens requires no account, but its source-available license requires a separate license for commercial or production use. Pricing is on request.

Who it suits

ChurnLens suits teams that want to calculate MRR, churn, LTV, and related subscription metrics from Stripe or CSV data while hosting the tool themselves. Its JSON, MCP, CI, and webhook options also fit teams connecting metrics to dashboards, AI agents, code scanning, or notification systems.

What it does well

  • Reports include MRR, ARR run-rate, active customers, churn, and LTV.
  • Breaks down monthly MRR movement into five categories.
  • Accepts Stripe or CSV billing data.
  • Supports JSON, SARIF, MCP, and webhook forwarding.
  • Runs on Linux, macOS, and Windows.

What to know first

  • Commercial or production use requires a separate license.
  • Pricing is available on request.
  • Only the latest release receives security fixes before v1.0.

Limits

The source-available license allows personal, internal evaluation, research, and educational use; commercial or production use requires a separate license. Before v1.0, security fixes are provided only for the latest released version.

Getting started

  1. Visit the ChurnLens project on GitHub.
  2. Choose an installation route: pip, pipx, uv, Docker, Homebrew, or the shell install script.
  3. Provide Stripe or CSV billing data.
  4. Run the report or `mrr` command and select JSON output or a currency label if needed.
  5. Connect the JSON, MCP, SARIF, or webhook output to your intended workflow.

Verdict

Choose ChurnLens if you need self-hosted subscription metrics and want to send results into dashboards, AI tools, CI, or webhook destinations. Look elsewhere if you need commercial use under the included license or a published price before evaluating it.

Questions

What does ChurnLens cost?

Its pricing model is paid, with pricing available on request.

What data can it use?

ChurnLens uses Stripe or CSV billing data.

Does it require an account?

The repository describes ChurnLens as requiring no account.

Which operating systems does it support?

It supports Linux, macOS, and Windows, as well as API and self-hosted use.

Can it be used commercially?

Commercial or production use requires a separate license. The included license permits personal, internal evaluation, research, and educational use.

Who makes ChurnLens?

It is made by Cognis Digital, which says it was founded in Wyoming in 2024 and is headquartered in Sheridan, Wyoming, United States.

Facts from ChurnLens's own pages

AI and CI usage
The README says ChurnLens can be used through MCP, piped as JSON into agents or LLMs, or in CI with exit codes and SARIF. · github.com, 5 Oct 2026
AI compatibility
The README names Claude Desktop, Cursor, and Cognis.Studio as MCP clients and also mentions LangChain, CrewAI, AutoGen, and LlamaIndex. · github.com, 5 Oct 2026
Automation
The README describes recomputing metrics from ledger updates and publishing JSON to a BI or dashboard pipeline. · github.com, 5 Oct 2026
Deployment
Installation options listed include pip, pipx, uv, Docker, Homebrew, and a shell install script. · github.com, 5 Oct 2026
Headquarters
Sheridan, Wyoming, United States · github.com, 28 Sept 2026
Integrations
The README lists CSV input, JSON output, SARIF for code scanning, an MCP server for AI agents, and a webhook forwarder for SIEM, Slack, and Jira. · github.com, 5 Oct 2026
License
The Cognis Open Collaboration License allows personal, internal evaluation, research, and educational use; commercial or production use requires a separate license. · github.com, 5 Oct 2026
License and commercial use
The source-available COCL v1.0 license permits personal, internal evaluation, research, and educational use; commercial use requires a separate license. · github.com, 5 Oct 2026
Maker
Cognis Digital says it was founded in Wyoming in 2024 and gives its headquarters location as Wyoming, USA. · cognis.digital, 5 Oct 2026
Maker location and founding
Cognis Digital says it was founded in Wyoming in 2024. · cognis.digital, 5 Oct 2026
Metrics report
Its report includes current MRR, ARR run-rate, active customers, average customer churn, and monthly MRR, churn, and LTV figures. · github.com, 5 Oct 2026
MRR movement
The mrr command breaks down latest-month MRR movement into new, expansion, reactivation, contraction, and churned MRR. · github.com, 5 Oct 2026
Output
The commands support JSON output and a currency label, with USD as the default currency. · github.com, 5 Oct 2026
Output formats
The report and mrr commands support JSON output and a currency label, with USD as the default. · github.com, 5 Oct 2026
Platforms
The README lists Linux, macOS, Windows, Docker, and cloud deployment on AWS, Azure, GCP, or Kubernetes. · github.com, 5 Oct 2026
Purpose
ChurnLens is a self-hosted SaaS metrics tool for MRR, churn, and LTV using Stripe or CSV data. · github.com, 5 Oct 2026
Reports
Its full report includes current MRR, ARR run-rate, active customers, average customer churn, and monthly metrics including net-new MRR and LTV. · github.com, 5 Oct 2026
Security fixes
Until a tool reaches v1.0, the security policy says only the latest released version receives security fixes. · github.com, 5 Oct 2026
Security reporting
The security policy asks users to report vulnerabilities privately by email and says the team aims to acknowledge reports within three business days. · github.com, 5 Oct 2026
Self-hosting
The repository describes ChurnLens as self-hostable and says it requires no account. · github.com, 5 Oct 2026
Supported security versions
Until the tool reaches v1.0, the security policy says only the latest released version receives security fixes. · github.com, 5 Oct 2026

Where ChurnLens stands on Freedom251

Look at these too