co.churnkey/churnkey MCP Server
co.churnkey/churnkey
Query Churnkey cancel flows, retention metrics, and payment recovery data via Claude and Cursor.
What is the co.churnkey/churnkey MCP server?
The Churnkey MCP server lets Claude, Cursor, and other AI agents access your Churnkey data through a Data API key. It exposes tools to query cancel flow sessions, analytics, and data subject requests (DSR), enabling AI-powered retention insights and automation.
Churnkey is a production-ready cancel flow platform for SaaS. This MCP server bridges Churnkey's analytics and retention data to AI agents, letting you query session history, retention metrics, and compliance data directly from Claude or Cursor without manual API calls.
How to install co.churnkey/churnkey
Copy-paste configuration for popular MCP clients.
Tools & capabilities
Tools this server exposes to the agent.
Query cancel flow sessions— Retrieve Churnkey cancel flow session data and historyAccess retention analytics— Query retention metrics and analytics from ChurnkeyData subject requests (DSR)— Handle and query data subject request information
Use cases
- Ask Claude to analyze why customers are churning based on Churnkey survey responses
- Query retention metrics and payment recovery data to inform business decisions
- Automate compliance workflows by accessing DSR data through AI agents
- Generate churn insights and retention recommendations from session analytics
- Integrate Churnkey data into AI-powered customer retention workflows
co.churnkey/churnkey MCP server FAQ
It's a Model Context Protocol server that connects Claude, Cursor, and other AI agents to your Churnkey cancel flow platform, allowing them to query sessions, analytics, and compliance data via a Data API key.
Churnkey offers a free SDK for building cancel flows. The hosted platform and AI retention features require a paid account; you can create a free account at app.churnkey.co/register.
The MCP server is available at https://mcp.churnkey.co/mcp (remote/streamable-http). Add it to your MCP configuration in Cursor or Claude Desktop, and provide a Churnkey Data API key for authentication.
You need a Churnkey Data API key to authenticate the MCP server. Generate one in your Churnkey dashboard.
No, you need a Churnkey account and a Data API key to use this MCP server.
You can query cancel flow sessions, retention analytics, payment recovery data, and data subject request (DSR) information from your Churnkey account.
README (reference)
Source of truth, from the repository.
Churnkey SDK
A production-ready cancel flow for React. Open source. Optionally connects to Churnkey for analytics and AI-powered retention.
Packages
| Package | Description |
|---|---|
@churnkey/react | The cancel flow. Drop-in component, headless hook, or core state machine. React 18 and 19. |
@churnkey/node | Server-side token generation. Only needed if Churnkey is handling billing actions for you, or if you're using the hosted embed. |
@churnkey/mcp | Model Context Protocol server. Lets Claude, Cursor, and other AI agents query your Churnkey data (sessions, analytics, DSR) using a Data API key. |
Quick start
npm install @churnkey/react
import { CancelFlow } from '@churnkey/react'
import '@churnkey/react/styles.css'
<CancelFlow
steps={[
{
type: 'survey',
title: 'Why are you leaving?',
reasons: [
{
id: 'expensive',
label: 'Too expensive',
offer: { type: 'discount', couponId: 'STRIPE_SAVE20', percentOff: 20, durationInMonths: 3 },
},
{ id: 'not-using', label: 'Not using it enough', offer: { type: 'pause', months: 2 } },
{ id: 'missing', label: 'Missing features' },
],
},
{ type: 'feedback', title: 'Anything else?' },
{ type: 'confirm' },
]}
handleDiscount={async (offer) => myBilling.applyCoupon(offer.couponId)}
handlePause={async (offer) => myBilling.pause({ months: offer.months })}
handleCancel={async () => myBilling.cancel()}
onClose={() => setOpen(false)}
/>
Documentation and resources
@churnkey/react— full API reference, customization, headless usage, custom step types@churnkey/node—createTokenandauthHash@churnkey/mcp— MCP server for Claude / Cursor / Claude Desktop- Create a free Churnkey account — get an
appIdfor analytics - churnkey.co — dashboard, hosted embed, AI retention features
Repo layout
sdk/
├── packages/
│ ├── react/ @churnkey/react
│ ├── node/ @churnkey/node
│ └── mcp/ @churnkey/mcp
├── apps/
│ └── playground/ internal dev playground
└── scripts/ release + tooling helpers
Local development
pnpm install
pnpm --filter @churnkey/react build
pnpm --filter @churnkey/react test
To work against the playground:
pnpm --filter @churnkey/react dev # rebuilds on change
pnpm --filter @churnkey/playground dev # runs the playground app
License
MIT
Related MCP servers
I do everything related to Google Blogger content
I do everything related to Browser Automation & Management
I do everything related to calendar scheduling
I do everything related to coding and execution tasks
I create markdown content calendars and export them as PDFs via PDF Generator MCP
I do everything related to Gmail and productivity