Skip to main content
Glama

nukez_confirm

Confirm a file upload after sandbox curl completes. Call this after executing the curl command returned by nukez_store in sandbox mode. The server computes SHA-256 and records the hash. Requires a payer-signed locker:write envelope: signer-mode deployments sign automatically via the SDK; keyless clients first call without envelope to receive the exact envelope spec to sign, then re-call with envelope= (the batch spec returned by nukez_store is also accepted here). LARGE FILES: pass use_job=true after a resumable upload — the synchronous confirm streams the whole stored object on the request path, so large objects confirm through the gateway's asynchronous finalize job instead. Signer mode creates and polls the job automatically; keyless mode signs the job creation spec first, then signs the returned poll spec (fresh nonce each time, re-calling with job_id) until job_status is terminal (complete, partial, or failed).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
job_idNo
use_jobNo
envelopeNo
filenameNo
receipt_idNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / job_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Job Id"
      +}
    • addedInput schema / properties / use_job
      Added value: +{
      +  "default": false,
      +  "title": "Use Job",
      +  "type": "boolean"
      +}
  2. Changed5 schema fields changed
    • addedInput schema / properties / envelope
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Envelope"
      +}
    • addedInput schema / properties / filename / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / filename / default
      Added value: +null
    • removedInput schema / properties / filename / type
      Removed value: -"string"
    • removedInput schema / required
      Removed value: -[
      -  "filename"
      -]
  3. First observed

TDQS

A4.9/5.0
Behavior5/5

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

No annotations are supplied, so the description carries the full burden. It discloses the server-side SHA-256 hash computation, the need for a payer-signed locker:write envelope, the two-phase keyless envelope spec flow, the request-path streaming for synchronous confirms of large objects, and the async finalize job with terminal statuses (complete, partial, failed).

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?

The description is dense and front-loaded with the core action, and split into understandable chunks (normal flow, large files, keyless vs signer mode). It could be more readable, and the embedded strings are a bit noisy, but every clause earns its place and there is no filler.

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

Completeness5/5

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

Complex multi-path behavior (keyless sign-verify flow, large-file jobs, payment envelope requirement) is fully covered in the description; the output schema exists and would document return values, so no gap there. An agent working without annotations still knows the full call sequence, required envelope semantics, and what terminal statuses to expect.

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?

Schema description coverage is 0%, yet the description fully explains envelope and use_job and provides the job_id and receipt_id context. It explains that the batch spec returned by nukez_store is also accepted in envelope, that two args are actually mutually required in practice, and describes the job lifecycle. This compensates completely for the bare schema.

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?

The description states a clear verb and resource ('Confirm a file upload'), and orients the agent by referencing the specific prior step ('after executing the curl command returned by nukez_store in sandbox mode'). It also distinguishes itself from the broader upload flow by highlighting the SHA-256 hashing and the large-file async path.

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?

The description explicitly tells the agent when to call this tool and how: after the sandbox curl, with a payer-signed locker:write envelope, covering both signer-mode and keyless clients. It also spells out the large-file alternative (use_job=true, resumable upload) and the keyless signing/polling loop until terminal job status, effectively routing around sibling tools like nukez_store and nukez_upload_chunk.

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