Skip to content
MCP server

RetentionCheck

Pull churn from Stripe, Postgres, MySQL, or pasted feedback. AI-ranked drivers + fixes.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.6.2
Listing updated
4 days ago

About RetentionCheck

RetentionCheck is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add retentioncheck-mcp-server --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env STRIPE_SECRET_KEY='<STRIPE_SECRET_KEY>' --env POSTGRES_URL='<POSTGRES_URL>' --env MYSQL_URL='<MYSQL_URL>' -- npx -y @retentioncheck/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "retentioncheck-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@retentioncheck/mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>",
        "POSTGRES_URL": "<POSTGRES_URL>",
        "MYSQL_URL": "<MYSQL_URL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "retentioncheck-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@retentioncheck/mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>",
        "POSTGRES_URL": "<POSTGRES_URL>",
        "MYSQL_URL": "<MYSQL_URL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "retentioncheck-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@retentioncheck/mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>",
        "POSTGRES_URL": "<POSTGRES_URL>",
        "MYSQL_URL": "<MYSQL_URL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "retentioncheck-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@retentioncheck/mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>",
        "POSTGRES_URL": "<POSTGRES_URL>",
        "MYSQL_URL": "<MYSQL_URL>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "retentioncheck-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@retentioncheck/mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>",
        "POSTGRES_URL": "<POSTGRES_URL>",
        "MYSQL_URL": "<MYSQL_URL>"
      }
    }
  }
}

Configuration

  • ANTHROPIC_API_KEYAnthropic API key for running churn analysis (required for analyze_churn, analyze_stripe_churn, and analyze_sql_churn; get_example_analysis works without it).
  • STRIPE_SECRET_KEYStripe API key for analyze_stripe_churn. Use a RESTRICTED (read-only) key with these permissions: Subscriptions Read, Customers Read, Prices Read. Create one at https://dashboard.stripe.com/apikeys/create. Optional — only required for the analyze_stripe_churn tool.
  • POSTGRES_URLPostgres connection string for analyze_sql_churn when dialect='postgres'. Format: postgres://user:pass@host:5432/db?sslmode=require. Use a READ-ONLY user — see retentioncheck.com/integrations for the exact GRANT SQL. Optional — only required for the analyze_sql_churn tool with postgres dialect.
  • MYSQL_URLMySQL connection string for analyze_sql_churn when dialect='mysql'. Format: mysql://user:pass@host:3306/db?ssl=true. Use a READ-ONLY user — see retentioncheck.com/integrations for the exact GRANT SQL. Optional — only required for the analyze_sql_churn tool with mysql dialect.
  • RETENTIONCHECK_TELEMETRYSet to 0 to opt out of anonymous usage telemetry. Telemetry tracks tool invocations and aggregate counts — never the feedback text, financial values, or any PII.

Pricing

Open source

Prices change. Check retentioncheck.com before you buy.

RetentionCheck FAQ

Is RetentionCheck free?

Yes. RetentionCheck is open source, so you can use and self-host it for free.

How do I add RetentionCheck to Claude Code?

Run this command in your terminal: claude mcp add retentioncheck-mcp-server --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env STRIPE_SECRET_KEY='<STRIPE_SECRET_KEY>' --env POSTGRES_URL='<POSTGRES_URL>' --env MYSQL_URL='<MYSQL_URL>' -- npx -y @retentioncheck/mcp-server

What are the best alternatives to RetentionCheck?

The closest alternatives to RetentionCheck are Midplane, PlatypusDB, Lorebase, Sovaria and model2data studio.

Alternatives to RetentionCheck

  1. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  2. PlatypusDB

    MCP server

    Gives MCP clients access to your PlatypusDB database connections, scoped per agent

    Runs locally
    • Open source
    • Databases
  3. Lorebase

    MCP server

    Lets agents read and change a governed, versioned Postgres knowledge graph

    Runs locally
    • Open source
    • Knowledge and memory
  4. Sovaria

    MCP server

    Manage a Sovaria backend (Postgres, auth, storage, functions) from an AI assistant

    Not checked yet
    • 4 tools
    • Remote
    • Freemium
    • Databases
  5. Generate realistic connected test data, dbt projects and dashboards from a schema

    • Remote
    • Freemium
    • Databases
  6. semlayer

    MCP server

    Infers a semantic layer from your data warehouse and serves it to agents

    Runs locally
    • Free
    • Databases