# Chameleon.io MCP for AI Agents MCP

> Chameleon.io manages your entire user lifecycle from right in your chat client. It lets you trigger product tours, read survey responses, and track custom user events for instant visibility into how people are adopting your software.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** user-onboarding, product-adoption, user-engagement, in-app-tours, user-segmentation, microsurveys

## Description

Need to know if a new feature is actually getting used? You can connect Chameleon.io to any AI agent and get full control over your onboarding and adoption data through natural conversation. Instead of logging into the dashboard, you simply ask your agent to track events or check user progress. This lets product teams quickly see which users are stuck and why. When you're working with complex tools like this, relying on a centralized catalog makes all the difference; that’s where Vinkius comes in, giving access to thousands of MCPs so you don't have to connect multiple services.

You can ask your agent to identify specific users by their properties, or pull up detailed records for all tours and surveys you've built. It handles everything from tracking a custom event when a user hits 'checkout' to deleting old accounts if compliance requires it. The result is that your product team moves faster because they get real-time behavior data without leaving the conversation.

## Tools

### list_chameleon_events
Lists recent custom events that users have tracked within Chameleon's system.

### delete_chameleon_user
Permanently deletes a user and all associated data records in Chameleon for compliance purposes.

### get_experience_details
Retrieves specific information about any given product experience, like tours or launchers.

### identify_chameleon_user
Creates a new user profile or updates an existing one with custom identifying properties.

### list_experiences
Provides a complete list of all product experiences (tours, launchers, microsurveys) you have set up.

### list_user_segments
Shows every user segment group that has been configured within Chameleon.

### list_microsurvey_responses
Retrieves and lists the most recent feedback submissions from your microsurveys.

### track_user_event
Logs a new, custom behavioral event for a specific user at a defined point in their journey.

## Prompt Examples

**Prompt:** 
```
What are our top 5 most active user segments right now?
```

**Response:** 
```
**Current Active User Segments**

| Segment Name | Count | Last Updated |
| :--- | :---: | :--- |
| Enterprise Clients | 450 | Today | 
| Free Trial Users (3-day) | 1,210 | 2 hours ago |
| Education Sector Leads | 78 | Yesterday |

*The 'Free Trial' segment is the most active group. They generated 1,520 events in the last 24 hours.*
```

**Prompt:** 
```
Show me all my current product tours and tell me which ones are linked to a survey.
```

**Response:** 
```
Found 6 total experiences:

*   **Welcome Tour:** (Tour) — No associated surveys.
*   **Advanced Feature Guide:** (Launcher) — Linked to 'Feature Feedback Survey'.
*   **Setup Wizard:** (Microsurvey) — Measures initial setup success.
*   **Billing Flow Guide:** (Tour) — No associated surveys. 

You have 2 experiences that connect user feedback to the flow.
```

**Prompt:** 
```
I need to update a user's profile before they see the next onboarding step.
```

**Response:** 
```
Okay, I updated the profile for **user_789**. The following properties were applied:

*   **Plan:** Enterprise (Updated from Basic)
*   **Industry:** Fintech (New property added)
*   **Internal Status:** Qualified Lead

This user is now eligible to see all premium content and advanced tours.
```

## Capabilities

### List all product experiences (Tours, Launchers, Microsurveys)
Shows every onboarding flow or survey you've created so your agent can pick the right one.

### View and manage user segments
Lists out all of your defined user groups, allowing you to check who falls into specific categories.

### Review recent microsurvey responses
Pulls the most current feedback from surveys so you can gather immediate qualitative data.

### Update user profiles with custom properties
Allows your agent to modify a user's record, adding or changing details like their plan level or industry.

### Log and monitor custom user events
Tracks specific actions taken by users in the app—like clicking 'Upgrade' or 'Complete Setup'.

### Permanently delete a user record
Removes all associated data for a single user, fulfilling compliance and deletion requests.

## Use Cases

### Investigating a Drop in Conversion Rate
A product manager asks, 'Why did the checkout completion rate dip last week?' The agent checks for recent activity using `list_chameleon_events` and identifies that users are failing to complete the required profile step because of missing data. This pinpoints the exact behavioral gap.

### Targeting a New Enterprise Client
A customer success manager needs to onboard a large client quickly. They use `identify_chameleon_user` to update the user profile with 'Enterprise' plan details, ensuring all future tours and segments they see are appropriate for that level.

### Reviewing Beta Feedback
The product marketing manager wants to know what users thought about a new feature. They ask the agent to check `list_microsurvey_responses`, getting an instant, summarized report of user feedback without opening the survey dashboard.

### Auditing Active Onboarding Flows
A development team member needs to verify all active onboarding flows. They call `list_experiences` and instantly get a comprehensive list of all tours, launchers, and surveys needing review or updates.

## Benefits

- Immediate insights into user drop-off: Use the `track_user_event` tool to log specific actions, letting your agent tell you exactly where users are stalling.
- Granular data control: The ability to `identify_chameleon_user` means you can ensure that any action taken—like showing a premium tour—is targeted only at the right profile.
- Full experience oversight: Instead of digging through menus, use `list_experiences` to get an instant summary of all active tours and surveys in natural language.
- Compliance made easy: Don't worry about GDPR. Use `delete_chameleon_user` to permanently remove a user’s data with one simple command.
- Deep feedback loop: Quickly analyze real-world sentiment by using `list_microsurvey_responses`, gathering qualitative data without leaving your chat client.

## How It Works

The bottom line is you treat complex user onboarding data—normally locked in a dashboard—like a simple conversation thread.

1. Subscribe to this MCP and provide your unique Chameleon Account Secret (which you find in Settings > API).
2. Connect your preferred AI client. The agent now has permission to read and write user data across all your product experiences.
3. Start giving commands, like 'What happened with the last 10 signups?' or 'Show me all active tours,' and get immediate answers.

## Frequently Asked Questions

**How does the Chameleon.io MCP help me track where users are dropping off?**
It lets your agent monitor specific actions using `track_user_event`. You can pinpoint exactly which step in your onboarding flow causes users to leave, giving you actionable data to improve the experience.

**Can I use Chameleon.io MCP to check what my current user segments are?**
Yes. You ask the agent, and it retrieves a list of all your pre-configured user groups. This helps you confirm that your marketing or product campaigns are targeting the right people.

**Is Chameleon.io MCP useful for collecting feedback from beta users?**
Definitely. You can ask the agent to retrieve and analyze recent microsurvey responses, giving you a quick summary of user sentiment without accessing the dashboard yourself.

**What if I need to change a user's plan or status? Can Chameleon.io MCP do that?**
The agent can update user profiles using `identify_chameleon_user`. This lets you modify custom properties—like changing 'Basic' to 'Enterprise'—to immediately adjust what the user sees in your product.

**Is Chameleon.io MCP required for GDPR compliance?**
While it doesn't handle all compliance, it provides a critical tool: `delete_chameleon_user`. This allows you to permanently remove a user and their data record when requested.