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:
| Skill | What it does |
|---|---|
whisperr-install | Follows 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-insights | Answers 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-sync | Checks 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)
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:
| Agent | File in your repo | Source |
|---|---|---|
| Codex, Cursor, Copilot, most agents | AGENTS.md | snippets/AGENTS.md |
| Claude Code | CLAUDE.md | snippets/CLAUDE.md |
| Cursor | .cursor/rules/whisperr.mdc | rules/whisperr.mdc |
| Windsurf | .windsurf/rules/whisperr.md | snippets/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_nameas 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 asemailOptedIn; when it does not ask, the flag is left out, and it is nevertruefor 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
| Path | For |
|---|---|
.claude-plugin/plugin.json, .claude-plugin/marketplace.json, .mcp.json | Claude Code plugin and marketplace |
.cursor-plugin/plugin.json, rules/ | Cursor plugin |
plugin.json, mcp.json | Portable Agent Plugins package, with the OpenAI listing under extensions.com.openai (ChatGPT and Codex) |
.agents/plugins/marketplace.json | Codex repo marketplace |
skills/ | The three skills (shared by every agent) |
snippets/ | AGENTS.md, CLAUDE.md and Windsurf blocks, copy-prompt fallback |
registry/server.json | Official MCP Registry entry net.whisperr/whisperr |
scripts/validate.py | Manifest, schema and skill checks (CI) |
scripts/build-openai-zip.sh | Builds dist/whisperr-openai-plugin.zip for the OpenAI plugin portal |
PUBLISHING.md | Submission 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)
- Claude Code plugins, marketplaces,
.mcp.jsonand skills: https://code.claude.com/docs/en/plugins-reference · https://code.claude.com/docs/en/plugins/marketplace-reference · https://code.claude.com/docs/en/plugins/publish · https://code.claude.com/docs/en/skills - Claude plugin directory: https://claude.com/docs/plugins/submit · https://claude.com/docs/plugins/pre-submission-checklist
- Cursor plugins and MCP install links: https://cursor.com/docs/reference/plugins · https://cursor.com/docs/mcp/install-links
- VS Code MCP install URLs: https://code.visualstudio.com/api/extension-guides/ai/mcp
- OpenAI plugins (ChatGPT and Codex): https://developers.openai.com/plugins/build/plugins · https://developers.openai.com/plugins/deploy/submission · https://learn.chatgpt.com/docs/extend/mcp
- Agent Plugins schemas: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
- Windsurf / Devin Desktop MCP: https://docs.devin.ai/desktop/cascade/mcp
- Official MCP Registry: https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/remote-servers.mdx · https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/authentication.mdx
License
MIT. See LICENSE. Issues and questions: https://github.com/WhisperrAI/whisperr-agent-kit/issues