localazy_create_glossary_term

WRITE: add one term to a project's glossary (max 1,000 terms per project). Needs the Reviewer role. The term guides translators and Localazy AI from now on. POST /projects/{projectId}/glossary.

destructive

Argument	Type	Description
term*	array	The term in each language: [{lang, term}]. Include the project's source language.
project*	string	Localazy project id or slug (from localazy_list_projects).
description	string	Explanation for translators.
exact_match	boolean	Match the exact form only (no inflected forms).
case_sensitive	boolean	Match case exactly.
translate_term	boolean	true = the term is translated; false = keep it as is in every language.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "term"
  ],
  "properties": {
    "term": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "lang",
          "term"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_#-]{2,24}$",
            "description": "Language code, e.g. en, cs, pt_BR, zh#Hans (as listed with localazy_list_projects languages=true)."
          },
          "term": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1
          }
        }
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "The term in each language: [{lang, term}]. Include the project's source language."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "description": "Explanation for translators."
    },
    "exact_match": {
      "type": "boolean",
      "description": "Match the exact form only (no inflected forms)."
    },
    "case_sensitive": {
      "type": "boolean",
      "description": "Match case exactly."
    },
    "translate_term": {
      "type": "boolean",
      "description": "true = the term is translated; false = keep it as is in every language."
    }
  }
}

localazy_get_file_keys

Read the strings of one file in one language: key id, key path, current translation (a string, an array or a plural object keyed @one/@other). Pages of up to 1000 keys; pass `next` for the following page. Set extra_info for hidden/limit/deprecated/comment, no_content to list keys without text. Counts against the project's daily fetch cap. GET /projects/{projectId}/files/{fileId}/keys/{lang}.

read-only

Argument	Type	Description
lang*	string	Language code, e.g. en, cs, pt_BR, zh#Hans (as listed with localazy_list_projects languages=true).
next	string	Paging key: pass the previous reply's `next`. Absent `next` = last page.
limit	integer	Items per page, 1-1000 (default 100 for keys; Localazy's own default for links is 1000).
file_id*	string	File id (from localazy_list_files).
project*	string	Localazy project id or slug (from localazy_list_projects).
deprecated	boolean	Include deprecated keys.
extra_info	boolean	Add hidden, limit, deprecated and comment to each key.

localazy_get_glossary_term

One glossary term by id. GET /projects/{projectId}/glossary/{id}.

read-only

Argument	Type	Description
project*	string	Localazy project id or slug (from localazy_list_projects).
term_id*	string	Glossary term id (from localazy_list_glossary).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "term_id"
  ],
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    },
    "term_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Glossary term id (from localazy_list_glossary)."
    }
  }
}

localazy_get_import_progress

Progress of an import batch started with localazy_import_keys (pass its `import_batch`). The endpoint is used by Localazy's own API client but is not in the public docs yet, so the reply is returned as Localazy sends it. GET /projects/{projectId}/import/{importBatch}.

read-only

Argument	Type	Description
project*	string	Localazy project id or slug (from localazy_list_projects).
import_batch*	string	The `import_batch` returned by localazy_import_keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "import_batch"
  ],
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    },
    "import_batch": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The `import_batch` returned by localazy_import_keys."
    }
  }
}

localazy_get_mt_suggestions

Machine Translation suggestions (one per engine) for one source key into a target language. Free: it does not consume Localazy credits (Localazy AI does; see localazy_translate_with_ai). The first request for a key can be slower. Nothing is saved. GET /projects/{projectId}/keys/{keyId}/suggestions/mt.

read-only

Argument	Type	Description
to*	string	Target language code.
from	string	Source language code (default: the project's source language).
key_id*	string	Source key id (the `id` of a key from localazy_get_file_keys).
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "key_id",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Target language code."
    },
    "from": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Source language code (default: the project's source language)."
    },
    "key_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Source key id (the `id` of a key from localazy_get_file_keys)."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_get_tm_suggestions

Translation Memory suggestions for one source key into a target language: earlier translations of the same text, with the project they came from. Free; no Localazy credits. GET /projects/{projectId}/keys/{keyId}/suggestions/tm.

read-only

Argument	Type	Description
to*	string	Target language code.
from	string	Source language code (default: the project's source language).
key_id*	string	Source key id (the `id` of a key from localazy_get_file_keys).
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "key_id",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Target language code."
    },
    "from": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Source language code (default: the project's source language)."
    },
    "key_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Source key id (the `id` of a key from localazy_get_file_keys)."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_import_keys

