@retainrabbit/mcp

A stdio Model Context Protocol server that lets an AI coding assistant (Claude Desktop / Cursor / Claude Code) manage RetainRabbit flows and — the differentiator — generate ready-to-paste integration code for a chosen flow + framework.

The API key lives only in this server process (from env); it never appears in any tool's output. get_install_snippet emits keyless browser code (it uses your workspaceId, not the key).

Client config

// Claude Desktop / Cursor / Claude Code — mcpServers entry
{
  "mcpServers": {
    "retainrabbit": {
      "command": "npx",
      "args": ["-y", "@retainrabbit/mcp"],
      "env": {
        "RETAINRABBIT_API_KEY": "rk_live_…",
        "RETAINRABBIT_BASE_URL": "https://<app>/api/v1"
      }
    }
  }
}

Both env vars are required; the server exits with a clear stderr message if either is missing.

Tools

| Tool | Input | Description | | --- | --- | --- | | list_flows | — | List the workspace's flows (name · status · id) plus the structured array. | | get_flow | { flowId } | Get a flow's name, status, steps, and hostedUrl. | | get_recovery_stats | — | Recovered MRR, save rate, and session counts. | | get_session | { sessionId } | A cancellation session's outcome and recovered MRR. | | get_install_snippet | { flowId, framework } | Keyless, ready-to-paste integration code for react | js | html-script | link. |

Notes

• stdout is the JSON-RPC channel — diagnostics go to stderr, never stdout.
• Built on @modelcontextprotocol/sdk (stdio transport) + zod, reusing @retainrabbit/api-client.