Skip to main content
Glama

Dropyour

by io.dropyour
OverviewDiscussionsAdmin

Change a drop's settings

dropyour_update_settings
Idempotent

Change a drop's visibility (private = link-only + noindex, public = indexable), its expiration, or remove the "Hosted on Dropyour" badge (badgeHidden — Pro account token required), or its private name (name — empty string clears it). Switching to public triggers a stricter content re-scan and may be rejected. With an account token, owned drops need no managementToken.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNoA private name for this drop (only you see it). Empty string clears it.
tagsNoPrivate tags — replaces all tags. Empty array clears them.
dropIdYes
publishAtNoScheduled go-live (ISO datetime) — the drop returns 404 until then (future, before expiration). Empty string = publish now.
visibilityNo
badgeHiddenNoRemove the Dropyour badge — requires a Pro account token
managementTokenNo
expiresInSecondsNoExpiration in seconds (1h..2592000) or "default" (your tier's default)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / tags
      Added value: +{
+  "description": "Private tags — replaces all tags. Empty array clears them.",
+  "items": {
+    "maxLength": 32,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 8,
+  "type": "array"
+}
  2. Changed3 schema fields changed
    • changedInput schema / properties / expiresInSeconds / anyOf
      Previous value: -[
-  {
-    "const": 3600,
-    "type": "number"
-  },
-  {
-    "const": 86400,
-    "type": "number"
-  },
-  {
-    "const": 604800,
-    "type": "number"
-  },
-  {
-    "const": 2592000,
-    "type": "number"
-  },
-  {
-    "const": "default",
-    "type": "string"
-  }
-]New value: +[
+  {
+    "maximum": 2592000,
+    "minimum": 3600,
+    "type": "integer"
+  },
+  {
+    "const": "default",
+    "type": "string"
+  }
+]
    • addedInput schema / properties / expiresInSeconds / description
      Added value: +"Expiration in seconds (1h..2592000) or \"default\" (your tier's default)"
    • addedInput schema / properties / publishAt
      Added value: +{
+  "description": "Scheduled go-live (ISO datetime) — the drop returns 404 until then (future, before expiration). Empty string = publish now.",
+  "type": "string"
+}
  3. Changed1 schema field changed
    • addedInput schema / properties / name
      Added value: +{
+  "description": "A private name for this drop (only you see it). Empty string clears it.",
+  "maxLength": 80,
+  "type": "string"
+}
  4. Changed1 schema field changed
    • changedInput schema / properties / expiresInSeconds / anyOf
      Previous value: -[
-  {
-    "const": 3600,
-    "type": "number"
-  },
-  {
-    "const": 86400,
-    "type": "number"
-  },
-  {
-    "const": 604800,
-    "type": "number"
-  },
-  {
-    "const": 2592000,
-    "type": "number"
-  }
-]New value: +[
+  {
+    "const": 3600,
+    "type": "number"
+  },
+  {
+    "const": 86400,
+    "type": "number"
+  },
+  {
+    "const": 604800,
+    "type": "number"
+  },
+  {
+    "const": 2592000,
+    "type": "number"
+  },
+  {
+    "const": "default",
+    "type": "string"
+  }
+]
  5. First observed

TDQS

A4.1/5.0
Behavior5/5

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

Annotations only provide idempotentHint, so the description carries the behavioral burden. It explains visibility semantics (private = link-only + noindex, public = indexable), warns that switching to public triggers a stricter content re-scan and may be rejected, and clarifies auth requirements for badgeHidden and managementToken. These details add real value beyond the annotation and schema.

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?

Three dense, front-loaded sentences: the first enumerates what can be changed, the second warns about the public-switch side effect, and the third clarifies auth. Every sentence earns its place with no filler or repetition.

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?

For an 8-param mutation tool with only idempotentHint and no output schema, the description covers the critical behavioral, auth, and edge-case context an agent needs to call it correctly. The few omitted details, such as publishAt and tags, are already documented in the schema, so the overall definition is complete enough.

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 description coverage is 63%, and the description adds meaning where the schema is silent or minimal: visibility enum semantics, managementToken vs account-token ownership, and the badge's Pro requirement. It does not mention publishAt or tags, but those already have schema descriptions, so the combined coverage is strong.

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?

Description opens with a concrete verb+resource: 'Change a drop's visibility... its expiration, or remove the badge... or its private name,' so an agent immediately knows what the tool does. It does not explicitly contrast with siblings like dropyou_publish or dropyou_schedule, but the settings-update scope is clear.

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?

The description implies when to use the tool: when you need to change visibility, expiration, badgeHidden, or the private name. However, it does not explicitly state when to prefer a sibling tool or when this tool should not be used, such as for publishing/scheduling operations.

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

All Dropyour toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources