Skip to main content
Glama

Server Details

Manage translation projects, phrases and locales with secure organization-scoped tools and views.

Ownership verified
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Available Tools

17 tools
add_localeAdd locale with missing translationsA
Destructive
Inspect

Add a new locale to a project and generate translations for every key currently missing in that locale. Uses the default-locale value as the source for each translation.

ParametersJSON Schema
NameRequiredDescriptionDefault
modelNoTranslation model to use. Defaults to gpt-5.6-luna.
localeYesNew locale code to add (for example, it)
contextNoOptional context applied while translating the missing phrases.
projectYesProject name (slug) to localize

Output Schema

ParametersJSON Schema
NameRequiredDescription
localeYes
statusYes
localesYes
projectYes
translationCountYes

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already indicate a destructive, non-read-only operation, and the description adds meaningful behavioral context: it generates translations for missing keys and uses the default-locale value as the translation source. This reveals side effects beyond the raw annotation flags without contradicting them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences communicate the core action, the scope ('every key currently missing'), and the source behavior. There is no filler or redundancy.

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?

The description, combined with full schema coverage, annotations, and an output schema, is nearly complete. A brief note about prerequisites (e.g., the project must have a default locale) would make it fully comprehensive, but no essential calling behavior is missing.

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?

The input schema covers all four parameters with descriptions, so the baseline is 3. The description adds general context about translation sourcing but does not add per-parameter semantic detail beyond what the schema already provides.

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 clearly identifies the verb ('Add') and specific resource ('a new locale'), then expands on what the operation does: generate translations for all currently missing keys using the default-locale value as source. This distinguishes add_locale from siblings like add_project, add_phrase, and even find_missing_translations.

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?

The description makes the use context clear: add a locale and fill in missing translations. It does not explicitly name alternatives or state when not to use it, but the context is unambiguous enough for an agent to select it appropriately.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_phraseAdd key with translationsA
Destructive
Inspect

Create a new key in a project’s default locale and generate translations for every other configured locale. Omit value to use the key as its source value. Refuses to overwrite an existing key.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesNew exact phrase key
modelNoTranslation model to use. Defaults to gpt-5.6-luna.
valueNoSource value in the default locale. Omit to use the key itself.
contextNoOptional context that helps translators disambiguate the phrase.
projectYesProject name (slug) to add the key to

Output Schema

ParametersJSON Schema
NameRequiredDescription
keyYes
statusYes
localesYes
projectYes
defaultLocaleYes
translationCountYes

TDQS

A3.6/5.0
Behavior1/5

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

The description usefully discloses creation behavior, auto-translation, the omit-value fallback, and overwrite refusal. However, the annotations declare destructiveHint=true, while the description states the tool refuses to overwrite an existing key and only creates new keys. This is a direct contradiction, so the behavior score must be 1.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences with no filler. The primary action is front-loaded, optional value behavior is next, and the overwrite refusal closes with an important boundary. Every sentence earns its place.

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?

For a 5-parameter tool, the description covers the core behavior, the value fallback, the translation side effect, and the existing-key refusal. The output schema and full parameter schema cover the remaining details. The only notable gap is that it doesn't explicitly route existing-key edits to update_phrase, and the conflicting destructiveHint muddies the safety picture.

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 description coverage is 100%, so every parameter is already documented in the input schema. The description repeats the omit-value behavior but does not add parameter-level semantics beyond that. Baseline 3 is appropriate.

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 uses a specific verb ('Create') and names the exact resource ('a new key in a project’s default locale') and outcome ('generate translations for every other configured locale'). It also states a defining constraint ('Refuses to overwrite an existing key') that clearly separates it from update_phrase and other siblings.

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?

The context is clear: use this tool for adding a new key with generated translations, not for modifying an existing key. The overwrite refusal implies the alternative, but it never explicitly names update_phrase or states when to prefer a different sibling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_projectAdd projectA
Destructive
Inspect

Create a MultiLocale project with a default locale and optional additional locales. Refuses to create a duplicate project name in the authenticated organization.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesNew project name (prefer a URL-safe slug)
localesNoInitial locale codes. The default locale is added automatically when omitted.
defaultLocaleYesDefault locale code for the project (for example, en)

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
projectYes

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already indicate this is not read-only and is destructive; the description adds useful behavioral context by stating that duplicate project names are refused and that the operation is scoped to the authenticated organization. This is adequate for a create operation, though error behavior is not detailed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences contain the core purpose and a key constraint with no redundant wording. The action is front-loaded and every sentence earns its place.

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?

For a simple create tool with full schema coverage, an output schema, and annotations, the description plus structured data covers required parameters, key behavior, and organizational scope. Nothing essential is missing for an agent to call this tool correctly.

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?

The input schema has 100% description coverage, so all three parameters are already documented structurally. The description only adds a high-level restatement that additional locales are optional and the default locale is included automatically, which is helpful but not essential.

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 uses a specific verb ('Create') with a concrete resource ('a MultiLocale project') and adds meaningful detail about default and additional locales. This clearly separates it from siblings like add_locale, add_phrase, and update_project.

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?

The description clearly frames this as the tool for creating a new project and notes the duplicate-name refusal, so an agent can identify the right invocation context. It does not explicitly name alternatives or exclusions, but the verb and resource make the intended use apparent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_phraseDelete key and all translationsA
Destructive
Inspect

Permanently delete every locale translation for one key in a project. If a phrase is shared with other projects, this deletes the shared row for those projects too, rather than only detaching the project.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesExact key whose complete locale group should be deleted
projectYesProject id or name that contains the key to delete

Output Schema

ParametersJSON Schema
NameRequiredDescription
keyYes
statusYes
projectYes
sharedProjectsYes
deletedTranslationCountYes

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already mark destructiveHint=true and readOnlyHint=false. The description adds valuable nuance beyond this: the deletion is permanent, applies to every locale translation, and removes the shared row for other projects rather than merely detaching the project. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the primary action and scope, and the shared-row caveat is placed second. No filler or repetition.

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?

For a simple two-parameter destructive tool with a complete schema, clear annotations, and an output schema, the description covers the permanent scope and the shared-phrase edge case. Nothing essential is missing for an agent to invoke it correctly.

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?

Input schema covers both required parameters with clear descriptions at 100% coverage, so the description carries little parameter burden. It reinforces that 'key' and 'project' identify the complete locale group, but adds no new parameter-level meaning.

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?

Description begins with a specific verb and object: 'Permanently delete every locale translation for one key in a project.' It also clarifies the scope and permanence, and the distinction from siblings like get_phrase, update_phrase, or share_phrase is clear even without naming them.

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?

The description makes the use case clear: use when a key and all its translations should be removed, including shared rows. It does not explicitly name alternatives or state 'do not use this to edit translations,' but the permanent destructive scope is unmistakable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

export_locale_dictionaryExport locale dictionaryA
Read-onlyIdempotent
Inspect

Export one locale of a MultiLocale project as bounded, sorted key/value entries. Results are API-paginated with a maximum of 50 entries per call and each value is capped at 500 characters.

ParametersJSON Schema
NameRequiredDescriptionDefault
skipNoNumber of keys to skip, sorted alphabetically. Defaults to 0 and is capped at 10000.
limitNoMaximum number of keys to return. Defaults to 25, capped at 50.
projectYesProject name (slug) to export
languageYesLanguage code to export (for example, en)

Output Schema

ParametersJSON Schema
NameRequiredDescription
skipYes
statusYes
entriesYes
hasMoreYes
projectYes
languageYes
nextSkipYes
returnedCountYes
valuesTruncatedYes
offsetCapReachedYes

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, so the description only needs to add context. It discloses API pagination with a 50-entry maximum and a 500-character value cap, which are meaningful behavioral constraints beyond the structured annotations. It does not contradict any annotation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no filler: the purpose is front-loaded, and the second sentence adds two consequential behavioral constraints. Every clause contributes actionable information.

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?

