Skip to main content
Glama

PDFShift

get_log

Get a single conversion log by its request id.

Input Schema

NameRequiredDescriptionDefault
request_idYesThe request id of the conversion.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full disclosure burden, and it only conveys that the operation returns one log. It says nothing about not-found behavior (error vs. empty), permission/auth requirements, or whether the record is a snapshot versus live data — all things an agent would want before calling a bare lookup with no safety hints.

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?

A single front-loaded sentence with no filler; the key qualifier 'single' appears early. Its brevity is clean rather than padded, though the terseness is part of why other dimensions have gaps.

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?

For a one-parameter read lookup with no output schema and no annotations, the description covers the essential contract: what it fetches and by what key. It remains silent on failure modes and return shape, which is a real but modest gap at this complexity level.

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?

There is only one parameter and schema coverage is 100%, with the schema already documenting request_id as 'The request id of the conversion.' The description's 'by its request id' adds no format, source, or disambiguation detail beyond that, so the baseline 3 applies.

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 ('Get a single conversion log') and narrows scope with the qualifier 'single', which implicitly separates it from the sibling list_logs. It stops short of naming that sibling, so the differentiation is inferable rather than explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'by its request id' hints that a known request id is the precondition, but there is no explicit when-to-use statement, no when-not, and no routing to list_logs for the case where the agent lacks an id or wants more than one record. For a lookup tool whose main alternative is a sibling list, that omission matters.

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