# Chattermill MCP for AI Agents AI Agent Connect

> Chattermill helps you pull customer feedback and sentiment into your AI agent. It pulls data from sources like Zendesk and the App Store so you can track NPS, CSAT, and recurring themes without leaving your chat interface.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_7ElC5zitqUaAiTIJzTNguvk7mDPLGsadzWCfQEJc/ai-agent-connect
- **Tags:** sentiment-analysis, nps, csat, feedback-loop, customer-experience, data-unification

## Description

Connect your Chattermill account to any AI agent and take full control of your customer experience intelligence through natural conversation. Unify feedback from Zendesk, App Store, Typeform, and dozens of other sources into one view. Vinkius makes it easy to get this running in minutes so you can start querying your customer insights from Claude, Cursor, or any MCP-compatible client. You can see all your feedback projects, browse customer responses with date filters, and explore AI-generated themes to pinpoint recurring issues. It also lets you retrieve calculated metrics like NPS, CSAT, and net sentiment on demand, or audit your data sources. If you need to add new data, you can even submit feedback entries directly from your agent.

## Tools

### submit_feedback_response
Submit a new feedback response to a Chattermill project. You can include a comment, score, and source information.

### get_chattermill_metric
Retrieve a calculated metric like NPS, CSAT, sentiment, or volume for a project. Use this to get high-level performance data.

### get_chattermill_project
Get details of a specific Chattermill project by its ID. This is useful for looking up project-specific configurations.

### list_theme_categories
List categories that group feedback themes together. This is helpful for high-level trend analysis across your data.

### list_feedback_sources
List all feedback data sources for a project. Use this to see which platforms like Zendesk or Typeform are feeding your pipeline.

### list_data_types
List all feedback data types for a project. Use this to discover types like NPS or survey responses.

### list_chattermill_projects
List all available feedback projects in your Chattermill account. Use this first to find the project key you need.

### list_feedback_responses
List paginated feedback responses for a specific project. You can filter these by date to see recent customer comments.

### list_custom_segments
List custom segments defined for a project. Use this to access user-defined cohorts for advanced analysis.

### list_feedback_themes
List AI-generated feedback themes detected in a project. This helps you identify recurring customer topics automatically.

### get_response_details
Get detailed information for a single feedback response. This returns the comment, score, metadata, and applied themes.

## Prompt Examples

**Prompt:** 
```
What's our current NPS for the mobile app project?
```

**Response:** 
```
Retrieving NPS for 'mobile-app'... Your current NPS is **+42**. This is based on the last 500 responses. Would you like to see the sentiment breakdown or the top themes?
```

**Prompt:** 
```
Show me the most common complaints from the App Store.
```

**Response:** 
```
Checking App Store feedback... The most common issues are:

*   **Slow login** (high volume)
*   **UI bugs on tablets**
*   **Missing 'export' button**

These are all categorized under the **Performance** and **UX** themes.
```

**Prompt:** 
```
Summarize the latest 10 feedback responses for the web project.
```

**Response:** 
```
Here are the 10 latest responses for the 'web' project:

| Comment | Score | Source |
| :--- | :--- | :--- |
| Great UI, but slow | 4 | Web Survey |
| Love the new dashboard | 5 | App Store |
| Still having login issues | 2 | Zendesk |

Most users are praising the new dashboard but mentioning a slight delay in data syncing.
```

## Capabilities

### List all feedback projects
Get a complete list of your Chattermill projects to find the correct keys for your queries.

### Retrieve NPS and CSAT metrics
Pull calculated sentiment scores and volume data for any specific project instantly.

### Identify recurring themes
See AI-generated categories that group your customer feedback into actionable topics.

### Browse customer responses
Paginate through specific feedback entries filtered by date or source.

### Audit data sources
Check which platforms like Zendesk or Typeform are successfully feeding your pipeline.

### Access custom segments
View user-defined cohorts for targeted analysis of specific customer groups.

### Submit new feedback
Add new feedback entries directly to a project from your AI chat interface.

## Use Cases

### The 'Why is NPS dropping?' check
A CX Manager asks the agent to compare NPS across two projects. The agent uses get_chattermill_metric to show the trend.

### The 'What's the top complaint?' search
A Product Manager asks for the top 3 themes. The agent uses list_feedback_themes to identify 'slow loading' as a major issue.

### The 'Recent feedback summary'
An analyst asks for the last 20 responses from the App Store. The agent uses list_feedback_responses with source filtering.

### The 'Data audit'
An Ops lead wants to check if Typeform is sending data. The agent uses list_feedback_sources to confirm the connection.

## Benefits

- Stop jumping between Zendesk and your feedback dashboard. Use list_feedback_sources and list_feedback_responses to see everything in one place.
- Get instant answers on customer sentiment. Use get_chattermill_metric to pull NPS or CSAT scores instantly during meetings.
- Identify product friction faster. Use list_feedback_themes to see what is actually bothering your users based on AI analysis.
- Analyze specific user cohorts easily. Use list_custom_segments to filter feedback by your own custom rules.
- Submit feedback manually. Use submit_feedback_response to add notes or data points directly into your Chattermill pipeline.

## How It Works

The bottom line is you get a direct line to your customer sentiment data without switching tabs.

1. Subscribe to the Chattermill MCP on Vinkius.
2. Paste your Chattermill API Key from your dashboard into your AI client settings.
3. Ask your agent to pull NPS scores, themes, or recent feedback from your projects.

## Frequently Asked Questions

**Can I use Chattermill MCP to see my NPS scores?**
Yes, you can pull your NPS, CSAT, and net sentiment metrics directly into your chat. It's great for getting quick numbers during meetings without having to log in to the dashboard.

**Does Chattermill MCP support multiple sources like Zendesk and Typeform?**
Yes, it pulls from all the sources you've already connected to Chattermill. Your agent can see data from your app stores, surveys, and support tickets in one view.

**How do I get my API key for Chattermill?**
You can find your API key in your Chattermill dashboard under Settings. Once you have it, just paste it into your AI client's connection settings.

**Can my agent actually write new feedback to Chattermill?**
Yes, the Connector allows your agent to submit new feedback responses. You can have it save notes or manual entries directly into a specific project.

**Can I see specific themes from my customer feedback?**
Yes, it can list all the AI-generated themes Chattermill has identified. This helps you see recurring topics like 'billing issues' or 'slow performance' instantly.

**Is Chattermill MCP good for tracking sentiment trends?**
It's perfect for that. You can ask your agent to filter feedback by date or source to see how sentiment has shifted over time.

**Can I use this to see custom segments?**
Yes, it can access your custom segments. This is useful if you want to see how specific cohorts, like 'power users,' are feeling about your product.

**How do I find the project key I need to use with most tools?**
Start by asking the agent to run `list_chattermill_projects`. This returns all your projects with their keys. Most Chattermill API endpoints — responses, themes, metrics, etc. — require this project key as the first parameter.

**What customer experience metrics can I retrieve?**
Use `get_chattermill_metric` with a metric type of `nps`, `average_score`, `net_sentiment`, or `volume`. You can filter by date range, category, or theme for more targeted insights. All metrics require a project key.

**Where do I find my Chattermill API Key?**
Log in to your Chattermill account and navigate to **Settings > API**. You can generate and copy your personal API Key from that section. The key is used as a Bearer token on every API request.