Skip to main content
Glama
williamamed

mcp-polizei

by williamamed

Eliminar cliente OAuth

delete_oauth_client

Delete an OAuth client by its internal UUID. Provide the tenant context; the clientId is not used for deletion.

Instructions

Elimina un cliente OAuth. El id interno (UUID) es obligatorio y se incluye el tenant. El clientId no identifica al cliente para eliminar (usa id).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesID interno (UUID) del cliente
extraNo
tenantNoID del tenant (default: tenant activo de la sesión)
clientIdNoclient_id (no se usa para eliminar; consulta list_oauth_clients para el id)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A4.3/5.0
Behavior2/5

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

No hay anotaciones y la descripción no menciona efectos secundarios, irreversibilidad, requisitos de permisos ni comportamiento ante fallos. Solo indica la acción de eliminar, dejando al agente sin información sobre consecuencias.

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?

La descripción es breve y directa, con dos oraciones que comunican la acción y la instrucción clave sin redundancias. La información más importante se presenta de forma concisa.

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

Completeness4/5

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

Para una operación de eliminación, la ausencia de especificación del valor de retorno es aceptable. Sin embargo, no se aclara si el parámetro 'tenant' es opcional u obligatorio, ni se indica qué sucede si el cliente no existe.

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

Parameters5/5

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

La descripción añade valor más allá del esquema al aclarar que 'id' es el identificador interno a usar, y que 'clientId' no es válido para la eliminación. Esto resuelve una posible ambigüedad semántica.

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?

La descripción indica claramente que la acción es eliminar un cliente OAuth. El nombre de la herramienta también es explicativo y no hay ambigüedad sobre la operación.

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

Usage Guidelines5/5

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

Se proporciona una guía explícita sobre qué parámetro usar: menciona que el id interno (UUID) es obligatorio y que el clientId no debe utilizarse para esta acción, evitando confusión.

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