Poll

Create a poll / voting question where users pick from predefined options.

Updated 16 Sep 20261 min read

Send "type": "poll".

Create a poll / voting question where users pick from predefined options. Use this for polls, surveys, opinion votes, multiple-choice questions, audience polls, feedback forms, or quick votes. For collecting AND upvoting open-ended ideas use render_upvoteideas; for a random picker use render_spinningwheel.

Also available as the MCP tool render_poll. The same payload works through either surface.

Fields

data

questionstringrequired

The poll question (e.g., "What is your favorite programming language?")

optionsstring[]required

Array of 3-6 distinct, non-empty string options to vote on

optionImagesstring[]

OPTIONAL, index-aligned with options. When this render includes images, each entry is "mfimg::" followed by a description of that option's picture (no text, letters or numbers in it); otherwise a real image URL. Omit for a text poll.

Example

{
  "type": "poll",
  "data": {
    "question": "string",
    "options": [
      "string"
    ],
    "optionImages": [
      "string"
    ]
  }
}

Was this page helpful?