Skip to main content
Glama

Удаление ответов

delete_quiz_answers
Destructive

Убирает ответы в корзину, возвращает их оттуда или удаляет безвозвратно. Обычное удаление обратимо: ответ пропадает из списка и отчёта, но лежит в корзине. Безвозвратное необратимо — вместе с ответом убираются и файлы, которые загрузил респондент, поэтому нужен отдельный признак confirm_purge. Скрытые и отправленные на модерацию ответы не затрагиваются.

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>",
      "action": "<action>"
    },
    "name": "delete_quiz_answers"
  }
}

Input Schema

NameRequiredDescriptionDefault
scopeNoНад чем работать: selected — над перечисленными в answer_ids (по умолчанию), all — над всеми ответами опроса. При all список id не нужен, а действие требует confirm_purge.
actionYestrash — в корзину, restore — вернуть из корзины, purge — удалить безвозвратно.
quiz_idYesID опроса.
answer_idsNoID ответов, до 500 за раз. Берите их из quiz://{id}/answers. Обязателен при scope=selected, то есть в обычном случае; при scope=all не передаётся.
confirm_purgeNoОбязателен и должен быть true для действия purge: подтверждение, что ответы и файлы удаляются насовсем.
excluded_answer_idsNoПри scope=all — ответы, которые нужно оставить как есть, до 500 штук.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Beyond destructiveHint=true, it discloses that normal deletion is reversible via trash, purge is irreversible and removes respondent-uploaded files, confirm_purge is required, and hidden/moderation answers are untouched. This is substantive operational context for a destructive tool.

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

Conciseness5/5

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

Four sentences are front-loaded with the core actions, followed by reversibility, purge side effects, and exclusions. No filler is present; each sentence adds operational value.

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

Completeness5/5

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

For a six-parameter destructive mutation with full schema coverage and annotations, the description covers action semantics, reversibility, required confirmation, side effects, and exclusions. Return values are not described, but with no output schema that is not an invocation-critical gap.

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

Parameters4/5

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

Schema coverage is 100%, so the schema already documents all six parameters. The description adds meaning by explaining why confirm_purge exists and by stating that hidden/moderation answers are not affected, which nuances the behavior of scope=all; it still does not add new syntax or per-parameter option detail.

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 precise verb and resource: it moves answers to trash, restores them, or permanently deletes them. It clearly scopes the operation to quiz answers rather than whole quizzes, though it does not explicitly name a sibling alternative.

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

Usage Guidelines4/5

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

It explains the conditions for the three actions and highlights the reversible versus irreversible distinction, which guides action choice. It also states that hidden and moderation-pending answers are unaffected, but it does not name alternative tools such as delete_quiz.

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