Grovs
The Grovs MCP server lets AI assistants manage all aspects of the Grovs growth platform — deep links, analytics, campaigns, and app configuration — through natural language.
Account & Project Management: Retrieve account info, list all projects and domains, check instance usage and subscription limits, and create new projects with production and test environments.
Deep Link Management: Create deep links with custom names, paths, metadata (title, subtitle, image), tags, and data payloads; retrieve link details by path or URL; update existing links; search and list links with pagination, filtering, and sorting; and archive/deactivate links.
Analytics: Access project-level aggregated metrics (views, installs, opens, revenue) with period comparisons, view per-link daily analytics, and identify top-performing links ranked by views.
Campaign Management: Create campaigns to group related links, list campaigns with aggregated metrics and filtering, and archive campaigns (which also deactivates their associated links).
Redirect Configuration: Set per-platform fallback URLs for iOS App Store, Google Play, web, and desktop, plus a global fallback.
SDK Configuration: Configure iOS settings (bundle ID, team ID, App Store ID) and Android settings (package name, SHA256 fingerprints).
Provides deep linking and SDK configuration for Android apps, including Play Store redirects and platform-specific settings.
Provides deep linking and SDK configuration for iOS apps, including App Store redirects and platform-specific settings.
Integrates with Windsurf editor via MCP to provide Grovs management capabilities within the development environment.
Supports containerized deployment of the MCP server for self-hosted Grovs instances.
Provides SDK integration for Flutter mobile apps to enable deep linking, attribution, and analytics functionality.
Integrates with VS Code via MCP to provide Grovs management capabilities within GitHub Copilot-enabled environments.
Provides deep linking and SDK configuration for iOS apps, including bundle ID and team ID settings for Apple platforms.
What is Grovs?
Grovs is an open-source, privacy-first growth platform for mobile apps — a self-hostable alternative to Branch.io and AppsFlyer. It provides:
Deep Linking — one link that routes users to the right content across iOS, Android, and web. Deferred deep links survive the install flow so users land on the right screen on first open.
Attribution — deterministic, first-party install and event attribution. No fingerprinting, no data sharing with ad networks.
Revenue Analytics — in-app purchases, subscriptions, and custom revenue events matched back to the campaign that drove the install.
Campaigns — group links, track performance, and compare results across channels.
EU-hosted, open-source SDKs, 20M+ daily active users in production. See the backend repo for self-hosting.
Related MCP server: routine-mcp
What is this MCP server?
This is an MCP (Model Context Protocol) server that lets AI assistants manage your Grovs platform through natural language. Create deep links, check analytics, configure redirects, run campaigns — without leaving your editor.
Quick Start
Claude Code
/plugin marketplace add grovs-io/mcp
/plugin install grovs@grovsInstalls the MCP server and skills that teach Claude how to use Grovs. On first use, a browser window opens for OAuth — no API keys needed.
Cursor
Open Settings > MCP and add a new server:
{
"mcpServers": {
"grovs": {
"url": "https://mcp.grovs.io/mcp"
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"grovs": {
"serverUrl": "https://mcp.grovs.io/mcp"
}
}
}VS Code (GitHub Copilot)
Add to your .vscode/mcp.json:
{
"servers": {
"grovs": {
"type": "http",
"url": "https://mcp.grovs.io/mcp"
}
}
}ChatGPT Desktop
Open Settings > MCP Servers > Add Server and enter:
https://mcp.grovs.io/mcpSelf-Hosted
If you're running your own Grovs backend, run the MCP server locally and point your client to it:
git clone https://github.com/grovs-io/mcp.git
cd mcp
npm install && npm run build
npm startOr with Docker:
docker build -t grovs-mcp .
docker run -p 8080:8080 grovs-mcpThen use http://localhost:8080/mcp as the server URL in any of the client configs above.
All clients will trigger an OAuth flow on first use — a browser window opens to authenticate with your Grovs account.
Configuration
Variable | Default | Description |
|
| Server port |
|
| Grovs backend URL (override for self-hosted) |
|
| Public URL of this MCP server (used for OAuth callbacks) |
Copy .env.example to .env for local development.
Tools
Tool | Description |
| Account info, instances, projects, and domains |
| Usage metrics and subscription status for an instance |
| Create a new instance with production and test projects |
| Create a deep link with metadata, tags, and custom data |
| Get full details of a link by path |
| Update a link's metadata, tags, or redirects |
| Deactivate a link (irreversible) |
| Search and list links with pagination and filters |
| Project-level metrics: views, installs, opens, revenue |
| Per-link daily metrics |
| Top performing links ranked by views |
| Create a campaign to group related links |
| List campaigns with aggregated metrics |
| Archive a campaign and deactivate its links |
| Set per-platform redirect behavior (App Store, Play Store, web) |
| Configure iOS/Android SDK settings (bundle ID, team ID, etc.) |
Architecture
MCP Client (Claude Code, Cursor, etc.)
│
│ MCP protocol over HTTP
▼
Express app (src/app.ts)
│
├── OAuth flow (/authorize, /callback, /register)
│
└── MCP endpoint (/mcp)
│
├── Tool registration (src/server.ts)
│ Zod schema validation + runWithAuth error boundary
│
├── Handlers (src/tools/handlers.ts)
│ Business logic, plain functions, throw on error
│
├── Formatters (src/tools/formatters.ts)
│ Convert API JSON to human-readable text
│
└── API client (src/api-client.ts)
HTTP calls to Grovs backendDevelopment
npm run dev # start with auto-reload
npm run build # compile TypeScript
npm test # run tests (186 tests)
npm run test:watch # run tests in watch mode
npm run lint # ESLint
npm run format # PrettierSee CONTRIBUTING.md for project structure and PR guidelines.
SDKs
Platform | Repository |
iOS | |
Android | |
React Native | |
Flutter |
License
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/grovs-io/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server