churnkey — Claude Code MCP server: Churnkey data in your agent
Wires an AI agent into Churnkey so it can read sessions, retention analytics and DSR requests with a Data API key.
claude mcp add --transport http churnkey https://mcp.churnkey.co/mcpWhat churnkey does
@churnkey/mcp is the Model Context Protocol package inside the churnkey/sdk repo. Point Claude, Cursor or another agent at it and the agent can query your Churnkey sessions, analytics and DSR records. The endpoint is https://mcp.churnkey.co/mcp over HTTP, so there is no local build step.
You need a Data API key. Without it the connection is there but the data calls fail. Grab the key from your Churnkey account; the same account hands out an appId if you want analytics.
The repo ships three packages: @churnkey/react for the cancel flow component on React 18 and 19, @churnkey/node for server-side token generation, and @churnkey/mcp for the server itself. MIT licensed.
What it helps with
- check cancel sessions without opening the dashboard
- pull retention numbers into a chat with the agent
- locate open DSR requests in Churnkey
- cross-check churn data while reviewing billing code
Example prompts for the agent
- Show me the latest cancel sessions from Churnkey
- What were our retention metrics this week?
- Find open DSR requests in Churnkey
How to install churnkey
Platform CLI: remote server
claude mcp add --transport http churnkey https://mcp.churnkey.co/mcpPlatform CLI: remote server
codex mcp add churnkey --url https://mcp.churnkey.co/mcpConfig file
{
"mcpServers": {
"churnkey": {
"url": "https://mcp.churnkey.co/mcp"
}
}
}Config file
{
"servers": {
"churnkey": {
"type": "http",
"url": "https://mcp.churnkey.co/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http churnkey https://mcp.churnkey.co/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about churnkey
How do I install churnkey in Claude Code?
Run claude mcp add --transport http churnkey https://mcp.churnkey.co/mcp.
What does the churnkey MCP server do?
It exposes your Churnkey data — sessions, analytics and DSR — to an AI agent, using a Data API key.
Do I need an API key?
Yes, a Data API key from your Churnkey account. Data requests fail without one.