Claude MarketplacesSubmit
retain-so avatar

Mcp Server

retain-so/mcp-server

Bridges Claude and other MCP clients directly to Retain's churn prevention platform. You get read tools to query at-risk customers by severity, pull full health profiles, check MRR exposure, and view active alerts with risk factors. Write operations let your agent log outreach notes, mark alerts as contacted, and archive resolved cases. All calls hit Retain's /agent/* HTTP API using a scoped key you generate in their dashboard. Useful when you're running retention playbooks conversationally and want to triage, investigate, and document follow-up without context-switching to a web UI. Setup is the standard npx pattern with an API key in the environment.

tools
7
auth
Secret needed
transport
STDIO
env var
1
last updated
Jun 5, 2026
View on GitHub

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

get_at_risk_customersCustomers by churn risk (Critical/High/Stable/Healthy), ordered by MRR. Defaults to Critical + High.

Customers by churn risk (Critical/High/Stable/Healthy), ordered by MRR. Defaults to Critical + High.

No parameter schema in public metadata yet.

get_customer_detailsFull profile for one customer by id or name.

Full profile for one customer by id or name.

No parameter schema in public metadata yet.

get_mrr_at_riskTotal MRR at risk plus active-alert counts by risk level.

Total MRR at risk plus active-alert counts by risk level.

No parameter schema in public metadata yet.

get_active_alertsActive alerts by priority, with risk factors and outreach state.

Active alerts by priority, with risk factors and outreach state.

No parameter schema in public metadata yet.

get_churn_metricsChurn rate, MRR churned, expansion/contraction, net revenue retention.

Churn rate, MRR churned, expansion/contraction, net revenue retention.

No parameter schema in public metadata yet.

mark_alert_contactedMark an alert as contacted.

Mark an alert as contacted.

No parameter schema in public metadata yet.

archive_alertArchive a resolved alert.

Archive a resolved alert.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

RETAIN_API_KEY*secret

Your API key from Retain

Readme

Retain MCP Server

Let your AI agent see who is about to churn, and do something about it.

@retain-so/mcp-server connects Retain to any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, and friends). Ask in natural language which customers are at risk, pull a customer's full health profile, check MRR at risk, and log outreach, all without opening the dashboard.

Retain is an AI-first churn prevention and customer analytics platform. This server is the bridge between your agent and your Retain data.

What you can ask your agent to do

Read:

  • "Which customers are at critical risk this week?"
  • "Show me my high-risk customers ordered by MRR."
  • "What's my total MRR at risk, broken down by risk level?"
  • "Pull the full profile for Acme Inc."
  • "List the active alerts I haven't contacted yet."
  • "Summarize this month's churn metrics and net revenue retention."

Act (needs a read+write key):

  • "Mark the alert for Globex as contacted."
  • "Archive the resolved alert for Initech."

Setup (under 5 minutes)

View the full README on GitHub

Details

Repository
github.com/retain-so/mcp-server
Package
@retain-so/mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active