{
  "markdown": "<p align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://s3.eu-north-1.amazonaws.com/grovs.io/full-white.svg\">\n    <img src=\"https://s3.eu-north-1.amazonaws.com/grovs.io/full-black.svg\" width=\"120\" alt=\"Grovs\">\n  </picture>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/grovs-io/mcp/releases\"><img src=\"https://img.shields.io/github/v/release/grovs-io/mcp?style=flat-square&color=4F46E5\" alt=\"Latest release\"/></a>\n  <a href=\"#\"><img src=\"https://img.shields.io/badge/MCP-1.0-4F46E5?style=flat-square\" alt=\"MCP 1.0\"/></a>\n  <a href=\"#\"><img src=\"https://img.shields.io/badge/Claude%20Code-supported-4F46E5?style=flat-square\" alt=\"Claude Code\"/></a>\n  <a href=\"#\"><img src=\"https://img.shields.io/badge/Cursor-supported-4F46E5?style=flat-square\" alt=\"Cursor\"/></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/github/license/grovs-io/mcp?style=flat-square&color=4F46E5\" alt=\"MIT License\"/></a>\n  <a href=\"https://github.com/grovs-io/mcp/stargazers\"><img src=\"https://img.shields.io/github/stars/grovs-io/mcp?style=flat-square&color=4F46E5\" alt=\"GitHub stars\"/></a>\n</p>\n\n<p align=\"center\">\n  MCP server for managing deep links, analytics, and app configuration on <a href=\"https://grovs.io\">Grovs</a>.\n  <br />\n  Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://grovs.io\">Website</a> &middot;\n  <a href=\"https://docs.grovs.io\">Documentation</a> &middot;\n  <a href=\"https://github.com/grovs-io/mcp/issues\">Issues</a>\n</p>\n\n---\n\n## What is Grovs?\n\n[Grovs](https://grovs.io) is an open-source, privacy-first growth platform for mobile apps — a self-hostable alternative to Branch.io and AppsFlyer. It provides:\n\n- **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.\n- **Attribution** — deterministic, first-party install and event attribution. No fingerprinting, no data sharing with ad networks.\n- **Revenue Analytics** — in-app purchases, subscriptions, and custom revenue events matched back to the campaign that drove the install.\n- **Campaigns** — group links, track performance, and compare results across channels.\n\nEU-hosted, open-source SDKs, 20M+ daily active users in production. See the [backend repo](https://github.com/grovs-io/backend) for self-hosting.\n\n## What is this MCP server?\n\nThis is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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.\n\n## Quick Start\n\n### Claude Code\n\n```\n/plugin marketplace add grovs-io/mcp\n/plugin install grovs@grovs\n```\n\nInstalls 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.\n\n### Cursor\n\nOpen **Settings > MCP** and add a new server:\n\n```json\n{\n  \"mcpServers\": {\n    \"grovs\": {\n      \"url\": \"https://mcp.grovs.io/mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"grovs\": {\n      \"serverUrl\": \"https://mcp.grovs.io/mcp\"\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot)\n\nAdd to your `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"grovs\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.grovs.io/mcp\"\n    }\n  }\n}\n```\n\n### ChatGPT Desktop\n\nOpen **Settings > MCP Servers > Add Server** and enter:\n\n```\nhttps://mcp.grovs.io/mcp\n```\n\n### Self-Hosted\n\nIf you're running your own Grovs backend, run the MCP server locally and point your client to it:\n\n```bash\ngit clone https://github.com/grovs-io/mcp.git\ncd mcp\nnpm install && npm run build\nnpm start\n```\n\nOr with Docker:\n\n```bash\ndocker build -t grovs-mcp .\ndocker run -p 8080:8080 grovs-mcp\n```\n\nThen use `http://localhost:8080/mcp` as the server URL in any of the client configs above.\n\n> All clients will trigger an OAuth flow on first use — a browser window opens to authenticate with your Grovs account.\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `PORT` | `8080` | Server port |\n| `GROVS_API_URL` | `https://mcp.grovs.io` | Grovs backend URL (override for self-hosted) |\n| `PUBLIC_URL` | `http://localhost:8080` | Public URL of this MCP server (used for OAuth callbacks) |\n\nCopy `.env.example` to `.env` for local development.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_status` | Account info, instances, projects, and domains |\n| `get_usage` | Usage metrics and subscription status for an instance |\n| `create_project` | Create a new instance with production and test projects |\n| `create_link` | Create a deep link with metadata, tags, and custom data |\n| `get_link` | Get full details of a link by path |\n| `update_link` | Update a link's metadata, tags, or redirects |\n| `archive_link` | Deactivate a link (irreversible) |\n| `search_links` | Search and list links with pagination and filters |\n| `get_analytics_overview` | Project-level metrics: views, installs, opens, revenue |\n| `get_link_analytics` | Per-link daily metrics |\n| `get_top_links` | Top performing links ranked by views |\n| `create_campaign` | Create a campaign to group related links |\n| `list_campaigns` | List campaigns with aggregated metrics |\n| `archive_campaign` | Archive a campaign and deactivate its links |\n| `configure_redirects` | Set per-platform redirect behavior (App Store, Play Store, web) |\n| `configure_sdk` | Configure iOS/Android SDK settings (bundle ID, team ID, etc.) |\n\n## Architecture\n\n```\nMCP Client (Claude Code, Cursor, etc.)\n    │\n    │  MCP protocol over HTTP\n    ▼\nExpress app (src/app.ts)\n    │\n    ├── OAuth flow (/authorize, /callback, /register)\n    │\n    └── MCP endpoint (/mcp)\n            │\n            ├── Tool registration (src/server.ts)\n            │       Zod schema validation + runWithAuth error boundary\n            │\n            ├── Handlers (src/tools/handlers.ts)\n            │       Business logic, plain functions, throw on error\n            │\n            ├── Formatters (src/tools/formatters.ts)\n            │       Convert API JSON to human-readable text\n            │\n            └── API client (src/api-client.ts)\n                    HTTP calls to Grovs backend\n```\n\n## Development\n\n```bash\nnpm run dev          # start with auto-reload\nnpm run build        # compile TypeScript\nnpm test             # run tests (186 tests)\nnpm run test:watch   # run tests in watch mode\nnpm run lint         # ESLint\nnpm run format       # Prettier\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for project structure and PR guidelines.\n\n## SDKs\n\n| Platform | Repository |\n|----------|-----------|\n| iOS | [grovs-io/grovs-ios](https://github.com/grovs-io/grovs-ios) |\n| Android | [grovs-io/grovs-android](https://github.com/grovs-io/grovs-android) |\n| React Native | [grovs-io/grovs-react-native](https://github.com/grovs-io/grovs-react-native) |\n| Flutter | [grovs-io/grovs-flutter](https://github.com/grovs-io/grovs-flutter) |\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 7147,
  "sha": "ad99fdd4bc0db3cc3c65e6e5b06a3692f76648746d4c54f4a728b1bea4287381",
  "repo_slug": "grovs-io/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_grovs_mcp_203e3fcf/readme"
}