For a read-only export tool with a complete input schema and an output schema, the description is complete. It states the scope, sorted/bounded nature, pagination behavior, and value size limit, so an agent can call it correctly without missing key constraints.

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 description coverage is 100%; every parameter (project, language, skip, limit) already has a clear schema description including defaults and bounds. The tool description reinforces the pagination cap but adds no parameter-specific meaning beyond what the schema provides.

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 uses a clear verb and resource: 'Export one locale of a MultiLocale project as bounded, sorted key/value entries.' It specifies the scope (one locale) and output shape (key/value), but it never contrasts itself with similar siblings like list_phrases or search_phrases, so it lacks explicit sibling differentiation.

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?

There is no guidance on when to use this tool instead of alternatives such as list_phrases or search_phrases. The description states what it does but no conditions, exclusions, or hints for routing an agent to a sibling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

find_duplicate_phrase_valuesFind duplicate default-locale copyA
Read-onlyIdempotent
Inspect

Find keys in a bounded scan of one MultiLocale project whose default-locale translations have the same value. The result explicitly reports when the scan or output preview is truncated.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectYesProject id or name whose default-locale copy should be checked
scanLimitNoMaximum default-locale phrases to scan. Defaults to 1000, capped at 2000.

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
projectYes
scanLimitYes
duplicatesYes
defaultLocaleYes
scanTruncatedYes
duplicateCountYes
phrasesScannedYes
duplicatesTruncatedYes

TDQS

A4/5.0
Behavior4/5

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

Annotations already establish read-only, idempotent, non-destructive behavior. The description adds meaningful non-obvious context: the scan is bounded, and the result explicitly reports truncation of either the scan or the output preview. This helps the agent anticipate partial results.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences: the first states the tool's purpose and scope, the second adds an important truncation behavior. There is no filler or repetition of schema or annotation details.

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?

The description is sufficiently complete for a read-only discovery tool with an output schema and 100% parameter schema coverage. It covers scope, boundedness, and truncation behavior; the output schema handles return-value details.

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 description coverage is 100%, so the parameters are already well documented. The description's 'bounded scan' phrasing loosely aligns with scanLimit, but it does not add material detail beyond what the schema provides. Baseline 3 is appropriate.

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 specific verb ('Find keys'), a precise resource ('one MultiLocale project'), and the exact condition ('default-locale translations have the same value'). This clearly distinguishes it from siblings like find_missing_translations and search_phrases.

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 description implies usage context through 'bounded scan of one MultiLocale project' and 'default-locale copy,' but it does not explicitly state when to choose this tool over alternatives or when not to use it. No sibling is named as a competing option.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

find_missing_translationsFind missing translationsA
Read-onlyIdempotent
Inspect

Report missing keys in a bounded scan of one locale or up to 10 configured locales, compared with the project default locale. The result explicitly reports partial locale or phrase scans and never creates translations.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectYesProject id or name whose translation coverage should be checked
languageNoLocale code to check. Omit to report coverage for every configured locale.
scanLimitNoMaximum phrases to scan per locale. Defaults to 1000, capped at 2000.
localeLimitNoMaximum configured locales to check when language is omitted. Defaults to 10.

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
localesYes
projectYes
scanLimitYes
defaultLocaleYes
localesTruncatedYes
sourceScanTruncatedYes
sourcePhrasesScannedYes

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already mark this as read-only and idempotent, but the description adds valuable behavior: scans are bounded, partial scans are explicitly reported, and it never creates translations. This goes beyond the structured annotations and helps an agent trust the tool's side-effect profile.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no filler. The first sentence front-loads the core purpose and scope; the second adds the critical boundary conditions about partial reports and non-mutation. Every clause earns its place.

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?

