io.github.BenSpank/pollbolt

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

AI-native survey & form builder. Manage surveys, responses, analytics, and webhooks.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "pollbolt": {
      "url": "https://api.pollbolt.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (15)

• create_survey

  Create a new survey. Returns the survey details including share_url. Supported question types: short_text, long_text, multiple_choice, checkbox, checkbox_list, numeric, star_rating, picture_choice, opinion_scale, date, email, contact_info, poll_question, statement.

  Parameters:

  • title (required) — string — Survey title
  • questions (required) — array — Array of questions
  • styles — object — Optional styling configuration for branding and visual design.
  • settings — object
  • variables — array — Custom variables for scoring, calculations, and recall.
  • hidden_fields — array — Hidden fields for URL parameters or custom data, passed through the survey URL.
  • ending_screens — array — Optional ending screens list.
  • welcome_screen — ['object', 'null'] — Optional welcome screen configuration.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_surveys read-only

  List all surveys in your PollBolt account with pagination.

  Parameters:

  • page — number — Page number (default: 1)
  • status — string — Filter by status
  • per_page — number — Results per page (default: 20, max: 100)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_survey read-only

  Get full details of a specific survey including all questions.

  Parameters:

  • survey_id (required) — string — The survey ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_survey destructive

  Update a survey's title, questions, settings, styles, screens, or logic. Providing questions replaces all existing questions.

  Parameters:

  • survey_id (required) — string — The survey ID
  • title — string — New title
  • styles — object — Partial styling update. Only provided fields are changed.
  • settings — object
  • questions — array — Replacement questions array (replaces all questions)
  • variables — array — Replace all variables.
  • hidden_fields — array — Replace all hidden fields.
  • ending_screens — array — Replace all ending screens.
  • welcome_screen — ['object', 'null'] — Replace welcome screen (set null to remove).

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• delete_survey destructive

  Permanently delete a survey and all its responses.

  Parameters:

  • survey_id (required) — string — The survey ID to delete

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• list_responses read-only

  List responses for a survey with pagination and filters. Returns response metadata and answers.

  Parameters:

  • survey_id (required) — string — The survey ID
  • page — number — Page number (default: 1)
  • since — string — ISO date - only responses after this date
  • until — string — ISO date - only responses before this date
  • status — string — Filter by response status (default: completed)
  • per_page — number — Results per page (default: 20, max: 50)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_response read-only

  Get a single response by ID.

  Parameters:

  • survey_id (required) — string — The survey ID
  • response_id (required) — string — The response ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• submit_response

  Submit a response to a survey programmatically. Answers is a map of question_id to answer value.

  Parameters:

  • survey_id (required) — string — The survey ID
  • answers (required) — object — Map of question_id -> answer value
  • user_id — string — Optional user identifier
  • completion_time — number — Completion time in milliseconds

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_analytics read-only

  Get analytics summary for a survey (views, responses, completion rate).

  Parameters:

  • survey_id (required) — string — The survey ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_media_library_images read-only

  List images from the account's media library, including brandkits, uploaded media, logos, and theme backgrounds.

  Parameters:

  • limit — number — Max images to return (default 100, max 500).
  • search — string — Optional search term to filter images by name/URL.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• duplicate_survey

  Create a copy of an existing survey with all its questions, styles, logic, and screens. Returns the new survey details including share_url.

  Parameters:

  • survey_id (required) — string — The survey ID to duplicate
  • title — string — Optional title for the copy (defaults to 'Original Title (Copy)')

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• create_webhook

  Register a webhook to receive notifications when survey events occur.

  Parameters:

  • url (required) — string — Webhook URL to receive POST requests
  • events — array — Events to subscribe to (default: response.completed)
  • secret — string — Secret for HMAC-SHA256 webhook signatures
  • survey_id — string — Specific survey ID or '*' for all surveys

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• list_webhooks read-only

  List all registered webhooks for your account.

  Parameters:

  • survey_id — string — Optional: filter by survey ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_webhook

  Update a webhook's URL, events, active status, or secret.

  Parameters:

  • webhook_id (required) — string — The webhook ID
  • url — string
  • events — array
  • secret — string
  • is_active — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• delete_webhook destructive

  Delete a registered webhook.

  Parameters:

  • webhook_id (required) — string — The webhook ID to delete

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.