# GrowingIO MCP

> GrowingIO turns complex product analytics into simple conversation commands. Connect your AI client directly to this platform to monitor user behavior, audit conversion funnels, and query deep performance metrics without touching a dashboard. Get instant insights on everything from event tracking to segment health.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** product-analytics, user-behavior, event-tracking, conversion-funnel, segmentation, growth-metrics

## Description

This MCP lets you talk directly to your product analytics data. Instead of spending time navigating complex dashboards or writing SQL queries in a separate tool, your AI agent handles it all. You can ask natural language questions and get immediate answers about user activity.

It's designed for anyone who needs to understand *how* users are behaving on their site right now. For example, you can ask the system to list every event being tracked or identify specific groups of users—segments—that represent your most valuable customers. It tracks everything from basic feature adoption rates to complex conversion funnels.

Because this MCP is hosted on Vinkius, you connect once and gain access to a full suite of data tools. Your agent acts as an instant analyst, pulling together metrics, segment details, and campaign performance into one conversation thread. You get clear answers about drop-off points in your purchase flow or which ad campaigns are actually driving growth.

## Tools

### get_event
Retrieves detailed information about a single user behavioral event.

### get_funnel
Pulls the setup and data for a specific conversion funnel.

### get_metrics
Runs quantitative queries to retrieve project performance metrics based on natural language input.

### get_project_info
Fetches general metadata and configuration details for the entire GrowingIO project.

### get_segment_users
Gets a list of actual user IDs who belong to a specific defined segment or cohort.

### list_ads
Provides an overview and details of all currently tracked advertising campaigns.

### list_events
Lists all the types of behavioral events that have been configured in the project.

### list_log_sources
Lists and describes all the data sources feeding into the GrowingIO platform.

### list_segments
Retrieves a list of all defined user segments, allowing you to see available cohorts.

### list_variables
Lists and describes every tracked variable or field used across the project's data.

## Prompt Examples

**Prompt:** 
```
List all user segments in GrowingIO.
```

**Response:** 
```
I've retrieved your GrowingIO segments. You have 15 defined cohorts, including 'Power Users', 'At-Risk Users', and 'New Signups'. Which one would you like to see the user list for?
```

**Prompt:** 
```
Show me the conversion funnel for 'Checkout Flow'.
```

**Response:** 
```
I've retrieved the details for the Checkout Flow funnel. Current conversion rate is 42% from 'Add to Cart' to 'Purchase Complete'. The biggest drop-off is at the 'Shipping Info' step. Would you like to see the breakdown per device type?
```

**Prompt:** 
```
Query the DAU for the last 7 days.
```

**Response:** 
```
Across the last 7 days, your Daily Active Users (DAU) averaged 12,500, peaking at 14,200 on Wednesday. This represents a 5% increase compared to the previous week. Should I retrieve the metrics for Weekly Active Users (WAU) as well?
```

## Capabilities

### Check user activity logs
Retrieve metadata for specific tracked events that users perform within the product.

### Analyze conversion pathways
Get detailed data and configuration information on how users move through key checkout funnels.

### Run performance queries
Execute natural language requests to calculate specific metrics, like Daily Active Users or total purchases.

### Identify user groups
List and examine defined user segments to find high-value cohorts or at-risk users.

### Review advertising performance
Browse available ad campaigns to see which growth drivers are working best.

## Use Cases

### Troubleshooting a sudden drop in signups
The PM notices conversion rates dropped 15% yesterday. They ask their agent, 'What is the biggest drop-off point in the signup funnel?' The agent uses get_funnel and reports back that the friction is at the phone number verification step. They can then use get_event to check if the verification event itself is failing.

### Identifying a profitable group of users
The Growth Engineer wants to know who their best customers are. They ask, 'List all segments and then give me the user list for the 'Platinum Tier' segment.' The agent uses list_segments and get_segment_users to deliver an actionable list of IDs.

### Quarterly feature adoption audit
The Data Analyst needs a report on usage. They ask, 'Query the total number of times users viewed the help center in Q3.' The agent executes get_metrics and returns the precise count, saving hours of manual data extraction.

### Comparing campaign success
The Marketing Lead wants to know if their latest ad spend paid off. They ask, 'List recent ads and check the metrics for conversion attributed to Campaign X.' The agent uses list_ads and get_metrics to correlate spending with performance.

## Benefits

- Stop clicking through dashboards to understand basic usage. You can ask your agent to list all tracked events or get project metadata with a single command.
- Pinpoint exactly where users are dropping off. Use the MCP's funnels data to audit specific conversion paths, helping you fix leaks in the checkout process.
- Find high-value customers instantly. By using the segment tools, your agent can identify defined cohorts and give you the list of user IDs belonging to them.
- Quickly check performance without writing code. Use get_metrics to run quantitative queries on metrics like DAU or WAU just by asking a question.
- Coordinate marketing efforts better. You can list ads and track variables, ensuring that your campaign insights are directly tied back to user actions.

## How It Works

The bottom line is you tell your agent what data you need; it handles the connections and returns actionable metrics in plain text.

1. Subscribe to this MCP and provide your GrowingIO Project ID, Client ID, and API Token.
2. Connect the service to your preferred AI client like Claude, Cursor, or Windsurf.
3. Ask a natural language question—for example, 'What is the DAU for last week?'—and get the data returned instantly.

## Frequently Asked Questions

**How do I find out what events are tracked using GrowingIO with this MCP?**
You use list_events. This tool retrieves a full catalog of every behavioral event type currently configured within your project, letting you know exactly what data is available for tracking.

**Can I run complex queries like 'DAU minus WAU' using the get_metrics tool?**
Yes, you can execute quantitative metric queries with get_metrics. You just need to phrase your request clearly in natural language and ensure the variables you reference are tracked.

**What is the difference between list_segments and getting users in a segment?**
list_segments shows you what cohorts exist (the names). get_segment_users takes one of those cohort names and gives you the actual, specific IDs of all the users who belong to it.

**Does this MCP help me understand ad campaign success?**
Yes. You can use list_ads to see available campaigns, and then combine that with get_metrics to check if a specific advertising effort is correlating to higher conversion rates.

**I need general project details; what tool should I use in GrowingIO?**
Use get_project_info. This tool pulls the overall metadata and configuration for your entire platform, giving you a high-level view of the data structure.