@retentioncheck/mcp-server

@retentioncheck/mcp-server

MCP server for AI-powered churn analysis. Analyze customer cancellation feedback to identify churn patterns, severity ratings, and actionable recommendations.

Tools

analyze_churn

Analyze cancellation feedback to identify why customers are leaving.

Input:

• feedback (string, required) — cancellation responses, one per line
• focus (string, optional) — narrow analysis to a specific area (e.g., "pricing")

Output: Structured JSON with executive summary, priority action, and categorized insights (reason, count, percentage, severity, confidence, examples, recommendation).

get_example_analysis

See a pre-computed example analysis. No API key required.

Input:

• scenario (string, optional) — "b2b-saas" (default), "consumer-app", or "pricing"

Installation

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .claude.json):

{
  "mcpServers": {
    "retentioncheck": {
      "command": "npx",
      "args": ["-y", "@retentioncheck/mcp-server"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to Cursor MCP settings with the same configuration.

Requirements

• Node.js 20+
• Anthropic API key (for analyze_churn tool only)

Example Usage

Ask your AI assistant:

• "Analyze my cancellation feedback" (then paste your data)
• "Show me an example churn analysis"
• "Why are my customers churning?" (then provide feedback)

Full App

For history, trend tracking, PDF exports, team sharing, and more: retentioncheck.com

Anonymous Telemetry

Starting in 0.2.0, this package sends anonymous usage events to help us understand which tools are used and how. We track:

• A randomly generated install ID (UUID, persisted to ~/.retentioncheck-mcp/install-id.json)
• Which tool was called (analyze_churn or get_example_analysis)
• Whether the call succeeded or failed (and a generic error category if it failed)
• Item count for analyze_churn (how many feedback rows were analyzed)
• MCP server version, Node version, platform/arch

We do NOT track:

• The feedback text itself
• Your Anthropic API key or any credentials
• Any PII, IP address, hostname, or user identity

To opt out, set RETENTIONCHECK_TELEMETRY=0 in your MCP server's env config:

{
  "mcpServers": {
    "retentioncheck": {
      "command": "npx",
      "args": ["-y", "@retentioncheck/mcp-server"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here",
        "RETENTIONCHECK_TELEMETRY": "0"
      }
    }
  }
}

You can also delete ~/.retentioncheck-mcp/install-id.json at any time to reset your anonymous install ID.

License

MIT