Skip to main content
Glama

Get resource upload instructions

get_resource_upload_instructions
Read-onlyIdempotent

Use this tool before preparing binary resource uploads to learn the upload and binding workflow. No parameters required. MCP version 2.12.

Input Schema

NameRequiredDescriptionDefault
mcp_versionNoSet to "2.12", the MCP version in this tool's description. Use this tool's version, not another tool's version.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / mcp_version / description
      Previous value: -"Set to \"2.11.7\", the MCP version in this tool's description. Use this tool's version, not another tool's version."New value: +"Set to \"2.12\", the MCP version in this tool's description. Use this tool's version, not another tool's version."
  2. Changed1 schema field changed
    • changedInput schema / properties / mcp_version / description
      Previous value: -"Set to \"2.11.0\", the MCP version in this tool's description. Use this tool's version, not another tool's version."New value: +"Set to \"2.11.7\", the MCP version in this tool's description. Use this tool's version, not another tool's version."
  3. Added

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so behavior is well covered structurally; the description's only added behavior is that this is a preparatory step. The line "No parameters required" is a mild risk since the schema offers an mcp_version parameter it asks callers to set, and the description never says what the response looks like (instructions text, steps, version-specific notes).

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?

Three short sentences, front-loaded with the usage trigger, with no filler. The trailing version stamp is slightly orphaned but does carry meaning.

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 no output schema, the description should convey what the caller receives and how it feeds the next step; "upload and binding workflow" is the only hint. Adequate to call the tool, but thin for a versioned, workflow-shaping instruction endpoint that sits alongside set_app_resources and upload_resources.

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

Parameters3/5

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

Schema coverage is 100% and the single parameter carries its own detailed description tying it to "2.12", so baseline 3 applies. The description's "MCP version 2.12." echoes the schema rather than clarifying when to pass mcp_version versus omit it, which the "No parameters required" phrasing arguably muddies.

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: it returns the upload and binding workflow instructions for binary resources. An agent can distinguish it from upload_resources and get_upload_status, though the description never names those siblings to sharpen the contrast.

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?

"Use this tool before preparing binary resource uploads" gives an explicit trigger point in the workflow. It offers no exclusions or named alternatives (e.g., when to skip straight to upload_resources), so it stops short of full routing guidance.

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.

Resources