# Zenloop MCP MCP

> Zenloop helps your AI agent analyze Net Promoter System (NPS) feedback and manage customer surveys without logging into a dashboard. It lets you pull, summarize, and even programmatically submit responses from various channels like email or websites.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** nps-tracking, customer-feedback, experience-management, survey-analysis, retention-metrics, customer-insights

## Description

This connector links your AI client directly to Zenloop for managing all things customer feedback. Instead of jumping through dashboards, you ask your agent what you need—whether it's an overall account status check or a deep dive into specific sentiment trends. You can automatically list active and historical surveys or pull targeted answers based on date ranges. Plus, the ability to generate responses across different platforms means you can simulate customer input for testing or automation. Because all data flows through Vinkius, you get full visibility via Vinkius AI Analytics; you always know exactly which tool was called and what data moved. This capability is critical when building complex workflows that need accurate feedback metrics.

## Tools

### get_account_details
Retrieves basic configuration and metadata about your Zenloop account setup.

### list_survey_answers
Lists all customer answers and responses, with the ability to filter them by date range.

### create_email_answer
Creates a new survey response that simulates coming from an email embed source.

### create_embed_answer
Generates a new survey response designed for a website embed channel.

### create_link_answer
Creates a new survey response that simulates coming from a simple link click.

### create_overlay_answer
Generates a new survey response meant for a website overlay pop-up.

### get_survey_details
Pulls specific details for a single, identified survey ID.

### list_surveys
Provides a complete list of every configured survey in your Zenloop account.

## Prompt Examples

**Prompt:** 
```
List all active surveys in my Zenloop account.
```

**Response:** 
```
I've retrieved your surveys. You have 4 active surveys, including 'Post-Purchase NPS', 'Website Exit Intent', and 'Email Newsletter Feedback'. Would you like to see the responses for any of them?
```

**Prompt:** 
```
Show me customer responses for survey ID 'abc123xyz' from last week.
```

**Response:** 
```
I found 25 responses for survey abc123xyz from the last 7 days. The average NPS score is 8.4. Notable comments include 'Excellent service!' and 'Delivery was a bit slow'.
```

**Prompt:** 
```
Submit a Link response for survey 'abc123' with score 10 and comment 'Amazing experience!'.
```

**Response:** 
```
Successfully submitted the response to survey 'abc123'. The score of 10 and your comment have been recorded in Zenloop.
```

## Capabilities

### List Surveys
Retrieves a list of all active and configured surveys within your Zenloop account.

### Get Survey Details
Pulls detailed configuration information for one specific survey ID.

### List Responses by Date
Retrieves individual customer answers and responses, allowing you to filter the results by a specified date range.

### Get Account Metadata
Pulls high-level configuration data for your entire Zenloop project setup.

### Submit Link Response
Creates a new survey response that appears as if it came from a direct link click.

### Submit Email Response
Generates a new survey answer specifically formatted for an email embed channel.

### Submit Website Embed Response
Creates a synthetic survey response designed to look like it came from the main website body.

## Use Cases

### The Quarterly NPS Deep Dive
A data analyst needs to compare sentiment from Q1 versus Q2. Instead of exporting multiple CSVs, they ask their agent to use `list_survey_answers` twice—once filtered for the start/end dates of each quarter—getting two clean datasets instantly.

### Feature Feedback Loop
A Product Manager wants to know what users think about a new feature. They ask their agent to get details on the relevant survey using `get_survey_details` and then pull all responses related to that product area.

### Testing Integrations
A developer needs sample data for a QA test. Rather than waiting for a real user, they instruct their agent to use `create_overlay_answer`, submitting a fake response to ensure the downstream system accepts the input.

### Checking Project Health
A Customer Success Manager logs in and immediately asks: 'What is our current account status?' The agent uses `get_account_details` to confirm access rights or check overall project metadata, saving time.

## Benefits

- Stop manually checking dashboards. Use `list_surveys` to instantly see all your active and historical survey titles, guiding your next analysis step.
- Need data for a report? Instead of clicking through pages, call `list_survey_answers`, specifying the start and end date so you get exactly the responses you need.
- Simulate data for testing. You can generate new submissions using dedicated tools like `create_link_answer` or `create_embed_answer` to model user input without manual entry.
- Quickly check setup info. Running `get_account_details` gives you high-level metadata about your project, letting you confirm connection status right away.
- Build complex automation chains. Combine this MCP with a messaging tool to automatically analyze feedback and then send a follow-up summary message.

## How It Works

The bottom line is that you treat Zenloop like another API endpoint in your workflow, talking to it purely through natural conversation.

1. First, subscribe to this MCP and enter your Zenloop API Token.
2. Next, direct your AI agent to run a specific action, such as listing all surveys or retrieving responses for a date range.
3. Finally, the agent executes the call, returning the requested data directly to your chat window.

## Frequently Asked Questions

**How do I find my Survey Hash ID?**
Use the `list_surveys` tool to see a comprehensive list of all surveys in your account along with their unique hash IDs.

**Can I filter survey responses by date?**
Yes, the `list_survey_answers` tool accepts optional `date_from` and `date_to` parameters in YYYY-MM-DD format.

**Is it possible to programmatically submit an NPS score?**
Absolutely. You can use the specific create tools (e.g., `create_link_answer`) to submit scores and comments for any survey channel.

**What information does using `list_surveys` provide?**
It gives you a comprehensive list of every active or historical survey configured in your account. This allows your agent to quickly identify all the relevant survey IDs before you pull specific performance data.

**If I need to submit a new answer, how do I choose between the different `create` tools?**
You select the tool that matches the channel the customer used. Use `create_link_answer` for direct links, or `create_embed_answer` if the survey was embedded directly on a website page.

**How can I get detailed configuration data for one specific survey using `get_survey_details`?**
You pass the unique ID to this function. It returns all metadata about that single survey, confirming things like its status and key metrics before you attempt to list responses.

**What does `get_account_details` show me about my Zenloop account?**
This tool retrieves high-level information, including overall project configuration and metadata. It's useful for checking your general status or understanding account limits without needing to query specific surveys.

**When should I use `list_survey_answers` instead of `get_survey_details`?**
Use `get_survey_details` when you need the survey's settings; use `list_survey_answers` when your goal is to actually pull the responses, which can then be filtered by a date range.