For a read-only reporting tool with a rich output schema and annotations covering idempotence and safety, the description covers scope, limits, and result semantics. Nothing essential is missing for an agent to select and invoke it correctly.

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

Parameters4/5

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

Schema description coverage is 100%, so the baseline is 3. The description adds conceptual meaning by tying 'one locale or up to 10 configured locales' to language and localeLimit, and 'bounded scan' to scanLimit, which helps an agent reason about parameter behavior beyond the raw 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?

Description states a specific action ('Report missing keys') and the resource scope ('bounded scan of one locale or up to 10 configured locales'), and it clarifies the comparison basis ('project default locale'). It distinguishes itself from siblings like find_duplicate_phrase_values or export_locale_dictionary by focusing on missing keys rather than duplicates or exports.

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?

The description clearly establishes when this tool is useful: when you need missing translation keys relative to the default locale. It stops short of naming alternative tools or giving explicit when-not-to-use guidance, but the context is strong enough for an agent to infer the intended use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_phraseGet phraseA
Read-onlyIdempotent
Inspect

Fetch translations for one exact phrase key in a MultiLocale project. Returns a bounded Markdown and structured preview across locales, or a single locale when language is provided.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesExact phrase key to look up
projectYesProject name (slug) the phrase belongs to
languageNoLanguage code to fetch (e.g. en, it). Omit to fetch all languages for the key.

Output Schema

ParametersJSON Schema
NameRequiredDescription
keyYes
statusYes
projectYes
translationsYes
translationCountYes
translationsTruncatedYes

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds a small amount of behavioral context by noting the return preview is Markdown and structured, and that locale scope depends on whether language is supplied. It does not contradict annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the primary action and resource, and does not waste words. The only slightly vague phrase is 'bounded Markdown', but overall the definition is appropriately compact.

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?

For a read-only lookup tool with 100% schema coverage, an output schema, and strong annotations, the description is nearly complete. It accurately captures the exact-key semantics and optional language narrowing. It would be more complete if it explicitly directed agents away from search_phrases or list_phrases, but the wording already implies that boundary.

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 description coverage is 100%, so the schema already documents key, project, and language in detail. The description mostly restates the language behavior ('single locale when language is provided') that the schema already covers, adding little semantic value beyond what structured fields provide.

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 clearly states a specific verb ('Fetch') and a concrete resource ('translations for one exact phrase key in a MultiLocale project'). It also differentiates from siblings by emphasizing 'one exact phrase key', which excludes list_phrases and search_phrases without needing to open their definitions.

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?

The description conveys the intended use case: retrieving translations for a specific exact key, optionally narrowed to one locale. It does not explicitly name alternatives or say when not to use it, but the context is clear enough for an agent to select it over list/search variants.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_projectGet projectA
Read-onlyIdempotent
Inspect

Fetch a single MultiLocale project by id or name. Returns bounded Markdown and structured project metadata, including name, configured locales, and timestamps.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectIdOrNameYesProject id or project name (slug)

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
projectYes

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, covering the safety profile. The description adds useful behavioral context beyond that: it returns 'bounded Markdown' and 'structured project metadata' including name, locales, and timestamps. No contradiction with annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences, with the core action and resource in the first sentence and valuable output detail in the second. No filler or redundant phrasing.

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?

For a single-parameter read-only getter with an output schema and full annotation coverage, the description is complete. It clarifies the lookup scope, the output type, and key metadata fields. The existence of the output schema means return values need not be exhaustively listed.

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 description coverage is 100%, with projectIdOrName already described as 'Project id or project name (slug)'. The description merely restates 'by id or name' without adding syntax, format, or disambiguation details, so it adds no value beyond the schema baseline.

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 specific verb ('Fetch'), a clear resource ('a single MultiLocale project'), and the lookup key ('by id or name'). It also distinguishes itself from sibling tools like list_projects and search_phrases by emphasizing it retrieves one project with metadata, not a collection or search result.

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 description implies the tool is for retrieving a single project by identifier, which is a clear context. However, it does not explicitly state when to prefer this over alternatives such as list_projects or search_phrases, nor does it mention exclusions or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_phrasesList phrasesA
Read-onlyIdempotent
Inspect

