@retainq/mcp

RetainQ MCP Server — Connect AI assistants to your churn reduction platform.

What is this?

This is a Model Context Protocol (MCP) server for RetainQ. It lets AI assistants (like Claude, Cursor, Kiro, etc.) interact with your RetainQ workspace — query retention metrics, manage flows, analyze churn data, and more.

Related MCP server: Attio MCP Server

Installation

npx @retainq/mcp

Or install globally:

npm install -g @retainq/mcp

Configuration

Environment Variable

Set your RetainQ API key:

export RETAINQ_API_KEY=rq_live_your_key_here

Get an API key from Settings → API Keys in your RetainQ dashboard.

MCP Client Config

Add to your MCP client configuration (e.g., Claude Desktop, Kiro, Cursor):

{
  "mcpServers": {
    "retainq": {
      "command": "npx",
      "args": ["@retainq/mcp"],
      "env": {
        "RETAINQ_API_KEY": "rq_live_your_key_here"
      }
    }
  }
}

Available Tools (32)

Analytics

• get_retention_stats — Workspace metrics overview

• get_recent_sessions — Latest flow sessions with outcomes

• get_top_churn_reasons — Cancellation reasons ranked by frequency

• get_high_risk_customers — Customers above churn risk threshold

• get_offer_performance — Offer acceptance rates and revenue

Flows

• list_flows — List all flows

• get_flow — Get flow details

• create_flow — Create new flow (simple or advanced)

• update_flow — Update flow metadata

• delete_flow — Archive a flow

• configure_simple_flow — Set simple flow config (survey, offers, feedback, design)

• set_advanced_flow_schema — Set node-based flow schema

• publish_flow — Publish and make live

• get_flow_schema — Get current published schema

Offers

• list_offers — List all retention offers

• create_offer — Create new offer

• update_offer — Update offer

• delete_offer — Archive offer

Customers

• list_customers — List customers with churn scores

• get_customer — Get customer by email

• get_customer_sessions — Get a customer's session history

Opportunities

• list_opportunities — List retention opportunities

• confirm_opportunity — Confirm/fulfill an opportunity

• reject_opportunity — Reject an opportunity

AI Intelligence

• run_churn_analysis — Run AI-powered churn analysis

• ask_ai — Ask RetainQ AI a question about your data

Notifications

• list_notifications — Get recent notifications

• get_notification_preferences — Get notification settings

• update_notification_preferences — Update notification settings

Feedback

• list_feedback — Get session feedback/answers

• export_feedback_csv — Export feedback as CSV

API Base URL

By default connects to https://app.retainq.com/api/v1/public. Override with:

export RETAINQ_API_URL=http://localhost:3000/api/v1/public

License

MIT