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!’”

Add Survey Logic and Calculations

You can add, view and update logic in your survey using plain instructions.

  • Jump logic: send respondents to a different question based on their answer.
    “If the answer to question 2 is ‘No’, skip to question 5.”

  • Display logic: show a question only when certain conditions are met.
    “Only show question 4 if the respondent selected ‘Yes’ in question 3.”

  • Answer logic: show or hide specific answer choices in a question based on what the respondent selected in a previous question.
    “In question 5, only show the option ‘Enterprise support’ if the respondent selected ‘Enterprise’ in question 4.”

  • Thank-you screen logic: show a different thank-you screen depending on the responses.
    “Show the ‘Premium’ thank-you screen if the respondent chose the Pro plan.”

  • Numeric expressions (calculations): calculate values from responses, such as a total score.
    “Create a calculation that adds up the ratings from questions 2, 3 and 4.”

You can also ask the AI to show the logic already set up in a survey:

“Show me all the logic in my Customer Feedback Survey.”

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.

Working with Existing Surveys

BlockSurvey MCP can work with surveys available in the Team Space connected to your current MCP session.

For example:

“List my surveys.”

You can then refer to a survey by its name.

Example:

“Add a question to my Customer Feedback Survey.”

The MCP identifies the survey and performs the requested operation.

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.

Platform Compatibility

BlockSurvey MCP can be used with any AI application that supports remote MCP servers with OAuth, including Claude (Claude.ai, Claude Desktop and Claude Code), ChatGPT, Gemini CLI, GitHub Copilot in VS Code and Grok.

Other MCP-compatible AI applications can also connect to BlockSurvey MCP.

Limitations

What these tools can't do

Survey settings (Settings tab — none of these are exposed):

  • Settings (general survey config)

  • Audience (recipient/contact lists)

  • Brand (custom branding/theming beyond welcome/thank-you screen layout)

  • Languages (translations/multi-language)

  • Notifications (email/alert triggers)

  • Assignment & Formulas (Text Variables)

  • Data Lookup (external data lookups)

  • Export (data export settings/config)

  • Activity (audit log/activity history)

  • Restore (version history / restore points)

Logic & advanced question behavior:

  • Discount logic

  • Repeat logic

  • Duplicate submission logic

  • Message & feedback logic

  • Question groups and A/B test questions — can’t change their type, and reorder/delete only reaches top-level questions, not children nested inside a group or A/B test

  • Scoring — a per-choice numeric score field can be set, but there’s no dedicated scoring/results configuration (e.g. score-based branching or reports)

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.)

Note: For features that are not currently supported through MCP, use the BlockSurvey survey builder.

FAQ

1. If I disconnect or revoke BlockSurvey MCP, will my surveys be deleted?

No. Disconnecting or revoking BlockSurvey MCP access does not delete your surveys. Your surveys remain in your BlockSurvey account/workspace and can still be accessed and managed directly through BlockSurvey.

2. Do I need a BlockSurvey account to use BlockSurvey MCP?

Yes. You need a BlockSurvey account and access to the relevant Organization or Team Space.

3. Do I need to know how MCP works?

No. You can use BlockSurvey MCP through normal conversational instructions.

4. Do I need to know the MCP tool names?

No. You don't need to know how MCP works or remember individual tool names. Simply describe what you want to do using natural language.

5. Can I create an entire survey with one prompt?

Yes. You can describe the survey you want, including the questions and answer choices, and BlockSurvey MCP can create the survey for you.

6. Can I edit an existing survey?

Yes. You can add, edit, delete, and reorder questions, manage answer choices, change supported question settings, add and update survey logic and calculations, and update welcome and thank-you screens.

7. Can I publish a survey through MCP?

Yes. Once your survey is ready, you can ask the AI to publish it. BlockSurvey MCP will provide the public survey link.

8. What happens if MCP can't find my survey?

Make sure the survey belongs to the Organization and Team Space connected to your current MCP session and that you have access to it. If the survey still cannot be found, verify that you are connected to the correct workspace and try again.

9. Can I use MCP for every BlockSurvey feature?

Not currently. BlockSurvey MCP supports a range of survey creation and management operations, but some advanced BlockSurvey features may still need to be configured directly in the BlockSurvey survey builder.

Need Help?

If you run into any issues, contact us at [email protected] and we’ll be happy to help. Please include the operation you were trying to perform and any error message you received.

Related Articles
Did this answer your question?