List translation phrases for a MultiLocale project. Optionally filter by language or key. Returns a bounded Markdown and structured preview of id, key, language, and value.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyNoFilter by exact phrase key
projectYesProject name (slug) to list phrases for
languageNoFilter by language code (e.g. en, it, es)

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
phrasesYes
phraseCountYes
phrasesTruncatedYes

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already establish read-only, idempotent, non-destructive behavior. The description adds useful behavioral context beyond the annotations by disclosing that results are bounded and that the output is a Markdown and structured preview containing id, key, language, and value. No contradiction with annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with zero filler. The main action and scope lead, optional filters follow, and the return behavior closes the statement—each clause earns its place.

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 a rich output schema and comprehensive annotations, the description covers the essential usage and result shape. It could additionally mention limits on the bounded preview or sorting behavior, but 'bounded' plus the structured preview suffices for an agent to invoke the tool correctly.

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 description coverage is 100%, so the baseline is 3. The description echoes the filter-by-language-or-key semantics already present in the schema but does not add extra meaning beyond what the property descriptions provide, such as format constraints or interaction effects between filters.

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 clearly identifies the action ('List') and resource ('translation phrases for a MultiLocale project'). It specifies optional filtering by language or key, and distinguishes the list operation from singular 'get_phrase' by nature. However, it does not explicitly name a sibling or contrast with 'search_phrases', which would have secured a 5.

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 statement 'Optionally filter by language or key' implies a typical use case—enumerating phrases with optional narrowing. Yet there is no explicit guidance about when to choose this over the closely related 'search_phrases', 'get_phrase', or 'export_locale_dictionary' tools, leaving the routing decision partly to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_projectsList projectsA
Read-onlyIdempotent
Inspect

List all MultiLocale projects the authenticated user has access to. Returns a bounded Markdown and structured preview of project ids, names, locales, and timestamps.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
projectsYes
projectCountYes
projectsTruncatedYes

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and non-destructive behavior, so the bar is lower. The description adds useful behavioral context: it returns a bounded Markdown and structured preview, and it scopes results by authenticated access. No contradiction with the annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences with no filler. The first sentence states the action and scope, and the second sentence describes the return format, making the description easy to scan and immediately actionable.

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?

For a no-parameter, read-only list tool with an output schema and safety annotations, this description is complete. It tells an agent what scope applies, what fields will be present, and that the result is bounded, leaving no essential gap.

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

Parameters4/5

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

The input schema has zero parameters and schema description coverage is 100%, so there is no parameter semantics to clarify. The description usefully focuses on what the response contains instead of parameter documentation, matching the baseline for a zero-parameter tool.

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 the specific verb 'List' and the resource 'all MultiLocale projects', clearly identifying what the tool does. It also defines the scope as projects the authenticated user has access to, which differentiates it from single-project tools like get_project and creation tools like add_project.

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?

It clearly communicates that this is the enumeration tool for projects the user can access, with no parameters or complex preconditions. It does not explicitly name alternatives or exclusion criteria, so it falls short of a perfect 5, but the intended usage is obvious.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_team_membersList team membersA
Read-onlyIdempotent
Inspect

List a bounded roster for the authenticated MultiLocale organization. Returns only each member's display name and role. Email addresses, member IDs, role IDs, phone, country, and signup device details are excluded.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
membersYes
memberCountYes
membersTruncatedYes

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare read-only, idempotent, non-destructive behavior. The description adds useful behavioral context beyond that, including the organization scope, bounded nature of the roster, and the precise fields suppressed from the response.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no filler; the main action and scope are front-loaded, and the exclusion list adds useful detail without bloating the definition. Every sentence earns its place.

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?

