# Formbricks MCP MCP > Formbricks captures user feedback with open-source surveys you embed directly into your product. It lets you collect actionable insights right when they matter most. Use this MCP to manage survey structures, pull individual responses, and track contact details through natural conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** user-feedback, experience-management, survey-automation, data-collection, product-insights ## Description Collecting user feedback shouldn't feel like pulling teeth. This MCP connects your Formbricks environment to your AI agent so you can handle surveys and data collection entirely through chat. You can ask your agent to list all existing surveys or check the status of specific ones, making management a simple query. Need to analyze what users are saying? The tool lets you pull detailed results for any survey submission, giving you raw feedback ready for review. It also keeps track of who submitted the data—retrieving person details and metadata helps you build out user profiles instantly. When you connect this MCP via Vinkius, your agent treats all these resources like a single database, turning unstructured conversation into actionable product insights. ## Tools ### create_survey Build a brand new survey structure in Formbricks. ### delete_survey Remove an existing survey from your account. ### get_person Fetch the full details and custom attributes for a specific user by ID. ### get_response Retrieve all data points and answers from one particular submission. ### get_survey Get the full structure and settings for a specific survey ID. ### list_action_classes See all configured action classes that control data flow in your product. ### list_people Get a list of every identified person record available in Formbricks. ### list_responses List multiple survey responses, optionally filtering them by a specific survey ID. ### list_surveys Fetch an overview of every survey currently configured in your account. ### list_webhooks List all external webhooks set up to trigger when data changes. ## Prompt Examples **Prompt:** ``` List all surveys in Formbricks. ``` **Response:** ``` I've found 4 surveys: 'Product Feedback', 'NPS Survey', 'Onboarding', and 'Feature Request'. ``` **Prompt:** ``` Show me responses for the NPS survey. ``` **Response:** ``` Retrieving responses... I found 15 submissions. The average score is 8.5. Notable comments include 'Easy to use' and 'Needs dark mode'. ``` **Prompt:** ``` Get metadata for person 'user_555'. ``` **Response:** ``` Person 'user_555' is Jane Doe. They are on the 'Pro' plan and have completed 3 surveys in the last month. ``` ## Capabilities ### See and manage surveys List every survey in your account or build new ones programmatically. ### Analyze specific responses Pull the full details for any single user submission to review feedback content. ### Track people records Retrieve metadata and custom attributes for identified users in your system. ### Review data flow settings Check the status of configured webhooks and action classes to understand how your product handles data. ## Use Cases ### Investigating a poor NPS score A customer service rep needs to know why user 'johnny' gave a low score. They ask the agent to find Johnny's details using `get_person` and then pull his responses via `get_response`. This immediately shows the pain points, allowing them to address the issue quickly. ### Auditing data collection A PM needs to know if they have overlooked any feedback forms. They ask the agent to run `list_surveys`, which instantly provides a checklist of every active and inactive survey, ensuring nothing is missed. ### Onboarding workflow check The ops team wants to understand if user data is flowing correctly when they complete the onboarding flow. They use `list_webhooks` and `list_action_classes` to verify that every necessary data point is being triggered. ### Analyzing a feature release After deploying a new widget, the team wants aggregated feedback. Instead of exporting CSVs, they ask the agent to run `list_responses`, optionally filtering by the specific survey ID for that widget, giving them instant, focused data. ## Benefits - Stop manually checking dashboards. Use the agent to run `list_surveys` and get a full overview of every survey you own in seconds, without leaving your chat window. - Deep dive into single submissions. If a user leaves a vague comment, asking for `get_response` pulls all their answers at once, giving context immediately. - Build better user profiles. Running `list_people` lets your agent get a list of contacts, and then you can use `get_person` to grab that person's specific metadata (like subscription tier). - Track data flow easily. Use tools like `list_webhooks` or `list_action_classes` to map out exactly where and how customer data moves through your product. - Maintain clean data. Need to sunset an old survey? You can use the agent to programmatically run `delete_survey`, keeping your workspace tidy. ## How It Works The bottom line is, you talk to your AI client like talking to a database administrator; it handles all the API calls in the background. 1. Subscribe to this MCP and enter your Formbricks Personal API Key. 2. Your agent reads the connection, making all survey management tools available for use. 3. You simply ask your agent a question—like 'What were the responses for the NPS survey?'—and it fetches the data directly. ## Frequently Asked Questions **How do I find out what surveys are available using list_surveys?** You run the `list_surveys` tool. This instantly returns an overview of every survey ID and name you have created in Formbricks, giving you a quick inventory. **Does get_response require me to know the submission date?** No. You only need the specific response ID. The tool uses that unique identifier to retrieve all associated data points and answers for that single submission, regardless of when it was submitted. **What if I want to see multiple responses from one survey?** Use `list_responses`. You can optionally pass a Survey ID as a filter, which makes sure the agent only returns submissions related to that specific form. **Can I get metadata for a person using get_person?** Yes. The tool pulls not just basic contact info but also any custom attributes you've set up in your Formbricks user profile, giving deep context about the individual. **If I need to remove an entire survey structure, how do I use `delete_survey`?** It permanently removes the survey and all associated metadata. Before running this tool, verify that no active responses or workflows depend on it. **Before getting specific details with `get_person`, how can I view a filtered list of contacts using `list_people`?** This tool returns a paginated list of identified people, allowing you to filter by attributes. You'll use the returned IDs to target precise records for detailed retrieval. **If I need to monitor data flow and see what external systems are connected, how do I use `list_webhooks`?** Running this tool lists all configured webhooks and action classes. It’s essential for debugging or verifying which services receive your submitted feedback. **What key details does the `get_survey` function provide about a survey's structure?** It returns the full schema, including all field types and whether answers are required. This lets your AI client validate incoming responses against the correct format. **Can I list all my active surveys using my AI agent?** Yes! Use the `list_surveys` tool to retrieve a full list of surveys in your Formbricks environment. **How do I check responses for a specific survey?** Simply provide the Survey ID to the `list_responses` tool. Your agent will fetch all submissions associated with that survey. **Can I delete a survey using this agent?** Yes, use the `delete_survey` action and provide the unique Survey ID.