Skip to main content
Glama

Dayze — Life Context

Bulk Dismiss Clarifications

bulk_dismiss_clarifications
Destructive

Preview first, 30-day undo. Dismiss non-person / typed junk from the clarification queue. Reviewed and reversible: first call preview_destructive_change({ tool: "bulk_dismiss_clarifications", arguments: { entity_type?, reason? } }), which stores the exact change without applying it. After the user confirms, call bulk_dismiss_clarifications with preview_id, restore_window_acknowledged: true and request_id; the reviewed preview is applied exactly and a changed record is refused. Returns restore_id; restore_change({ restore_id }) undoes it for 30 days unless the record was edited since. The preview lists every clarification that would be dismissed; restore returns them to pending. ($0.05; API key required)

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
reasonNo
preview_idYespreview_id returned by preview_destructive_change for this tool.
request_idYesRequired idempotency key; retries return the original receipt.
entity_typeNo
idempotency_keyNoAlias for request_id.
restore_window_acknowledgedYesMust be true after reviewing the preview and its 30-day restore window.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
accountNoThe Dayze account this data belongs to. With more than one Dayze connection, name it in the answer.
messageNo
dismissedNo
preview_idNo
provenanceNoWhich connector wrote the record and which connected Dayze account received it.
restore_idNoPass to restore_change to undo within restore_window_days.
reversibleNo
idempotent_replayNo
restore_expires_atNo
restore_window_daysNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / account
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer.",
      +  "properties": {
      +    "display_name": {
      +      "description": "Account display name.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "handle": {
      +      "description": "Account handle, e.g. @goh.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "note": {
      +      "description": "How to disclose the account to the user.",
      +      "type": "string"
      +    },
      +    "qa_fixture": {
      +      "description": "True for a known QA test account: its records are fixture data, not a real life.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "handle",
      +    "display_name",
      +    "qa_fixture",
      +    "note"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / provenance
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Which connector wrote the record and which connected Dayze account received it.",
      +  "properties": {
      +    "account": {
      +      "additionalProperties": false,
      +      "description": "The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer.",
      +      "properties": {
      +        "display_name": {
      +          "description": "Account display name.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "handle": {
      +          "description": "Account handle, e.g. @goh.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "note": {
      +          "description": "How to disclose the account to the user.",
      +          "type": "string"
      +        },
      +        "qa_fixture": {
      +          "description": "True for a known QA test account: its records are fixture data, not a real life.",
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "handle",
      +        "display_name",
      +        "qa_fixture",
      +        "note"
      +      ],
      +      "type": "object"
      +    },
      +    "channel": {
      +      "description": "Always mcp_connector.",
      +      "type": "string"
      +    },
      +    "connector": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "kind": {
      +          "description": "oauth or api_key.",
      +          "type": "string"
      +        },
      +        "name": {
      +          "description": "The connected app or API-key label shown to the account owner.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "kind",
      +        "name"
      +      ],
      +      "type": "object"
      +    },
      +    "source": {
      +      "description": "chatgpt for ChatGPT OAuth writes; mcp for another OAuth app or API key.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "source",
      +    "channel",
      +    "connector",
      +    "account"
      +  ],
      +  "type": "object"
      +}
  2. Changed10 schema fields changed
    • addedInput schema / properties / preview_id
      Added value: +{
      +  "description": "preview_id returned by preview_destructive_change for this tool.",
      +  "type": "string"
      +}
    • changedInput schema / properties / request_id / description
      Previous value: -"Client idempotency key (retries return original result)."New value: +"Required idempotency key; retries return the original receipt."
    • addedInput schema / properties / restore_window_acknowledged
      Added value: +{
      +  "description": "Must be true after reviewing the preview and its 30-day restore window.",
      +  "type": "boolean"
      +}
    • addedInput schema / required
      Added value: +[
      +  "preview_id",
      +  "restore_window_acknowledged",
      +  "request_id"
      +]
    • addedOutput schema / properties / idempotent_replay
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / preview_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / restore_expires_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / restore_id
      Added value: +{
      +  "description": "Pass to restore_change to undo within restore_window_days.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / restore_window_days
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / reversible
      Added value: +{
      +  "type": "boolean"
      +}
  3. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already flag destructiveHint=true, and the description adds substantial context beyond them: a 30-day undo via restore_change, refusal if the record changed since preview, restore_id return, idempotency behavior, and even cost/API-key requirements. This is exactly the behavioral disclosure a mutation tool needs.

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?

Front-loaded with the two key facts ('Preview first, 30-day undo') and organized as a workflow. It is somewhat dense and repeats the review/reversibility idea, but nearly every sentence carries operational detail.

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 destructive bulk mutation with a preview gate, the description covers the full lifecycle: preview, confirmation, application, undo window, and failure on changed records. An output schema exists, so return-value detail is not required, and cost/auth are noted.

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?

With 67% schema coverage, the description still explains how the three required parameters are used together (preview_id from the preview call, restore_window_acknowledged after review, request_id for idempotent retries) and documents the preview-side entity_type/reason arguments. It adds real meaning over the schema.

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

Purpose5/5

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

States a specific verb+resource with a scoping qualifier: 'Dismiss non-person / typed junk from the clarification queue.' The 'bulk' framing plus the junk-type filter distinguishes it from the single-item dismiss_clarification and the resolve_clarification siblings without opening a schema.

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 gives an explicit two-step protocol (preview first, then call this after the user confirms) and names the exact preview call and required arguments. It stops short of naming dismiss_clarification as the single-item alternative, so the routing guidance is clear but not exhaustive.

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.