# Zengain MCP

> Zengain MCP connects your customer success and usage analytics data to any AI client. It helps you identify high-intent website visitors by company, letting your agent pinpoint warm leads before they even fill out a contact form or send an email.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** customer-success, product-analytics, lead-scoring, user-engagement, adoption-metrics, customer-health

## Description

Stop guessing about why users churn. This connector gives your agent deep insight into how people are actually using your product and interacting with it. Instead of logging into multiple dashboards to piece together a user's journey, you can ask questions like, 'What is the health score for this account?' or 'List all products we offer.' The system pulls real-time usage metrics, showing which features users adopted and where they might be struggling. You can track key product milestones (KPM) and monitor custom events to build a complete picture of engagement.

When you need to automate outreach based on these findings—for example, sending an alert when a user's health score drops or if critical usage activity stops—the real power comes from combining this data. You can chain your agent with other MCPs in the Vinkius catalog; for instance, linking this analytics feed directly to a messaging platform’s MCP lets you automatically draft and send outreach to that warm lead right through your AI client's natural conversation flow.

## Tools

### get_health_score
Calculates the current customer health score for a specific user based on their engagement history.

### get_product
Fetches detailed configuration metadata for a single, named product within your account.

### get_analytics_summary
Retrieves a high-level summary of overall product usage metrics and key performance indicators.

### get_user_details
Pulls comprehensive information and profile data for an individual user ID.

### list_events
Retrieves a list of all custom tracking events that have occurred across the platform.

### list_kpms
Lists and checks Key Product Milestones to help identify successful onboarding stages or potential churn risks.

### list_products
Generates a list of all products currently registered in your Zengain account.

### list_users
Provides an immediate listing of every user associated with the product.

### list_webhooks
Shows all configured webhooks, letting you audit where external systems are receiving your data.

### track_event
Records a new, specific custom event (like 'Feature X clicked') to update the user's activity log.

## Prompt Examples

**Prompt:** 
```
List all products in my Zengain account.
```

**Response:** 
```
I've found 3 products: 'Desktop App v2', 'Cloud SaaS Portal', and 'Mobile Lite'. Which one should I analyze?
```

**Prompt:** 
```
What is the health score for user 'customer_456'?
```

**Response:** 
```
User 'customer_456' has a health score of 82/100 (Good). Their engagement has increased by 15% over the last 30 days.
```

**Prompt:** 
```
Show me a summary of usage analytics for this month.
```

**Response:** 
```
Across all products, you have 1,200 Daily Active Users (DAU) and 5,500 Monthly Active Users (MAU). Feature adoption for 'Real-time Sync' is at an all-time high.
```

## Capabilities

### Analyze Product Health
Get an overall summary of usage metrics, calculate individual customer health scores, or retrieve detailed information on specific product configurations.

### Track User Activity
List registered users and track custom events in real-time to see exactly what actions people are taking inside your platform.

### Monitor System Integrations
List configured webhooks so you can understand how data flows out of the system and where external tools are pulling information from.

## Use Cases

### The sudden drop in activity
A CSM notices a key user hasn't logged in this week. Instead of sending a generic 'checking in' email, they ask the agent to run `get_health_score` and review recent events via `list_events`. They discover usage dropped after product feature Y was updated. The CS manager can then follow up with highly specific training on Feature Y.

### Segmenting high-value leads
A Growth Marketer wants to find users who interacted with the pricing page multiple times but never signed up. They run `list_users` and filter by activity, then use `get_user_details` to pull their company info for targeted outreach.

### Debugging a broken integration
The ops engineer suspects data isn't making it from the platform to the CRM. They first run `list_webhooks` to check if any hooks are configured, then use `list_events` to verify that the core action event is actually being generated.

### Onboarding a new enterprise client
The Product Manager needs to confirm all necessary services are active. They run `list_products` for an inventory check, then use `get_product` on the specific 'Enterprise Tier' to ensure all required metadata is present before signing the contract.

## Benefits

- Stop guessing about lead quality. Use `get_health_score` to get a single, immediate number that summarizes how engaged a user is, rather than reviewing dozens of scattered metrics.
- Know exactly what the customer is doing at all times. You can track custom activity using `track_event`, creating an audit trail for every click or action taken in the product.
- Understand your full inventory. Use `list_products` and `get_product` to keep a precise record of every service offering, ensuring nothing gets overlooked during onboarding.
- Audit data flow easily. By running `list_webhooks`, you see exactly which external systems are connected, eliminating the fear that critical data is leaking or inaccessible.
- Get clear visibility into user status. The combination of `list_users` and `get_user_details` lets your agent pull profiles fast, giving context to every interaction.
- Manage product growth cycles. Running `list_kpms` helps you spot when a new customer hits a major milestone, signaling the perfect time for a high-value outreach.

## How It Works

The bottom line is you get deep, actionable insights into your customer base without jumping between tabs and dashboards.

1. Subscribe to this MCP, then supply your Zengain Tenant ID and API Key.
2. Connect it to your preferred AI client—like Claude or Cursor—from a single place.
3. Ask your agent any question related to user activity, product performance, or usage trends.

## Frequently Asked Questions

**How do I use the get_health_score tool with Zengain?**
You provide the specific customer ID to the agent; it returns their calculated health score and a brief explanation of why that number was generated. This is better than looking at raw usage numbers because the system weights them for you.

**Can I use list_events with Zengain MCP?**
Yes, `list_events` lets you see a full history of custom actions taken by users. This is critical because it shows *when* something happened, not just that it happened.

**Is get_user_details the same as list_users?**
No; `list_users` gives you a basic roster of all IDs. You must then use `get_user_details` on an individual ID to pull rich data like their profile information or company details.

**What is the best way to track user behavior?**
You should combine tools. Use `list_users` to find who you care about, then use `get_user_details` for context, and finally, `track_event` manually when a key interaction happens that needs logging.

**How do I check which webhooks are active using the `list_webhooks` tool?**
You use this MCP to see all configured endpoints and their status. It provides a list of registered hooks, allowing you to verify if your data flow connections are live or need updating.

**Can I refine my user search when using the `get_user_details` tool?**
Yes, you must provide specific identifiers like a unique user ID or email address. This ensures the agent pulls precise records for that single user instead of loading broad lists.

**What format does the `track_event` tool require to log a custom event?**
The tool requires three pieces of data: an event name, a timestamp, and a metadata payload. You define the event in natural language and include key/value pairs for context like user IDs or feature names.

**If I need to process a large number of users, is there a limit when using the `list_users` tool?**
The MCP handles pagination automatically for bulk reads. When you run this tool, it returns results in manageable chunks until all available user records are processed by your agent.

**Can I calculate a customer's health score using my AI agent?**
Yes! Use the `get_health_score` tool by providing the User ID. The agent will retrieve the real-time engagement score from Zengain.

**How do I see high-level usage summary for a specific product?**
Use the `get_analytics_summary` tool. You can optionally provide a Product ID to filter the metrics for that specific offering.

**Is it possible to track a new custom event through this integration?**
Yes, use the `track_event` action. Provide the User ID and the Event Name to record engagement data programmatically.