Retain So MCP server

by retain-so·io.github.retain-so/mcp-server·v0.1.2·1 stars

No reviews yet

Model Context Protocol server for Retain: let AI agents query churn risk and act on retention.

B77/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B77/100

full report

Adoption

New

1 stars

Reviews

Write one

Nobody has reviewed Retain So yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Retain So tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

add_customer_note
Add a note to a customer's active alert. Useful to document outreach done outside Retain. Requires a read+write agent key.
archive_alert
Archive a resolved alert, removing it from the attention queue. Requires a read+write agent key.
get_active_alerts
List active (non-archived) alerts ordered by priority, with customer, risk factors, MRR at risk and outreach state.
get_at_risk_customers
List customers by churn risk level, ordered by MRR at risk. Use to answer "which customers are at critical/high risk?".
get_churn_metrics
Consolidated metrics for the current period: churn rate, MRR churned, new/expansion/contraction MRR and net revenue retention.
get_customer_details
Get the full profile for one customer by id or name: plan, health score, risk level, seats, activity trend and recent alerts.
get_mrr_at_risk
Total monthly recurring revenue at risk plus active-alert counts by risk level. A quick executive snapshot.
mark_alert_contacted
Advance one or more alerts to the "contacted" outreach state with a timestamp. Pass a single id to mark one alert, or several to mark them in one call. Requires a read+write agent key.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 50 days ago12/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 77/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Retain So compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 77/100; higher than 50% of 4,460 AI and agents servers
Tools: 8; the typical AI and agents server has 6
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 1; more than 50% of 2,711 AI and agents servers

What its tools let an agent do: 5 read · 1 create · 1 change · 1 delete

Install Retain So in Claude Code, Cursor or VS Code

Runs npx -y @retain-so/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-server -- npx -y @retain-so/mcp-server

Add to Cursor

What the publisher says

From the Retain So repository's README, as published. We do not edit it. Read it on GitHub

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)

In Retain, go to Settings → Agent keys and create a key. Pick read for query-only, or read & write to let the agent take actions. Copy it (it is shown once).
Add the snippet for your client below.
Restart the client and ask your first question.

Claude Code

claude mcp add retain --env RETAIN_API_KEY=rk_agent_xxx -- npx -y @retain-so/mcp-server

Claude Desktop (claudedesktopconfig.json)

{
  "mcpServers": {
    "retain": {
      "command": "npx",
      "args": ["-y", "@retain-so/mcp-server"],
      "env": { "RETAIN_API_KEY": "rk_agent_xxx" }
    }
  }
}

Cursor / Windsurf (.cursor/mcp.json or ~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "retain": {
      "command": "npx",
      "args": ["-y", "@retain-so/mcp-server"],
      "env": { "RETAIN_API_KEY": "rk_agent_xxx" }
    }
  }
}

Tools

Coming soon: sendretentionemail (trigger a templated retention email).

Example conversation

You: Who's about to churn and how much money is on the line?

Agent: (calls getmrratrisk, then getatriskcustomers) You have $4,200 MRR at risk across 7 active alerts. The two biggest are Acme Inc ($900, critical, 18 days inactive) and Globex ($650, high).

You: I emailed Acme today, mark their alert as contacted.

Agent: (calls markalertcontacted) Done. Acme's alert is now marked as contacted.

Configuration

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Retain So: common questions

Is Retain So MCP server safe?: Mostly: it is graded B (77/100). Read the Retain So safety report
How do I install Retain So?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Retain So need an API key?: Yes. The registry entry asks for RETAIN_API_KEY.
Is Retain So maintained?: The last commit was 88 days ago (2026-08-08). The latest release is v0.1.2.
What can I use instead of Retain So?: Servers from other publishers that do the same job: Skillsmith MCP server.
How does Retain So compare with other AI and agents MCP servers?: safety score 77/100 (higher than 50% of 4,460 AI and agents servers); tools 8 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Retain So

Same job from other publishers: the closest match first, then the best rated.

Skillsmith
Share agent skills across your team, scan them for risk, and track what's actually used.
not reviewed
Established
B