MCP server — read-only v1

Connect your AI agent via MCP

MCP (Model Context Protocol) is an open standard that lets AI clients discover and call tools on your behalf. Add ChurnWin's MCP server to Claude, Cursor, or any compatible client and your agent can query churn data, at-risk customers, and cancellation feedback without any custom code.

Connection details

Endpoint

https://api.churnwin.com/mcp/

Auth header

Authorization: Bearer cwk_live_…

Keys are minted at Settings → Agent Access. You need an active ChurnWin plan to create one.

Copy-paste config

Drop this into your MCP client config (e.g. claude_desktop_config.json for Claude Desktop, or the MCP settings panel in Cursor / Windsurf).

{
  "mcpServers": {
    "churnwin": {
      "url": "https://api.churnwin.com/mcp/",
      "headers": {
        "Authorization": "Bearer cwk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Replace cwk_live_YOUR_KEY_HERE with the key you generated in Settings.

Available tools

Your AI client will see these 10 tools automatically once the server is connected. All tools accept an optional business parameter to scope results to a specific connected Stripe account.

get_metrics

Current churn rate, MRR, retention, and subscription counts for a given period

get_churn_trend

Day-by-day churn volume over a rolling window

get_churn_reasons

Aggregated cancellation reason breakdown with percentages

list_at_risk_customers

Subscribers ranked by AI risk score with key risk signals

list_recent_churn

Most recently churned customers and MRR lost

get_cancellation_feedback

Verbatim survey responses from churned users

get_action_plan

ChurnWin's AI-generated prioritised retention recommendations

get_feedback_performance

Survey send, open, and response rates over time

list_customers

Full customer roster with status, plan, and MRR — paginated and searchable

list_businesses

All Stripe accounts connected to your ChurnWin workspace

Try it with Claude

Once connected, you can ask Claude natural-language questions about your churn:

You: What are my top churn reasons this quarter and what should I fix first?

→ Claude calls get_churn_reasons, get_action_plan, and get_cancellation_feedback automatically, then synthesises an answer.

Get your API key

You need a ChurnWin account with Stripe connected. Once you're in, head to Settings → Agent Access to mint a key.

Start free Go to Agent Access

Developer overview

What the API gives you, who it's for

REST API reference

All endpoints, params, and JSON examples