Skip to content

whisperrai/whisperr

v0.7.0MIT

Install the Whisperr SDK with your own coding agent, verify that events arrive, and answer retention questions from your Whisperr data. Connects to the Whisperr remote MCP server.

Whisperr agent kit

Whisperr

Install Whisperr with the coding agent you already use. Whisperr finds the users who are about to churn and sends the right message at the right time. This kit connects your agent to the Whisperr MCP server and gives it three skills:

SkillWhat it does
whisperr-installFollows the Whisperr integration playbook: detects your stack, installs the Whisperr SDK at the latest version, adds init, identify/reset, push tokens, push-open tracking and RevenueCat, Superwall or Adapty linking with Whisperr's privacy rules, wires your required events, builds before and after (no new errors), registers new events, then waits until real events arrive.
whisperr-insightsAnswers retention questions ("how many users are at risk, and why?") from your live Whisperr data. Changes apply when you ask; risky ones (real sends, deletions, revocations, team changes) wait for your yes in the chat.
whisperr-keep-in-syncChecks every code change that touches tracked events, so a refactor does not silently stop an event, and adds or retires events after an install (retiring needs your confirmation).

Supported stacks: Swift/iOS, React Native/Expo, Flutter, web (React, Next.js, any JS app) and Node. Python, PHP and .NET follow the docs.

MCP server: https://mcp.whisperr.net/mcp (Streamable HTTP, OAuth 2.1). The first tool call opens a browser sign-in. You pick your Whisperr app and approve scopes: data:read, install:write (owners and admins) and changes:propose (make workspace changes). You need a Whisperr account.

Install

Claude Code

In a Claude Code session:

/plugin marketplace add WhisperrAI/whisperr-agent-kit
/plugin install whisperr@whisperr

Or from your shell:

claude plugin marketplace add WhisperrAI/whisperr-agent-kit
claude plugin install whisperr@whisperr

Restart the session, run /mcp, select whisperr and sign in. Then ask: "Install Whisperr in this app."

MCP server only (no skills): claude mcp add --transport http whisperr https://mcp.whisperr.net/mcp

Cursor

Add Whisperr MCP server to Cursor

Deeplink (paste into a browser): cursor://anysphere.cursor-deeplink/mcp/install?name=whisperr&config=eyJ1cmwiOiJodHRwczovL21jcC53aGlzcGVyci5uZXQvbWNwIn0=

For the skills and the rule, copy rules/whisperr.mdc to .cursor/rules/whisperr.mdc and the skills/ folders to .cursor/skills/. The full plugin (MCP server, skills and rule) is also available from the Cursor Marketplace after review.

VS Code (GitHub Copilot agent mode)

Install in VS Code

Or from your shell:

code --add-mcp '{"name":"whisperr","type":"http","url":"https://mcp.whisperr.net/mcp"}'

Codex and ChatGPT

Codex CLI, plugin with skills:

codex plugin marketplace add WhisperrAI/whisperr-agent-kit
codex plugin add whisperr@whisperr

MCP server only:

codex mcp add whisperr --url https://mcp.whisperr.net/mcp
codex mcp login whisperr

ChatGPT and the Codex app: install Whisperr from the plugin directory after it is listed. Until then, add https://mcp.whisperr.net/mcp as a custom MCP connection in ChatGPT developer mode.

Windsurf (Devin Desktop)

Devin Local agent:

devin mcp add whisperr https://mcp.whisperr.net/mcp

Legacy Cascade agent: add this to mcp_config.json (~/.config/devin/mcp_config.json; older Windsurf installs use ~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "whisperr": { "serverUrl": "https://mcp.whisperr.net/mcp" }
  }
}

Copy snippets/windsurf-whisperr.md to .windsurf/rules/whisperr.md.

Lovable, Bolt, Replit, Rork and other app builders

Use the copy-prompt fallback: snippets/copy-prompt.md. Paste your publishable key and event list into the prompt, then paste the prompt into the tool. Replit also accepts a custom remote MCP server URL.

Cloud agents, CI and other runs without a browser

