# Formbricks MCP

> Formbricks connects your feedback and survey management to any AI agent, giving you conversational access to user-generated data. It acts as an open-source alternative to commercial platforms like Typeform or Qualtrics, letting agents list surveys, retrieve responses, manage contacts, and track organizational tags directly through natural conversation.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** feedback-collection, user-experience, open-source, survey-automation, customer-insights, data-retrieval

## Description

Stop jumping between dashboards just to get a single answer. This MCP lets your AI agent connect right into Formbricks, giving you instant oversight of customer feedback and survey data. You don't need to learn complex API calls; you simply ask your agent for what you need—like listing all surveys or finding responses related to 'Dark Mode.' Your agent can fetch detailed question metadata from specific surveys, find a person's full profile by searching contacts, or even list out all the organization tags applied to a piece of feedback. This capability lets you manage your entire customer experience workflow conversationally. When paired with Vinkius, you get immediate access to this specialized data layer, making it easier than ever to turn raw user responses into actionable insights without writing a single line of code.

## Tools

### create_survey
Creates a brand new survey within your Formbricks account.

### delete_survey
Permanently removes an existing survey from the system.

### get_environment_info
Retrieves essential background details about your current Formbricks environment setup.

### get_contact_details
Fetches comprehensive metadata for a specific CRM contact profile.

### get_product_info
Retrieves detailed information about the product associated with your account.

### get_response
Gets deep details for a single, specific survey submission to analyze user sentiment and answers.

### get_survey
Retrieves all the structural details about an entire survey, including its questions.

### list_contacts
Provides a list of all current CRM contacts in your system.

### list_responses
Retrieves a summary list of recent survey responses submitted by users.

### list_surveys
Lists all the surveys currently available in your account environment.

### list_tags
Retrieves a list of organizational tags you can use to categorize feedback and content.

### update_survey
Modifies the settings or structure of an existing survey.

## Prompt Examples

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

**Response:** 
```
Retrieving surveys... I found 4 surveys, including 'Feature Request' (published) and 'Post-Onboarding Survey' (published). Would you like to see the responses for any of these?
```

**Prompt:** 
```
Show me the last 5 responses for survey ID 'sur_abc123'.
```

**Response:** 
```
Fetching responses... For survey sur_abc123, I found 5 recent submissions. Sentiment appears generally positive with key requests for 'Dark Mode' and 'API improvements'.
```

**Prompt:** 
```
Find the contact profile for 'john.doe@example.com'.
```

**Response:** 
```
Searching contacts... I found a profile for John Doe. He has submitted 3 survey responses and is tagged with 'Beta User'.
```

## Capabilities

### Survey Creation and Maintenance
Build, modify, or delete entire surveys directly through your agent.

### Customer Data Retrieval
Search for specific contacts and retrieve their complete metadata profiles from the CRM.

### Response Analysis
Pull real-time lists of submitted survey responses or fetch full details on individual submissions to gauge user sentiment.

### Data Organization
List and manage the organization tags used across your surveys and feedback loops, keeping data clean.

### System Context Retrieval
Get foundational details about the environment or product to maintain full context during conversations.

## Use Cases

### The PM needs to gauge reaction to a new UI element.
A Product Manager asks their agent: 'Show me responses for the onboarding survey related to the dashboard.' The agent runs list_responses and get_response, pulling specific feedback points that confirm whether users are struggling with the new layout. They immediately see which questions need rewriting.

### The CS team member needs a customer's full history.
A Customer Success agent asks: 'What is John Doe's contact profile and how much feedback has he given us?' The agent runs list_contacts and get_contact_details, giving the agent the necessary context to handle the call effectively.

### Marketing needs to audit old survey content.
A Marketing Operations person asks: 'List all surveys that haven't been updated in six months.' The agent uses list_surveys, allowing them to quickly identify outdated forms and decide whether to delete_survey or update_survey.

### The data analyst needs a full view of the product context.
An analyst asks: 'What are the core features we've been testing?' The agent runs get_product_info, retrieving key system details and helping structure reports that tie feedback directly to specific product components.

## Benefits

- Get immediate insights by listing responses. You can ask your agent to find the last five submissions for a specific survey ID, giving you an instant snapshot of user sentiment without navigating reports.
- Manage surveys on the fly. Instead of logging in to rebuild or tweak forms, use tools like list_surveys and update_survey to change statuses or adjust questions directly through conversation.
- Deep dive into contacts. Need to know everything about a person? Use get_contact_details to pull their entire metadata profile, including how many times they've submitted feedback.
- Automate data categorization. You can list tags and use them to keep your feedback loops organized automatically, ensuring that all responses are properly filed for later analysis.
- Streamline reporting. By combining tools like get_survey and list_responses, you bypass manual report generation entirely, turning raw data into conversation points.

## How It Works

The bottom line is that instead of logging into Formbricks and navigating multiple menus, you just talk to your AI client about the data you need.

1. Subscribe to this MCP through Vinkius and enter your Formbricks Personal API Key.
2. Connect your preferred AI client, like Cursor or Claude, to the Vinkius catalog.
3. Tell your agent what you want—for example, 'List all published surveys'—and it pulls the data instantly.

## Frequently Asked Questions

**How do I use the Formbricks MCP to find all my surveys?**
You run list_surveys. This tool pulls a full roster, letting you know exactly how many surveys exist and if they are published or in draft mode.

**Can I update survey settings using the Formbricks MCP?**
Yes, you use the update_survey tool. You don't have to manually edit the form; your agent handles changing the status or structure of existing surveys for you.

**What if I need a user's full contact history in Formbricks?**
You use get_contact_details. This retrieves all metadata associated with that person, giving context far beyond just their name and email address.

**Is the Formbricks MCP better than using a dedicated survey tool like Qualtrics?**
The Formbricks MCP gives you programmatic access to the data. You get conversation control over the insights, which is different from just having the raw platform interface.

**How do I connect my AI client to the Formbricks MCP?**
You subscribe via Vinkius and provide your API key. Then, you simply tell your agent what information you need—the rest is automated.