# Kissmetrics MCP

> Kissmetrics MCP connects your agent directly to user behavioral analytics data. Track every click, manage customer profiles, and query complex business metrics using natural language prompts. Stop building dashboards just to answer simple questions; let your AI client pull the exact people counts or event details you need instantly.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** behavioral-analytics, user-tracking, event-tracking, customer-journey, metrics, data-insights

## Description

You shouldn't have to write code or jump through five different tabs just to see how users are interacting with a new feature. This MCP lets your agent handle all that complexity for you. Instead of running multiple API calls, you simply ask your AI client a question—like, 'How many people viewed the pricing page last week?'—and it executes the necessary tracking and data retrieval automatically.

It handles everything from recording custom user events to updating profile details for specific customers. You can also discover exactly which event types or property names are available in your account without consulting documentation. This capability makes complex analytics feel like a simple conversation. Since Vinkius hosts this connection, you connect once and gain access to all these deep behavioral insights right inside your preferred agent environment.

## Tools

### alias_identities
Links two different user identifiers together so your system recognizes them as the same person.

### list_event_types
Retrieves a complete list of all custom event types currently defined in your Kissmetrics account.

### list_property_names
Shows every property name used across your user profiles and events for reference.

### query_metric_data
Pulls historical data for a specific, measurable metric ID when you know the parameters you want to check.

### query_people_count
Counts how many people match detailed criteria and returns that number directly.

### record_event
Logs a specific user behavior event, requiring both a person's identity and the name of the action.

### set_person_properties
Updates key characteristics or attributes for a specific individual in your customer database.

## Prompt Examples

**Prompt:** 
```
Record a 'Purchased' event for 'user@example.com' with price 49.99.
```

**Response:** 
```
I've recorded the 'Purchased' event for user@example.com. The price of 49.99 has been successfully attached as a property to this event in Kissmetrics.
```

**Prompt:** 
```
Set the property 'Plan Tier' to 'Enterprise' for 'customer_123'.
```

**Response:** 
```
Successfully updated properties for customer_123. The 'Plan Tier' is now set to 'Enterprise' in their behavioral profile.
```

**Prompt:** 
```
Show me all event types defined in my account.
```

**Response:** 
```
I've retrieved 15 event types from your Kissmetrics account, including 'Signed Up', 'Logged In', 'Purchased', and 'Feature Used'. Would you like to query metrics for any of them?
```

## Capabilities

### Track user activity
Log specific actions or events for individual users so you can map their journey through the application.

### Manage customer profiles
Set, update, and modify key attributes (properties) associated with a person's account in your system.

### Link user identities
Associate multiple identifiers—like linking a browser ID to an email address—to keep one unified view of a single user.

### Query performance metrics
Retrieve specific data points, such as the count of people or metric values over time, for business reporting.

### Discover available fields
List all predefined event types and property names used in your account to guide your queries.

## Use Cases

### Investigating a sudden drop in feature usage
A Product Manager notices low engagement. They prompt their agent: 'Show me the people count for users who logged in last week but never used the export tool.' The agent runs `query_people_count`, immediately flagging the user segment that needs attention.

### Tracking a limited-time marketing campaign
A Growth Marketer launches an ad campaign and wants to measure conversions. They ask their agent to record every successful purchase event, using `record_event` instantly as users complete the checkout flow.

### Updating a user's status after onboarding
A developer finishes setting up a new client account and needs to flag them as 'Beta Tester.' They prompt: 'Set the property 'Status' to 'Beta Tester' for customer_123.' The agent runs `set_person_properties` immediately.

### Calculating ROI on specific user journeys
A Data Analyst needs to compare revenue across different product lines. They ask the agent to pull historical metric data for 'Revenue' using `query_metric_data`, comparing Q1 results to Q2.

## Benefits

- Stop building dashboards just to answer simple questions. Instead of manual dashboard assembly, you can use the `query_people_count` tool to get immediate answers about user segments.
- Never lose track of a customer's journey again. You can use `alias_identities` to unify multiple IDs into one single view, even if they signed up on different devices.
- Manage user data quickly without touching the backend database. Use `set_person_properties` to update crucial profile information—like 'Plan Tier' or 'Region'—in a conversational prompt.
- Monitor feature adoption in real time. Instead of waiting for weekly reports, use the agent to record new events using `record_event` as soon as they happen.
- Save hours on data discovery. Tools like `list_event_types` and `list_property_names` let you see exactly what data points are available without diving into documentation or running boilerplate code.

## How It Works

The bottom line is, you get deep behavioral insights without writing any integration code.

1. Subscribe to this MCP and enter your Kissmetrics API Key within Vinkius.
2. Use your AI client's conversational interface, telling it exactly what data you need—for example, 'Show me the count of users who purchased X.'
3. Your agent runs the query against your live analytics data and returns a clean answer or dataset directly to your chat.

## Frequently Asked Questions

**How do I use Kissmetrics MCP to track events?**
You run the `record_event` tool via your agent. You just need to tell it the person's identity and the name of the action, like 'Purchased.' It handles logging the behavior.

**Can I check what data points are available with Kissmetrics MCP?**
Yes, you can use `list_event_types` to see every event type defined in your account. You also have `list_property_names` for all property names.

**Is Kissmetrics MCP better than using the raw API calls?**
Yes. While raw APIs give you access, this MCP wraps those complex calls into simple tools, letting your agent run them conversationally without you needing to write code.

**What if I need to find a user across multiple devices using Kissmetrics MCP?**
Use the `alias_identities` tool. This function links different identifiers (like an email and a browser ID) so your analytics view remains unified.

**Can I query data for specific metrics with Kissmetrics MCP?**
Absolutely. The `query_metric_data` tool lets you get historical values for a metric, provided you specify the necessary IDs and parameters.