For a zero-parameter read-only list tool with an output schema and annotations already covering safety and idempotency, the description is complete. It tells the agent what will be returned, what is excluded, and the organizational scope, leaving no critical gap.

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

Parameters4/5

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

The tool takes zero parameters and the schema description coverage is 100%, so there are no parameter semantics for the description to clarify. The description still reinforces the implicit operation scope by stating it acts on the authenticated organization's team roster.

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?

States a specific verb and resource: 'List a bounded roster' for team members. It clarifies exactly what is returned (display name and role) and what is excluded (emails, IDs, phone, country, signup device), making the tool's scope unmistakable.

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?

The description clearly frames the tool as a bounded roster listing for the authenticated organization, which conveys when it is appropriate. It also signals what this tool is not for by listing excluded fields, though it does not name an alternative tool for richer member data.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_phrasesSearch phrasesA
Read-onlyIdempotent
Inspect

Search translation phrases for a MultiLocale project by matching a query string against phrase keys and values. Returns a bounded Markdown and structured preview of matching ids, keys, languages, and values.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesSearch text to match against phrase keys and values
projectYesProject name (slug) to search phrases in
languageNoRestrict search to a specific language code (e.g. en, it)

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
phrasesYes
phraseCountYes
phrasesTruncatedYes

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint and idempotentHint, so the description need not repeat safety. It adds value by disclosing the output form ('bounded Markdown and structured preview') and the scope of returned data ('ids, keys, languages, and values'), which goes beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences deliver the core action, the matching mechanism, and the result format with no filler. The primary operation is front-loaded, and every phrase earns its place.

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?

Given the simple three-parameter shape, high schema coverage, and existing output schema, the description conveys enough to correctly select the tool and understand its return nature. Minor gaps like pagination or case-sensitivity are acceptable because 'bounded' already signals a limited preview.

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 schema already explains the query and project parameters. The description reinforces that query matches both keys and values, but it does not meaningfully clarify the optional language parameter beyond the schema. Baseline 3 is appropriate because the structured schema carries the semantic weight.

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 clearly identifies the operation ('Search translation phrases'), the targeted resource ('for a MultiLocale project'), and the matching mechanism ('query string against phrase keys and values'). It also distinguishes itself from siblings like list_phrases by emphasizing query-based matching and the returned preview content.

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 description implies this tool is for query-based search within a project, which contrasts with list_phrases or get_phrase, but it never explicitly states when to use this tool over those alternatives or when not to use it. Usage context is inferable but not made explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

share_phraseShare key with projectsA
DestructiveIdempotent
Inspect

Attach every locale translation for one key in a source project to one or more target projects. The underlying phrase rows become shared, so future edits affect every attached project.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesExact key to share across every locale
projectYesSource project id or name that already contains the key
targetProjectsYesOne or more target project ids or names to attach to the key

Output Schema

ParametersJSON Schema
NameRequiredDescription
keyYes
statusYes
projectYes
targetProjectsYes
translationCountYes

TDQS

A4/5.0
Behavior3/5

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

Annotations already signal readOnly=false, destructiveHint=true, and idempotentHint=true. The description adds useful behavioral context by stating that underlying phrase rows become shared and future edits affect every attached project, but it does not disclose potential destructive edge cases such as what happens if a target project already has an existing phrase with the same key or whether sharing is reversible.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, tight and front-loaded with the action, then the key consequence. No filler or repetition of obvious schema details.

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?

Given the output schema and complete parameter documentation, the description sufficiently explains what the operation does and its main consequence. It is slightly incomplete regarding destructive edge cases, but annotations already flag that dimension.

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 description coverage is 100%, so parameters are already well-documented. The description reinforces that the key must already exist in the source project and that targetProjects receive attachments, but it adds no new behavioral detail beyond the 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 uses a specific verb ('attach') and names the exact resource and scope: every locale translation for one key in a source project, shared to one or more target projects. This clearly distinguishes the tool from siblings like add_phrase or update_phrase.

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?

