Skip to main content

How to Create and Manage Surveys with BlockSurvey MCP

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

  1. Open Claude Desktop.

  2. Go to Customize -> Connectors and click Add.

  3. Enter a name for your MCP connection and enter the BlockSurvey MCP URL: https://mcp.blocksurvey.io/mcp

  4. Select the recommended authentication and OAuth client options shown in the connection window and click Add.

  5. Click Connect to start the BlockSurvey authorization process.

  6. Sign in to your BlockSurvey account.

  7. Select the Organization you want to use.

  8. Select the relevant Team Space.

  9. Review the access requested by BlockSurvey MCP.

  10. Click Allow on the consent page.

  11. You will be redirected back to your application and can start using BlockSurvey MCP.

Connect using ChatGPT plugin

  1. Open ChatGPT.

  2. Click on Plugins.

  3. Click on Plus icon and start the BlockSurvey authorization process.

  4. Name your MCP (anything of your choice) and paste this URL: https://mcp.blocksurvey.io/mcp

  5. Select OAuth in the dropdown. Select the Checkbox click on Create.

  6. Click on the Sign in with Blocksurvey and start the BlockSurvey authorization process.

  7. Sign in to your BlockSurvey account.

  8. Select the Organization you want to use.

  9. Select the relevant Team Space.

  10. Review the access requested by BlockSurvey MCP.

  11. Click on Allow in the consent page.

  12. 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, list

  • Choice-Style:
    Multiple choice, checkboxes, dropdown, multiple-select dropdown, ranking, color picker

  • Rating / Scale:
    Number rating, slider, star rating, customer experience

  • Matrix:
    Matrix rating, matrix rating multiple, matrix text, matrix number, matrix dropdown, matrix star rating

  • Media / 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.

Did this answer your question?