Skip to main content
Glama

delete_webhook

Delete a webhook endpoint. Fleet/Platform. Requires Bearer.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Added

TDQS

C2.6/5.0
Behavior2/5

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

没有annotations,描述必须承担行为披露的全部责任。它仅提及需要Bearer认证,但未说明删除是否永久、是否影响关联资源、是否幂等或错误响应行为。对于一个破坏性操作,这是显著的透明度缺口。

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?

描述非常简短,没有冗余句子,核心删除意图放在最前。但'Fleet/Platform'作为一个独立片段含义模糊,信息价值有限,稍有浪费。

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

Completeness2/5

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

虽然工具参数简单,但无输出schema、无annotations,描述需提供更多上下文。它缺少删除的后果(如永久性、关联影响)、适用场景和可能的错误情况,仅凭当前信息agent难以全面评估调用影响。

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

Parameters1/5

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

Schema description coverage为0%,描述完全未提及id参数的含义、格式或用途,仅能依靠参数名'id'猜测。描述没有为参数增加任何超出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?

描述以明确的动词+资源开头('Delete a webhook endpoint'),能够与兄弟工具如delete_fiche、update_webhook区分开。但'Fleet/Platform'这一片段含义不明确,可能让agent困惑其具体适用范围,略减清晰度。

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?

描述没有说明何时使用该工具而非替代方案(如update_webhook或revoke_share),也未提供任何使用上下文或排除条件。'Requires Bearer'仅提及认证要求,不属于使用时机指导。

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.

TDQS

A3.7/5.0
Disambiguation5/5

Each tool targets a distinct resource and action: fiches have create/get/list/update/delete, shares have create/list/revoke, webhooks have register/list/update/delete, and geocode/status/subscribe are separate supporting operations. There is no meaningful overlap between tools.

Naming Consistency4/5

The majority of tools follow a clear verb_noun snake_case pattern such as create_fiche, revoke_share, and register_webhook. Minor deviations exist—status is noun-only, subscribe has no explicit object, and list_fiches pluralizes while create_fiche does not—but the naming remains predictable.

Tool Count5/5

Fifteen tools is within the ideal range and each tool maps to a concrete operation needed for the service: fiche lifecycle, sharing, webhooks, and account management. No redundant or filler tools are present.

Completeness5/5

The tool surface covers full CRUD for fiches, share creation/listing/revocation, webhook registration/listing/update/deletion, and account subscription/status. Agents can complete the main workflows around creating, sharing, and managing access sheets without dead ends.

Resources