The description provides clear context for when to use the tool: when a key already exists in a source project and its translations should be attached to other projects. It also explains the consequence ('future edits affect every attached project'), which makes the use case obvious, though it does not explicitly name alternatives or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

show_project_overviewShow MultiLocale project overviewA
Read-onlyIdempotent
Inspect

Render a bounded overview for a known MultiLocale project. Use this after listing projects or when the user provides a project id or name. It shows safe project metadata and up to 24 configured locales without downloading the project phrase dictionary.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectIdOrNameYesMultiLocale project id or name (slug) to render

Output Schema

ParametersJSON Schema
NameRequiredDescription
projectYes

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already mark it read-only, idempotent, non-destructive, and closed-world; the description adds useful behavioral context beyond annotations: the overview is bounded, the metadata is safe, it returns at most 24 locales, and it does not download the phrase dictionary. No contradiction exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with what the tool does and when to use it, followed by a concise boundary ('without downloading the project phrase dictionary'). 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?

For a one-paramerer tool with a full input schema, a declared output schema, and rich annotations, the description is complete enough: it gives the precondition, the resource, and the main limitations. Nothing needed for a correct invocation is missing.

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% with a clear description of projectIdOrName, so the schema already carries the parameter meaning. The description reinforces that it accepts an id or name and that the project must be known, but adds no new parameter-level syntax or format details.

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 uses a specific verb ('Render') and resource ('bounded overview for a known MultiLocale project') and clarifies the scope with 'safe project metadata and up to 24 configured locales.' The 'without downloading the project phrase dictionary' clause differentiates it from content-export/list-style siblings, so an agent can tell it apart.

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?

It states explicit invocation context: 'Use this after listing projects or when the user provides a project id or name.' This makes the precondition clear, but it does not list exclusions or name alternative tools such as get_project or export_locale_dictionary.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

update_phraseUpdate phrase translationA
DestructiveIdempotent
Inspect

Update the translation value for a specific phrase key and language in a MultiLocale project. Phrases may be shared across projects — updating affects all projects that share the key. Clears machine-translation flags since the value is now human-edited.

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesExact phrase key to update
valueYesNew translation value for the given language
projectYesProject name (slug) the phrase belongs to
languageYesLanguage code of the translation to update (e.g. en, it, es)

Output Schema

ParametersJSON Schema
NameRequiredDescription
keyYes
valueYes
statusYes
projectYes
languageYes
previousValueYes
sharedProjectsYes

TDQS

A4.5/5.0
Behavior5/5

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

The annotations already flag destructive behavior and idempotency, but the description adds meaningful behavioral detail: updates propagate across all projects sharing the key, and machine-translation flags are cleared because the value becomes human-edited. This is valuable context beyond the annotations and helps an agent anticipate side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, each earning its place: the first states the core operation, the second warns of cross-project side effects, and the third explains flag clearing. The most important action is front-loaded, and there is no redundant or promotional wording.

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?

For a moderately simple 4-parameter update tool with a full output schema and clear annotations, the description covers the operation, shared-key side effects, and flag behavior. Nothing an agent needs to invoke it correctly is missing.

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 description coverage is 100%, so all four parameters are already documented structurally. The description adds little new parameter-level meaning beyond reinforcing that key and language identify the specific translation and that value is the new human-edited string. This matches the baseline for fully schema-covered parameters.

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 names the exact action ('update the translation value'), the target resource ('phrase key and language'), and the container ('MultiLocale project'). It also distinguishes itself clearly from sibling tools like add_phrase, delete_phrase, and update_project by stating precisely which object and attribute it modifies.

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?