WRITE: add or update up to 50 string keys in ONE file, in ONE language (flat key -> text; use a key like "home.title" for the key name). Needs the Owner role. Nothing is deleted or deprecated, and Localazy does not overwrite existing current translations by default (translations identical to the source are skipped). By default the language is the project's source language, so this adds new source keys or changes the source text of existing ones (which marks their translations as changed); pass a different language to import translations, optionally through review with import_as_new. Imports count against the project's daily import cap (Free plan: 100/day). Returns an import_batch id for localazy_get_import_progress. POST /projects/{projectId}/import.

destructive

Argument	Type	Description
keys*	object	Key name -> text, 1-50 entries (e.g. {"home.title": "Welcome"}).
project*	string	Localazy project id or slug (from localazy_list_projects).
language*	string	Language of the strings in `keys`, e.g. en. Use the project's source language to add source keys.
file_name	string	Target file name in the project (default content.json). A new name creates a new file.
file_path	string	Optional path of the file in the project, without the file name.

localazy_list_cdn_metadata

List the Localazy CDN release tags of a project and the URL of each tag's metadata file (languages, plural rules). Needs the Manager role. GET /projects/{projectId}/cdn.

read-only

Argument	Type	Description
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project"
  ],
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_list_files

List the files in a project (id, name, type, optional path). Use a file id with localazy_get_file_keys to read its strings. GET /projects/{projectId}/files.

read-only

Argument	Type	Description
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project"
  ],
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_list_glossary

All glossary terms of a project: id, description, translate/case-sensitive/exact-match flags and the term in each language. GET /projects/{projectId}/glossary.

read-only

Argument	Type	Description
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project"
  ],
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_list_import_formats

List the file types Localazy can store strings as (type id, name, support for plurals/arrays/structured keys). The `json` type is what localazy_import_keys uses. GET /import/formats.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

localazy_list_key_links

List links between duplicate source keys (key id, linked project id, linked key id), paged. Needs the Reviewer role. GET /projects/{projectId}/links.

read-only

Argument	Type	Description
next	string	Paging key: pass the previous reply's `next`. Absent `next` = last page.
limit	integer	Items per page, 1-1000 (default 100 for keys; Localazy's own default for links is 1000).
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project"
  ],
  "properties": {
    "next": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Paging key: pass the previous reply's `next`. Absent `next` = last page."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Items per page, 1-1000 (default 100 for keys; Localazy's own default for links is 1000)."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_list_projects

List the Localazy projects the token can reach (a project token reaches one project): id, slug, name, source language, your role and visibility. Optionally add owning-organization limits (keys used/available, feature flags) and per-language progress counts (active, review, current, translated, sourceChanged, needImprovement). GET /projects.

read-only

Argument	Type	Description
languages	boolean	Add per-language translation progress.
organization	boolean	Add the owning organization's key usage and feature flags.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "languages": {
      "type": "boolean",
      "description": "Add per-language translation progress."
    },
    "organization": {
      "type": "boolean",
      "description": "Add the owning organization's key usage and feature flags."
    }
  }
}

localazy_submit_translation

WRITE: set the translation of ONE source key in ONE target language. Reviewers, managers, owners and trusted translators set it as the current version (it overwrites the existing translation and goes live in the next download/CDN release); a translator's value is stored as a candidate for review. Values are stored as-is, with no placeholder, plural or length check, and the source language cannot be written. Check the reply's `stored`. POST /projects/{projectId}/keys/{keyId}/translations/{lang}.

destructive

Argument	Type	Description
lang*	string	Target language code (not the source language).
value*	any	The translation: a string for a singular key, an array of strings for an array key, or an object keyed by plural form (zero, one, two, few, many, other; the @one/@other form that localazy_get_file_keys returns is accepted too) for a plural key, with at least one form. It must match the key's form.
key_id*	string	Source key id (the `id` of a key from localazy_get_file_keys).
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "key_id",
    "lang",
    "value"
  ],
  "properties": {
    "lang": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Target language code (not the source language)."
    },
    "value": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 20000
        },
        {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 20000
          },
          "maxItems": 100,
          "minItems": 1
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string",
            "pattern": "^@?(zero|one|two|few|many|other)$"
          },
          "additionalProperties": {
            "type": "string",
            "maxLength": 20000
          }
        }
      ],
      "description": "The translation: a string for a singular key, an array of strings for an array key, or an object keyed by plural form (zero, one, two, few, many, other; the @one/@other form that localazy_get_file_keys returns is accepted too) for a plural key, with at least one form. It must match the key's form."
    },
    "key_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Source key id (the `id` of a key from localazy_get_file_keys)."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

