BlockSurvey MCP lets you create and manage BlockSurvey surveys directly through AI assistants such as ChatGPT and Claude. Instead of manually building your survey question by question, you can simply describe what you want in natural language, and the AI can create or modify your survey for you.
What is BlockSurvey MCP?
The Model Context Protocol (MCP) allows AI applications to securely interact with external applications and services. With BlockSurvey MCP, you can use conversational instructions to perform common survey-building and management tasks in BlockSurvey.
You can use MCP to:
Create surveys
Add, edit, delete, and reorder questions
Manage answer choices
Make questions required or optional
Change supported question types
Edit welcome and thank-you screens
View existing surveys
Preview surveys
Publish surveys and get their public link
How to Connect BlockSurvey MCP
Before using BlockSurvey MCP, connect your BlockSurvey account to an MCP-compatible AI application.
Connect using Claude Desktop
Open Claude Desktop.
Go to Customize -> Connectors and click Add.
Enter a name for your MCP connection and enter the BlockSurvey MCP URL:
https://mcp.blocksurvey.io/mcpSelect the recommended authentication and OAuth client options shown in the connection window and click Add.
Click Connect to start the BlockSurvey authorization process.
Sign in to your BlockSurvey account.
Select the Organization you want to use.
Select the relevant Team Space.
Review the access requested by BlockSurvey MCP.
Click Allow on the consent page.
You will be redirected back to your application and can start using BlockSurvey MCP.
Connect using ChatGPT plugin
Open ChatGPT.
Click on Plugins.
Click on Plus icon and start the BlockSurvey authorization process.
Name your MCP (anything of your choice) and paste this URL: https://mcp.blocksurvey.io/mcp
Select OAuth in the dropdown. Select the Checkbox click on Create.
Click on the Sign in with Blocksurvey and start the BlockSurvey authorization process.
Sign in to your BlockSurvey account.
Select the Organization you want to use.
Select the relevant Team Space.
Review the access requested by BlockSurvey MCP.
Click on Allow in the consent page.
It will redirect you to your ChatGPT and you can start using BlockSurvey MCP.
Note: BlockSurvey MCP works with the workspace selected during the authorization process. Make sure you select the correct Organization and Team Space.
What Can You Do with BlockSurvey MCP?
Create Surveys Using Natural Language
Once connected, you can describe the survey you want to create instead of building it manually.
For example: “Create a customer satisfaction survey with 5 questions about product quality, customer support, pricing, and overall satisfaction.”
Manage Existing Surveys
BlockSurvey MCP can work with surveys available in the Team Space connected to your current MCP session.
View your surveys
Ask: “List my surveys.”
Or view the structure of a specific survey: “Show me the structure of my Customer Feedback Survey.”
Add questions
Add a new question to an existing survey:
“Add a question asking customers how satisfied they are with our customer support.”
You can also specify where it should appear:
“Add the customer support question after question 2.”
Edit questions
Modify an existing question using natural language:
“Change question 3 to ‘How likely are you to recommend our product?’”
You can also update supported settings such as required status, answer choices, rating scales, limits, and formats.
Manage answer choices
You can add, edit, or remove individual answer choices.
For example: “Add ‘Not sure’ to the choices in question 4.”
Or:
“Rename ‘Good’ to ‘Satisfied’ in question 2.”
Make questions required or optional
Change whether respondents must answer a question.
For example: “Make question 3 required.”
Or:
“Make the email question optional.”
Change question types
You can change an existing question to another supported question type.
For example: “Change question 4 to a star rating question.”
If changing the question type could affect other survey functionality, you may be asked to confirm the change.
Delete questions
Remove questions from an existing survey:
“Delete the question asking about age.”
Since deleting a question is a destructive action, MCP may ask you to confirm before removing it.
Reorder questions
Change the order of top-level questions by simply describing the desired order.
For example: “Move the customer support question to the end.”
Or:
“Move question 5 to the second position.”
Edit Welcome and Thank-You Screens
Update the content of your survey's welcome or thank-you screen.
For example: “Change the welcome screen to say that the survey takes less than 2 minutes.”
Or:
“Change the thank-you message to ‘Thanks for helping us improve our product!’”
Preview and Publish Your Survey
Before sharing your survey, you can ask the AI to preview it:
“Show me a preview of my survey.”
Use the preview to check:
Questions
Question order
Answer choices
Required questions
Welcome screen
Thank-you screen
Once everything is ready, you can publish the survey directly through MCP:
“Publish my survey and give me the public link.”
BlockSurvey MCP will return the public survey link after the survey is published.
Supported Question Types
You can use any of the following question types when creating or adding questions. If you don't specify a question type, Claude/ChatGPT will choose a suitable type based on your request.
Text / Basic Input:
Single textbox, comment box, number, email, date, phone number, website, country, listChoice-Style:
Multiple choice, checkboxes, dropdown, multiple-select dropdown, ranking, color pickerRating / Scale:
Number rating, slider, star rating, customer experienceMatrix:
Matrix rating, matrix rating multiple, matrix text, matrix number, matrix dropdown, matrix star ratingMedia / Special:
File upload, image capture, signature, payment, statement, consent
Good to Know
Claude does not invent answer choices. If a question requires fixed options and you haven't provided them, it will ask you for them.
Destructive actions, such as deleting questions or answer choices, require confirmation.
Reordering only applies to top-level questions. Questions inside a question group or A/B test are not moved.
Changing a question type can regenerate its internal ID. If the question is referenced by features such as skip logic or calculations, Claude will flag this before making the change.
Images cannot be uploaded through the MCP connector. Images and screen backgrounds still need to be added through the BlockSurvey survey builder.
Limitations
BlockSurvey MCP currently focuses on survey creation and basic survey management. Some advanced BlockSurvey features still need to be configured directly through the BlockSurvey survey builder.
Survey settings
The following are not currently exposed through MCP:
General survey settings
Audience and recipient lists
Brand and custom theming
Languages and translations
Notifications
Assignment & Formulas
Data Lookup
Export settings
Activity and audit history
Restore/version history
Logic and advanced behavior
MCP cannot create new:
Skip logic
Calculations
Discount logic
Display logic
Looping logic
Repeat logic
Media
No file/image upload capability anywhere — can't set images on welcome screens, thank-you screens, or questions
Post-creation / data tools (none exist)
Getting responses / submissions
Analytics or reporting
Webhooks
Integrations (Discord, slack, etc.)
It can, however, detect existing references and warn you when an action such as deleting, reordering, or changing a question type could affect existing logic.
Question groups and A/B test questions also have limitations: their child questions cannot be independently reordered or deleted through MCP, and their question types cannot be changed.