Churnkey MCP server
Commit Nov 13, 2026Lets AI agents query Churnkey cancel flow data, retention analytics, and data subject requests using a Data API key.
Also known as churnkey/sdk, sdk
- Stars
- 24
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.5.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is Churnkey MCP?
Churnkey lets AI agents query Churnkey cancel flow data, retention analytics, and data subject requests using a Data API key.
Summary generated from the project's README
About Churnkey MCP server
Querying Churnkey cancel flow data and retention analytics from within AI agents is what this server enables. It allows developers to connect tools like Claude, Cursor, or Claude Desktop to their Churnkey account to inspect specific business metrics directly through a chat interface.
To use this server, you must provide a Data API key. It provides access to several distinct data categories, including user sessions, retention analytics, and data subject requests. This allows an AI client to act as a data analyst for your subscription business by retrieving information about why users are leaving and how they interact with your cancel flows.
What you can do with it
- 1Analyze user churn reasonsAsk an AI agent to summarize the primary reasons users are canceling their subscriptions based on recent survey data.
- 2Monitor retention metricsRequest a report on retention analytics to understand how different offers impact user churn.
- 3Manage data privacy requestsUse an AI assistant to identify and track pending data subject requests within your Churnkey account.
Written from the project's README. Every use case is checked against a quote from it.
How to install Churnkey MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Churnkey MCP in Claude Code
$ claude mcp add --transport http sdk https://mcp.churnkey.co/mcpInstall Churnkey MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sdk": {
"url": "https://mcp.churnkey.co/mcp"
}
}
}Install Churnkey MCP in VS Code
.vscode/mcp.json
{
"servers": {
"sdk": {
"type": "http",
"url": "https://mcp.churnkey.co/mcp"
}
}
}Install Churnkey MCP in VS Code CLI
$ code --add-mcp '{"name":"sdk","type":"http","url":"https://mcp.churnkey.co/mcp"}'Install Churnkey MCP in Codex
$ codex mcp add sdk --url https://mcp.churnkey.co/mcpInstall Churnkey MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.sdk] url = "https://mcp.churnkey.co/mcp"
Install Churnkey MCP in Gemini CLI
$ gemini mcp add -s user --transport http sdk https://mcp.churnkey.co/mcpInstall Churnkey MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sdk": {
"url": "https://mcp.churnkey.co/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablechurnkey/sdk is public and reachablegithub.com/churnkey/sdk ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/churnkey/sdk ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubChurnkey 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.result?.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
Releasing
A merge to main that raises a package's package.json version publishes it. In the PR:
- Bump
versionin the package'spackage.json. - Move the
Unreleasedentries in itsCHANGELOG.mdunder a## <version> - <date>heading. That section becomes the GitHub release notes. - Move the copies of the version kept in code:
server.jsonandsrc/server.tsfor@churnkey/mcp,src/index.tsfor@churnkey/node. The release plan refuses to run while they disagree withpackage.json.
On merge, the Release workflow checks out the commit that set the version (the merge or squash commit on main; rebase merging is off for this reason), runs the CI gate, publishes that build to npm with provenance, tags it <name>@<version> and creates the GitHub release. For @churnkey/mcp it then runs the registry publish. A merge that does not change a version publishes nothing. Prereleases and versions below the current latest are left alone; publish those by hand with --tag.
A release that stops partway is finished by running the Release workflow again from main: the plan picks up any package whose npm version, tag or release is missing and skips the parts that already landed. Manual runs from other branches do nothing.
Publishing authenticates with npm trusted publishing, so there is no npm token in this repo. Each package lists this repo's release.yml with the release environment as its trusted publisher in its settings on npmjs.com. That environment only deploys from main.
License
MIT
Churnkey MCP questions
How do I add Churnkey MCP to Claude Code?
Run claude mcp add --transport http sdk https://mcp.churnkey.co/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Churnkey MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can the Churnkey MCP server do?
It lets AI agents query your Churnkey data, including sessions, analytics, and DSR (data subject requests).
How does the Churnkey MCP server authenticate?
It authenticates with a Churnkey Data API key.
Which AI clients work with the Churnkey MCP server?
Claude, Cursor, Claude Desktop, and other MCP-capable AI agents.
How do I install the Churnkey MCP package?
Install it from npm as @churnkey/mcp, part of the Churnkey SDK monorepo.