# Countly MCP for AI Agents AI Agent Connect

> Countly MCP lets you manage product analytics via your AI agent. Track user sessions, record custom events, and pull deep behavioral metrics without leaving your chat window. It turns your product data into a conversation.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_XCn8RC0rHZifc5Dr5D6YChNJVMfaKxEkqpKm6o4D/ai-agent-connect
- **Tags:** product-analytics, user-tracking, event-logging, session-management, data-segmentation

## Description

This Connector lets you talk to your Countly analytics data directly. Instead of digging through complex dashboards or manually filtering event logs, you can just ask your agent for the numbers you need. If you're trying to figure out where users are dropping off in your funnel, you can pull those specific session metrics instantly. You can also have your agent record new events or update user profiles on the fly as part of a larger task. It's a way to make your product data actionable without the usual overhead of navigating a web UI. You'll find this especially useful when you're connected to the Vinkius catalog, as it lets you jump from high-level strategy to specific data points in seconds. It handles the heavy lifting of querying your analytics so you can focus on making decisions based on what's actually happening in your app.

## Tools

### end_session
Close out a user's current session. This ensures your engagement metrics stay accurate.

### read_drill
Perform complex filtering and deep-dive analysis on your enterprise data. It handles the heavy lifting of segmentation.

### read_events
Fetch detailed records for specific custom keys. Use this to see exactly what happened during a specific action.

### read_metrics
Get standard numbers for sessions, users, or countries. This is the fastest way to see high-level app health.

### record_events
Log specific actions taken by users inside your app. Use this to capture custom interactions like button clicks.

### update_session
Extend the duration of an existing user session. It helps you keep track of long-running engagement.

### update_user_details
Change names, emails, or custom properties for a specific user. This keeps your user database clean and current.

### begin_session
Start a brand new session for a user. Use this to initialize tracking for a new interaction.

## Prompt Examples

**Prompt:** 
```
How many users signed up from the UK yesterday?
```

**Response:** 
```
I've pulled the latest data for you. There were **142 new signups** from the UK yesterday. 

| Region | Signups |
| :--- | :--- |
| UK | 142 |
| US | 890 |
| CA | 312 |
```

**Prompt:** 
```
Record a 'premium_upgrade' event for user 'user_55' with a value of 99.00.
```

**Response:** 
```
Done. I've recorded the **premium_upgrade** event for user **user_55**. The value of **99.00** has been logged successfully in your Countly analytics.
```

**Prompt:** 
```
Update the email for user 'dev_99' to 'dev_test@example.com'.
```

**Response:** 
```
I've updated the profile for user **dev_99**. The email address is now set to **dev_test@example.com** in your Countly database.
```

## Capabilities

### Pull session and user metrics
Get high-level numbers on active users and geographic distribution instantly.

### Record custom app events
Log specific user actions like purchases or signups using your agent.

### Update user profiles
Modify names, emails, and custom properties for your users through chat.

### Extend active sessions
Keep user sessions active or end them to manage engagement data accurately.

### Query specific event data
Fetch detailed records for specific custom keys to find behavioral patterns.

### Filter data with the Drill API
Perform complex segmentations and deep-dive analysis on your enterprise data.

## Use Cases

### Finding a funnel bottleneck
A product manager asks the agent to find where users drop off. The agent uses read_events to pull data on a specific sign-up step.

### Bulk updating user profiles
A growth lead needs to update emails for a new cohort. They ask the agent to run update_user_details for the new list.

### Quick KPI checks
An analyst needs to know the session count for the last hour. The agent uses read_metrics to pull the data in seconds.

### Custom event auditing
A developer wants to see how many people clicked a new button. The agent uses read_events to fetch data for that specific key.

## Benefits

- Stop jumping between tabs by using read_metrics to get high-level numbers instantly in your chat window.
- Automate your data entry by using record_events to log user actions without manual intervention.
- Keep your user database clean by using update_user_details to modify names and emails via your agent.
- Get deep-dive insights into specific user segments using read_drill for complex enterprise filtering.
- Manage real-time engagement by using begin_session, end_session, and update_session to track active users accurately.

## How It Works

The bottom line is you get instant access to your product's behavioral data through a natural chat interface.

1. Subscribe to the Connector and gather your Countly Server URL and API credentials.
2. Input your App Key, API Key, and App ID into your preferred AI client.
3. Ask your agent to pull reports, update profiles, or record events in plain English.

## Frequently Asked Questions

**How does the Countly MCP help my product team?**
It lets your team talk to your analytics data using natural language. Instead of digging through dashboards, you can ask your agent for specific metrics, user counts, or event data instantly.

**Can I use Countly MCP to update user information?**
Yes. Your agent can update names, emails, and custom properties for specific users directly through the Connector, which helps keep your user database current without manual entry.

**Does Countly MCP support custom events?**
It does. You can have your agent record specific actions within your app, like button clicks or purchases, and then query those events later to see how users are interacting with your features.

**Is Countly MCP good for large scale data filtering?**
If you have the Enterprise Edition, it includes the Drill API. This allows your agent to perform complex segmentations and deep-dive analysis into your data.

**Can I use Countly MCP with Claude or Cursor?**
Yes. This Connector is compatible with any MCP-supported client, including Claude, Cursor, Windsurf, and VS Code, allowing you to access your analytics from your favorite workspace.

**What happens when I ask for metrics via Countly MCP?**
Your agent will pull the latest data for sessions, users, or countries and present it to you in a clear, readable format, often including summaries or tables.

**How can I retrieve aggregated data like total sessions or user counts?**
You can use the `read_metrics` tool. Simply specify the method (e.g., 'sessions' or 'users') to get the aggregated analytics data from your Countly instance.

**Can I record custom user actions with metadata?**
Yes! Use the `record_events` tool. You can provide a device ID and an array of event objects containing keys, counts, and segmentation details to track specific interactions.

**Does this server support advanced filtering for Enterprise users?**
Yes, if you have the Enterprise Edition, you can use the `read_drill` tool to perform complex queries and segmentation using the Drill API.