Skip to main content
Glama

Pug

Get deletion request

get_deletion_request
Read-only

GetDeletionRequest returns the status of an erasure request so a controller can prove fulfilment within the statutory window (the DSAR audit trail).

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_deletion_request"
  }
}

Input Schema

NameRequiredDescriptionDefault
project_idNoThe id of the project, from list_projects.
request_idNo

Output Schema

NameRequiredDescriptionDefault
errorNo
statusNo
profile_idNo
request_idNo
external_idNo
completed_atNo
requested_atNo
events_identifiedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, openWorldHint=false and destructiveHint=false, so the safety profile is covered. The description adds domain context (this is the audit-trail record used as statutory proof), which is useful, but it discloses nothing operational such as permission requirements, behaviour with missing or ambiguous request identifiers, or why the call is marked non-idempotent.

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?

A single front-loaded sentence leading with the verb and resource, with no filler. The parenthetical DSAR synonym is mildly redundant but arguably useful vocabulary for matching compliance queries.

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?

With an output schema present and annotations covering read safety, the description need not explain return values, and the compliance purpose is well conveyed. It falls short on the two optional parameters and the call pattern for them, which is the main thing an agent still needs in order to invoke it correctly.

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

Parameters2/5

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

Schema coverage is only 50% — project_id is documented, request_id is not — and the description mentions neither parameter, so it fails to compensate for the gap. It never explains the distinction between supplying project_id plus request_id versus neither, even though the schema marks both as optional.

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?

States a specific verb and resource ("returns the status of an erasure request") plus the compliance motivation (proving fulfilment inside the statutory window). An agent can tell exactly what this retrieves; the catalog has no other deletion-request tool, so sibling differentiation is implicit rather than argued.

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

Usage Guidelines3/5

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

Usage is implied by the compliance framing (call it to check on an erasure request for the DSAR audit trail), but there is no explicit when-to-use or when-not guidance and no mention of alternatives such as listing or filtering requests. Nothing says what to do when request_id is omitted, which matters given both parameters are optional.

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.