# Fairing MCP

> Fairing helps you analyze post-purchase surveys and zero-party data directly through your AI agent. You can list survey questions, track individual customer responses, and pull high-level performance metrics without leaving your workflow. It puts all your consumer insights into natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** zero-party-data, customer-attribution, post-purchase-survey, consumer-insights, data-collection, marketing-analytics

## Description

Managing customer feedback shouldn't require jumping between dashboards or running complex reports. This MCP connects to Fairing so you can analyze everything from post-purchase surveys to zero-party data using just a chat prompt. You gain full control over understanding what customers think after they buy something. Instead of exporting raw data, your agent pulls insights on demand; for example, you can run `list_responses` to see all submitted feedback or use `get_customer_responses` to understand exactly why one specific user left a particular rating. It's about getting answers immediately. This capability fits right into the Vinkius catalog, letting any MCP-compatible client access this data alongside your other services. You can even check active integrations with platforms like Klaviyo or GA4 using `list_integrations`, giving you one place to monitor performance and customer sentiment.

## Tools

### list_responses
Lists every single survey response submitted by customers.

### list_surveys
Retrieves a list of all the surveys you have created in Fairing.

### get_account_info
Pulls general details about your connected Fairing account.

### get_customer_responses
Fetches all survey responses and data points specifically for one customer.

### get_insights
Gathers overall performance metrics and high-level trends across your surveys.

### get_me
Checks the current identity and status of the API token being used.

### get_question
Retrieves detailed information for a single, specific survey question.

### get_response
Gets the full details for one particular customer survey submission.

### get_survey_details
Fetches complete information about a single, defined survey.

### list_customers
Lists customers who have submitted any kind of survey response.

### list_integrations
Checks and displays all third-party platforms currently connected to Fairing.

### list_questions
Lists every available question template used across your surveys.

## Prompt Examples

**Prompt:** 
```
List all active survey questions on Fairing.
```

**Response:** 
```
I've retrieved your questions. You have 3 active questions including 'How did you hear about us?' (ID: 101) and 'Who is this gift for?' (ID: 102). Would you like to see the response count for any of these?
```

**Prompt:** 
```
Show me the latest 5 survey responses.
```

**Response:** 
```
Fetching recent responses... The latest feedback includes 'Instagram Ad', 'Friend Referral', and 'Google Search'. Would you like the details for response ID 205?
```

**Prompt:** 
```
Check my active integrations on Fairing.
```

**Response:** 
```
Inspecting integrations... Your account is currently connected to Klaviyo (Syncing), Google Analytics 4 (Active), and Meta (Active).
```

## Capabilities

### List all available surveys
Retrieve a list of every survey you have set up in Fairing.

### Get detailed question information
Fetch the full configuration and details for any specific survey question.

### Find all customer feedback records
List every single submitted response across all your active surveys.

### Analyze one customer's history
Pull all survey responses and data points associated with a single, named customer.

### Extract overall performance metrics
Get aggregated insights and high-level performance numbers across your entire suite of surveys.

### Review account details
Retrieve essential information about your Fairing account, including API token identity.

## Use Cases

### Why did my recent ad campaign underperform?
The marketing manager needs to know if poor performance relates to survey feedback. They ask their agent, 'Show me the responses from customers who mentioned paid ads.' The agent uses `get_customer_responses` and filters by keywords, giving a clear reason for low conversion rates.

### We need to segment our top 10% most valuable users.
The retention specialist asks the agent to 'List all customers who left feedback mentioning premium products.' The agent runs `list_customers` and helps pull targeted groups, allowing immediate, personalized outreach.

### We're launching a new product line; what should we ask about?
The data analyst uses the MCP to run `get_survey_details` on existing surveys. They compare current questions against known market gaps and suggest additions for the next round of feedback.

### I need a quick summary of general product sentiment.
Instead of looking at 50 different survey tabs, the analyst asks the agent to 'What are the overall performance metrics?' The agent runs `get_insights` and delivers a single, actionable summary.

## Benefits

- Stop compiling manual attribution reports. You can ask for aggregated insights, and the agent pulls performance metrics across all your survey streams instantly.
- Deep dive into single users' intent using `get_customer_responses`. Instead of wading through dozens of entries, you get everything related to one person's journey in seconds.
- Keep track of your tech stack. Use `list_integrations` to monitor if Klaviyo or GA4 are syncing correctly without having to log into those platforms separately.
- Understand the data structure first by running `list_questions`. You can quickly verify exactly what questions are active before asking for complex analysis.
- Gain full visibility over your account status using `get_account_info`, ensuring your AI agent has the correct credentials and permissions to run reports.

## How It Works

The bottom line is: you talk to your data instead of digging through spreadsheets.

1. Subscribe to this MCP and paste in your Fairing API Key (you find this key in the Fairing Settings > Account section).
2. Connect your preferred AI client, like Cursor or Claude, directly to this Vinkius catalog.
3. Ask a natural language question—for example, 'What were the top 3 reasons customers responded last week?' The agent runs the necessary tools and gives you the answer.

## Frequently Asked Questions

**How do I find out which surveys are active using the Fairing MCP?**
You call `list_surveys`. This tool gives you a definitive list of all survey titles and IDs, helping you focus your analysis on what's currently running.

**Can I get feedback for only one customer using Fairing MCP?**
Yes. Use `get_customer_responses` to pull every piece of data submitted by a single user, allowing you to trace their entire interaction history immediately.

**Does the Fairing MCP show me which platforms are connected?**
You run `list_integrations`. This tool gives you a current status report on all third-party services like Klaviyo or GA4 that are actively syncing with your account.

**What is the difference between list_responses and get_insights in Fairing MCP?**
The difference is scope. `list_responses` gives you a raw, itemized record of every single submission. `get_insights`, however, provides high-level averages, percentages, and trends across all those responses.

**Can I check my account details with the Fairing MCP?**
You use `get_account_info`. This confirms your basic setup information, which is useful for troubleshooting or confirming API access scope before running complex queries.