@windback-ai/mcp

Official Windback MCP server — query your churn data and trigger recovery actions directly from Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI client.

What you can do

Once connected, ask Claude natural language questions about your churn data:

"Why are my customers on the Pro plan churning?" "Show me all events that haven't received a winback email yet" "What's my recovery rate this month?" "Generate recovery emails for the 3 most recent churns" "What's the most common cancel reason?"

Installation

npm install -g @windback-ai/mcp
# or use directly with npx (no install needed)

Claude Desktop Setup

Add this to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "windback": {
      "command": "npx",
      "args": ["-y", "@windback-ai/mcp"],
      "env": {
        "WINDBACK_API_KEY": "pb_sk_your_secret_key",
        "WINDBACK_PROJECT_SLUG": "your-project-slug"
      }
    }
  }
}

Restart Claude Desktop. You'll see a hammer icon — Windback tools are live.

Cursor / Windsurf Setup

Add to .cursor/mcp.json or .windsurf/mcp.json in your project root:

{
  "mcpServers": {
    "windback": {
      "command": "npx",
      "args": ["-y", "@windback-ai/mcp"],
      "env": {
        "WINDBACK_API_KEY": "pb_sk_your_secret_key",
        "WINDBACK_PROJECT_SLUG": "your-project-slug"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | WINDBACK_API_KEY | ✅ Yes | Your Windback secret key (pb_sk_...) from Settings → API Keys | | WINDBACK_PROJECT_SLUG | ✅ Yes (most tools) | Your project slug from the dashboard URL | | WINDBACK_BASE_URL | No | Override API base URL (default: https://api.windbackai.com) |

Available Tools

Analytics & Stats

| Tool | Description | |---|---| | get_churn_stats | Overview: total events, recovered count, MRR at risk, recovery rate | | get_email_analytics | Email performance: open rate, click rate, daily breakdown | | get_recovery_trends | Day-by-day recovery trends for the last N days | | get_cancel_insights | Cancel reason distribution + recent written feedback |

Churn Events

| Tool | Description | |---|---| | list_churn_events | List events with status filter and pagination | | get_churn_event | Full event details including AI-generated email variants | | mark_event_recovered | Manually mark an event as recovered |

Recovery Emails

| Tool | Description | |---|---| | generate_variants | Trigger AI to generate 9 recovery email variants | | send_variant | Send a specific variant to the churned customer | | submit_cancel_flow | All-in-one: create event + generate + send best email automatically |

Payment Failures (Dunning)

| Tool | Description | |---|---| | list_payment_failures | List failed payment records with status filter | | get_payment_failure_stats | Dunning overview: failing, recovered, MRR at risk |

Example Prompts

"Show me my 10 most recent churn events"
"What percentage of customers cite price as their cancel reason?"
"Find all events with status 'new' that need emails generated"
"Generate recovery emails for event abc123 then send the discount variant"
"How many customers did I recover this week vs last week?"
"What's my open rate on winback emails this month?"
"Show me customers who churned but we haven't emailed yet"
"Mark event xyz as recovered"

License

MIT