The browser sign-in cannot finish there. A workspace owner or admin creates an install token in the Whisperr dashboard (Integrations → Your code → Coding agent → Agent without a browser) and stores it as WHISPERR_INSTALL_TOKEN where the agent runs. The agent sends it as Authorization: Bearer … to https://mcp.whisperr.net/install. The token works in one app, can register events more than once, and expires 60 minutes after it was created. Configs for Claude Code, Codex, Cursor and plain HTTP: skills/whisperr-install/references/headless.md. The plugin's own MCP config stays on the browser sign-in.

Any other MCP client

{
  "mcpServers": {
    "whisperr": { "type": "http", "url": "https://mcp.whisperr.net/mcp" }
  }
}

Rules for your repository

Agents follow short repository rules better than on-demand skills. Paste the block that fits your agent into your repository. AGENTS.md and CLAUDE.md load in every session; the Cursor and Windsurf rules load when the agent works on matching code:

AgentFile in your repoSource
Codex, Cursor, Copilot, most agentsAGENTS.mdsnippets/AGENTS.md
Claude CodeCLAUDE.mdsnippets/CLAUDE.md
Cursor.cursor/rules/whisperr.mdcrules/whisperr.mdc
Windsurf.windsurf/rules/whisperr.mdsnippets/windsurf-whisperr.md

Replace the <…> placeholders with your SDK package, version, init file and key variable. The whisperr-install skill offers to do this for you.

What this kit runs, sends and stores

  • The kit contains only text: manifests, skills, rules and images. It runs no code on your machine and installs no packages by itself. Your agent runs the commands that the skills describe (package install, build, analyze), in your terminal, with your approval settings.
  • The only network destination the kit configures is the Whisperr MCP server https://mcp.whisperr.net/mcp, operated by Whisperr. Your agent sends it tool arguments: event definitions (code, name, property schema), synthetic test events, deployment identifiers such as a commit SHA, and your questions about your data.
  • Whisperr tools never return delivery addresses (email, phone, push tokens), API keys or secrets. Changes to your workspace apply when the agent calls the tool. Risky ones, such as messages to real people, deletions, revocations and team changes, run only after an owner or admin confirms the exact summary in the agent.
  • The skills tell your agent to send first_name as the only name trait and to send email and phone only as channels. When your app asks users whether it may email them, the agent passes their answer as emailOptedIn; when it does not ask, the flag is left out, and it is never true for a user who did not agree. Your answer to "Does your signup get permission to email users?" in the dashboard decides the rest: Yes opts app-sent emails in unless the user declined, Per user needs the user's yes, and No or no answer leaves consent to your backend with the server key. The skills install the latest SDK version (https://docs.whisperr.net/sdk-versions.json).

Privacy policy: https://whisperr.net/privacy/ · Terms: https://whisperr.net/terms/ · Security: https://whisperr.net/security/

Repository layout

PathFor
.claude-plugin/plugin.json, .claude-plugin/marketplace.json, .mcp.jsonClaude Code plugin and marketplace
.cursor-plugin/plugin.json, rules/Cursor plugin
plugin.json, mcp.jsonPortable Agent Plugins package, with the OpenAI listing under extensions.com.openai (ChatGPT and Codex)
.agents/plugins/marketplace.jsonCodex repo marketplace
skills/The three skills (shared by every agent)
snippets/AGENTS.md, CLAUDE.md and Windsurf blocks, copy-prompt fallback
registry/server.jsonOfficial MCP Registry entry net.whisperr/whisperr
scripts/validate.pyManifest, schema and skill checks (CI)
scripts/build-openai-zip.shBuilds dist/whisperr-openai-plugin.zip for the OpenAI plugin portal
PUBLISHING.mdSubmission steps for each directory

Develop

pip install jsonschema pyyaml
python3 scripts/validate.py --require-schema
claude plugin validate --strict .claude-plugin/plugin.json
./scripts/build-openai-zip.sh

Raise version in .claude-plugin/plugin.json, .cursor-plugin/plugin.json and plugin.json together for every release, then tag vX.Y.Z. The release workflow attaches the OpenAI ZIP to the GitHub release.

Formats used (checked 2026-10-05)

License

MIT. See LICENSE. Issues and questions: https://github.com/WhisperrAI/whisperr-agent-kit/issues