Skip to main content
Glama

Ответы на опрос

get_quiz_answers
Read-onlyIdempotent

Возвращает список ответов респондентов (submissions) по опросу. Каждый ответ содержит answer_id для toggle_answer_visibility и tag_answer и ab_variant — какой вариант A/B-теста видел респондент ({"<id виджета>": "<id варианта>"}, null — без A/B-теста). answer_total_count считает ответы по тем же фильтрам.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "quiz_id": "<quiz_id>"
    },
    "name": "get_quiz_answers"
  }
}

Input Schema

NameRequiredDescriptionDefault
dateNoФильтр по дате (формат Y-m-d).
sortNoПоле сортировки: date_end — время завершения, date_start — время начала, score — сумма баллов, duration — время прохождения, q:<uuid вопроса> — значение ответа на вопрос с числом (rating, scale, nps, smile-rating, slider, number; uuid — rowId вопроса в ответе). Пустые значения — в конце.
limitNoКоличество ответов (по умолчанию 20, макс. 100).
orderNoНаправление сортировки: asc или desc, по умолчанию desc.
localeNoЯзыки опроса: только ответы, заполненные на этих языках (коды из settings.languages или основной lang); "none" — ответы без языка.
offsetNoСмещение (по умолчанию 0).
quiz_idYesID опроса.
site_pathNoОпрос на сайте: только ответы, показанные на этой странице сайта — путь вроде /catalog/coffee, точное совпадение, до 255 символов. Работает на любом тарифе. У каждого ответа есть site_path и site_device (desktop | mobile) — страница и устройство показа, у обычного опроса null.
is_deletedNoСкрытые ответы: true — показать те, что исключены из отчётов. По умолчанию их в выдаче нет.
is_completeNoФильтр по завершённости (true — только завершённые, false — незавершённые). Не передан — завершённые и незавершённые вместе. Незавершённые требуют опции тарифа «незавершённые ответы»: без неё false даёт ошибку tariff_incomplete, а без is_complete приходят только завершённые и флаг incomplete_excluded_by_tariff: true.
is_screenoutNoОтсеянные ответы: true — показать тех, кого отсеяла логика опроса. По умолчанию их в выдаче нет.
unique_link_idsNoID ссылок этого набора: только их ответы. Без unique_link_group_id не учитывается.
unique_link_group_idNoID набора уникальных ссылок из manage_quiz_unique_links: только ответы этого набора. Работает на любом тарифе. У каждого ответа в выдаче есть поле unique_link — ссылка и набор или null.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / site_path
      Added value: +{
      +  "description": "Опрос на сайте: только ответы, показанные на этой странице сайта — путь вроде /catalog/coffee, точное совпадение, до 255 символов. Работает на любом тарифе. У каждого ответа есть site_path и site_device (desktop | mobile) — страница и устройство показа, у обычного опроса null.",
      +  "maxLength": 255,
      +  "type": "string"
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / locale
      Added value: +{
      +  "description": "Языки опроса: только ответы, заполненные на этих языках (коды из settings.languages или основной lang); \"none\" — ответы без языка.",
      +  "items": {
      +    "enum": [
      +      "ru",
      +      "en",
      +      "es",
      +      "pt",
      +      "de",
      +      "fr",
      +      "it",
      +      "tr",
      +      "pl",
      +      "uk",
      +      "be",
      +      "kk",
      +      "uz",
      +      "ky",
      +      "tg",
      +      "az",
      +      "hy",
      +      "ka",
      +      "ro",
      +      "cs",
      +      "nl",
      +      "sv",
      +      "fi",
      +      "da",
      +      "nb",
      +      "et",
      +      "lv",
      +      "lt",
      +      "el",
      +      "bg",
      +      "sr",
      +      "hr",
      +      "sk",
      +      "sl",
      +      "hu",
      +      "zh",
      +      "ja",
      +      "ko",
      +      "hi",
      +      "id",
      +      "vi",
      +      "th",
      +      "mn",
      +      "none"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  3. Changed5 schema fields changed
    • changedInput schema / properties / is_complete / description
      Previous value: -"Фильтр по завершённости (true — только завершённые, false — незавершённые)."New value: +"Фильтр по завершённости (true — только завершённые, false — незавершённые). Не передан — завершённые и незавершённые вместе. Незавершённые требуют опции тарифа «незавершённые ответы»: без неё false даёт ошибку tariff_incomplete, а без is_complete приходят только завершённые и флаг incomplete_excluded_by_tariff: true."
    • changedInput schema / properties / order / description
      Previous value: -"Направление сортировки: asc или desc."New value: +"Направление сортировки: asc или desc, по умолчанию desc."
    • changedInput schema / properties / sort / description
      Previous value: -"Поле сортировки: date_end или date_start."New value: +"Поле сортировки: date_end — время завершения, date_start — время начала, score — сумма баллов, duration — время прохождения, q:<uuid вопроса> — значение ответа на вопрос с числом (rating, scale, nps, smile-rating, slider, number; uuid — rowId вопроса в ответе). Пустые значения — в конце."
    • removedInput schema / properties / sort / enum
      Removed value: -[
      -  "date_end",
      -  "date_start"
      -]
    • addedInput schema / properties / sort / pattern
      Added value: +"^(date_end|date_start|score|duration|q:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
  4. First observed

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare a safe, idempotent read, so the description is not obligated to cover safety. It adds genuine behavioral context instead: the per-answer shape (answer_id, ab_variant with its widget-to-variant mapping and null case) and the fact that answer_total_count is computed with the same filters, which matters for pagination.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, purpose front-loaded, no filler. The A/B-test parenthetical is slightly heavy but carries real format information, so nothing is clearly wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 13-parameter read tool with no output schema, the description covers the core return fields but stays thin on ordering/pagination interaction, tariff-dependent behavior, and what the full payload looks like. The rich schema descriptions compensate for much of this, leaving it adequate rather than complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 13 parameters are already documented and the baseline is 3. The description contributes only the note that answer_total_count honors the same filters, which is a small addition beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: it returns a list of respondent submissions for a survey, which separates it from count-only or export siblings. It does not name an alternative tool explicitly, so differentiation is implied rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit when-to-use or when-not guidance. The only usage signal is indirect: answer_id is said to feed toggle_answer_visibility and tag_answer, but nothing tells the agent when to prefer count_quiz_answers or the export_answers_* tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources