MCP Tools
search_translations
Search translation files by key path or value. Simple case-insensitive substring match — not fuzzy or regex. Useful for finding existing translations before adding duplicates.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | yes | Substring to search for. Matched against translation keys and/or string values. Case-insensitive. Example: "save" matches key "common.actions.save" or value "Save changes". |
searchIn | "keys" | "values" | "both" | no | Whether to search in translation keys, values, or both. Default: "both". |
layer | string | no | Layer name to search in (e.g., "root", "app-admin"), or "*" for all layers. If omitted, searches all layers. Call discover to discover available layers. |
locale | string | no | Locale code to search in (e.g., "en", "de"). If omitted, searches all locales. |
projectDir | string | no | Absolute path to the Nuxt project root. Defaults to I18N_PROJECT_DIR, then server cwd. Example: "/home/user/my-app". |
outputFile | string | no | Absolute path to write full JSON output. Returns only a compact summary to the caller — use this for large outputs to avoid flooding the conversation context. Example: "/tmp/search-results.json" |
Paired CLI Command
The same operation runs from a terminal as the-i18n-cli search, whose page documents its flags. Both paths call the same @the-i18n-kit/cli functions, so the result is the same.
Every tool is advertised by the-i18n-mcp and listed on the MCP tools overview.