localazy_translate_with_ai

COSTS CREDITS: translate up to 10 texts with Localazy AI. Every call consumes Localazy credits from the account balance, by the number of translated words (see localazy.com/pricing); nothing is stored in the project, the translations are only returned. Limits: 10 requests/minute, 32 items and 16,384 characters per request. Beta. Needs the Owner role. POST /projects/{projectId}/ai.

destructive

Argument	Type	Description
to*	string	Target language code, e.g. cs.
from*	string	Source language code, e.g. en.
items*	array	1-10 texts to translate.
project*	string	Localazy project id or slug (from localazy_list_projects).
fallback	string	Engine to use when Localazy AI is unavailable.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "from",
    "to",
    "items"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Target language code, e.g. cs."
    },
    "from": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_#-]{2,24}$",
      "description": "Source language code, e.g. en."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "source"
        ],
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 512,
            "description": "Key name, as context."
          },
          "source": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1
              },
              {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 4000
                }
              }
            ],
            "description": "Text, or an object of plural forms."
          },
          "comment": {
            "type": "string",
            "maxLength": 1000,
            "description": "Context note."
          },
          "length_limit": {
            "type": "integer",
            "maximum": 32767,
            "minimum": 0,
            "description": "Maximum characters of the translation."
          }
        }
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "1-10 texts to translate."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    },
    "fallback": {
      "enum": [
        "google",
        "deepl"
      ],
      "type": "string",
      "description": "Engine to use when Localazy AI is unavailable."
    }
  }
}

localazy_update_glossary_term

WRITE: replace the content of one glossary term (the term list and any flags you pass overwrite the old values). Needs the Reviewer role. Read the term first with localazy_get_glossary_term. PUT /projects/{projectId}/glossary/{id}.

destructive

Argument	Type	Description
term*	array	The term in each language: [{lang, term}]. Include the project's source language.
project*	string	Localazy project id or slug (from localazy_list_projects).
term_id*	string	Glossary term id (from localazy_list_glossary).
description	string	Explanation for translators.
exact_match	boolean	Match the exact form only (no inflected forms).
case_sensitive	boolean	Match case exactly.
translate_term	boolean	true = the term is translated; false = keep it as is in every language.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "term_id",
    "term"
  ],
  "properties": {
    "term": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "lang",
          "term"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_#-]{2,24}$",
            "description": "Language code, e.g. en, cs, pt_BR, zh#Hans (as listed with localazy_list_projects languages=true)."
          },
          "term": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1
          }
        }
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "The term in each language: [{lang, term}]. Include the project's source language."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    },
    "term_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Glossary term id (from localazy_list_glossary)."
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "description": "Explanation for translators."
    },
    "exact_match": {
      "type": "boolean",
      "description": "Match the exact form only (no inflected forms)."
    },
    "case_sensitive": {
      "type": "boolean",
      "description": "Match case exactly."
    },
    "translate_term": {
      "type": "boolean",
      "description": "true = the term is translated; false = keep it as is in every language."
    }
  }
}

localazy_update_key_properties

WRITE: change a source key's translator comment, maximum translation length, or hidden flag (fields you omit stay as they are). Needs the Manager role. It does not change texts and cannot deprecate or delete the key. PUT /projects/{projectId}/keys/{keyId}.

destructive

Argument	Type	Description
limit	integer	Maximum translation length; -1 removes the limit.
hidden	boolean	Hide the key from translators.
key_id*	string	Source key id (the `id` of a key from localazy_get_file_keys).
comment	string	Context note for translators.
project*	string	Localazy project id or slug (from localazy_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "key_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100000,
      "minimum": -1,
      "description": "Maximum translation length; -1 removes the limit."
    },
    "hidden": {
      "type": "boolean",
      "description": "Hide the key from translators."
    },
    "key_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Source key id (the `id` of a key from localazy_get_file_keys)."
    },
    "comment": {
      "type": "string",
      "maxLength": 2000,
      "description": "Context note for translators."
    },
    "project": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Localazy project id or slug (from localazy_list_projects)."
    }
  }
}

Localazy MCP by usefulapi

Try it

localazy_create_glossary_term Destructive

Localazy MCP by usefulapi

Try it

localazy_create_glossary_term Destructive

Tools (17)