Skip to main content
Glama

Enterprise: get translation

enterprise_get_translation
Read-only

Get a finished translation of a processed Enterprise uuid.

Input Schema

NameRequiredDescriptionDefault
uuidYesYour own identifier for the audio, used as the processing key
languageYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds the useful state constraint that only a 'finished' translation of an already 'processed' uuid is returned, but says nothing about behavior when the translation is not yet ready.

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 tight sentence with no waste, front-loading the verb and resource. It is arguably under-specified rather than over-long, but as conciseness goes it is efficient.

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 carry more of the return-value and error behavior burden, yet it only names what is fetched. For a read tool with a state precondition ('finished'), it leaves the agent guessing what is returned and what happens on an unfinished translation.

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

Parameters2/5

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

Schema coverage is 50%: uuid carries a description while language has only an enum with no explanation. The description's mention of a 'processed Enterprise uuid' reinforces the uuid semantics but adds nothing about the language parameter or its enum values, so it fails to compensate for the coverage gap.

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?

The description states a specific verb (Get) and resource (a finished translation) tied to a processed Enterprise uuid, so the agent knows exactly what is retrieved. It stops short of distinguishing this tool from closely related siblings such as enterprise_get_result or enterprise_query_results, leaving overlap unresolved.

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 phrase 'of a processed Enterprise uuid' implies the prerequisite that the audio must already be processed and the translation finished, but no explicit when-to-use condition or alternative tool is named. Usage is inferable rather than stated.

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.