Skip to main content
Glama

Render Standard Statement

render_standard_statement
Read-only

Renders one authenticated Standard Statement, named by its transfer handle, as a newly generated human-readable presentation PDF retained behind a fresh download handle. A document the pipeline's form law would refuse is refused whole. Each call renders and retains a new artifact; the books are untouched. Not metered.

Input Schema

NameRequiredDescriptionDefault
handleYesServer-side transfer handle (download:<id> / upload:<id>) naming the standard document.
workspace_tagYesActive workspace id (the workspace_tag create_workspace and list_workspaces return); scopes authorization and transfer storage.

Output Schema

NameRequiredDescriptionDefault
engineYesStamped engine build/version identity for the tool result.
statusYesstandard_statement_rendered on success.
source_handleYesThe rendered standard statement document's transfer handle, echoed.
workspace_tagYesWorkspace scoped by the tool call.
presentation_pdfYesThe generated PDF's transfer descriptor — session_id, handle, artifact_kind=generated_pdf, file_name, media_type, byte_count, sha256, expires_at, download_program — plus carries_protected_data=true, statement (its routing identity), and render_warnings.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare read-only, non-idempotent, closed-world, non-destructive, and the description usefully reinforces this with 'each call renders and retains a new artifact; the books are untouched' and 'not metered'. It also discloses an all-or-nothing failure mode ('refused whole') that annotations cannot express, though it omits any timing/async behavior for a render operation.

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?

Four tight sentences with the core action front-loaded and no filler. Dense domain jargon ('form law', 'the books') slightly reduces readability, but nothing is wasted.

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?

With annotations covering the safety profile and an output schema covering the return shape, the description supplies the remaining behavioral context: artifact retention, non-metering, and atomic refusal. The notable gap is whether rendering is synchronous or must be awaited via wait_for_workspace_idle.

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 both parameters carry descriptions, so the schema does the heavy lifting. The description adds only gloss ('named by its transfer handle', 'fresh download handle') and gives no format detail or constraint beyond what the schema already states.

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 (renders) and resource (Standard Statement) plus the produced artifact type (PDF behind a fresh download handle), which is far more than a restatement of the title. It does not differentiate itself from close siblings such as export_standard_statement or open_standard_document, so the agent must infer which one to pick.

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?

Usage is only implied: the statement must be addressed by an authenticated transfer handle and the result is a new presentation PDF. There is no explicit when-to-use versus export_standard_statement/open_standard_document, and no prerequisites such as needing the document pre-authenticated or whether rendering is synchronous.

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