Wavebrook MCP server
Commit Oct 13, 2026Connect your AI assistant to your Wavebrook Dashboard to query app statistics, earnings, payouts, and manage notifications.
Also known as wavebrook/ai-plugins, ai-plugins
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 13, 2026
- License
- MIT
What is Wavebrook MCP?
Wavebrook connects your AI assistant to your Wavebrook Dashboard to query app statistics, earnings, payouts, and manage notifications.
Summary generated from the project's README
About Wavebrook MCP server
Wavebrook provides a remote MCP server that connects publisher accounts to their Wavebrook Dashboard. This integration allows AI assistants to access app statistics, earnings, and payout information through natural language queries. It is designed for developers and publishers who use tools like Claude, ChatGPT, Cursor, VS Code, and Gemini CLI to monitor their application performance and financial status.
Users connect by signing in with their existing Wavebrook Dashboard credentials via OAuth, which removes the need to manage manual API keys. By default, the connection provides read-only access to account data, including DAU, consent percentages, and location metrics. If a user explicitly selects the option to allow changes during sign-in, the assistant can perform actions such as adding new apps, refreshing store listings, or marking notifications as read.
This server includes a specific skill that teaches the assistant the necessary vocabulary and metrics used within the Wavebrook ecosystem. While the assistant can explain alerts and read legal documents, certain sensitive tasks like deleting accounts or accepting updated terms must still be completed directly within the dashboard.
What you can do with it
- 1Analyze application earningsAsk your assistant to report monthly earnings broken down by specific apps or partners.
- 2Investigate performance dropsRequest an explanation for sudden changes in user metrics like location-based daily active users.
- 3Manage app inventoryInstruct the AI to add a new application to your account using a store link.
- 4Monitor payout statusQuery the assistant to find out what is preventing a scheduled payout from completing.
Written from the project's README. Every use case is checked against a quote from it.
How to install Wavebrook MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Wavebrook MCP in Claude Code
$ claude mcp add --transport http ai-plugins https://mcp.wavebrook.com/mcpInstall Wavebrook MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ai-plugins": {
"url": "https://mcp.wavebrook.com/mcp"
}
}
}Install Wavebrook MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ai-plugins": {
"type": "http",
"url": "https://mcp.wavebrook.com/mcp"
}
}
}Install Wavebrook MCP in VS Code CLI
$ code --add-mcp '{"name":"ai-plugins","type":"http","url":"https://mcp.wavebrook.com/mcp"}'Install Wavebrook MCP in Codex
$ codex mcp add ai-plugins --url https://mcp.wavebrook.com/mcpInstall Wavebrook MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ai-plugins] url = "https://mcp.wavebrook.com/mcp"
Install Wavebrook MCP in Gemini CLI
$ gemini mcp add -s user --transport http ai-plugins https://mcp.wavebrook.com/mcpInstall Wavebrook MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ai-plugins": {
"url": "https://mcp.wavebrook.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablewavebrook/ai-plugins is public and reachablegithub.com/wavebrook/ai-plugins ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-13github.com/wavebrook/ai-plugins ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubWavebrook for AI assistants
Connect your AI assistant to your Wavebrook Dashboard account. Ask how your apps are doing, what you earned and what's holding up a payout, in plain language.
This repo packages the Wavebrook remote MCP server for Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI and others. It also ships one skill that teaches the assistant our vocabulary, metrics and common workflows.
MCP server URL:
https://mcp.wavebrook.com/mcp
You sign in with your Wavebrook Dashboard account. There are no API keys to copy.
What it can do
- Show your account, apps, DAU, consent % and location %.
- Report earnings by month, app and Partner, and list your payouts.
- Explain alerts, such as a drop in location DAU.
- Read your dashboard notifications and legal documents.
- If you allow changes: add a new app, refresh an app from its store listing and mark notifications as read.
Some things stay in the dashboard: accepting updated terms, payout details, and deleting apps or your account. Wavebrook admins handle Partner activation.
Privacy
- The assistant only sees what you approve when you sign in. By default that's read-only access to your own account.
- Changes need a separate opt-in: tick Also let it make changes on the sign-in screen.
- Disconnect any time at Account → Connected apps in the Wavebrook Dashboard.
- Only publisher accounts can connect.
Install
Claude.ai and Claude Desktop
- Go to Customize → Connectors.
- Click Add custom connector.
- Enter the name
Wavebrookand the URLhttps://mcp.wavebrook.com/mcp. - Click Add, then Connect and sign in.
On Team and Enterprise plans, an Owner adds it at Organization settings → Connectors → Add → Custom → Web. Members then connect from Customize → Connectors. If the dialog asks for an OAuth client, choose Register automatically.
Claude Code
Install the plugin, which adds the server and the skill:
claude plugin marketplace add wavebrook/ai-plugins
claude plugin install wavebrook@wavebrook
Or add only the server:
claude mcp add --transport http wavebrook https://mcp.wavebrook.com/mcp
Then run /mcp in Claude Code and sign in.
ChatGPT
Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts.
- Open Settings → Security and login and turn on Developer mode.
- Go to ChatGPT Plugins and select the plus button.
- Enter the name
Wavebrookand the MCP server URLhttps://mcp.wavebrook.com/mcp. Choose OAuth if asked. - Sign in when prompted.
On Business and Enterprise workspaces, your admin may need to enable developer mode first.
Codex
Install the plugin:
codex plugin marketplace add wavebrook/ai-plugins
codex plugin add wavebrook@wavebrook
codex mcp login wavebrook
Or add only the server to ~/.codex/config.toml:
[mcp_servers.wavebrook]
url = "https://mcp.wavebrook.com/mcp"
Then sign in:
codex mcp login wavebrook
Cursor
If the link doesn't open Cursor, paste this deeplink into your browser:
cursor://anysphere.cursor-deeplink/mcp/install?name=wavebrook&config=eyJ1cmwiOiJodHRwczovL21jcC53YXZlYnJvb2suY29tL21jcCJ9
Or add it to ~/.cursor/mcp.json:
{
"mcpServers": {
"wavebrook": {
"url": "https://mcp.wavebrook.com/mcp"
}
}
}
Cursor also reads the plugin in this repo, skill included.
VS Code and GitHub Copilot
Paste this install link into your browser:
vscode:mcp/install?%7B%22name%22%3A%22wavebrook%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.wavebrook.com%2Fmcp%22%7D
Or add it to .vscode/mcp.json:
{
"servers": {
"wavebrook": {
"type": "http",
"url": "https://mcp.wavebrook.com/mcp"
}
}
}
VS Code opens a browser window to sign in the first time you use it.
Gemini CLI
gemini extensions install https://github.com/wavebrook/ai-plugins
Then run /mcp auth wavebrook in Gemini CLI and sign in.
Windsurf
Community-tested only. Add this to your MCP config file (mcp_config.json):
{
"mcpServers": {
"wavebrook": {
"serverUrl": "https://mcp.wavebrook.com/mcp"
}
}
}
OpenClaw
openclaw plugins install wavebrook --marketplace wavebrook/ai-plugins
OpenClaw loads the MCP server from the plugin. Its docs don't yet confirm OAuth sign-in for remote servers, so this may not connect. If it doesn't, use another client.
Example prompts
- "How much did my apps earn last month, by Partner?"
- "Compare this month's DAU with last month for each app."
- "Why did location DAU drop on my Android app this week?"
- "What's blocking my next payout?"
- "Do I have any updated terms to accept?"
- "Add this app to my Wavebrook account: https://play.google.com/store/apps/details?id=com.example.app"
Troubleshooting
- Sign-in keeps looping or is refused. You must sign in with an active publisher account. Partner and staff accounts can't connect.
- "We've updated our terms". Accept them at dashboard.wavebrook.com/re-accept, then ask again.
- The assistant can't add apps. You didn't allow changes at sign-in. Disconnect at Account → Connected apps, connect again and tick Also let it make changes.
- Disconnect an assistant. Go to Account → Connected apps.
Support
Email hello@wavebrook.com.
Licence
MIT. See LICENSE.
Wavebrook MCP questions
How do I add Wavebrook MCP to Claude Code?
Run claude mcp add --transport http ai-plugins https://mcp.wavebrook.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Wavebrook MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I grant the AI permission to make changes to my account?
You must tick the 'Also let it make changes' option on the sign-in screen during the connection process.
Can I use a staff or partner account to connect?
No, only publisher accounts are supported for connection.
How do I disconnect my AI assistant from Wavebrook?
You can disconnect any time through the Connected apps section in your Wavebrook Dashboard.
What happens if the assistant cannot add new apps?
This usually means you did not opt-in to allow changes during the initial sign-in process.