# Howuku MCP

> Howuku analyzes user behavior from your website. Your AI agent connects to this MCP to view heatmaps, track session recordings, list conversion funnels, and check for user feedback across multiple projects. It lets you understand exactly how people interact with your site without manually sifting through analytics dashboards.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** ux-research, heatmaps, session-recordings, conversion-rate, user-behavior

## Description

Trying to figure out why users drop off? You don't need guesswork; you need concrete data. This MCP connects your agent directly to Howuku, giving it access to deep behavioral insights from your web properties. Instead of opening dozens of tabs and piecing together reports, your AI client can pull everything into a single context. It retrieves session recordings so you can watch exactly what users did. You can also map out conversion funnels or check custom tracking events for specific actions. Because this MCP is hosted on Vinkius, your agent gets access to all these powerful tools in one place, making deep UX analysis available via simple conversation.

## Tools

### get_me
Provides basic information about the currently authenticated user making the request.

### get_project
Retrieves specific details for a single, named project site within Howuku.

### list_events
Lists all custom tracking events that have been set up for a given project.

### list_feedback
Retrieves visual feedback items submitted by users on the site, like comments or suggestions.

### list_funnels
Lists the defined conversion funnels for a project to track step-by-step user progress.

### list_heatmaps
Retrieves and lists available heatmaps, showing where users click or scroll on a page.

### list_organizations
Lists all corporate organizations associated with the current account.

### list_projects
Provides a list of every project (website) linked to your Howuku account.

### list_recordings
Lists recent session recordings, allowing you to review how real users interacted with the site.

### list_surveys
Retrieves a list of surveys configured for a project, used to gather qualitative user opinions.

## Prompt Examples

**Prompt:** 
```
List all my Howuku projects.
```

**Response:** 
```
I'll fetch your project list for you.
```

**Prompt:** 
```
Show me recent session recordings for project ID 123.
```

**Response:** 
```
I'll retrieve the latest recordings for that project.
```

**Prompt:** 
```
Check for any new user feedback on my site.
```

**Response:** 
```
I'll check the feedback items for your projects.
```

## Capabilities

### Analyze site flow and user journeys
Your agent can retrieve full session recordings and visualize heatmaps to pinpoint areas where users struggle or spend too much time.

### Track specific user actions
You can list custom tracking events, which helps you monitor critical interactions that aren't covered by standard analytics.

### Map out conversion paths
The MCP allows listing conversion funnels to see where users enter and where they usually get stuck before completing a goal.

### Collect direct user sentiment
It can list visual feedback items and surveys, giving you immediate access to what actual users are telling you about the site.

### Manage project scope
You can list all projects under your account, ensuring you analyze data from every website you manage.

## Use Cases

### Investigating low checkout completion rates
The agent first uses `list_projects` to select the e-commerce site. Then, it requests a view of the conversion funnels via `list_funnels`. If the data is inconclusive, the agent pulls recent recordings using `list_recordings` so you can watch users failing at the payment page.

### Testing new feature adoption
A Product Manager asks the agent to list all custom tracking events (`list_events`) for the new signup flow. This immediately confirms if the necessary milestones are being recorded and tracked, saving hours of manual API querying.

### Understanding user frustration points
You run a query that combines `list_heatmaps` with recent feedback data from `list_feedback`. The agent shows you that users are clicking on an unresponsive element, which the heat map confirms and the feedback items explain.

### Analyzing overall site health
The agent starts by getting user info using `get_me` to confirm access. It then uses `list_organizations` to ensure it's checking all relevant company properties before pulling data from the main project listing.

## Benefits

- You stop guessing about product adoption. By checking the `list_recordings`, your agent lets you watch actual sessions, seeing exactly where users fail or get confused.
- No more siloed reports. You can compare data points—like running a `list_funnels` against specific custom tracking events from `list_events`—to pinpoint exact drop-off causes.
- Gathering user opinions is easier. Your agent pulls together feedback by checking the `list_feedback` and listing available surveys, giving you immediate qualitative context.
- Manage multiple sites effortlessly. Instead of logging into separate dashboards, use `list_projects` to scope your analysis across every site under one roof.
- Pinpoint interaction weaknesses immediately. Running a query for `list_heatmaps` shows where users are clicking most, letting you validate design decisions without manually drawing the heat map yourself.

## How It Works

The bottom line is you get deep, multi-faceted UX research data without leaving your chat interface.

1. Tell your agent which site or project needs analyzing using the listing tools.
2. Ask the agent to pull specific behavioral data, like a list of recordings or heatmaps, for that identified project.
3. The MCP processes the request and returns structured data, giving your AI client immediate insights into user behavior.

## Frequently Asked Questions

**How do I find all my websites for Howuku MCP?**
You use `list_projects`. This tool pulls a comprehensive list of every site connected to your account, so you know exactly what data is available before analyzing anything.

**What is the difference between `list_recordings` and `list_heatmaps`?**
`list_recordings` lets you watch a user's actual actions in real-time. `list_heatmaps`, by contrast, shows where users tend to click or scroll across an entire group of sessions.

**Can I check custom events using list_events?**
Yep, you run `list_events` for a specific project. This tool tells you what custom actions (like 'downloaded report' or 'clicked help button') are being tracked beyond the standard analytics.

**How do I find out what users think about my site?**
You check `list_feedback` and run through available surveys using `list_surveys`. These tools gather direct, qualitative input from your audience.

**What information does `get_me` return about my current account?**
It immediately returns your authenticated user details. This is useful for scoping other requests, letting you ensure that subsequent calls to list projects or organizations are filtered correctly by your associated profile.

**How can I check out defined conversion paths using `list_funnels`?**
The tool pulls a list of established funnels for a project. This allows you to visualize the intended user journey and identify specific steps where users might be dropping off during checkout or sign-up.

**If I want to see what questions users answered, should I use `list_surveys`?**
Yes, it retrieves all active surveys tied to a project. You can then analyze the completion rates and structure of those specific data collection forms.

**What parameters do I need when using `get_project`?**
You must provide the unique ID of the project you want details for. This function returns comprehensive metrics and configuration specifics for that exact website instance, going deeper than a simple list.

**Is this the same as VWO?**
Howuku was acquired by VWO. This MCP uses the Howuku API which is now part of the VWO ecosystem.

**How do I get my Howuku API Key?**
You can find your API key in your Howuku/VWO dashboard under Account Settings > API Keys.

**Can I see session recordings?**
The list_recordings tool provides metadata and links to view session recordings for your projects.