Skip to content
SPECIFICTION
Get listed

ChurnLens

github.com

WindowsmacOSLinuxAPISelf-hosted
Visit github.com
Spec score 7.7 #10 of 22 in Subscription Analytics Software

What it is

ChurnLens is a self-hosted SaaS metrics tool for calculating MRR, churn, and LTV from Stripe or CSV data. Its full report includes current MRR, ARR run-rate, active customers, average customer churn, and monthly figures such as net-new MRR and LTV. The `mrr` command breaks the latest month’s MRR movement into new, expansion, reactivation, contraction, and churned amounts. Reports can return JSON and use a chosen currency label, with USD as the default.

ChurnLens can recompute metrics from ledger updates and publish JSON to a BI or dashboard pipeline. It also lists SARIF output for code scanning, an MCP server for AI agents, and webhook forwarding for SIEM, Slack, and Jira. The README describes use through MCP, JSON piped into agents or LLMs, or CI with exit codes and SARIF. Installation options include pip, pipx, uv, Docker, Homebrew, and a shell script. It requires no account. The source-available license permits personal, internal evaluation, research, and educational use; commercial or production use requires a separate license. Pricing is on request.

Spec sheet

Purpose
ChurnLens is a self-hosted SaaS metrics tool for MRR, churn, and LTV using Stripe or CSV data.Read 5 Oct 2026 · github.com
Platforms
The README lists Linux, macOS, Windows, Docker, and cloud deployment on AWS, Azure, GCP, or Kubernetes.Read 5 Oct 2026 · github.com
Deployment
Installation options listed include pip, pipx, uv, Docker, Homebrew, and a shell install script.Read 5 Oct 2026 · github.com
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.Read 5 Oct 2026 · github.com
License
The Cognis Open Collaboration License allows personal, internal evaluation, research, and educational use; commercial or production use requires a separate license.Read 5 Oct 2026 · github.com
Headquarters
Sheridan, Wyoming, United StatesRead 28 Sep 2026 · github.com
Maker
Cognis Digital says it was founded in Wyoming in 2024 and gives its headquarters location as Wyoming, USA.Read 5 Oct 2026 · cognis.digital
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.Read 5 Oct 2026 · github.com
AI compatibility
The README names Claude Desktop, Cursor, and Cognis.Studio as MCP clients and also mentions LangChain, CrewAI, AutoGen, and LlamaIndex.Read 5 Oct 2026 · github.com
Automation
The README describes recomputing metrics from ledger updates and publishing JSON to a BI or dashboard pipeline.Read 5 Oct 2026 · github.com
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.Read 5 Oct 2026 · github.com
Maker location and founding
Cognis Digital says it was founded in Wyoming in 2024.Read 5 Oct 2026 · cognis.digital
Metrics report
Its report includes current MRR, ARR run-rate, active customers, average customer churn, and monthly MRR, churn, and LTV figures.Read 5 Oct 2026 · github.com
MRR movement
The mrr command breaks down latest-month MRR movement into new, expansion, reactivation, contraction, and churned MRR.Read 5 Oct 2026 · github.com
Output
The commands support JSON output and a currency label, with USD as the default currency.Read 5 Oct 2026 · github.com
Output formats
The report and mrr commands support JSON output and a currency label, with USD as the default.Read 5 Oct 2026 · github.com
Reports
Its full report includes current MRR, ARR run-rate, active customers, average customer churn, and monthly metrics including net-new MRR and LTV.Read 5 Oct 2026 · github.com
Security fixes
Until a tool reaches v1.0, the security policy says only the latest released version receives security fixes.Read 5 Oct 2026 · github.com
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.Read 5 Oct 2026 · github.com
Self-hosting
The repository describes ChurnLens as self-hostable and says it requires no account.Read 5 Oct 2026 · github.com
Supported security versions
Until the tool reaches v1.0, the security policy says only the latest released version receives security fixes.Read 5 Oct 2026 · github.com

Strong points and limits

Strong points

  • Reports MRR, ARR run-rate, churn, and LTV
  • Breaks down monthly MRR movement
  • Supports JSON output and configurable currency
  • Can be self-hosted without an account
  • Offers several installation options

Limits

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

Who it suits

ChurnLens suits teams that want to self-host SaaS metrics reporting from Stripe or CSV data and send JSON into other tools. It may also fit workflows using MCP, agents, or CI, provided the license terms fit the intended use.

Verdict

ChurnLens provides detailed SaaS metrics and multiple ways to feed results into other workflows. Confirm the separate license requirement for commercial or production use before adopting it.

Where Specifiction places it

Alternatives to ChurnLensAll alternatives →