The description provides clear context: this is for updating an existing translation identified by key and language within a project. It does not explicitly mention alternatives or exclusion conditions, such as 'use add_phrase for new keys' or 'use delete_phrase to remove', so it stops short of the top score but still gives enough situational clarity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

update_projectUpdate projectA
DestructiveIdempotent
Inspect

Update a MultiLocale project’s default locale, complete locale list, or translation context. Project names are intentionally not changed because phrases reference the project name.

ParametersJSON Schema
NameRequiredDescriptionDefault
contextNoOptional translation context for the project. Use an empty string to clear it.
localesNoComplete replacement list of locale codes. Include the default locale.
defaultLocaleNoNew default locale code. It must be one of the project locales.
projectIdOrNameYesProject id or project name (slug)

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusYes
projectYes
changedFieldsYes

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already mark this as destructive and idempotent, so the description does not need to restate that. It adds beyond the annotations by explaining a non-obvious design invariant: project names cannot be changed because phrases reference the project name. It also signals that the locale list replacement is complete, not additive, which is important destructive context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no filler. The primary action is stated first, and the critical project-name invariants is placed second. Every word earns its place.

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?

The description plus the 100% schema coverage and annotations provide most of what an agent needs: what can be updated, the fact that project name stays fixed, and the destructive/idempotent nature. The only notable gap is the lack of explicit guidance about using add_locale versus update_project for locale changes, but the schema's 'complete replacement list' language mitigates this.

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 description coverage is 100%, so the description is not required to carry param details. It does name the high-level update targets (default locale, complete locale list, translation context), which maps to defaultLocale, locales, and context. But it adds no semantics beyond the schema, such as the requirement that defaultLocale be in the locales list or that the locales param is a complete replacement.

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 names a specific verb (Update), a specific resource (MultiLocale project), and exactly which aspects can be changed: default locale, complete locale list, and translation context. It also distinguishes itself by explicitly stating that project names are intentionally not changed, which separates it from any project-naming operation and from sibling tools like add_project.

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?

The description states what the tool can do and gives an explicit when-not: project names are intentionally not changed because phrases reference the project name. This is a clear exclusion. However, it does not explicitly contrast with add_locale or other sibling tools, so an agent must infer that add_locale is the better choice for adding a single locale rather than replacing the complete locale list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 17 tool updates
    • First observedadd_locale
    • First observedadd_phrase
    • First observedadd_project
    • First observeddelete_phrase
    • First observedexport_locale_dictionary
    • First observedfind_duplicate_phrase_values
    • First observedfind_missing_translations
    • First observedget_phrase
    • First observedget_project
    • First observedlist_phrases
    • First observedlist_projects
    • First observedlist_team_members
    • First observedsearch_phrases
    • First observedshare_phrase
    • First observedshow_project_overview
    • First observedupdate_phrase
    • First observedupdate_project

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.9/5.0
Disambiguation4/5

The tool set separates resources (project, phrase, locale, team member) with clear action prefixes. Some read tools overlap: get_project vs show_project_overview, and list_phrases vs search_phrases, but descriptions clarify exact scope and parameters. No two tools appear to perform the same operation.

Naming Consistency5/5

All 17 tools follow a consistent lowercase_snake_case verb_noun pattern, e.g. add_project, list_phrases, update_phrase, export_locale_dictionary. There are no mixed conventions, vague verbs, or inconsistent abbreviation styles. This is exemplary.

Tool Count3/5

At 17 tools, the set is on the heavy side for a localization server and above the typical 3-15 well-scoped range. While each tool has a distinct purpose, show_project_overview and the find_* diagnostics add surface area and could be trimmed without losing core functionality. Still, the count is not excessive for the broad domain.

Completeness3/5

Phrases have full CRUD plus search/share, and projects have create/read/update/list, but delete_project is absent, leaving an obvious lifecycle gap. Team member operations are list-only, and locale removal is only possible indirectly via update_project. Core translation workflows work, but these gaps will block some common tasks.

Resources