MCP Tools
rename_translation_key
Rename/move a translation key across ALL locale files in a layer. Preserves the value in every locale. Use dryRun to preview changes before applying them.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
layer | string | yes | Layer name from discover (e.g., "root", "app-admin"). The key will be renamed in ALL locale files in this layer. |
oldKey | string | yes | Current dot-separated key path to rename. Example: "common.actions.save". |
newKey | string | yes | New dot-separated key path after renaming. Example: "common.buttons.save". Must not already exist. |
dryRun | boolean | no | When true, returns a preview of what would be renamed without writing any files. Default: false. |
projectDir | string | no | Absolute path to the Nuxt project root. Defaults to I18N_PROJECT_DIR, then server cwd. Example: "/home/user/my-app". |
Paired CLI Command
The same operation runs from a terminal as the-i18n-cli rename, 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.