Model Context Protocol (MCP) for Churnkey

The co.churnkey/churnkey MCP server reads and manages Churnkey cancel flows, retention metrics, and payment recovery. It is part of the Churnkey SDK ecosystem, and is associated with React-focused cancel-flow tooling that can optionally connect to Churnkey for analytics and AI-powered retention.

🛠️ Key Features

Supports reading and managing cancel flows
Handles retention metrics
Manages payment recovery
Provided as @churnkey/mcp within the SDK

🚀 Use Cases

Integrate Churnkey cancel-flow data and retention metrics
Coordinate payment recovery workflows
Pair with React cancel-flow components and/or hosted integrations

⚡ Developer Benefits

Access @churnkey/mcp for Model Context Protocol usage
Works alongside @churnkey/react (cancel flow: component, hook, state machine) and @churnkey/node (server-side token generation)

⚠️ Limitations

The excerpt provides no tool count or specific MCP tools/endpoints.

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

bash

npm install @churnkey/react

tsx

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 — createToken and authHash

@churnkey/mcp — MCP server for Claude / Cursor / Claude Desktop

Create a free Churnkey account — get an appId for analytics

churnkey.co — dashboard, hosted embed, AI retention features

sdk/ ├── packages/ │ ├── react/ @churnkey/react │ ├── node/ @churnkey/node │ └── mcp/ @churnkey/mcp ├── apps/ │ └── playground/ internal dev playground └── scripts/ release + tooling helpers

Install

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.churnkey.co/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "churnkey": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.churnkey.co/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

co.churnkey/churnkey

Model Context Protocol (MCP) for Churnkey

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

Churnkey SDK

Packages

Quick start

Documentation and resources

Repo layout

Local development

License

Install

Remote endpoint

Related servers