Developer API & MCP — read-only v1

Plug your AI into your churn.

ChurnWin collects cancellation feedback and churn signals from your Stripe customers. The developer API and MCP server let your AI agent read that data and tell you what to build or fix to reduce churn — without writing a single SQL query.

Two ways to connect

Both options use the same API key, scoped to your ChurnWin account.

MCP server

Connect any MCP-compatible AI client (Claude, Cursor, Windsurf…) directly to ChurnWin. Your agent discovers all available tools automatically — no hand-written prompts needed.

MCP setup guide
REST API

Standard JSON over HTTPS. Point any HTTP-capable agent at https://api.churnwin.com/api/v1/agent and start querying. A machine-readable OpenAPI spec is available too.

REST API reference

What your agent can read

All endpoints are read-only in v1. Your data never leaves ChurnWin — the API key only grants read access.

Churn metrics & trend

Churn rate, MRR, retention over any period

At-risk customers

AI risk scores and signals for every subscriber

Churn reasons

Aggregated cancellation reason breakdown

Cancellation feedback

Verbatim survey responses from churned users

AI action plan

ChurnWin's prioritised retention recommendations

Recent churn

Latest churned customer list with MRR lost

Customer list

Full customer roster filterable by status

Feedback performance

Survey send/open/response rates over time

Businesses

All Stripe accounts connected to ChurnWin

Who it's for

Indie SaaS founders

Drop your MCP config into Claude and ask it what's driving churn this month — no dashboard diving.

Developer-led teams

Pipe churn data into your own AI workflows, internal tools, or Slack bots via the REST API.

AI-native builders

Build agents that cross-reference churn feedback with your product roadmap and suggest what to ship next.

Authentication

Every request requires an Authorization: Bearer cwk_live_… header. Keys are minted — and revoked — from Settings → Agent Access. You need an active ChurnWin plan to create keys.

Read-only scope — API keys cannot modify or delete your data.

MCP setup guide

Endpoint, config snippet, all 10 tools

REST API reference

All endpoints, params, and JSON examples