Skip to main content
Glama

Declare your app's MCP tools

dropyour_app_tools
Idempotent

Make YOUR graduated app callable by a third party's agent, as an MCP server at https://.dropyour.site/mcp — live as soon as ONE tool is declared; no tool declared = no /mcp at all (404). action='declarer': declare ONE tool — name (lowercase, no 'dropyour_' prefix: that would impersonate the platform), description (≤500 bytes), inputSchema (JSON Schema, ≤4KB), and the APP ROUTE the tool call POSTs to. The tool grants NOTHING beyond the route: your app's own guards apply unchanged, like a link (ADR-0264). action='retirer': close that surface — asks nothing, revoking is never harder than granting. action='lister': see what is declared. 16 tools max. Declared, never derived from your code: pushing new code never opens a surface silently. Note: the app-server transport builds on the 2026-07-28 MCP revision via a beta SDK — named here so you choose with open eyes.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNo
routeNoAbsolute app path the tool call POSTs to, e.g. /api/commande.
actionYes
dropIdYes
descriptionNo
inputSchemaNoJSON Schema of the tool input, as a JSON string.
managementTokenNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.4/5.0
Behavior5/5

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

注释仅提供idempotentHint和destructiveHint,描述额外披露了关键行为:无工具声明时/mcp返回404、16个工具上限、工具权限不超出路由、应用自身防护不变、代码推送不会静默开放表面、beta SDK风险。这些信息远超注释本身。

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?

描述较长但信息密度高,先给出核心价值,再分action说明,最后补充限制和风险。每句话都有实质内容,没有冗余,但长度可能影响快速解析。

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?

没有输出schema,描述未说明各action的返回内容或成功失败表现;同时未解释managementToken参数的用途和来源。尽管已覆盖权限模型和限制,但这两个缺口对于正确调用该工具仍有影响。

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覆盖率仅29%,描述有效补偿了name(小写、禁止dropyour_前缀)、description(≤500字节)、inputSchema(≤4KB)、route(POST目标路径)以及action枚举的语义。但完全未提及managementToken参数的作用,这是关键遗漏。

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?

描述以具体动词和资源开头,说明让已毕业应用作为MCP服务器可被第三方代理调用,并明确区分了declarer/retirer/lister三个动作。与sibling工具(如dropyour_graduate、dropyour_link)明显不同,功能边界清晰。

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?

描述为每个action提供了明确的使用上下文:declarer声明一个工具、retirer关闭表面、lister查看已声明内容。虽然没有显式列出替代工具或when-not条件,但作为独立管理工具,其使用场景已足够清晰。

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.