# Typeform MCP

> Typeform MCP connects your AI agent directly to Typeform data. Instead of manually exporting and cleaning CSV files, you can programmatically fetch form structures, analyze completion insights, and extract thousands of raw responses using natural conversation. It manages everything from listing all workspaces to pulling specific question arrays for advanced analysis.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** form-builder, survey-management, response-extraction, data-parsing, customer-feedback

## Description

Need to work with complex survey data? This MCP lets your AI client bypass the web panel entirely. You don't have to wrestle with heavy dashboards or dump massive, unreadable CSV files just to get a quick summary. Your agent can chat with Typeform directly: you tell it which form ID you need insights for, and it pulls that structured analytics instantly. It doesn't stop there; you can ask your AI client to list all forms across your entire account, or pull the underlying structure of an existing survey so you know exactly what data points you’re dealing with. If you're looking for a reliable catalog of tools like this, Vinkius makes connecting that intelligence fast and simple.

## Tools

### get_form_insights
Retrieves the overall analytics and completion metrics for a specific Typeform survey ID.

### get_form_details
Pulls the complete metadata and structural layout of any named Typeform document.

### get_form_responses
Gathers all submitted answers for a specific form ID, providing raw data points to your agent.

### list_forms
Provides an inventory of every Typeform survey currently active within the connected account.

### list_form_themes
Shows a list of available visual themes and design options for your forms before you build them.

### list_workspaces
Lists all independent workspaces associated with the Typeform account, helping you locate specific campaign groups.

## Prompt Examples

**Prompt:** 
```
List all forms strictly tied to our marketing department running today.
```

**Response:** 
```
Executed search. I found 2 forms actively listed on the primary token: 'End of Course Audit' (ID 98Ab) and 'Website UX Panel' (ID cc31). Do you want metadata on the UX panel specifically?
```

**Prompt:** 
```
Fetch the raw responses corresponding precisely to Form ID cc31 generated previously.
```

**Response:** 
```
Awaiting extraction protocols... Process resolved. We have 15 answers collected. The general sentiment is quite enthusiastic (rating averages around '8/10'). A recurring comment notes 'The UI flows really cleanly for mobile users'. How else can I summarize this dataset?
```

**Prompt:** 
```
Get the questions mapping block describing Form XYZ natively inside our array structurally without reading real data yet.
```

**Response:** 
```
Extracted architectural blueprint correctly. The Form XYZ encompasses exactly 6 blocks. Notably, a multiple-choice element ('How did you know us?') and a large text-field entry block ('Give suggestions'). Would you like to dump its responses now securely inside the session locally purely unhindered natively without blocks?
```

## Capabilities

### Map out entire form structures
List all workspaces or retrieve the underlying metadata to inspect how any Typeform survey is built.

### Discover available forms
Get a list of every active form within your account using simple commands.

### Analyze performance metrics
Pull aggregated analytics and completion rates for any specific form ID.

### Extract raw submissions
Retrieve thousands of individual answers, making the data available to your AI client without manual downloads.

### Check visual options
List all potential design themes for forms so you can plan your survey appearance ahead of time.

## Use Cases

### Analyzing post-launch user feedback
A product manager needs to know how users reacted to the new checkout flow. They ask their agent to get_form_responses for the 'Checkout Feedback' form ID. The agent collects 50 submissions and instantly summarizes that 70% of comments mention the payment page was confusing, saving hours of manual analysis.

### Auditing departmental survey usage
A marketing director needs to know what forms exist across three different teams. They use list_workspaces and then list_forms on each one. The agent returns a consolidated list, allowing the director to identify unused or outdated surveys quickly.

### Preparing for an A/B test
A UX designer needs to verify if two competing survey versions are using different underlying structures. They run get_form_details on both Form IDs and compare the metadata in the chat, confirming they only differ in one field type.

### Identifying data gaps after a campaign
After a big conference, an operations lead asks to check get_form_insights for the main survey. The agent shows that while completion rates are high, the 'Source of Referral' metric has zero inputs, pointing out a critical flaw in the form design.

## Benefits

- Stop dealing with messy CSVs. With get_form_responses, your agent pulls thousands of raw answers directly into the chat context, ready for immediate processing by your LLM.
- Audit your entire setup instantly. Use list_workspaces and list_forms to see every survey you own without having to click through dozens of dashboards manually.
- Understand performance at a glance. get_form_insights gives you key completion rates and analytics, letting you know immediately if a form needs revision.
- Build smarter surveys. get_form_details lets you inspect the structural blueprint of any form, so you can map flow logic without needing to enter the visual editor.
- Plan designs ahead of time. list_form_themes shows all available styling options before you commit to building a survey.

## How It Works

The bottom line is you get machine-readable access to Typeform’s backend without touching the website.

1. First, connect your AI client using an official token generated within the Typeform platform.
2. Next, use conversational commands to query specific fields, like listing workspaces or checking a form's structure.
3. Your agent processes the request and returns structured data—like analytics reports or raw answers—directly into your chat interface.

## Frequently Asked Questions

**How do I find all my Typeform surveys using the Typeform MCP?**
You use list_forms. This tool scans your entire account and gives you a complete, organized inventory of every single survey you have created or are running.

**What is the difference between get_form_details and get_form_responses?**
get_form_details shows you the form's structure (the questions and layout), while get_form_responses pulls in the actual, collected answers from users.

**Can I analyze data from different departments with Typeform MCP?**
Yes. You can use list_workspaces to see all departmental containers, then run tools like get_form_insights on specific forms within those workspaces.

**Does the Typeform MCP help me automate form creation?**
No. The MCP is for reading and analyzing data from existing forms. To build a new survey, you still need to use the Typeform platform interface.

**If I run get_form_responses, what format does the data come back in?**
The data is returned as structured text within your AI chat context. This allows your agent to process it immediately and summarize findings without needing a local file.